XML export kurzů na Evzdelavani.cz Jak XML import funguje? XML export kurzů vám umožní automatickou synchronizaci informací o nabízených kurzech (název, popis, lektor, termín, místo a další důležité informace) mezi vaším systémem a Evzdelavani.cz. Citlivost k chybám: Pokud je celé XML nevalidní, nebo strojově nečitelné, nemůžeme vaše kurzy vůbec naimportovat. Chybí-li v XML povinné položky u jednotlivých kurzů, nejsou tyto kurzy importovány. Při importu jsou tyto kurzy a (nebo) jejich termíny "přeskočeny". Pokud jsou špatně (nevalidně) vyplněny nepovinné položky, jsou tyto kurzy i termíny importovány. Tyto nevalidní položky jsou "přeskočeny" a neimportují se. Robot bude XML stahovat každý den v brzkých ranních hodinách. Při nedostupnosti souboru nebo dlouhém načítání souboru nebude aktualizace provedena.
Jak XML feed vytvořit? Na prvním řádku uveďte hlavičku:
?>
Je potřeba mít kódování opravdu ve formátu UTF 8. Nestačí jen kódování uvést do hlavičky souboru. Kódování souboru si ověřte např. ve vašem internetovém prohlížeči. Na dalším řádku uveďte uvozující tag "courses":
Na další řádky vložte informace o jednotlivých kurzech s jejich popisem, kategorizací, termíny a lektory. Např.:
Marketing na Facebooku a dalších sociálních sítích <description> <strong>Sociální média: Definice, druhy a principy - proč řešit sociální média, co je WOM a jak využít virální šíření
- jak sociální média fungují, typologie uživatelů
- vyhodnocení komunikace, opuštění sociálních sítí.
]]>
Marketing Čeština Sociální média středně pokročilí https://www.vzdelavaci.cz/course/xxx Budova Lighthouse <price amount="3700" currency="CZK"/> Petr <surname>Novák ... ... ... ... <noterm> ... ...
Informace o dalších kurzech vkládejte ve stejném formátu vždy za značku tak, aby byla dodržena správná posloupnost elementů. Za poslední vložený kurz vložíte ještě ukončení elementu:
Dokumentace XML elementů XML soubor se skládá z jednotlivých elementů, u kterých je potřeba dodržet správné pořadí. Na následujících řádcích jsou jednotlivé elementy popsány. Je také dodrženo jejich správné pořadí.
U povinných elementů a atributů je uvedeno "povinné", ostatní položky jsou volitelné. Čím více položek vyplníte, tím lépe uživatelé Váš kurz naleznou.
Uvozující element Uvozující element s identifikací verze XML a kódování. Element je povinný.
Element courses
Kořenová značka, v jejímž rámci je vše ostatní. Element je povinný.
Elementy kurzu O kurzu vyplňte co nejvíce položek, díky tomu uživatelé váš kurz lépe najdou.
Element course elementy kurzu Základní element, který uzavírá všechny ostatní elementy. Kurzů může být v XML neomezené množství. Atributy: id="..." - povinný. Jedinečný a časově stálý identifikátor kurzu. Identifikátorem může být jakákoli číselná nebo textová hodnota. Maximální délka 100 znaků. Podmínkou je jeho unikátnost a časová stálost. Je důležité, aby atribut id se u daného kurzu v čase neměnil. Pokud se id kurzu mění, při každém importu původní kurz na Evzdelavani.cz smažeme a vytvoříme nový identický kurz, který však má jiné URL. Změna URL pak kurz poškozuje v SEO i v našich marketingových aktivitách, což způsobí, že tento kurz bude mít méně poptávek.
Element name název kurzu
Obsahuje název kurzu. Neuvádějte prosím celý název KAPITÁLKAMI. Maximální délka 255 znaků. Element je povinný.
Element description <description>
Popis kurzu může být formátován pomocí pouze těchto HTML značek: <strong>
- Element je povinný.
Element image Ilustrační obrázek, který reprezentuje daný kurz. V atributu src="..." uveďte URL obrázku: minimální rozměry obrázku jsou 300 x 225 px - větší obrázek poměrově zmenšíme, menší obrázek nebude zpracován poměr stran obrázků by měl být 4:3, pokud nedodržíte tento poměr stran, obrázek ořízneme na poměr stran 4:3 obrázek musí být dostupný na uvedené URL v době zpracování importu akceptované formáty obrázků: jpg, png, gif Ke kurzu můžete zadat pouze jeden obrázek. Element je nepovinný. Obrázek se zobrazí ve výsledcích vyhledávání a v detailu kurzu. Díky obrázku bude váš inzerát výraznější! Jaký zvolit obrázek ke kurzu? fotografie nebo ilustrace související s tématikou kurzu fotografie z již proběhlých termínů kurzu fotografie učebny nebo místa, kde bude výuka probíhat obrázek pomůcky nebo učebnice, které se budou při výuce používat
Element video Ilustrační video, které reprezentuje daný kurz, ukazuje výukové prostory apod. V atributu src="..." uveďte kompletní URL videa na YouTube, např. "https://www.youtube.com/watch?v=cJ--Lkj7zo". Nepodporujeme jiné videoservery než YouTube. Ke kurzu můžete zadat pouze jedno video. Element je nepovinný.
Element focus Název
kategorie
Určuje zařazení kurzu do kategorií. Uvnitř elementu může / nemusí být název kategorie. obsahuje atribut id="...": počet uvedených kategorií může být maximálně 2 kurz musí být zařazen do konkrétních podkategorií (id není dělitelné 100) id musí odpovídat číselníku kategorií: http://www.evzdelavani.cz/seznam-kategorii Element je povinný. Proč máme tak málo hlavních kategorií a podkategorií? Prototypy jsme testovali na uživatelích a zjistili jsme, že si mnohem lépe vyberou z omezeného počtu kategorií. Webové stránky se lidem lépe používají a rychleji najdou to, co hledají. Výsledky si pak dokáží upřesnit dle potřeby např. podle profesí a dalších parametrů jako je termín, lokalita, lektor nebo cena. Může se stát, že si žádnou z kategorií nevyberete, nebude odpovídat vašemu kurzu. V tomto případě vás prosíme o návrh kategorie nové. Zvážíme její přidání s ohledem na potenciál obsahu.
Element language název
jazyka
Slouží po uvedení vyučovacího jazyka kurzu. Uvnitř elementu můžete uvést název jazyka, obsahuje atribut id="...": Číselník id: •
1 – čeština
•
2 – angličtina
Element je nepovinný. Není-li element uveden, je kurzu nastaven jazyk "čeština".
Element keyword klíčové slovo Zde uvádějte klíčová slova, podle kterých bude váš kurz lépe dohledatelný. Maximální délka jednoho klíčového slova je 100 znaků. U jednoho kurzu může být zadáno maximálně 20 klíčových slov. Element je nepovinný. Jaká klíčová slova napsat? Jsou to slova nebo sousloví, která charakterizují váš kurz. Můžete použít např. slangové výrazy nebo dovednosti získané na kurzu. Nemusíte uvádět výrazy, které již máte v názvu nebo popisu kurzu, to je zbytečné.
Element level název
úrovně
Určuje úroveň požadovaných znalostí - těchto elementů může být několik za sebou. Uvnitř elementu může být název úrovně. Element povinně obsahuje atribut id, který může mít tyto hodnoty: 1 - začátečníci 2 - středně pokročilí 3 - odborníci Element je nepovinný. Když není element uveden, je kurzu nastavena úroveň "nezáleží".
Element URL URL kurzu URL kurzu na Vašich stránkách. Element je nepovinný.
Element Retraining Tento element určuje, že daný kurz je rekvalifikační. Rekvalifikační kurz znamená, že účast na kurzu může být uhrazena Úřadem práce. Element povinně obsahuje atribut enable, který může mít tyto hodnoty: 0 - kurz není rekvalifikační 1 - kurz je rekvalifikační Element je nepovinný. Když není element uveden, zpracujeme kurz jako, že není rekvalifikační.
Elementy termínu K jednomu kurzu může být uvedeno více termínů konání kurzu. Tyto termíny uvádějte za sebou, každý s unikátním identifikátorem. Termín určují následující elementy. Pokud chcete inzerovat kurz bez termínu (např. e-learning nebo aktuálně žádný termín k danému kurzu nemáte vypsaný), podívejte se níže do kapitoly "Element noterm".
Element term
Element uzavírá termín kurzu - těchto elementů může být několik za sebou. Obsahuje následující atributy: id="..." - povinný, identifikátor termínu kurzu v rámci daného kurzu musí být unikátní a časově stálý identifikátor termínu identifikátorem může být jakákoli číselná nebo textová hodnota maximální délka 100 znaků state="..." - nepovinný, stav termínu kurzu určuje jestli se má nebo nemá daný termín zobrazovat uživatelům může nabývat těchto hodnot: 0 - uzavřený (dočasně pozastaven, nezobrazuje se uživatelům) 1 - otevřený (zobrazuje se) pokud není atribut uveden, použijeme hodnotu 1 - otevřený (zobrazuje se) Je důležité, aby atribut id se u daného termínu v čase neměnil. Pokud se id termínu mění, při každém importu původní termín na Evzdelavani.cz smažeme a vytvoříme nový identický termín, který však má jiné URL. Změna URL pak termín poškozuje v SEO i v našich marketingových aktivitách, což způsobí, že tento termín bude mít méně poptávek. Element je povinný u kurzů s termíny.
Element date Tento element určuje datum a čas konání kurzu. Obsahuje následující atributy: from="..." - povinný, udává od kdy se tento termín kurzu koná. Formát data je yyyy-mm-ddThh:mm:ss: yyyy - rok zapsaný čtyřmi číslicemi mm - měsíc zapsaný dvěmi číslicemi (je-li jednočíselný pak je uvozen nulou) dd - den T - oddělovač data a času h - hodiny m - minuty s - sekundy to="..." - povinný, udává do kdy se tento termín kurzu koná. Formát data je shodný jako u atributu from="...". Element je pro kurz s termínem povinný.
Element price
<price amount="cena bez DPH" currency="měna" vat="sazba DPH v %" discount="absolutní výše slevy bez DPH" discount-percent="výše slevy v %"/>
Element určuje cenu kurzu v daném termínu (cena se u jednotlivých termínů může lišit). Je možné také uvést slevu z ceny. Obsahuje následující atributy: amount="..." - povinný, cenu za kurz bez DPH celé číslo bez mezer při uvedení ceny s hodnotou 0, budeme prezentovat kurz s cenou "zdarma" currency="..." - nepovinný, měna ceny mohou být použity následující hodnoty: CZK, EUR pokud není atribut uveden, použijeme CZK vat="..." - nepovinný, sazba DPH v % uvádějte jen číslo, znak % neuvádějte pokud je daný kurz osvobozen od DPH, uveďte sazbu "0" pokud není atribut uveden, použijeme aktuální základní sazbu DPH platnou v ČR atributy pro zadání slevy discount="..." - absolutní výše ceny v dané měně bez DPH, celé číslo bez mezer - výslednou cenu po slevě spočítáme tak, že toto číslo odečteme od čísla uvedeného v atributu amount discount-percent="..." - výše slevy v %, uvádějte jen celé číslo (0 až 100), znak % neuvádějte oba atributy jsou nepovinné je možné uvést pouze jeden z těchto atributů - nezadávejte nikdy oba zároveň Element je pro kurz s termínem povinný.
Element address upřesnění adresy
Určuje místo konání kurzu. U kurzů v České republice je možné uvést obec (město) nebo přesnou adresu. U zahraničních kurzů stačí uvést pouze stát. Je možné také místo adresy uvést, že kurz je online. Obsahuje následující atributy: country="..." - kód státu nepovinný atribut pokud ho neuvedete, použijeme výchozí hodnotu, kterou je "cz" (Česká republika) tj. je důležité ho uvést u kurzů v zahraničí city="..." - název obce (města) povinný atribut pro kurzy v ČR volitelný pro kurzy v zahraničí street="..." - název ulice, volitelný atribut registry_number="..." - číslo popisné, volitelný atribut house_number="..." - číslo orientační, volitelný atribut zip="..." - PSČ, volitelný atribut flag="online" - označení e-learningu/online kurzů/webinářů (bez adresy konání) nepovinný atribut pokud uvedete tento atribut, neuvádějte žádné další atributy Jako textovou informaci tohoto elementu lze volitelně uvést upřesnění adresy - např. "Budova Lighthouse Towers, 11. patro". Element je pro kurz s termínem povinný.
Adresy v ČR validujeme proti databázi adres, proto je důležité, aby byla adresa zadána správně a jednoznačně. Jinak nedojde k importu daného termínu kurzu.
Velmi doporučujeme uvádět u kurzů přesné adresy. Uživatelé ocení jasnou informaci a díky přesné adrese můžeme uživatelům zobrazit mapku s místem konání kurzu.
Příklady zadání přesné adresy v ČR
Adresa ve městě i s upřesněním:
Budova Lighthouse Towers, jedenácté patro Adresa v obci bez ulic, bez upřesnění:
01"/>
Příklad zadání obce (města) v ČR
Příklady zadání adresy v zahraničí (Francie)
Francouzská riviera, Cannes
Příklad zadání e-learningu/online kurzu/webináře (bez adresy)
Element lector Tento element určuje lektora daného termínu. Element je nepovinný. Proč uvádět lektora? Lektoři jsou totiž pro naše uživatele velmi důležití, častokrát hledají přímo jejich jméno. Lektor dokáže ovlivnit celkový dojem z kurzu. Proto uvedené jméno lektora dokáže přilákat potenciální účastníky vašeho kurzu.
Varianta s uvedením položek lektora
jméno <surname>přijmení .. .. Zadání lektora včetně dalších elementů upřesňujících informace o lektorovi. Element firstname
jméno Zde uveďte jméno lektora. Element je povinný. Element surname
<surname>přijmení Zde uveďte příjmení lektora. Element je povinný. Element degrees_before
<degrees_before>tituly před
jménem
Zde uvádějte tituly před jménem lektora. Element je nepovinný. Element degrees_after
<degrees_after>tituly za
jménem
Zde uvádějte tituly za jménem lektora. Řetězec neuvozujte čárku, uvádějte jen samostatné tituly, např.:
<degrees_after>Ph.D.,
MBA
Od příjmení budou tituly čárkou odděleny automaticky. Výsledek tedy bude: Ing. Jan Novák, Ph.D., MBA Element je nepovinný. Element description
<description>
Zde uveďte základní informace o lektorovi (krátké CV). Popis lektora může být formátován pomocí pouze těchto HTML značek: <strong>
- Element je nepovinný. Element skills
<skills>
Zde uvádějte dovednosti, specializace nebo získané certifikáty lektora. Dovednosti lektora můžou být formátovány pomocí pouze těchto HTML značek: <strong>
- Element je nepovinný. Element image
V atributu src="..." uveďte odkaz na fotografii lektora. K lektorovi je povolena pouze jedna fotografie: minimální rozměry fotografie jsou 220 x 220 px - větší fotografie poměrově zmenšíme, menší fotografie nebude zpracována poměr stran fotografie by měl být 1:1, pokud nedodržíte tento poměr stran, fotografii ořízneme na poměr stran 1:1 fotografie musí být dostupná na uvedené URL v době zpracování importu akceptované formáty fotografie: jpg, png, gif Element je nepovinný.
Elementy kurzu nabízeného bez termínu Inzerci kurzu bez termínu doporučujeme pro tyto případy: e-learning/online kurz aktuálně žádný termín k danému kurzu nemáte vypsaný, ale přesto chcete kurz inzerovat s "termínem po dohodě" Pokud chcete inzerovat kurz bez termínu, musíte místo elementu termínu (term) použít element noterm.
Element noterm <noterm> <price .../> ... ... Element uvádějte u každého kurzu pouze jednou. Pokud má kurz termín, cenu i místo konání dohodou, můžete uvést zkrácenou verzi:
<noterm /> Element je povinný, pokud chcete nabízet kurz bez
termínu.
Pokud v rámci jednoho kurzu uvedete zároveň elementy term i noterm, dáme přednost elementu term a kurz se naimportuje s termíny.
Element price Element určuje cenu kurzu. Podrobný popis viz výše. U kurzů nabízených bez termínu je možné uvést také atribut flag="custom". Tím nám říkáte, že "cena kurzu je dohodou":
<price flag="custom"/> Element je u kurzů nabízených bez termínu nepovinný. Pokud ho neuvedete, znamená to pro nás, že "cena kurzu je dohodou".
Element address Určuje místo konání kurzu. Podrobný popis viz výše. U kurzů nabízených bez termínu je možné uvést také atribut flag="custom". Tím nám říkáte, že "místo konání kurzu je dohodou":
Kurzy bez termínu jsou často e-learningy/online kurzy. V takovém případě uveďte atribut flag="online":
Element je u kurzů nabízených bez termínu nepovinný. Pokud ho neuvedete, znamená to pro nás, že "místo konání kurzu je dohodou".
Element lector Tento element určuje lektora nebo na něj odkazuje. Podrobný popis viz výše.
Element je nepovinný.
Povinné a nepovinné informace Souhrn povinných a nepovinných informací ke kurzům a jejich případné omezení. Tyto informace odpovídají jednotlivým elementům nebo atributům. Získáte tak rychlý přehled o datech, která si musíte připravit pro funkční export. Bez správně vyplněných povinných položek nelze kurz naimportovat a zobrazovat našim uživatelům.
Položky kurzu Povinné
id kurzu, omezení na 100 znaků elementy kurzu název kurzu, omezení na 255 znaků název kurzu popis kurzu, formát: html, povolené tagy: p, strong, ul, li <description> zařazení kurzu do pokategorie (focus id podle číselníku), omezení: alespoň jedno zařazení, id není dělitelné 100 (zařazení do konkrétní podkategorie) Název kategorie termín kurzu, viz. níže, omezení: alespoň jeden Nepovinné
ilustrační obrázek kurzu, omezení: nejvýše jeden, minimální rozměr: 300 x 225 px, poměr stran: 4:3 (pokud použijete jiný poměr stran, obrázek ořízneme), formát: jpg, png, gif ilustrační video kurzu, omezení: nejvýše jedno, možné je zadávat videa pouze z YouTube jazyk kurzu (podle číselníku), při neuvedení použijeme default id 1 čeština název jazyka klíčová slova, každé klíčové slovo je omezeno na 100 znaků, maximálně 20 klíčových slov u jednoho kurzu klíčové slovo vazba na profese (vhodné pro, id podle číselníku)., omezení: nejvýše deset elementů za sebou úroveň kurzu (id podle číselníku), omezení: nejvýše tři elementy za sebou, při neuvedení použijeme default: 0 nezáleží název úrovně rekvalifikační kurz, při neuvedení použijeme default: kurz není rekvalifikační url kurzu, při uvedení se v detailu kurzu oběví odkaz na dané url url kurzu< /url>
Položky termínu Povinné
id termínu, omezení na 100 znaků elementy termínu datum termínu OD, formát: ISO (2012-08-26T09:00:00) nebo YYYY-MM-DD
datum termínu DO, formát: ISO (2012-08-26T09:00:00) nebo YYYY-MM-DD cena, viz níže místo konání, viz níže Nepovinné
stav (id podle číselníku), defaultně = 1 (otevřený termín) elementy termínu lektor, viz níže
Položky kurzu nabízeného bez termínu Povinné
element noterm s uvedením dalších údajů: <noterm>volitelně elementy ceny, místa konání, element noterm, kdy je cena i místo konání dohodou: <noterm />
lektora
Nepovinné
cena, viz níže místo konání, viz níže lektor, viz níže
Položky ceny Povinné
cena - u kurzu s termínem je cena povinná, uvádějte cenu bez DPH, jako celé číslo bez <price amount="cena bez DPH" currency="měna" vat="sazba DPH v %">
mezer
Nepovinné
měna - při neuvedení použijeme default = CZK <price amount="cena bez DPH" currency="měna" vat="sazba DPH v %"> sazba DPH v % (znak % neuvádějte) - při neuvedení použijeme aktuální základní sazbu DPH platnou v ČR, pokud je daný kurz osvobozen od DPH, uveďte sazbu "0" <price amount="cena bez DPH" currency="měna" vat="sazba DPH v %"/> sleva - můžete uvést absolutní výši slevy (jako celé číslo bez mezer) nebo slevu v % (celé číslo 0 až 100, znak % neuvádějte) <price amount="cena bez DPH" discount="absolutní výše slevy bez DPH"> <price amount="cena bez DPH" discount-percent="výše slevy v %"> cena dohodou - je možné zadat volitelně pouze u kurzu nabízeného bez termínu: <price flag="custom"/>
Položky místa konání stát - je důležitý pro zahraniční kurzy, pro české ho není nutné uvádět upřesnění adresy město - je povinné ho uvést u kurzů v ČR, volitelně pro zahraniční kurzy upřesnění adresy ulice - uvedení je volitelné upřesnění adresy číslo popisné - uvedení je volitelné
upřesnění adresy číslo orientační - uvedení je volitelné upřesnění adresy PSČ - uvedení je volitelné upřesnění adresy upřesnění adresy (např. "Budova Lighthouse Towers, 11. patro") - uvedení je volitelné upřesnění adresy online kurz/e-learning - v tomto případě zadejte adresu takto: místo konání dohodou - je možné zadat pouze u kurzu nabízeného bez termínu:
Položky lektora Povinné
jméno jméno příjmení <surname>přijmení Nepovinné
titul před jménem, omezení: prostý text bez omezení délky <degrees_before>tituly před jménem titul za jménem, omezení: prostý text bez omezení délky <degrees_after>tituly za jménem fotografie lektora, omezení: nejvýše jedna, minimální rozměr: 220 x 220 px, poměr stran: 1:1 (pokud použijete jiný poměr stran, fotografii ořízneme), formát: jpg, png, gif popis lektora, formát: html, povolené tagy: p, strong, ul, li <description> dovednosti lektora, formát: html, povolené tagy: p, strong, ul, li <skills>
Číselníky Číselníky se automaticky aktualizují dle naší databáze. Pro aktuální data doporučujeme XML s číselníky automaticky stahovat z níže uvedených URL. •
Číselník kategorií kurzů http://evzdelavani.cz/seznam-kategorii
•
Číselník kategorií kurzů (XML) http://evzdelavani.cz/seznam-kategorii-xml
•
Číselník kategorií kurzů (json) http://evzdelavani.cz/seznam-kategorii-json