Agregátor článků
Stahuje články z jiných Joomla webů (katedry, projekty) přes jejich Web Services API a ukládá je lokálně do jedné databáze. Obsah pak jde použít v YOOtheme builderu jako běžný zdroj dat — s filtrem podle zdroje, skupiny, tagů i časového okna akce.
Historie změn
AGG/SYNC/SOURCE | 1.0.20 | 1.0.2 | 1.0.12 | Publikovaná funkční verze |
ARCHITEKTURA
Tři rozšíření
Komponenta a oba pluginy se instalují samostatně (tři nezávislé balíčky), ale dávají smysl jen společně — bez komponenty nemá plugin zdroje co zobrazit a bez task pluginu se data sama neobnoví.
KOMPONENTA
com_mazaagg
Administrace: Zdroje, Skupiny a stažený Obsah. Vlastní databázové úložiště článků, nezávislé na com_content cílového webu.
SYSTEM PLUGIN
plg_system_mazaaggsource
Zpřístupní stažené články jako zdroj dat „Agregované články“ v YOOtheme Dynamic Content, s vlastními filtry.
TASK PLUGIN
plg_task_mazaaggsync
Naplánovatelná úloha v Joomla Scheduleru, která na pozadí pravidelně stahuje nová data ze všech zveřejněných zdrojů.
JAK TO FUNGUJE
Od API tokenu k obsahu na webu
01
Přidáte zdroj
URL jiného webu s Joomla a její API token — plugin „Web Services - Content“ tam musí být zapnutý.
02
Vyberete kategorie
Po uložení URL a tokenu se seznam kategorií zdroje načte automaticky — zaškrtnete, co se má stahovat.
03
Úloha stáhne obsah
Naplánovaná synchronizace (nebo ruční „Synchronizovat vše“) uloží články do lokální databáze.
04
Vytáhnete v builderu
V Dynamic Content vyberete zdroj „Agregované články“ a napojíte na mřížku/slider jako běžný obsah.
SPRÁVA V ADMINISTRACI
Tři pohledy komponenty
Vlastní položka v hlavním menu administrace, se třemi podsekcemi.
Zdroje
Přehled napojených webů se stavem poslední synchronizace a počtem položek.
Skupiny
Volitelné třídění napříč zdroji — cíl pro obsah z více webů patřících k jednomu tématu.
Obsah
Všechny stažené články na jednom místě — lze ručně odpublikovat, archivovat nebo smazat.
REFERENCE
Nastavení zdroje
Obecné
Název a URL webu
Zobrazovaný název a kořenová adresa zdrojové Joomly, např. https://web.tul.cz.
API token
Token Joomla Web Services zdroje; ukládá se šifrovaně. Tlačítko „Test připojení“ ověří přístup a vypíše kategorie.
Popis
Volitelná poznámka, dostupná i jako pole „Popis zdroje“ v YOOtheme Dynamic Content.
Výběr obsahu
Kategorie a podkategorie
Výběr kategorií načtený přímo ze zdroje; volitelné zahrnutí podkategorií. Nic nevybráno = vše.
Jazykový filtr
Importuje jen zadaný jazyk (např. cs-CZ); prázdné pole stáhne všechny jazyky.
Cílová skupina
Skupina, do které se položky z tohoto zdroje zařadí.
Retence
Max. položek
Kolik nejnovějších položek z tohoto zdroje se drží uložených. 0 = bez omezení.
Max. stáří (dny)
Nestahovat a zahodit články starší než zadaný počet dní. 0 = přebrat globální výchozí hodnotu.
Při odebrání ze zdroje
Odpublikovat, smazat nebo ponechat položku, když na zdroji zmizí nebo je odpublikovaná.
DYNAMIC CONTENT
Zdroj „Agregované články“ v builderu
Ve výběru zdroje dat se objeví vedle vestavěných zdrojů Joomly, se svými vlastními filtry.
Filtry zdroje dat
Zdroj, cílová skupina, příznak (checkbox), akce (časové okno) a řazení.
Pole a Display Conditions
Titulek, text, obrázek, tagy, autor, datum i vlastní custom fields ze zdroje — vše napojitelné jako obvykle.
Filtry dotazu
Zdroj / Cílová skupina
Omezí výpis na jeden konkrétní web nebo skupinu; prázdné = vše.
Akce (časové okno)
Nadcházející, probíhající nebo proběhlé — podle mapovaných dat zahájení/ukončení akce.
Příznak (checkbox)
Filtr na zaškrtnuté custom field checkboxy ze zdroje, seskupené podle pole.
Pole objektu
Titulek, úvodní/celý text, obrázek, odkaz na originál, kategorie zdroje, tagy, zdroj, popis zdroje, skupina, autor, jazyk, datum zveřejnění, zahájení/ukončení akce — a libovolná další vlastní pole (custom fields) automaticky nabídnutá podle toho, co se skutečně stáhlo.
SYNCHRONIZACE
Naplánovaná úloha v Scheduleru
Systém → Plánovač úloh → Nová úloha → „Agregátor článků: synchronizovat všechny zdroje“. Interval a HTTP timeout se nastavují v globální konfiguraci komponenty; „Synchronizovat vybrané / vše“ jde spustit i ručně přímo ze seznamu Zdrojů.
SPRÁVA ROZŠÍŘENÍ
Všechny tři díly v administraci
Systém → Správce rozšíření. Tři samostatné instalační balíčky (com_mazaagg, plg_system_mazaaggsource, plg_task_mazaaggsync) — nainstalovat a udržovat aktuální je potřeba všechny tři.