Dokumentácia XML - články a aktuality

Základné pravidlá

• XML aktualít a článkov možno využiť na import a 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 - email
          • 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