|
There are no translations available.
Jsou 2 možné varianty akcí v exportu:
- V exportu budou všechny aktuálně probíhající a budoucí akce a jakmile některá z exportu zmizí před začátkem konání, znamená to pro nás, že byla zrušena.
- V exportu budou všechny aktuálně probíhající a budoucí akce a bude použit element "canceled" pro předčasně zrušené akce.
Změny v exportu kontrolujeme jednou denně (brzy ráno) a ty následně zanášíme k nám do databáze.
Pro validaci vašeho zdroje dat můžete využít tento validátor.
Minimální XML záznam o jedné akci se skládá z unikátního ID (číselné nebo textové), názvu akce, místa konání a data začátku akce.
Příklad minimálního xml
<?xml version="1.0" encoding="UTF-8"?>
<events>
<event>
<id>1111</id>
<name>Název akce</name>
<place>
<city>Praha</city>
</place>
<dates>
<date>
<start_date>2011-03-12</start_date>
</date>
</dates>
</event>
</events>
Pro místo konání akce rozlišujeme několik typů:
- město - element city
- ulice - element street
- objekt - element company
- zpřesnění místa - element other
- souřadnice ve formátu WGS84 - element wgs84
Pokud místo konání nemáte detailněji rozdělené (např. na ulici, město, objekt, atd.), vyplňte element other.
Datum a čas konání akce je povinné určitem datem jejího začátku. Pokud má daná akce i přesný čas je možné jej uvést v elementu start_time. Pokud u akce známe i její konec, můžeme jej uvést prostřednictvím elementů end_date, případně i end_time.
Počet termínů akce není omezen (elementy date), takže pokud se stejná akce koná na stejném místě několikrát, tak se jednotlivá data konání uvedou najednou.
Příklad více dat konání
<?xml version="1.0" encoding="UTF-8"?>
<events>
<event>
<id>1111</id>
<name>Název akce</name>
<place>
<city>Praha</city>
</place>
<dates>
<date>
<start_date>2011-03-12</start_date>
<start_time>18:00</start_time>
<end_time>19:30</end_time>
</date>
<date>
<start_date>2011-03-12</start_date>
<start_time>20:00</start_time>
<end_time>21:30</end_time>
</date>
</dates>
</event>
</events>
Pro přidání textové informace o akci použijte element description.
Pokud máte informace o akcích uloženy ve více jazycích, rádi uvítame překlady názvu a popisu akce
Zájem máme o tyto jazyky: cz, en, de, ru, pl, nl, it, es, fr
Příklad přidání jazykových verzi pro název a popis
<?xml version="1.0" encoding="UTF-8"?>
<events>
<event>
<id>1111</id>
<name lang="cz">Název akce</name>
<name lang="en">Name of event</name>
<description lang="cz">Popis akce</description>
<description lang="en">Description of event</description>
<place>
<city>Praha</city>
</place>
<dates>
<date>
<start_date>2011-03-12</start_date>
</date>
</dates>
</event>
</event>
Pokud váš systém obsahuje i informace o pořadateli akce, můžete tyto nepovinné údaje také doplnit do exportu, k tomu slouží element organizer.
Všechny údaje o pořadateli jsou nepovinné, takže můžete uvést jen ty, které máte. U kontaktních údajů (telefon, fax, email) je možné zadat více hodnot oddělených čárkou.
Příklad přidání informací o pořadateli
<?xml version="1.0" encoding="UTF-8"?>
<events>
<event>
<id>1111</id>
<name>Název akce</name>
<place>
<city>Praha</city>
</place>
<dates>
<date>
<start_date>2011-03-12</start_date>
</date>
</dates>
<organizer>
<name>Název pořadatele akce</name>
<person>Kontaktní osoba pořadatele</person>
<phone>608111222</phone>
<fax>2456789</fax>
<email>
This e-mail address is being protected from spambots. You need JavaScript enabled to view it
</email>
</organizer>
</event>
</events>
Pro zadání typů akce slouží element types a jeho podelementy type. Jedna akce může mít několik typů.
Informace o typech akcí nám můžete poskytnou v jednom ze tří možných způsobu:
- ID typů akcí z našeho číselníku typů
- uvedením ID typů akcí z vašeho vlastního číselníku, který nám zpřístupníte ve formátu XML
- uvedením názvu typu akce (např. hudba, film, karneval atd.)
Příklad přidání typů akcí
<?xml version="1.0" encoding="UTF-8"?>
<events>
<event>
<id>1111</id>
<name>Název akce</name>
<place>
<city>Praha</city>
</place>
<dates>
<date>
<start_date>2011-03-12</start_date>
</date>
</dates>
<types>
<type>2</type>
<type>5</type>
<type>12</type>
</types>
</event>
</events>
Pokud je možné rezervovat vstupenky na akci, uveďte URL adresu, kde je možné rezervovat, do elementu booking_url. Do elementu booking_note můžete uvést poznámku k předprodeji vstupenek.
Pokud je nějak omezen i čas, do kdy nejpozději je možné rezervaci provést, tak lze použít elementy booking_end_date, případně i booking_end_time, které jsou stejně jako ostatní časy konání akce v elementu date.
Příklad přidání informací o rezervaci vstupenek
<?xml version="1.0" encoding="UTF-8"?>
<events>
<event>
<id>1111</id>
<name>Název akce</name>
<place>
<city>Praha</city>
</place>
<dates>
<date>
<start_date>2011-03-12</start_date>
<booking_end_date>2011-03-11</booking_end_date>
<booking_end_time>19:00</booking_end_time>
</date>
<date>
<start_date>2011-03-13</start_date>
<booking_end_date>2011-03-12</booking_end_date>
<booking_end_time>19:00</booking_end_time>
</date>
</dates>
<booking_url>http://www.rezervujte-vstupenku.cz/?id=1111</booking_url>
</event>
</events>
Pokud máte k dispozici i obrázky (resp. soubory) týkající se akce můžete použít element photos (resp. files).
Do XML je možné vložit více fotografií i souborů. Jako obsah elementů photo (resp. file) uvádějte URL adresu k danému souboru.
Příklad vložení fotografií a souborů
<?xml version="1.0" encoding="UTF-8"?>
<events>
<event>
<id>1111</id>
<name>Název akce</name>
<place>
<city>Praha</city>
</place>
<dates>
<date>
<start_date>2011-03-12</start_date>
</date>
</dates>
<photos>
<photo>http://www.vase-akce.cz/tato-akce/foto1.jpg</photo>
<photo>http://www.vase-akce.cz/tato-akce/foto2.jpg</photo>
<photo>http://www.vase-akce.cz/tato-akce/foto3.jpg</photo>
</photos>
<files>
<file>http://www.vase-akce.cz/tato-akce/program1.pdf</file>
<file>http://www.vase-akce.cz/tato-akce/seznam_ucastniku.xls</file>
</files>
</event>
</events>
Pro přidání libovolné poznámky k dané akci slouží element note.
Pro zadání dalších doplňujících informaci k akci slouží element details.
Možné doplňující informace:
Příklad uvedení doplňujících informací
<?xml version="1.0" encoding="UTF-8"?>
<events>
<event>
<id>1111</id>
<name>Název akce</name>
<place>
<city>Praha</city>
</place>
<dates>
<date>
<start_date>2011-03-12</start_date>
</date>
</dates>
<details>
<duration>120</duration>
<languages>
<language>16</language>
<language>3</language>
</languages>
<subtitles>
<language>21</language>
<language>2</language>
</subtitles>
<accessible_from>15</accessible_from>
<sign_language>true</sign_language>
<free_entry>false</free_entry>
<significance>3</significance>
<barrier_free_access>true</barrier_free_access>
</details>
</event>
</events>
|
