Email Subscriptions
DokuWiki geeft individuele gebruikers de mogelijkheid zich in te schrijven voor paginawijzigingen. Als een pagina wordt gewijzigd door een gebruiker ontvangen alle andere gebruikers die zich hebben ingeschreven op die pagina een email met de wijzigingen. De email laat de wijzigingen zien in een uniform diff formaat, een voorbeeldmail is hieronder ook weergegeven.
De inschrijffunctie wordt in- en uitgeschakeld met de subscribers instelling. Het is standaard uitgeschakeld. De emailadres van de afzender wordt ingesteld met de mailfrom instelling.
Opmerking voor wikibeheerders
Wees voorzichtig met het inschakelen van deze functie. In een drukke wiki, met veel wijzigingen en veel inschrijvers, kan het emailen van de wijzigingen naar deze inschrijvers een zware belasting zijn voor de webserver. In een publieke wiki kan het ook gewetenloze mensen een methode geven om spam te versturen naar de wikigebruikers.
RSS Feeds zijn een alternatief (en lichter) mechanisme om details te ontvangen van wikiupdates.
Beheer Inschrijvingen
Je kunt de inschrijvingen beheren voor de huidige pagina via de Inschrijvingen wijzigen
knop van de paginawerkbalk, rechts van je wikipagina.
Om in te schrijven kies je tussen twee soorten inschrijvingen:
- De huidige pagina
Hier heb je als keuze voor de updatefrequentie:- Email bij iedere wijziging
- Samenvattings-email met wijzigingen per pagina (elke 1.00 dagen)
- De hele huidige namespace
Hier heb je als keuze voor de updatefrequentie:- Email bij iedere wijziging
- Samenvattings-email met wijzigingen per pagina (elke 1.00 dagen)
- Lijst van veranderde pagina's sinds laatste email (elke 1.00 dagen)
Als je bent ingeschreven voor een pagina of namespace zal deze in het overzicht van huidge inschrijvingen verschijnen. Een namespace inschrijving verschijnt op de beheerpagina voor alle pagina's die daarin zitten.
De huidige inschrijvingen overzicht heeft ook een Uitschrijven
knop.
Wijzigingen-emails
De templates voor emails met de wijzigingen staan in de map inc/lang/nl
met namen die beginnnen met subscr_
. Als je ze graag wilt aanpassen, moet je ze eerst kopiëren naar conf/lang/nl
om te voorkomen dat ze worden overschreven bij een update van de wiki. Zie ook wijzigen vertaalde teksten voor meer informatie.
Voorbeeldemail
Hieronder een voorbeeld email die verstuurd wordt als elke wijziging gemaild moet worden.
Hello! The page sample_page in the Wiki Name wiki changed. Here are the changes: -------------------------------------------------------- @@ -3,18 +3,18 @@ ===== Section Title ===== - (This is some example text) + (This is some different example text.) -------------------------------------------------------- Date : 2009/12/25 11:19 User : sampleuser Edit Summary: sample edit summary Old Revision: http://www.example.com/doku.php?id=sample_page?rev=1246611477 New Revision: http://www.example.com/doku.php?id=sample_page To cancel the page notifications, log into the wiki at http://www.example.com/ then visit http://www.example.com/doku.php?id=sample_page and unsubscribe page and/or namespace changes. -- This mail was generated by DokuWiki at http://www.example.com/
.mlist files
Het gebruiken van de inschrijvingen zal bestanden genereren met de extensie .mlist in de ~/data/meta/ mappen en submappen. In elke .mlist bestand staan de ingeschreven gebruikersnamen.
Als je jouw Wiki op een Windows systeem laat draaien, kun het volgende commando gebruiken om alle bestanden en regels te vinden:
findstr /s "." *.mlist
Vergelijkbaar is het volgende commando voor een Linux systeem:
grep -rH ".*" *.mlist
Op een Mac (maar ik neem aan ook op een Linux systeem) werkt het volgende commando beter:
egrep -r --include="*.mlist" every\|digest\|list .
(every=notify on any change, digest=digest changes, list=list of pages)
In elk geval, zorg dat je eerst naar je data/meta map gaat.