Slideshow_XH facilitates to display all images in a given folder as a slideshow. The slideshows do not support any interaction of the visitor. Multiple slideshows with different effects and timings are possible.
Slideshow_XH is a plugin for CMSimple_XH ≥ 1.7.0. It requires PHP ≥ 5.4.0.
The lastest release is available for download on Github.
The installation is done as with many other CMSimple_XH plugins.
- Backup the data on your server.
- Unzip the distribution on your computer.
- Upload the whole directory
slideshow/
to your server into theplugins/
directory of CMSimple_XH. - Set write permissions for the subdirectories
config/
andlanguages/
. - Navigate to
Plugins
→Slideshow
in the back-end to check if all requirements are fulfilled.
The configuration of the plugin is done as with many other CMSimple_XH
plugins in the back-end of the Website.
Go to Plugins
→ Slideshow
.
You can change the default settings of Slideshow_XH under Config
.
Hints for the options will be displayed
when hovering over the help icon with your mouse.
Localization is done under Language
.
You can translate the character strings to your own language,
if there is no appropriate language file available,
or customize them according to your needs.
To show a slideshow on all pages insert into the template:
<?=slideshow('FOLDER', 'OPTIONS')?>
To show a slideshow on a single page or in a newsbox insert into the page:
{{{slideshow('FOLDER', 'OPTIONS')}}}
The parameters have the following meaning:
FOLDER
: The path of a folder relative to the image folder of CMSimple_XH. All JPEG, PNG and GIF images inside this folder will be used for the slideshow; there must be at least two images inside this folder. If there are also*.webp
images with the same basename as a recognized image, this are used instead, if WebP is supported by the browser. All images should have the same aspect ratio.OPTIONS
: Any given option will override the respective value in theDefault
section of the plugin configuration. The format of this parameter is the same as a “query string” (see the examples below). The options can be given in any order. If you want to stick with the defaults, you can omit this parameter. The following options are available:order
: The order of the images:fixed
(alphabetically ordered; start with first image),sorted
(alphabetically sorted; start with randomly chosen image) orrandom
(randomly ordered).effect
: The kind of transition:fade
,slide
,curtain
orrandom
.easing
: The acceleration effect:linear
,easeIn
,easeOut
oreaseInOut
.delay
: The initial delay in milliseconds until the slideshow starts.pause
: The duration of the pause between the transitions in milliseconds.duration
: The duration of the transition effect in milliseconds.
To show the images inside of userfiles/images/banners/
with the default settings on every page:
<?=slideshow('banners')?>
To show images in a treatmill fashion:
{{{slideshow('slides/run/', 'effect=slide&pause=0&duration=2000')}}}
To show images as calm, slowly cross-fading slideshow:
{{{slideshow('slides/slow/', 'effect=fade&pause=5000&duration=100')}}}
To show appropriate images in a flip-book style:
{{{slideshow('slides/flip/', 'order=fixed&effect=fade&pause=100&duration=100')}}}
The slideshows can only be played, when JS is enabled in the browser of the visitors, and they are using contemporary browsers, Otherwise only the first image will be shown. The transition effects are CPU-intensive, particularly for large images, so you should restrain yourself to only a few slideshows with small or medium-sized images on the same page, to avoid stuttering slideshows for visitors with little processing power.
Report bugs and ask for support either on Github or in the CMSimple_XH Forum.
Slideshow_XH is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.
Slideshow_XH is distributed in the hope that it will be useful, but without any warranty; without even the implied warranty of merchantibility or fitness for a particular purpose. See the GNU General Public License for more details.
You should have received a copy of the GNU General Public License along with Slideshow_XH. If not, see https://www.gnu.org/licenses/.
Copyright 2012-2021 Christoph M. Becker
Danish translation © 2012 Jens Maegard
Czech translation © 2012-2013 Josef Němec
Slovak translation © 2013 Dr. Martin Sereday
French translation © 2014 Patrick Varlet
Slideshow_XH was inspired by Joe.
The plugin icon is designed by Mischa McLachlan. Many thanks for publishing this icon under a liberal license.
Many thanks to the community at the CMSimple_XH Forum for tips, suggestions and testing. Particularly, many thanks to Caravaner for the prompt reporting of bugs, and olape for suggesting the progressive WebP enhancement.
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 would not exist.