Pro kapely

Máte kapelu a chcete, aby uživatelé NaKoncert.cz mohli sledovat i Vaše koncerty? Stačí když nám poskynete seznam koncertů ve strukturované podobě.

Pokud následujícímu textu nebudete rozumět, nic si z toho nedělejte. Pošlete odkaz na tuto stránku Vašemu webmasterovi, ten už si s tím určitě hravě poradí :)

Soubor se strukturovaným seznamem koncertů je dynamicky generované xml dostupné přes url (webovou adresu) v následujícím formátu:

<?xml version="1.0" encoding="utf-8"?>
<shows version="1.0">
  <show>
    ... informace o prvním koncertu
  </show>
  <show>
    ... informace o druhém koncertu
  </show>
  ...atd...
</shows>

Informace o jednotlivých koncertech se skládá z těchto položek:

• date
• Datum, kdy se koncert koná
• Formát: den.měsíc.rok (např.: 21.8.2008)
• Tato informace je povinná
• city
• Město, ve kterém se koncert koná
• Pokud existuje více měst stejného jména, můžete jej upřesnit přidáním názvu nebo zkratky okresu do závorek (např.: Kralovice (PS))
• Tato informace je povinná
• venue
• Na jakém místě se koncert odehrává. Název konkrétního klubu nebo jen obecné určení místa (náměstí, kulturní dům)
• time
• V kolik hodin koncert začíná
• Formát: hh:mm (např.: 20:00)
• event
• Pokud se jedná o koncert v rámci nějaké větší akce (festival, městská slavnost atd.) je vhodné uvést název akce do tohoto pole
• comment
• Toto pole je určené pro další doplňující informace

Mimimální podoba xml souboru s jediným koncertem tedy vypadá takto:

<?xml version="1.0" encoding="utf-8"?>
<shows version="1.0">
  <show>
    <date>21.5.2008</date>
    <city>Praha</city>
  </show>
</shows>

Soubor s jedním koncertem ale se všemi nepovinnými údaji vypadá tedy takto:

<?xml version="1.0" encoding="utf-8"?>
<shows version="1.0">
  <show>
    <date>20.6.2008</date>
    <city>Brno</city>
    <time>18:55</time>
    <venue>Náměstí Svobody</venue>
    <event>Jeden svět 2008</event>
    <comment>akce připravená manažery na vozíčcích</comment>
  </show>
</shows>

Adresu Vámi vytvořeného přehledu nám pošlete společně s fotografií kapely v rozlišení 470x235 na adresu kapely@nakoncert.cz

Generátor pro PHP

Pokud máte web v PHP, máme pro Vás malého pomocníka. Stáhněte a rozbalte si soubor showsxml.php.zip, soubor shows.php zkopírujte do vhodného adresáře a vložte jej na začátek skriptu:

<?php
  Require("include/shows.php"); 
  //v tomto příkladě jsme soubor zkopírovali do adresáře include

  $XML = new ShowsXML(); 
  //vytvoříme si objekt který se nám postará o vygenerování xml

Nyní stačí jen načíst koncerty z databáze a pro každý záznam zavolat metodu AddShow() a nakonec vygenerovat XML metodou GetXML()

  //zde vytvorte smycku, ktera postupne nacte jednotlive koncerty 
  //z databaze a kazdy radek ulozi postupne do pole $koncert

  $XML->AddShow(
    array(
      "date" => $koncert["datum"], 
      "city" => $koncert["mesto"] 
      /* zde mohou následovat další nepovinné údaje (viz. výše) */
    )
  ); 

  //konec smyčky

  echo $XML->GetXML(); 
  //vygenerujeme XML na výstup
?>