Dokumentácia XML - články a aktuality
Základné pravidlá
- XML textov sa používa len pre export z Upgates.
- Tu je k náhľadu prázdne vzorové XML.
- Na testovanie štruktúry XML je možné použiť naše XSD.
- Tagy končiace na _YN> sú typu boolean a môžu nadobúdať hodnoty 0, 1, true, false.
- Dátum je zapísaný ako reťazec znakov vo formáte YYYY-MM-DD podľa ISO 8601. Y je rok, M je mesiac a D je deň. Príklad: 2020-12-30.
- Atribúty language označujúce jazykovú mutáciu používajú kódy podľa ISO 639-1 a sú povinné.
Import
- Je možné vykonávať len import nových článkov a aktualít, aktualizácia nie je možná.
- Ďalšie správanie importu môžete ovplyvniť nastavením v administrácii (viď nápoveda).
Export
- Exportujú sa všetky tagy s výnimkou tagov s prázdnou hodnotou. Tie môžu v exporte chýbať.
- Toto XML sa používa pre export dvoch typov obsahu - článkov a aktualít.
Štruktúra XML
- <TEXTS>
- version - verzia formátu XML, aktuálne je to 1.0
- <TEXT>
- type - typ textu, možné hodnoty:
- article - článok
- news - aktualita
- <ACTIVE_YN> - zobraziť text na webe
- <ACTIVE_FROM> - len aktuality, dátum, od ktorého bude aktualita aktívna
- <ACTIVE_TO> - len aktuality, dátum, do ktorého bude aktualita aktívna
- <CREATION_TIME> - dátum vytvorenia
- <DESCRIPTIONS> - texty
- <DESCRIPTION>
- language - Špecifikácie jazykovej mutácie
- <URL> - URL textu
- <TITLE> - Názov
- <SHORT_DESCRIPTION> - Krátky popis. Bez HTML formátovania
- <LONG_DESCRIPTION> - Dlhý popis. Formátovanie len pomocou HTML značiek
- <SEO_OPTIMALIZATION> - SEO
- <SEO>
- language - Špecifikácie jazykovej mutácie
- <SEO_URL> - Vlastná koncovka URL adresy
- <SEO_TITLE> - SEO titulok
- <SEO_META_DESCRIPTION> - META popisok stránky
- <CATEGORIES> - Kategórie, len články
- <CATEGORY>
- <CODE> - Kód kategórie, do ktorej bude článok zaradený. Páruje sa podľa existujúceho kódu kategórie
- <NAME> - Názov kategórie, do ktorej je článok zaradený
- <PRIMARY_YN> - Informácia, či je kategória primárna
- <POSITION> - Pozícia v kategórii
- <IMAGES> - Obrázky
- <IMAGE>
- <URL> - URL adresa obrázka
- <TITLES> - Popisky obrázka
- <TITLE>
- language - Špecifikácie jazykovej mutácie
- <MAIN_YN> - Obrázok je hlavný
- <LIST_YN> - Obrázok je zoznamový
- <FILES> - Súbory
- <FILE>
- <URL> - URL adresa súboru
- <TITLES> - Popisky súborov
- <TITLE>
- language - Špecifikácie jazykovej mutácie
- <METAS> - vlastné pole
- <META
- type - typ vlastného poľa, možné hodnoty:
- radio - prepínač
- checkbox - zaškrtávacie políčko
- input - textové pole
- date - dátum
- email - e-mail
- number - číslo
- select - rozbaľovacia ponuka
- multiselect - multi rozbaľovacia ponuka
- textarea - viacriadkové textové pole
- formatted - viacriadkové textové pole formátované (WYSIWYG)
- <META_KEY> - kľúč vlastného poľa - povolené znaky sú malé písmená, čísla (nesmú byť na prvej pozícii) a podtržítko
- <META_VALUE> - hodnota vlastného poľa, uvádza sa pokiaľ je rovnaká pre všetky jazykové mutácie
- <META_VALUES> - hodnoty vlastného poľa pre jednotlivé jazykové mutácie
- <META_VALUE>
- language - špecifikácie jazykovej mutácie