E-mailové odběry

https://www.dokuwiki.org/subscription

DokuWiki umožňuje jednotlivým uživatelům „odebírat“ e-mailem změny stránek. Když stránku upraví nějaký uživatel, všichni ostatní uživatelé, kteří se přihlásili k odběru této stránky, obdrží e-mail s popisem změn. Uživatel, který stránku upravil, e-mail nedostane.

Pouze přihlášení uživatelé mají přístup k nástroji stránky „Spravovat odběry“ (viz snímek obrazovky níže). Anonymní nebo neregistrovaní uživatelé se nemohou přihlásit k odběru. Upozornění: e-mailové odběry v DokuWiki slouží jako nástroj pro spolupráci, nikoli jako newsletter – pro anonymní odběr změn nebo newsletterový styl informací nabízí DokuWiki RSS kanál, viz XML Syndikace.

Funkce odběrů se řídí nastavením subscribers. Ve výchozím stavu je vypnuta. Můžete ji zapnout na konfigurační stránce své wiki. Také se ujistěte, že v sekci autentizace (ověřování) není v konfigurační volbě disableactions zaškrtnuto „Subscribe/Unsubscribe“. Adresa odesílatele se nastavuje pomocí mailfrom.

Buďte opatrní při zapínání této funkce. Ve frekventované wiki s častými změnami a mnoha odběrateli může zasílání e-mailů zatěžovat webový server. Ve veřejné wiki může být tato funkce zneužita k rozesílání spamu uživatelům.

Upozornění: funkce odběru je odlišná od nastavení notify (upozornění). To funguje i tehdy, když jsou odběry vypnuté.

RSS kanály představují alternativní (a méně zatěžující) způsob, jak získávat informace o aktualizacích wiki.

Správu odběrů pro aktuální stránku zobrazíte pomocí tlačítka Spravovat odběry v panelu nástrojů stránky.

Pro přihlášení k odběru si můžete vybrat mezi dvěma typy odběrů:

• Aktuální stránka
  Kde lze nastavit frekvenci upozornění:
  • e-mail při každé změně
  • souhrnný e-mail se změnami pro každou stránku (každých 1,00 dne)
• Celý aktuální jmenný prostor
  Kde lze nastavit frekvenci upozornění:
  • e-mail při každé změně
  • souhrnný e-mail se změnami pro každou stránku (každých 1,00 dne)
  • seznam změněných stránek od posledního e-mailu (každých 1,00 dne)

Jakmile se přihlásíte k odběru stránky nebo jmenného prostoru, zobrazí se v přehledu aktuálních odběrů. Odběr jmenného prostoru se zobrazí na stránce správy všech stránek v daném prostoru.

Frekvenci souhrnných e-mailů a seznamů lze nastavit pomocí subscribe_time.

Pro odhlášení z odběru přejděte na stránku nebo jmenný prostor, který máte přihlášený, otevřete správu odběrů podle výše uvedeného postupu a klikněte na „Odhlásit odběr“ vedle příslušné položky.

Pro snadnější nalezení správného místa pro odhlášení najdete odkaz ve spodní části každého e-mailu s odběrem, který obdržíte.

E-maily s odběry se nacházejí ve složce inc/lang/en a jejich názvy začínají na subscr_. Pokud je chcete upravit, nejprve je zkopírujte do conf/lang/en, abyste zabránili jejich přepsání při aktualizaci. Více informací najdete v úpravě lokalizovaných textů.

Používání odběrů vytváří soubory s příponou .mlist ve složkách a podsložkách ~/data/meta/. V každém souboru .mlist jsou uvedena uživatelská jména odběratelů.

Pokud máte Wiki uloženou v systému Windows, můžete použít následující příkaz pro zobrazení všech souborů a záznamů:

findstr /s "." *.mlist

Na systému Linux můžete použít tyto příkazy:

grep -r ".*\.mlist$" 
find . -name "*.mlist"
ls *.mlist 

Na Macu (a pravděpodobně i na Linuxu) funguje lépe tento příkaz:

egrep -r --include="*.mlist" every\|digest\|list .

(every = upozornění na každou změnu, digest = souhrn změn, list = seznam stránek)

Pro vyhledání všech odběrů konkrétního uživatele na OpenBSD nebo podobných UNIX systémech, kde grep nepodporuje volbu --include, použijte:

find . -name '*.mlist' -exec egrep -n '^user ' {} +

V každém případě se nejprve přepněte do adresáře [wiki directory]/data/meta.