README Plugin Sledování TV

Plugin je navržen tak, aby se co nejlépe přizpůsobil Vašemu webu. Obsah je responzivní a přizpůsobuje se šířce okna i šířce obsahu stránky.
pro zpřístupnění všech funkcí pluginu doporučujeme vložit knihovnu jQuery (libovolné verze)

Plugin můžete na Váš web vložit několika způsoby:

Data o službách jsou stahována ze serveru sledovanitv.cz a jsou 1 hodinu cachována v adresáři cache-sledovanitv (cachování lze vypnout).

Plugin je lokalizován v češtině a slovenštině.

Změny ve verzích

Plugin pro Wordpress

Instalace

  1. V administraci Wordpress nahrajte archiv s pluginem.
  2. V administraci aktivujte plugin SledovaniTV_v2
  3. V administraci > Nastavení > SledovaniTV_v2 si nastavte Váš identifikátor partnera, lokalizaci, určete, zda mají být data o službách cachována a zda se mají zobrazovat TV tipy, zprávy pro uživatele a počty HD kanálů. Také můžete vybrat, zda používat HTTPS nebo HTTP protokol. Nově lze také zvolit, jestli chcete zobrazovat položky přímého ceníku (např. HBO + HBO GO)
  4. Pro lepší zobrazení stránky zajistěte vložení knihovny jQuery (libovolné verze)

Použití

Obsah můžete vkládat do stránek pomocí shortcode značek:

  • [sledovanitv_v2/] - vložení celé šablony bez vlastních úprav obsahu (s informací o Sledování TV a výpisem všech služeb nabízených partnerem)

Pokud si potřebujete obsah přizpůsobit, můžete vkládat obsah po částech:

  • pokud chcete zjistit kódy všech dostupných služeb, můžete si je vypsat pomocí [sledovanitv_v2 part="servicesList"/]

  • [sledovanitv_v2 part="aboutTV"/] - informace o službě Sledování TV
  • [sledovanitv_v2 part="aboutTV"] vlastní html obsah [/sledovanitv_v2] - informace o službě Sledování TV + vlastní html obsah

  • [sledovanitv_v2 part="allowedServices"/] - seznam povolených služeb partnera
    • Pro zachování css stylů při výpisu jednotlivých služeb, prosím, dbejte na upozornění.

    • [sledovanitv_v2 part="allowedService" code="kód_služby"/] - vložení konkrétní povolené služby partnera
    • [sledovanitv_v2 part="allowedService" code="kód_služby"] vlastní html obsah s cenou služby [/sledovanitv_v2] - vložení konkrétní povolené služby partnera, navíc s vlastním html obsahem s cenou služby
    • pro správné vykreslení uzavřete vypsané služby (celek) mezi hlavičku a patičku pomocí

      • [sledovanitv_v2 part="allowedServicesHeader"/] - otevření výpisu
      • [sledovanitv_v2 part="allowedService" code="kód_služby"/] - vložení konkrétní povolené služby partnera
      • [sledovanitv_v2 part="allowedService" code="kód_služby"/] - vložení konkrétní povolené služby partnera
      • [sledovanitv_v2 part="allowedServicesFooter"/] - uzavření výpisu
    • Html může obsahovat (pro zachování css stylů):
      <p class="service-price-value">120 Kč</p>
      <p class="service-price-duration">&nbsp;/ měsíc</p>


  • [sledovanitv_v2 part="mainServices"/] - první 3 služby obsahující TV kanály (jako hlavní služby)
    • Pro zachování css stylů při výpisu jednotlivých služeb, prosím, dbejte na upozornění.

    • [sledovanitv_v2 part="mainService" code"kód_služby"/] - výpis služby obsahující TV kanály (jako hlavní služba)
    • [sledovanitv_v2 part="mainService" code"kód_služby"] vlastní html obsah s cenou služby [/sledovanitv_v2] - vložení konkrétní služby obsahující TV kanály, navíc s vlastním html obsahem s cenou služby
    • pro správné vykreslení uzavřete vypsané služby (celek) mezi hlavičku a patičku pomocí

      • [sledovanitv_v2 part="mainServicesHeader"/] - otevření výpisu
      • [sledovanitv_v2 part="mainService" code"kód_služby"/] - výpis služby obsahující TV kanály (jako hlavní služba)
      • [sledovanitv_v2 part="mainService" code"kód_služby"/] - výpis služby obsahující TV kanály (jako hlavní služba)
      • [sledovanitv_v2 part="mainServicesFooter"/] - uzavření výpisu
    • Html může obsahovat (pro zachování css stylů):
      <p class="service-price-value">120 Kč</p>
      <p class="service-price-duration">&nbsp;/ měsíc</p>


  • [sledovanitv_v2 part="tvServices"/] - seznam všech služeb obsahující TV kanály z ceníku partnera, které lze objednat
    • Pro zachování css stylů při výpisu jednotlivých služeb, prosím, dbejte na upozornění.

    • [sledovanitv_v2 part="tvService" code="kód_služby"/] - vložení konkrétní služby obsahující TV kanály z ceníku partnera
    • [sledovanitv_v2 part="tvService" code="kód_služby"] vlastní html obsah s cenou služby [/sledovanitv_v2] - vložení konkrétní služby obsahující TV kanály z ceníku partnera, navíc s vlastním html obsahem s cenou služby
    • pro správné vykreslení uzavřete vypsané služby (celek) mezi hlavičku a patičku pomocí

      • [sledovanitv_v2 part="tvServicesHeader"/] - otevření výpisu
      • [sledovanitv_v2 part="tvService" code="kód_služby"/] - vložení konkrétní služby obsahující TV kanály z ceníku partnera
      • [sledovanitv_v2 part="tvService" code="kód_služby"/] - vložení konkrétní služby obsahující TV kanály z ceníku partnera
      • [sledovanitv_v2 part="tvServicesFooter"/] - uzavření výpisu
    • Html může obsahovat (pro zachování css stylů):
      <p class="service-price-value">120 Kč</p>
      <p class="service-price-duration">&nbsp;/ měsíc</p>


  • [sledovanitv_v2 part="otherServices"/] - seznam všech služeb z ceníku partnera neobsahující TV kanály, které lze objednat
    • Pro zachování css stylů při výpisu jednotlivých služeb, prosím, dbejte na upozornění.

    • [sledovanitv_v2 part="otherService" code="kód_služby"/] - vložení konkrétní služby z ceníku partnera neobsahující TV kanály
    • [sledovanitv_v2 part="otherService" code="kód_služby"] vlastní html obsah s cenou služby [/sledovanitv_v2] - vložení konkrétní služby z ceníku partnera neobsahující TV kanály, navíc s vlastním html obsahem s cenou služby
    • pro správné vykreslení uzavřete vypsané služby (celek) mezi hlavičku a patičku pomocí

      • [sledovanitv_v2 part="otherServicesHeader"/] - otevření výpisu
      • [sledovanitv_v2 part="otherService" code="kód_služby"/] - vložení konkrétní služby z ceníku partnera neobsahující TV kanály
      • [sledovanitv_v2 part="otherService" code="kód_služby"/] - vložení konkrétní služby z ceníku partnera neobsahující TV kanály
      • [sledovanitv_v2 part="otherServicesFooter"/] - uzavření výpisu
    • Html může obsahovat (pro zachování css stylů):
      <p class="service-price-value">120 Kč</p>
      <p class="service-price-duration">&nbsp;/ měsíc</p>


  • [sledovanitv_v2 part="tvTips"/] - sekce TV tipy

  • [sledovanitv_v2 part="messages"/] - sekce zpráv pro uživatele

Plugin pro Joomla

Instalace

  1. V administraci Joomla nahrajte archiv s pluginem
  2. V administraci aktivujte plugin SledovaniTV_v2
  3. Na stránce pluginu v záložce Konfigurace si nastavte Váš identifikátor partnera, lokalizaci, určete, zda mají být data o službách cachována a zda se mají zobrazovat TV tipy, zprávy pro uživatele a počty HD kanálů. Také můžete vybrat, zda používat HTTPS nebo HTTP protokol. Nově lze také zvolit, jestli chcete zobrazovat položky přímého ceníku (např. HBO + HBO GO)
  4. Pro správné zobrazení stránky zajistěte vložení knihovny jQuery (libovolné verze)

Použití

Obsah můžete vkládat do stránek pomocí shortcode značek:

  • {sledovanitv_v2/} - vložení celé šablony bez vlastních úprav obsahu (s informací o Sledování TV a výpisem všech služeb nabízených partnerem)

Pokud si potřebujete obsah přizpůsobit, můžete vkládat obsah po částech:

  • pokud chcete zjistit kódy všech dostupných služeb, můžete si je vypsat pomocí {sledovanitv_v2 part="servicesList"/}

  • {sledovanitv_v2 part="aboutTV"/} - informace o službě Sledování TV
  • {sledovanitv_v2 part="aboutTV"} vlastní html obsah {/sledovanitv_v2} - informace o službě Sledování TV + vlastní html obsah

  • {sledovanitv_v2 part="allowedServices"/} - seznam povolených služeb partnera
    • Pro zachování css stylů při výpisu jednotlivých služeb, prosím, dbejte na upozornění.

    • {sledovanitv_v2 part="allowedService" code="kód_služby"/} - vložení konkrétní povolené služby partnera
    • {sledovanitv_v2 part="allowedService" code="kód_služby"} vlastní html obsah s cenou služby {/sledovanitv_v2} - vložení konkrétní povolené služby partnera, navíc s vlastním obsahem s cenou služby
    • pro správné vykreslení uzavřete vypsané služby (celek) mezi hlavičku a patičku pomocí

      • {sledovanitv_v2 part="allowedServicesHeader"/} - otevření výpisu
      • {sledovanitv_v2 part="allowedService" code="kód_služby"/} - vložení konkrétní povolené služby partnera
      • {sledovanitv_v2 part="allowedService" code="kód_služby"/} - vložení konkrétní povolené služby partnera
      • {sledovanitv_v2 part="allowedServicesFooter"/} - uzavření výpisu
    • Html může obsahovat (pro zachování css stylů):
      <p class="service-price-value">120 Kč</p>
      <p class="service-price-duration">&nbsp;/ měsíc</p>


  • {sledovanitv_v2 part="mainServices"/} - první 3 služby obsahující TV kanály (jako hlavní služby)
    • Pro zachování css stylů při výpisu jednotlivých služeb, prosím, dbejte na upozornění.

    • {sledovanitv_v2 part="mainService" code"kód_služby"/} - výpis služby obsahující TV kanály (jako hlavní služba)
    • {sledovanitv_v2 part="mainService" code"kód_služby"} vlastní html obsah s cenou služby {/sledovanitv_v2} - vložení konkrétní služby z ceníku partnera obsahující TV kanály, navíc s vlastním obsahem s cenou služby
    • pro správné vykreslení uzavřete vypsané služby (celek) mezi hlavičku a patičku pomocí

      • {sledovanitv_v2 part="mainServicesHeader"/} - otevření výpisu
      • {sledovanitv_v2 part="mainService" code"kód_služby"/} - výpis služby obsahující TV kanály (jako hlavní služba)
      • {sledovanitv_v2 part="mainService" code"kód_služby"/} - výpis služby obsahující TV kanály (jako hlavní služba)
      • {sledovanitv_v2 part="mainServicesFooter"/} - uzavření výpisu
    • Html může obsahovat (pro zachování css stylů):
      <p class="service-price-value">120 Kč</p>
      <p class="service-price-duration">&nbsp;/ měsíc</p>


  • {sledovanitv_v2 part="tvServices"/} - seznam všech služeb z ceníku partnera obsahující TV kanály, které lze objednat
    • Pro zachování css stylů při výpisu jednotlivých služeb, prosím, dbejte na upozornění.

    • {sledovanitv_v2 part="tvService" code="kód_služby"/} - vložení konkrétní služby s TV kanály z ceníku partnera
    • {sledovanitv_v2 part="tvService" code="kód_služby"} vlastní html obsah s cenou služby {/sledovanitv_v2} - vložení konkrétní služby z ceníku partnera obsahující TV kanály, navíc s vlastním obsahem s cenou služby
    • pro správné vykreslení uzavřete vypsané služby (celek) mezi hlavičku a patičku pomocí

      • {sledovanitv_v2 part="tvServicesHeader"/} - otevření výpisu
      • {sledovanitv_v2 part="tvService" code="kód_služby"/} - vložení konkrétní služby s TV kanály z ceníku partnera
      • {sledovanitv_v2 part="tvService" code="kód_služby"/} - vložení konkrétní služby s TV kanály z ceníku partnera
      • {sledovanitv_v2 part="tvServicesFooter"/} - uzavření výpisu
    • Html může obsahovat (pro zachování css stylů):
      <p class="service-price-value">120 Kč</p>
      <p class="service-price-duration">&nbsp;/ měsíc</p>


  • {sledovanitv_v2 part="otherServices"/} - seznam všech služeb z ceníku partnera neobsahující TV kanály, které lze objednat
    • Pro zachování css stylů při výpisu jednotlivých služeb, prosím, dbejte na upozornění.

    • {sledovanitv_v2 part="otherService" code="kód_služby"/} - vložení konkrétní služby z ceníku partnera neobsahující TV kanály
    • {sledovanitv_v2 part="otherService" code="kód_služby"} vlastní html obsah s cenou služby {/sledovanitv_v2} - vložení konkrétní služby z ceníku partnera neobsahující TV kanály, navíc s vlastním obsahem s cenou služby
    • pro správné vykreslení uzavřete vypsané služby (celek) mezi hlavičku a patičku pomocí

      • {sledovanitv_v2 part="otherServicesHeader"/} - otevření výpisu
      • {sledovanitv_v2 part="otherService" code="kód_služby"/} - vložení konkrétní služby z ceníku partnera neobsahující TV kanály
      • {sledovanitv_v2 part="otherService" code="kód_služby"/} - vložení konkrétní služby z ceníku partnera neobsahující TV kanály
      • {sledovanitv_v2 part="otherServicesFooter"/} - uzavření výpisu
    • Html může obsahovat (pro zachování css stylů):
      <p class="service-price-value">120 Kč</p>
      <p class="service-price-duration">&nbsp;/ měsíc</p>


  • {sledovanitv_v2 part="tvTips"/} - sekce TV tipy

  • {sledovanitv_v2 part="messages"/} - sekce zpráv pro uživatele

Plugin v PHP

Instalace

  1. Rozbalte archiv s pluginem do požadovaného umístění (<library_path>)
  2. Do stránky s pluginem mezi tagy <head> vložte:
    • <library_path>/resource/sledovanitv.css - základní styly
    • <library_path>/resource/sledovanitv.js - přizpůsobení obsahu šířce okna i šířce obsahu stránky + dynamické chování obsahu
  3. Pro správné zobrazení stránky zajistěte vložení knihovny jQuery (libovolné verze)

Použití

Ve Vašem PHP kódu si vytvořte instanci třídy SledovaniTV_v2, nad kterou můžete volat požadované metody pro výpis obsahu:

  • require_once('<library_path>/lib/Sledovanitv_v2.php');
    
    $sledovanitv = new SledovaniTV_v2($partner, $cacheEnabled = true, $localization = SledovanitvLanguages_v2::$cs_CZ, $messagesEnabled = true, $tvTipsEnabled = true, $showHdChannels = true, $useHttps = true, $addGeneralPriceList = false);

    argument $partner udává Váš identifikátor partnera (jakým se přihlašujete do API)
    argument $cacheEnabled povoluje nebo zakazuje cachování dat o službách (data se cachují na 24 hodin)
    argument $localization určuje jazyk pluginu a server, ze kterého se mají stahovat data. Validní hodnoty jsou:
         SledovanitvLanguages_v2::$cs_CZ - čeština (sledovanitv.cz)
         SledovanitvLanguages_v2::$sk_SK - slovenština (sledovanietv.sk)
    argument $messagesEnabled povoluje nebo zakazuje zobrazování zpráv pro uživatele.
    argument $tvTipsEnabled povoluje nebo zakazuje zobrazování TV tipů uživatelům.
    argument $showHdChannels povoluje nebo zakazuje zobrazování počtu HD kanálů.
    argument $useHttps ovlivňuje používání HTTPS protokolu (true = HTTPS, false = HTTP).
    argument $addGeneralPriceList povoluje nebo zakazuje zobrazování položek přímého ceníku (např. HBO + HBO GO).

  • Vložení celé šablony bez vlastních úprav obsahu (s informací o Sledování TV a výpisem všech služeb nabízených partnerem)
    $sledovanitv->printAll();

Pokud si potřebujete obsah přizpůsobit, můžete vkládat obsah po částech. K dispozici jsou následující metody:

  • Pokud chcete zjistit identifikátory všech dostupných služeb, můžete si je vypsat pomocí printServicesList()
  • printAboutTV() - informace o službě Sledování TV
  • printAboutTV('vlastní html obsah') - informace o službě Sledování TV + další vlastní html obsah
  • printAllowedServices($servicesContent = array() ) - seznam povolených služeb partnera

    argument $servicesContent je pole hodnot ve tvaru $code => 'vlastní html obsah služby', kde $code je kód služby. Specifikovaným službám je pak přidán zadaný html obsah.

    • printAllowedService($code, $htmlContent = null) - vložení konkrétní povolené služby partnera

      argument $code udává kód služby.
      argument $htmlContent specifikuje vlastní cenu služby v html
      Html může obsahovat (pro zachování css stylů):

      <p class="service-price-value">120 Kč</p>
      <p class="service-price-duration">&nbsp;/ měsíc</p>

    • Pokud se rozhodnete vypisovat služby jednotlivě, pro správné vykreslení uzavřete vypsané služby (celek) mezi hlavičku a patičku pomocí
      • printAllowedServicesHeader() - otevření výpisu
      • printAllowedService($code, $htmlContent = null) - vložení konkrétní povolené služby partnera
      • printAllowedService($code, $htmlContent = null) - vložení konkrétní povolené služby partnera
      • printAllowedServicesFooter() - uzavření výpisu
  • printMainServices($servicesContent = array() ) - vypíše 3 služby obsahujících TV kanály (jako hlavní služby)

    argument $servicesContent je pole hodnot ve tvaru $code => 'vlastní html obsah služby', kde $code je kód služby. Specifikovaným službám je pak přidán zadaný html obsah.

    • printMainService($code, $htmlContent = null) - vložení konkrétní služby obsahující TV kanály (jako hlavní služba)

      argument $code udává kód služby.
      argument $htmlContent specifikuje vlastní cenu služby v html
      Html může obsahovat (pro zachování css stylů):

      <p class="service-price-value">120 Kč</p>
      <p class="service-price-duration">&nbsp;/ měsíc</p>

    • Pokud se rozhodnete vypisovat služby jednotlivě, pro správné vykreslení uzavřete vypsané služby (celek) mezi hlavičku a patičku pomocí
      • printMainServicesHeader() - otevření výpisu
      • printMainService($code, $htmlContent = null) - vložení konkrétní služby obsahující TV kanály (jako hlavní služba)
      • printMainService($code, $htmlContent = null) - vložení konkrétní služby obsahující TV kanály (jako hlavní služba)
      • printMainServicesFooter() - uzavření výpisu
  • printTvServices($servicesContent = array() ) - seznam služeb obsahujících TV kanály

    argument $servicesContent je pole hodnot ve tvaru $code => 'vlastní html obsah služby', kde $code je kód služby. Specifikovaným službám je pak přidán zadaný html obsah.

    • printTvService($code, $htmlContent = null) - vložení konkrétní služby obsahující TV kanály

      argument $code udává kód služby.
      argument $htmlContent specifikuje vlastní cenu služby v html
      Html může obsahovat (pro zachování css stylů):

      <p class="service-price-value">120 Kč</p>
      <p class="service-price-duration">&nbsp;/ měsíc</p>

    • Pokud se rozhodnete vypisovat služby jednotlivě, pro správné vykreslení uzavřete vypsané služby (celek) mezi hlavičku a patičku pomocí
      • printTvServicesHeader() - otevření výpisu
      • printTvService($code, $htmlContent = null) - vložení konkrétní služby obsahující TV kanály
      • printTvService($code, $htmlContent = null) - vložení konkrétní služby obsahující TV kanály
      • printTvServicesFooter() - uzavření výpisu
  • printOtherServices($servicesContent = array() ) - seznam služeb, které neobsahují TV kanály

    argument $servicesContent je pole hodnot ve tvaru $code => 'vlastní html obsah s cenou služby', kde $code je kód služby. Specifikovaným službám je pak přidán zadaný html obsah.

    • printOtherService($code, $htmlContent = null) - vložení konkrétní služby, která neobsahuje TV kanály

      argument $code udává kód služby.
      argument $htmlContent specifikuje vlastní cenu služby v html
      Html může obsahovat (pro zachování css stylů):

      <p class="service-price-value">120 Kč</p>
      <p class="service-price-duration">&nbsp;/ měsíc</p>

    • Pokud se rozhodnete vypisovat služby jednotlivě, pro správné vykreslení uzavřete vypsané služby (celek) mezi hlavičku a patičku pomocí
      • printOtherServicesHeader() - otevření výpisu
      • printOtherService($code, $htmlContent = null) - vložení konkrétní služby, která neobsahuje TV kanály
      • printOtherService($code, $htmlContent = null) - vložení konkrétní služby, která neobsahuje TV kanály
      • printOtherServicesFooter() - uzavření výpisu
  • printTvTips() - sekce TV tipy
  • printMessages() - sekce zpráv pro uživatele

Změny ve verzích