Agregacja kanałów RSS/Atom
DokuWiki mogą integrować dane z zewnętrznych kanałów XML. Patrz również gromadzenie danych XML by dowiedzieć się jak DokuWiki eksportuje dane w postaci kanałów XML .
Składnia
Dołaczenie kanału RSS lub ATOM jest proste. Oto przykład dołączenia najnowszych wiadomości ze Slashdot:
{{rss>http://slashdot.org/index.rss}}
Do parsowania kanałów XML, używany jest SimplePie. Wszystkie formaty obsługiwane przez SimplePie mogą byż użyte również w DokuWiki. Możesz wpłynąć na renderowanie przez wiele dodatkowych parametrów oddzielonych spacjami:
Parametr | Opis |
---|---|
dowolna liczba | będzie użyta jako maksymalna liczba wyświetlanych elementów, domyślnie 8 |
reverse | wyświetla ostatnie elementy jako pierwsze w kanale |
author | pokazuje nazwy autorów elementów |
date | pokazuje daty elementów |
description | pokazuje opis elementu. Jeśli HTML jest wyłączony, wszystkie znaczniki zostaną usunięte |
n[dhm] | okres odświeżania, gdzie d=dni, h=godziny, m=minuty. (np. 12h = 12 godzin). |
Okres odświeżania to domyślnie 4 godziny. Każda wartość poniżej 10 minut będzie traktowana jako 10 minut. DokuWiki na ogół starają się dostarczyć buforowane wersje strony, oczywiście jest to niewłaściwe, gdy strona zawiera dynamiczne treści zewnętrzne. Parametr nakazuje DokuWiki przertsowanie strony jeśli jest później niż okres odświeżania od czasu ostatniego renderowania strony.
Przykład:
{{rss>http://slashdot.org/index.rss 5 author date 1h }}