Описание
Plugin automaticky sťahuje spravodajské články z XML kanálov agentúry SITA (Slovenská tlačová agentúra) a vytvára z nich príspevky vo vašom WordPresse — vrátane kategórií a titulných obrázkov. Import beží pravidelne na pozadí, k dispozícii je aj tlačidlo na okamžitý import a záznam o každom behu.
Potrebujete prístup ku kanálom SITA
Plugin sám o sebe nemá čo importovať — potrebujete aktívny prístup k XML kanálom agentúry SITA. Ide o platenú službu agentúry SITA.
- Záujem o prístup: obchod@sita.sk
- Ďalšie kontakty: https://biz.sita.sk/#kontakty
Technické problémy a hlásenie chýb
Zdrojový kód, dokumentáciu a hlásenie chýb nájdete na GitHube:
https://github.com/PayteR/sita-xml-importer
Chybu alebo návrh nahláste cez GitHub Issues:
https://github.com/PayteR/sita-xml-importer/issues
Nepoužívate WordPress?
Samotné spracovanie XML kanála je k dispozícii aj ako samostatná PHP knižnica bez závislostí — použiteľná v akomkoľvek PHP projekte, aj mimo WordPressu:
- Composer:
composer require sitask/xml-feed-parser - Alebo stačí skopírovať jediný súbor: https://github.com/PayteR/sita-xml-feed-parser
Ide o presne ten istý kód, aký používa tento plugin.
Čo plugin vie
- Pravidelný automatický import (predvolene každých 30 minút, nastaviteľné)
- Tlačidlo «Importovať teraz» pre okamžitý import na pozadí
- Záznam o každom behu (vytvorené / aktualizované / preskočené / chyby) s exportom do CSV
- Vytvára príspevky s nadpisom, perexom, obsahom a titulným obrázkom
- Automatické vytváranie kategórií podľa rubrík z kanála
- Nastaviteľný typ príspevku, stav a autor
- Bez duplicít — článok sa importuje raz a aktualizuje sa len pri zmene v zdroji
- Spoľahlivý aj na zdieľanom hostingu a pri veľkých kanáloch
- Hooky pre vývojárov a voliteľné príkazy pre WP-CLI
Plugin je nástupcom staršieho pluginu «SITA XML parser správ» (sita-parser-xml). Pri prechode sa nastavenia aj už importované články prenesú automaticky.
External Services
Tento plugin importuje obsah z XML kanálov agentúry SITA (Slovenská tlačová agentúra). Pripája sa na externé adresy, ktoré si sami nastavíte v nastaveniach pluginu. Kým nezadáte aspoň jednu adresu kanála, plugin sa nepripája nikam.
Na čo a kedy sa pripája:
- XML kanál(y) SITA — pri každom naplánovanom behu plugin odošle HTTP GET požiadavku na každú adresu kanála, ktorú ste zadali v Nastavenia > SITA XML Importer. Požiadavka obsahuje iba vami zadanú adresu (tá môže obsahovať prístupový token vydaný agentúrou SITA); žiadne údaje z vášho WordPressu sa neodosielajú.
- Obrázky článkov — pri každom importovanom článku, ktorý obsahuje obrázok, plugin stiahne tento obrázok z adresy uvedenej v kanáli a uloží ho do vašej knižnice médií.
Prístup k XML kanálom SITA je služba poskytovaná agentúrou SITA. Záujem o prístup: obchod@sita.sk, ďalšie kontakty na https://biz.sita.sk/#kontakty.
Poskytovateľ služby: SITA Slovenská tlačová agentúra a.s. — https://sita.sk (predtým webnoviny.sk)
Podmienky používania a ochrana súkromia: https://sita.sk
Скриншоты
Установка
- Nahrajte priečinok
sita-xml-importerdo/wp-content/plugins/, alebo plugin nainštalujte priamo z adresára pluginov WordPressu. - Aktivujte plugin v menu Pluginy.
- Prejdite do Nastavenia > SITA XML Importer.
- Zadajte adresu (adresy) vášho XML kanála SITA, každú na samostatný riadok.
- Nastavte autora príspevkov, typ príspevku, stav a prácu s kategóriami.
- Uložte nastavenia — import odteraz beží automaticky (predvolene každých 30 minút).
Prístup ku kanálom vybavíte na obchod@sita.sk, ďalšie kontakty nájdete na https://biz.sita.sk/#kontakty.
Podrobná dokumentácia (formát XML, hooky pre vývojárov, ukladanie dát a migrácia): https://github.com/PayteR/sita-xml-importer/tree/main/docs
Часто задаваемые вопросы
-
Potrebujem niečo od agentúry SITA?
-
Áno. Potrebujete aktívny prístup k XML kanálom SITA, inak plugin nemá čo importovať. Záujem o prístup: obchod@sita.sk, ďalšie kontakty na https://biz.sita.sk/#kontakty.
-
Ako často import beží?
-
Predvolene každých 30 minút, nastaviteľné na 15 minút, 30 minút alebo hodinu. Keďže WordPress cron (WP-Cron) spúšťajú návštevy stránky, na málo navštevovaných weboch môže import nabehnúť o niečo neskôr, než ukazuje nastavenie. Pre bežnú prevádzku to stačí a nič nastavovať netreba.
-
Dá sa import spúšťať aj cez WP-CLI?
-
Áno, ak WP-CLI na svojom hostingu máte a chcete import naviazať na systémový cron:
wp sita-xml-importer runspustí import,wp sita-xml-importer statusukáže posledný beh. Je to čisto voliteľné — plugin funguje rovnako dobre bez toho a väčšina webov to nepotrebuje. -
Kde nahlásim chybu alebo technický problém?
-
Cez GitHub Issues: https://github.com/PayteR/sita-xml-importer/issues
-
Prečo sa niektoré články neimportovali?
-
Články bez titulného obrázka sa zámerne preskakujú. Podrobnosti nájdete v dokumentácii na GitHube.
-
Prechádzam zo starého pluginu sita-parser-xml. Čo sa stane s dátami?
-
Nastavenia sa prenesú automaticky pri aktivácii a kontrola duplicít funguje okamžite. Na karte Údržba potom raz spustite migráciu údajov.
Отзывы
Нет отзывов об этом плагине.
Участники и разработчики
«SITA XML Importer» — проект с открытым исходным кодом. В развитие плагина внесли свой вклад следующие участники:
Участники
«SITA XML Importer» переведён на 1 язык. Благодарим переводчиков за их работу.
Перевести «SITA XML Importer» на ваш язык.
Заинтересованы в разработке?
Посмотрите код, проверьте SVN репозиторий, или подпишитесь на журнал разработки по RSS.
Журнал изменений
2.1.8
Oprava sťahovania titulných obrázkov vo formáte WebP a AVIF. Na niektorých weboch sa takýto obrázok neuložil a v zázname sa objavila hláška «Sorry, you are not allowed to upload this file type» — týkalo sa to najmä webov s CDN a sieťových inštalácií (multisite). Obrázky sa teraz importujú správne, a to aj v prípade, že adresa v kanáli nezodpovedá skutočnému formátu súboru — plugin príponu podľa obsahu opraví sám.
V sieťových inštaláciách (multisite) plugin zároveň doplní WebP a AVIF medzi povolené typy súborov, ak tam chýbajú — aby tieto obrázky mohli nahrávať aj redaktori ručne. Deje sa tak len pri aktivácii alebo aktualizácii superadminom a pridávajú sa výhradne formáty, ktoré WordPress sám podporuje.
Ak sa neúspech predsa objaví, záznam po novom uvádza aj zistený formát súboru, takže je z neho zrejmá príčina. Obrázok, ktorý WordPress odmietol, sa už neskúša sťahovať pri každom behu dookola; zopakuje sa pri oprave titulných obrázkov alebo pri importe s voľbou «Prepísať existujúce články».
Popis nových filtrov pre vývojárov nájdete v dokumentácii na GitHube.
2.1.7
Plugin po novom ponúka voliteľné príkazy pre WP-CLI (wp sita-xml-importer run a status) pre weby, ktoré chcú import naviazať na systémový cron. Nejde o odporúčaný ani potrebný spôsob prevádzky — bežný automatický import aj tlačidlo «Importovať teraz» fungujú nezmenene a nič nastavovať netreba. Doplnená bola aj šablóna prekladov (.pot) o reťazce pridané v predchádzajúcich verziách.
2.1.6
Oprava názvu Composer balíka v dokumentácii: správne je sitask/xml-feed-parser. Vo verzii 2.1.5 bol uvedený názov, ktorý na Packagiste nebolo možné použiť. Funkčnosť pluginu sa nemení.
2.1.5
Spracovanie XML kanála je po novom dostupné aj ako samostatná PHP knižnica bez závislostí (sitask/xml-feed-parser) — pre odberateľov, ktorí nepoužívajú WordPress. Ide o ten istý kód, aký používa plugin. Vnútorne sa trieda presunula do menného priestoru; správanie importu sa nemení.
2.1.4
Interná úprava bez zmeny správania: spracovanie XML kanála sa presunulo do samostatnej triedy nezávislej od WordPressu. Uľahčuje to testovanie a budúce použitie mimo WordPressu. Import, rozpoznávanie duplicít ani práca s obrázkami sa nemenia.
2.1.3
Opakovaný import s voľbou «Prepísať existujúce články» už neprepisuje popis a zdroj obrázka, ak sa zhodujú s kanálom — opakované prepisy nezmenených obrázkov tak nerobia zbytočné zápisy do databázy.
2.1.2
Opakovaný import s voľbou «Prepísať existujúce články» po novom aktualizuje aj popis a fotokredit titulného obrázka z kanála. Predtým sa nastavili len pri prvom stiahnutí obrázka.
2.1.0
Titulné obrázky po novom používajú popis a fotokredit z kanála SITA (prvky <ObrazokTitulok> a <ObrazokZdroj>), ak ich kanál poskytuje, namiesto popisu z IPTC/EXIF metadát súboru. Staršie kanály bez týchto prvkov to neovplyvní.
2.0.0
Prvé verejné vydanie na WordPress.org. Nástupca staršieho pluginu «SITA XML parser správ» (sita-parser-xml). Existujúce inštalácie prejdú bez zásahu: nastavenia aj importované články sa prenesú, starý plugin sa deaktivuje.
- Nastaviteľná frekvencia importu (15 minút, 30 minút alebo hodina) a tlačidlo «Importovať teraz».
- Záznam o každom importe (vytvorené / aktualizované / preskočené / chyby) s exportom do CSV.
- Stiahnuteľná diagnostická správa pre podporu.
- Spoľahlivosť na zdieľanom hostingu a pri veľkých kanáloch; príspevok sa aktualizuje len pri zmene v zdroji.
- Prehľadné rozhranie s kartami Nastavenia / Záznam importov / Údržba.
- Slovenský a český preklad.