====== 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 [[login|přihlášení]] uživatelé mají přístup k [[main-window#Nástroje stránky|nástroji stránky]] „Spravovat odběry“ (viz snímek obrazovky níže). Anonymní nebo [[doku>user registration|neregistrovaní]] uživatelé se nemohou přihlásit k odběru. Upozornění: e-mailové odběry v DokuWiki slouží jako [[wp>collaboration tool|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 [[syndication|XML Syndikace]].

===== Povolení odběrů =====

Funkce odběrů se řídí nastavením [[doku>config:subscribers|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í [[doku>config:mailfrom|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í [[doku>config:notify|notify (upozornění)]]. To funguje i tehdy, když jsou odběry vypnuté.

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

===== Správa odběrů =====

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ů:{{ https://www.dokuwiki.org/_media/subcriptionmanagement.png?400|}}
  * **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í [[doku>config:subscribe_time|subscribe_time]].

==== Odhlášení z odběru ====

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.

===== Přizpůsobení =====

==== E-maily s odběry ====

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 [[doku>localization#changing_localized_texts_in_your_installation|úpravě lokalizovaných textů]].

==== Soubory .mlist ====

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 [[https://openbsd.org|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''.