Slideshow_XH – CMSimple_XH Plugin

Plugin
Icon

Slideshow_XH usnadňuje zobrazení všech obrázků v dané složce jako prezentace. Tyto prezentace neumožňují žádnou interakci návštěvníka. Použití více prezentací s různými efekty a časováním je možné.

Prosím, přečtěte si tuto dokumentaci předtím, než narazíte na nějaké problémy!

Důležité upozornění

Slideshow_XH nemohly být testovány tak daleko v různých prostředích. Je tzv. BETA verze. Používejte opatrně!

Požadavky

Slideshow_XH je plugin pro CMSimple_XH ≥ 1.6. It requires PHP ≥ 5.2.0.

Instalace

Instalace se provádí stejně jako u ostatních pluginů CMSimple_XH. Viz CMSimple_XH wiki kde najdete více detailů.

  1. Zálohujte data na svém serveru.
  2. Rozbalte distribuční balíček ve svém počítači.
  3. Nahrajte celý adresář slideshow/ na váš server do adresáře pluginy CMSimple_XH.
  4. Nastavte práva k zápisu pro podadresáře config/ a languages/.
  5. Zkontrolujte "Slideshow" v režimu administrace zda jsou všechny požadavky splněny.

Nastavení

Konfigurace tohoto pluginu se pravádí stejně jako u ostatních CMSimple_XH pluginů v režimu administrace. Vyberte "Slideshow" v sekci "Pluginy".

Můžete změnit výchozí nastavení Slideshow_XH v "Config". Tipy pro volby se zobrazí při najetí nad nápovědy ikon s myší.

Lokalizace se provádí v nastavení "Jazyk". Můžete přeložit řetězce znaků ve vašem vlastním jazyce if there is no appropriate language file available, nebo je upravit podle vašich potřeb.

Použití

Chcete-li zobrazit prezentaci na všech stránkách vložte do šablony:

<?php echo slideshow('%ADRESÁŘ%', '%NASTAVENÍ%');?>

Chcete-li zobrazit prezentaci na jedné stránce nebo v Newsboxu vložte na stránku:

{{{PLUGIN:slideshow('%ADRESÁŘ%', '%NASTAVENÍ%');}}}

Tyto parametry mají následující význam:

%ADRESÁŘ%
Cesta k adresáři relativní k adresáři images v CMSimple_XH. Všechny JPEG, PNG a GIF obrázky uvnitř této složky budou použity pro prezentaci; there must be at least two images inside this folder. All images should have the same aspect ratio.
%NASTAVENÍ%
Jakákoli volba přepíše odpovídající hodnotu ve "výchozí" části konfigurace pluginu. Formát tohoto parametru je stejný jako "řetězec dotazu" (viz příklady níže). Možnosti mohou být uvedeny v libovolném pořadí. Pokud chcete použít výchozí nastavení, můžete tento parametr vynecháte. K dispozici jsou následující možnosti:
order
Pořadí obrázků: "fixed" (abecedně seřazeny; start od prvního obrázku), "sorted" (abecedně seřazeny; start od náhodného obrázku) oder "random" (náhodné zobrazení).
effect
Druh přechodu: "fade", "slide", "curtain" nebo "random".
easing
Efekt akcelerace: "linear", "easeIn", "easeOut" nebo "easeInOut".
delay
Počáteční zpoždění v ms než se spustí prezentace.
pause
Doba trvání pauzy mezi přechody v ms.
duration
Doba trvání přechodového efektu v ms.

Příklady

Chcete-li zobrazit obrázky z adresáře userfiles/images/bannery/ ve výchozím nastavením pluginu na každé stránce:

<?php echo slideshow('bannery');?>

Způsob, chcete-li zobrazit snímky v posuvném pásu:

{{{slideshow('slides/run/', 'effect=slide&pause=0&duration=2000');}}}

Chcete-li zobrazit obrázky klidně, pomalé vyblednutí slideshow:

{{{slideshow('slides/slow/', 'effect=fade&pause=5000&duration=100');}}}

Chcete-li zobrazit odpovídající obrázky ve stylu knihy s listováním:

{{{slideshow('slides/flip/', 'order=fixed&effect=fade&pause=100&duration=100');}}}

Omezení

Tyto prezentace mohou být přehrávány pouze, pokud je JS povolen v prohlížeči návštěvníka. Jinak ukáže pouze první obrázek. Přechodové efekty jsou náročné na výkon CPU, zejména pro velké obrázky. Takže byste se měli omezit jen na několik prezentací s malým nebo středním obrázky na stejné stránce, aby se zabránilo trhání prezentace pro návštěvníky s malým výpočetním výkonem.

Licence

Slideshow_XH je licencován pod GPLv3.

© 2012-2014 Christoph M. Becker

Dánský překlad © 2012 Jens Maegard
Český překlad © 2012-2013 Josef Němec
Slovenský překlad © 2013 Dr. Martin Sereday
French translation © 2014 Patrick Varlet

Credits

Slideshow_XH was inspired by Joe.

The plugin icon is designed by Mischa McLachlan. Many thanks for publishing this icon under a liberal license.

This plugin uses free applications icons from Aha-Soft. Many thanks for making these icons freely available.

Many thanks to the community at the CMSimple_XH-Forum for tips, suggestions and testing.

And last but not least many thanks to Peter Harteg, the "father" of CMSimple, and all developers of CMSimple_XH without whom this amazing CMS wouldn't exist.