====== slider Plugin ======

---- plugin ----
description: Add a slider element to any DokuWiki page
author     : Andreas Gohr 
email      : dokuwiki@cosmocode.de
type       : syntax
lastupdate : 2020-07-08
compatible : Elenor Of Tsort, Detritus, Weatherwax, Hogfather, Igor
depends    : 
conflicts  : 
similar    : 
tags       : slider, carousel

downloadurl: https://github.com/cosmocode/dokuwiki-plugin-slider/zipball/master
bugtracker : https://github.com/cosmocode/dokuwiki-plugin-slider/issues
sourcerepo : https://github.com/cosmocode/dokuwiki-plugin-slider/
donationurl: 

screenshot_img : 
----

This plugin adds a Slider element using the [[https://bxslider.com/|bxSlider jQuery Plugin]].

===== Installation =====

[[https://www.cosmocode.de/en/open-source/dokuwiki-plugins/|{{ https://cosmocode.de/static/img/dokuwiki/dwplugins.png?recache|A CosmoCode Plugin}}]]

Search and install the plugin using the [[plugin:extension|Extension Manager]]. Refer to [[:Plugins]] on how to install plugins manually.

==== Changes ====

{{rss>https://github.com/cosmocode/dokuwiki-plugin-slider/commits/master.atom date}}

===== Syntax =====

Slides need to start with a ''<slider>'' element which may contain an image (internal or external) as background for the slide. Inside the slide any other DokuWiki syntax can be put, this will be shown as an overlay over the background image. The last slide has to be finished with a ''</slider>'' element.

Simple Image only slider with internal and external images:

<code>
<slider some:internal:image.jpg>
<slider anotherlocalimage.jpg>
<slider http://example.com/externalimage.jpg>
</slider>
</code>

Slider with mixed content

<code>
<slider some:internal:image.jpg>
===== A Headline =====

And some other stuff

<slider>

This one has no background image at all.

<slider http://example.com/externalimage.jpg>
</slider>
</code>

===== Configuration and Settings =====

The size of background images can be set in the config manager. Images will be automatically scaled to match the full width of the page by the browser. The given size controls image quality vs. download size.

===== Discussion =====

  * Have you tested this plugin recently? It does not work in Detritus! Please check and update  --- [[user>atronoush|atronoush]] //2015-10-02 19:58//

>The plugin works fine in Detritus so please check your settings first. --- [[user>Laynee|Laynee]] //2016-03-14//

  * Would be nice to be able to link slider images as a whole instead of the overlaying content. Even better, to support full DokuWiki image links syntax inside the <slider> elements.
===== in rtl lang like arabic=====

  * It does not work in selfthinker! Please check and update  --- 

?