Instalace

Pro fungování nejsou potřeba žádné zvláštní požadavky na FV Player a nemusíte ani instalovat žádné další pluginy. Tato příručka obsahuje:

• Instalační kroky
• Vložení licenčního klíče
• Přepnutí do Beta verze v Pro verzi pluginu
• HTML5 vrstva kompatibility pro staré témata při použití starých prohlížečů
• Použití minify pluginů
• Požadavky na server
• Řešení problémů s JavaScript-em

Instalace

Zde je návod na instalaci FV Player pluginu na vaši stránku. Nezapomeňte, pokud chcete používat všechny pokročilé funkce, které náš přehrávač nabízí pořiďte si FV Player Pro licenci.

1. Stáhněte a rozbalte zip archiv obsahující plugin.

2. Zkopírujte fv-wordpress-flowplayer-master adresář do wp-content/plugins/ adresáře vaší WordPress instalace.

3. Klikněte na sekci Pluginy v administračním rozhraní vaší WordPress stránky a aktivujte FV Player plugin.
4. V Nastavení -> FV Player Klikněte na obě tlačítka Zkontrolovat šablony a Zkontrolovat videa v nastavení pluginů.

   Kontrolor hlásí, že je vše v pořádku na naši stránce

   Pokud vidíte upozornění o chybějícím html5.js souboru, které říká html5.js nebyl nalezen v šabloně! přečtěte si část níže.

5. Pokud navíc chcete vložit videa označená jen podle jejich názvu, můžete vytvořit adresář /videa/, a umístit jej přímo do kořenového adresáře vaši domény a vkládat vaše videa do něj. V opačném případě budete muset zadat úplnou adresu URL video souborů.

Vložení licenčního klíče

Pokud jste si koupili naše PRO rozšíření, vložte prosím váš licenční klíč do pole v horní části nastavení.

Po vložení validního klíče se zobrazí zpráva Děkujeme, že jste si zakoupili FV Player licenci! A nyní můžete nastavit váš přehrávač a videa.

Přepnutí do Beta verze v Pro verzi pluginu

Pokud jste nainstalovali Pro rozšíření můžete si vybrat, zda chcete používat nejnovější beta funkce, nebo stabilní vydání verze. Beta verze umožňuje používat nové funkce hned po jejich vydání, avšak při použítí beta verze se mohou vyskytnout problémy. Přepínání mezi Beta a Release není trvalé a můžete jej změnit v nastavení kdykoli budete chtít.

Pro přepínání mezi verzemi jděte do Nastavení -> FV Player Pro a v levém horním rohu uvidíte rozbalovací seznam.

Přidání chybějícího html5.js souboru

Když stisknete tlačítko Zkontrolovat šablonu, může se zobrazit varování html5.js nebyl nalezen ve vaši šabloně! Tento JavaScript poskytuje HTML5 tagům kompatibilitu pro starší verze prohlížečů Internet Explorer. Takže to není nezbytně nutné, ale doporučené pro lepší kompatibilitu.

Většina moderních WordPress šablon již používá tento soubor, ale pokud chybí, můžete ho použít z html5shiv Google Code stránky. Jednoduše stáhněte odkaz, rozbalte výsledný ZIP soubor a pak zkopírujte dist/html5shiv.js do složky Vaší šablony jako html5.js a přidejte následující PHP kód do Vaší header.php šablony před koncovou značku </head>:

<!--[if lt IE 9]>
 <script src="<?php echo get_template_directory_uri(); ?>/html5.js"></script>
 <![endif]-->

Použití minify pluginů

Minifikace je používána skoro na každé webové stránce s Javascriptem. Tady je kompletní návod k nastavení FV Playeru se čtyřmi populárními minifikačními pluginmi. (Autoptimize, WP Rocket, WP Minify and W3 Total Cache): Using FV Player with Minify Plugins

Požadavky na server

1. Musíte se ujistit, že vaše video soubory používají správné MIME typy. Následující typy můžete jednoduše přidat do vašeho .htaccess souboru:

   AddType video/mp4             .mp4
   AddType video/webm            .webm
   AddType video/ogg             .ogv
   AddType application/x-mpegurl .m3u8
   AddType video/x-m4v           .m4v
   # hls transport stream segments:
   AddType video/mp2t            .ts
       

   Pokud používáte NginX, tohle je řešeno ve konfiguračním souboru.

2. Pokud se zobrazí chybová zpráva, jako tato, máte nainstalováno PHP4 nebo nižší:

   <p><code>Parse error: syntax error, unexpected T_STRING, expecting T_OLD_FUNCTION or T_FUNCTION or T_VAR or ‘}’ in /... .../wp-content/plugins/fv-wordpress-flowplayer/models/flowplayer.php on line 4</code></p>

   Plugin vyžaduje pro správné spuštění PHP5. Požádejte tedy Vašeho poskytovatele hostingu, aby aktualizoval PHP4 na PHP5, protože PHP4 je neaktuální.

Oprava rozbitého JavaScript

Když jste přihlášen jako administrátor stránky, můžete si všimnout, že namísto přehrávajícího se videa se zobrazuje následující varování:

Administrator JavaScript varování:

Je nám líto, Váš JavaScript se zdá být nefunkční. (I’m sorry, your JavaScript appears to be broken.)

Zde je zobrazeno varování, které uvidíte na vašich stránkách v případě, že JavaScript nefunguje:

Varování administrátorovi se zobrazí namísto právě přehrávaného videa, aby oznámilo problém stránky s JavaScriptem

Toto varování jsme vložili, když jsme začali přijímat stížnosti, že náš přehrávač nefunguje, i když byl problém ve skutečnosti na internetové stránce klienta. Internetová stránka je jako ekosystém a když je nějaká část tohoto ekosystému nefunkční, může to mít vliv na zbytek stránky – o to ještě je vliv větší, pokud jde o JavaScript. Pokud jsi všimnete tohoto problému, pak pravděpodobně ani další pluginy nebudou fungovat správně a jednoduše Vás na to neupozorní.

Nejčastějšími problémy, které způsobují, proč se tato zpráva objevuje, jsou:

1. Fatální chyba JavaScriptu na vašem webu
   • Můžete zjistit, jaká chyba je vyvolána pomocí kontroly chybové konzole JavaScriptu ve vašem prohlížeči. Zde je praktický návod na WordPress.org – Použití prohlížeče na diagnostiku chyb JavaScriptu
   • Řešením je se nejprve pokusit vyměnit jiné téma (můžete použít náhled tématu), a když to nepomůže je třeba vypínat pluginy jeden po druhém. Pokud si myslíte, že jste našli konfliktní plugin, nebo že je chyba v našem pluginu, neváhejte použít naše fóra podpory
2. Některá knihovna není načtena správně nebo vůbec (buď jQuery nebo FV Flowplayer)
   • Toto je častý konflikt s tématem či pluginem (duplikát načtení jQuery, načtení další verzi Flowplayer), i když pracujeme tvrdě, abychom se tomu vyhnuli. Také jsme pro to přidali automatickú kontrolu v nastaveních pluginu, takže to je první místo, kam by měly vést Vaše kroky pro vyřešení tohoto problému.
   • Pokud všechny pluginy používají správně rozhraní WordPress API (jmenovitě wp_enqueue_scripts), tak by se zde neměly vyskytovat žádné problémy.
   • Řešením je nejprve se pokusit vyměnit jiné téma (můžete použít náhled tématu), a když to nepomůže je třeba vypínat pluginy jeden po druhém. Pokud si myslíte, že jste našli konfliktní plugin, nebo že je chyba v našem pluginu, neváhejte použít naše fóra podpory
3. Některá položka se pomalu načítá a blokuje správnou funkci JavaScript
   • To může být případ s jakýmkoli externím sledováním nebo reklamním kódem, který není načítán asynchronně. Znamená to, že položka je zavedena před tím, než prohlížeč pokračuje ve vykreslování stránky. Problém, jako je tento, může být dočasný, například je-li jeden z vnějších serverů přetížen.
   • Náš JavaScript vkládáme do paty stránky (nejlepší postup), takže pokud je nad ním pomalé načítání externí položky, může to chvíli trvat než se prohlížeč přestane snažit načítat externí položku a započne nahrávání přehrávače.
   • Řešením je vyhnout se externím skriptům nebo vždy používat skripty s asynchronním nahráváním. Doporučujeme, aby jste spustili úplný test Vaší stránky přes Pingdom a zjistili, který požadavek zpomaluje a blokuje načítání stránky.

Pokud Vaše problémy přetrvávají, použijte prosím naše fóra podpory. Také Vám nabízíme praktickou podporu, kde Vám rádi pomůžeme. Můžete si také objednat naši Pro podporu.

Pokud jste programátor/ka, naše příručka Řešení problémů Javascript chyb může být pro vás užitečná.