Home Joomla Simple Picture Slideshow - Howto Plugin Code
Main Menu
Most Read
Warning: Creating default object from empty value in /var/www/clients/client396/web1968/web/modules/mod_mostread/helper.php on line 79 Warning: Creating default object from empty value in /var/www/clients/client396/web1968/web/modules/mod_mostread/helper.php on line 79 Warning: Creating default object from empty value in /var/www/clients/client396/web1968/web/modules/mod_mostread/helper.php on line 79 Warning: Creating default object from empty value in /var/www/clients/client396/web1968/web/modules/mod_mostread/helper.php on line 79 Warning: Creating default object from empty value in /var/www/clients/client396/web1968/web/modules/mod_mostread/helper.php on line 79
Support

If you like the products on these pages, your support is highly appreciated. Thank you very much!

Amount: 

Latest Items
Warning: Creating default object from empty value in /var/www/clients/client396/web1968/web/modules/mod_latestnews/helper.php on line 109 Warning: Creating default object from empty value in /var/www/clients/client396/web1968/web/modules/mod_latestnews/helper.php on line 109 Warning: Creating default object from empty value in /var/www/clients/client396/web1968/web/modules/mod_latestnews/helper.php on line 109 Warning: Creating default object from empty value in /var/www/clients/client396/web1968/web/modules/mod_latestnews/helper.php on line 109 Warning: Creating default object from empty value in /var/www/clients/client396/web1968/web/modules/mod_latestnews/helper.php on line 109
Simple Picture Slideshow Plugin Usage - Code
Written by Andreas Berger   
Sunday, 12 July 2009 18:03

A survey of the possibilities to call, extend and modify slideshows with the code in the content item.

The "Simple Picture Slideshow" Plugin is called from within the content item. The code used offers - beside of setting the folder with the images - additional possibilities to enhance and arrange the slideshow.

A.) the slideshow

The code consists of the call {*besps}{/besps*} (without the asterisks) and contains the name of the folder with your images. The configured path to this folder (image root, by default "/images/stories") is added by the plugin automatically and must not be inserted.

The complete call in our sample would look such as:

{*besps}simpleslideshow{/besps*} - without the asterisks

To use a folder within a folder, the path below the set root folder (by default "/images/stories/") is used, e. g. to use the folder /images/stories/folder/subfolder" the call would look such as:

{*besps}folder/subfolder{/besps*} - without the asterisks

In general that´s it and the slideshow is ready to go.




B.) Parameter Overrides

Starting with version 1.3.0 the "Simple Picture Slideshow" offers the possibility to change every default setting from the backend whilst calling the plugin within the content item. With this feature it is possible to use different settings for every single slideshow.

To achieve this, the call of the plugin gets extended by the needed parameters. They are separated from the folder name and from each other by vertical bars (|). The have the syntax PARAMETER=VALUE:

List of possible parameters:

width - width of the slideshow in pixel (integer) e.g.: 400

height - height of the slideshow in pixel (integer) e.g.: 300

align - align the slideshow within the content item; possible values: 0 (right), 1 (center), 2 (left), 3 (float left), 4 (float right)

bgcol - background color as hexadecimal value (without leading #) e.g.: ffffff

sdur
- time to show pictures between two fades in seconds (integer) e.g.: 3

fdur - time the fading may take in seconds (integer) e.g.: 1

steps - steps to fade as value from 1-100 (integer) e.g.: 50

auto - start at pageload; possible values: 0 (no), 1 (yes)

sort - images sort order; possible values: 0 (A-Z - DEFAULT), 1 (Z-A), 2 (old-new), 3 (new-old), 4 (random)

setid - use folder name as identity of the top div-container; possible values: 0 (no), 1 (yes)

ctrls - show controls; possible values: 0 (no), 1 (yes)

csort - control elements sort order; any combination of the following values:
1 (Counter), 2 (Start), 3 (Stop), 4 (Back), 5 (Next), - (split between left and right)
e.g.: 1-2345 (refer to Plugin Howto)

cstart - value for control-element "start"; possible values "empty" (default button), any text, filename of button (refer to Plugin Howto)

cstop - value for control-element "stop"; possible values "empty" (default button), any text, filename of button (refer to Plugin Howto)

cfwd - value for control-element "fwd"; possible values "empty" (default button), any text, filename of button (refer to Plugin Howto)

cbwd - value for control-element "back"; possible values "empty" (default button), any text, filename of button (refer to Plugin Howto)

prld - load images afterwards (integer from 3 - "images in slideshow) e.g.: 5; refer to Plugin Howto

caps - show captions; possible values: 0 (no), 1 (yes)

inout - position of captions; possible values: 0 (below the main image), 1 (blended over the main image)

links - show links; possible values: 0 (no), 1 (yes)



Samples:

{*besps}slideshow|width=600|height=450{/besps*} - without the asterisks
Regardless of the settings in the backend, this gallery is shown with a width of 600 pixel (width=600) and a height of 450 pixel (height=450).

{*besps}slideshow|ctrls=0|caps=0|links=0|auto=1{/besps*} - without the asterisks
No controls, no captions, no links, start at pageload.

Notice:

The parameters listed here correspond with the parameters in the plugins configuration panel. Find a details description at: Howto Plugin .
The first parameter of the initial call always has to be the folder name (path). The sorting of the other parameters is arbitrarily.




C.) Captions

Captions and text have there own call. It´s:

{*besps_c}slideshow-number|imagefile|caption|text{/besps_c*} - without the asterisks

Slideshow-number:
The slideshow within one content item are numbered starting with 0.
This setting is obligatory.

Imagefile:
The name of the file "myimage.jpg".
Left empty, the call is used as default for the whole gallery. This means, if there is no setting for an image, this one is used. The file name and suffix are caseINsensitive.

Caption:
The Caption. If left empty . . . no caption is shown.

Text:
The additional text below the caption. If left empty . . . no text is shown.

Samples:

{*besps_c}0||myTitel|myText{/besps_c*} - without the asterisks
This call sets "myTitel" and "myText" as the default values for the first slideshow within the current content item by leaving the imagefile-value empty.
Notice: You don´t have to set a Default. If you don´t and there is no setting for an image, just nothing is shown.

{*besps_c}1|pic01.png||myText{/besps_c*} - without the asterisks
pic01.png of the second slideshow in the content item has no caption but the text "myText"

{*besps_c}0|pic02.png||{/besps_c*} -without the asterisks
pic02.png in the first slideshow shows no caption and no text although there is a default. The explicit setting overrides it.

{*besps_c}0|pic05.jpg|myTitelA|myTextA{/besps_c*} - without the asterisks
{*besps_c}0|pic06.jpg|myTitelB|myTextB{/besps_c*} - without the asterisks
{*besps_c}0|pic07.jpg|myTitelC|myTextC{/besps_c*} - without the asterisks
{*besps_c}0|pic08.jpg|myTitelD|myTextD{/besps_c*} - without the asterisks . . . and so on

Notice:
It is of no importance where within your content item and in which order your setting are.
The number of parameters has always to be 4. This means, a call always must contain 3 vertical bars, even if a setting is empty (e.g. the imagefile).
These vertical bars are protected characters within the calls and may not be used within your values.
Even when deactivated, Captions can be used to replace the (otherwise used by default) image filename as ALT-, TITLE-text.




D.) Links

If we want to link the images of our slideshow, there is a third call to do so:

{*besps_l}slideshow-number|imagefile|URL|titel|target{/besps_l*} - without the asterisks

Slideshow-number:
The slideshow within one content item are numbered starting with 0.
This setting is obligatory.

Imagefile:
The name of the file "myimage.jpg".
Left empty, the call is used as default for the whole slideshow. This means, if there is no setting for an image, this one is used. The file name and suffix are caseINsensitive.

URL:
The URL you want to link the image with. e.g.: http://www.bretteleben.de

Titel:
The titel, shown when the mouse is over the image. e.g.: bretteleben.de

target:
The window, you want to open the linked URL. e.g.: _blank (new window), _self (same window)

Samples:

{*besps_l}0||http://www.bretteleben.de|bretteleben.de|_blank{/besps_l*} - without the asterisks
This call sets a default link for the first slideshow within the current content item by leaving the value for the imagefile empty. The link opens in a new window.

{*besps_l}1|pic01.png|http://www.disney.com|Disney|_self{/besps_l*} - without the asterisks
pic01.png in the second slideshow within the content item is linked to www.disney.com. The link opens in the current window.

{*besps_l}0|pic02.png|||{/besps_l*} -without the asterisks
We don´t want pic02.png in the first slideshow within the content item to be linked. A special case, because as soon as we have links within a slideshow, every image gets linked. Setting this empty call the image is linked to the current page, without any further setting.

{*besps_l}0|pica.jpg|http://www.my.domain.com/myGreatProduct1|greatProduct1|_self{/besps_l*} - without the asterisks
{*besps_l}0|picb.jpg|http://www.my.domain.com/myGreatProduct2|greatProduct2|_self{/besps_l*} - without the asterisks
{*besps_l}0|picc.jpg|http://www.my.domain.com/myGreatProduct3|greatProduct3|_self{/besps_l*} - without the asterisks
{*besps_l}0|picd.jpg|http://www.my.domain.com/myGreatProduct4|greatProduct4|_self{/besps_l*} - without the asterisks ... and so on

Notice:
It is of no importance where within your content item and in which order your setting are.
The number of parameters has always to be 5. This means, a call always must contain 4 vertical bars, even if a setting is empty (e.g. the imagefile).
These vertical bars are protected characters within the calls and may not be used within your values.




If you have questions or suggestions, please use the comment-function. Please include the installed Joomla! version and if you have problems - if any possible - the affected page in your comment.

If you need additional features or customizations for your project that exceed the scope of support offered through the comments, you are invited to submit your requirements specification and the planned budget by email (menu item "Contact" in the menu at the top).

If you use this extensions, please post a rating and a review at extensions.joomla.org.

Last Updated on Wednesday, 12 January 2011 15:06
 
Comments (38)
Abstand nach der Slideshow verringern
18 Tuesday, 07 June 2011 14:44
Jan

Hi Andreas!

Zuerst einmal vielen Dank für dein tolles Plugin! Nun habe ich folgende Frage: wenn ich in den Plugin Parametern das Alignment Rechts, Links oder Mitte auswähle, dann ist die Slideshow in allen drei Fällen genau in der Mitte des Artikels, was auch so gewünscht ist. Leider ist der Abstand zum nachfolgenden Text sehr groß (sehe mit Firebug 7x
nach dem Slideshow Eintrag). Wähle ich Float Left bzw. Float Right, ist kein Abstand vorhanden, doch die Slideshow "klebt" in beiden Fällen am rechten Rand des Artikels.
Website: jom.ubinam.de
Kannst du mir bitte mitteilen wie ich mit der Alignmentauswahl "Mitte" den Abstand verringere?

Viele Grüße
Jan

Abstand nach der Slideshow verringern
Wednesday, 08 June 2011 08:46
Jan

Hi Andreas, Vielen Dank für deine Antwort! Du hast recht, ich hatte in joomla die Formatierung "pre-formatted" für die Slideshow-Anweisungen verwendet. Nach Umstellung auf Normal hat sich das gewünschte Bild ergeben.

VG, Jan

@Jan
Tuesday, 07 June 2011 21:30
A. Berger

Hallo Jan!

Der Abstand unterhalb der Slideshow entsteht durch die Paragraphen, in die Du die einzelnen Codezeilen für die Captions im Artikel gesetzt hast um sie schön übersichtlich untereinander zu haben. Das Plugin versucht zwar, solche Paragraphen (P) zu entfernen wenn es den Code ausliest, aber es ist dabei eher restriktiv um nicht ungewollt das Layout umzubauen. Es werden also nur Paragraphen entfernt, die den Code direkt einschließen. In Deinem Fall ist da jeweils auch ein Leerzeichen dabei, weshalb die Tags im Quelltext verbleiben.
Lösung: Entweder die Tags überhaupt entfernen - oder zumindest die überflüssigen Leerzeichen innerhalb der Paragraphen.

Gruß
Andreas

resizing the slideshow window
17 Monday, 06 June 2011 07:27
Nella

Hello Andreas,

I will like for the slide show window to be bigger than the original it came with.  So i went under plug in parameters and changed the height and width to be 800 pixels but after i saved and applied the changes my slideshow is still the same size.  The original size is way to small, please help

@Nella
Monday, 06 June 2011 20:47
A. Berger

Hi Nella!

First, please make sure to empty the Joomla! cache (system-cache and page-cache, if activated) after you changed the settings.
Second, please be aware that the plugin scales down images that are larger than the set dimensions but it does not enlarge images that are smaller than the set dimensions (because this always results in bad image quality).
Third, please make sure that you haven't set parameter overrides in the code in the article that prevent the changes in the backend from getting applied to the respective slideshow.

Best regards
Andreas

Rechte
16 Thursday, 26 May 2011 10:41
Paul

@Andreas,

Mein letzter Beitrag hat sich soeben erledigt. Habe mir dein Rat zu Herzen genommen und habe mal ALLE Rechte überprüft und siehe da...es funktioniert. Alle neue Plugins/Modul die ich installiert hatte waren auf 600 gestellt. Irgendwie stimmt da was nicht. Aber Tausend Dank für dieses sehr schöne Plugin. Mache weiter so!

Rechte
15 Thursday, 26 May 2011 08:20
Paul

@ Andreas,

vielen Dank für deine schnelle Hilfe. In der Tat, Ordner rechte waren zwar auf 755 gesetzt aber die Files waren auf 600 was für mich ebenso unerklärlich ist. Jetzt geht soweit aber die Slideshow startet immer noch nicht. http://www.bioenergetische-praxis-weimar.de/joomla2/plugins/content/simplepictureslideshow/files/besps.js  kann zwar den code sehen. Vielleicht hast du noch eine Idee dazu.
Und nochmals vielen Dank für deine Hilfe. Wenn man bedenkt das dieses Plugin Kostenlos ist und trotzdem so ein Klassen Support bekommt, kann ich nur sagen: Hut ab, können sich andere große Unternehmen eine Scheibe abschneiden.

Beste Grüße
Paul

link internal articles
14 Wednesday, 25 May 2011 17:34
Yann

Hi,

I was really happy to find this slideshow plugin, certainly the best I have seen and exactly what I wa looking for, I have a question though, is it possible to link some of the website articles, I have tried using the code but to no result, I am testing on a localhost at the moment, thanks

yann

@Yann
Wednesday, 25 May 2011 20:37
A. Berger

Hi Yann!

Yes it is. Please post the code you are using in your article, I will have a look at it.

Best regards
Andreas

Slideshow startet nicht
13 Wednesday, 25 May 2011 12:25
Paul

Hallo Andreas,

erstmal vielen dank für dieses Plugin. Ich habe alles nach Anleitung gemacht, bekomme die slideshow aber nicht gestartet, hast du eine Idee woran es liegen könnte? Wenn ich die Seite aktualisiere kommt zwar jedes mal ein anderes Bild, aber ich habe ja angecklickt das es starten soll beim Seitenaufruf. hier die Seite: http://www.bioenergetische-praxis-weimar.de/joomla2/index.php/de/

Danke für die Hilfe

@Paul
Wednesday, 25 May 2011 20:19
A. Berger

Hallo Paul!

Die Rechte des Plugin-Ordners stimmen nicht. Ruf mal das Stylesheet besps.css oder das JavaScript besps.js direkt in der Adresszeile des Browsers auf, dann siehst Du was ich meine:
http://www.bioenergetische-praxis-weimar.de/joomla2/plugins/content/simplepictureslideshow/files/besps.js

Ändere die Verzeichnisrechte (Ordner 755, Dateien 644), dann sollte alles klappen. Darüber hinaus solltest Du der Frage nachgehen, warum die Rechte so gesetzt wurden, denn das kann Dir auch bei anderen Erweiterungen Probleme bescheren.

Gruß
Andreas

can I place controls above slideshow?
12 Wednesday, 25 May 2011 08:46
nils

and if yes, how? I've tried playing with the css, but with no success so far...
can this be done?

thanks for a great plugin! :)
nils

@nils
Wednesday, 25 May 2011 20:07
A. Berger

Hi Nils!


Open the stylesheet /plugins/content/plugin_besps/besps.css and change the selector .besps_ctrls {} to .besps_ctrls {position:relative;top:-22px;padding-top:0px;}


Best regards
Andreas

Working on local server
11 Tuesday, 17 May 2011 12:52
21stcn

Hi there,

Developing on my localhost... no slideshow, but this error: No images found in folder C:\xampp\htdocs\joomla15/images/stories/folderx
There are images in folderx. Now, I guess the problem has something to do with the \'s, and I assume these are because of the local server. But I am unable to change /'s to \'s in default path, and don't know how to change C:\... to http://localhost....
Unless I am missing something?

Thanks

@21stcn
Tuesday, 17 May 2011 20:01
A. Berger

Hi 21stcn!

No, the fact the the absolute path in the error is reported with backslashes above and slashes below the web root has nothing to do with your problem. I am working on Windows locally too (XAMPP, USBW, ...) and it works fine.
Please check if the folder with the images is write protected or if there is a typo in the path or if the code is fragmented with HTML-tags (open the article and switch to HTML-view).

Best regards
Andreas

help
10 Sunday, 15 May 2011 01:13
soli

i follow by instruction but i got "Simple Picture Slideshow:
Could not find folder /hermes/bosweb/web116/b1169/ipg.solipics/Solipics/Solipics/images/ slideshow"


let me know how i can fix it

@soli
Sunday, 15 May 2011 08:35
A. Berger

Hi soli!

You could start with removing the whitespace from the path (there may be other typos too):

hermes/bosweb/web116/b1169/ipg.solipics/Solipics/Solipics/images/ slideshow ... before
hermes/bosweb/web116/b1169/ipg.solipics/Solipics/Solipics/images/slideshow  ... after

In addition: Please make sure that the path you set in the parameter "Image root" is not repeated in the code in your article. If the problem persists, please provide a link to the page, I will have a look at it.

Best regards
Andreas

Finally got captions working
9 Friday, 06 May 2011 14:10
Joomlamerica

What wasn't clear in the instructions is that the first code you have to use to have a slideshow with captions is the base slideshow code that identifies the folder for the images, in this case

{*besps}folder/subfolder{/besps*}

Then you add the slides with captions with ALL the slide codes beginning with 0, and then the image within the folder you identified in the first line of code: so the following code was as follows:

{*besps_c}0|1.jpg|Title|Caption.{/besps_c*}
{*besps_c}0|2.jpg|Title|Caption.{/besps_c*}

Once I figured this out (trial and error) it became easy.

@Joomlamerica
Monday, 09 May 2011 21:19
A. Berger

Hi Joomlamerica!

Thanks for your suggestion, I will integrate this.

Best regards
Andreas

Warning: Illegal string offset 'active' in /var/www/clients/client396/web1968/web/templates/biz_blue_ii/html/pagination.php on line 129 Warning: Illegal string offset 'active' in /var/www/clients/client396/web1968/web/templates/biz_blue_ii/html/pagination.php on line 135 Warning: Illegal string offset 'active' in /var/www/clients/client396/web1968/web/templates/biz_blue_ii/html/pagination.php on line 129 Warning: Illegal string offset 'active' in /var/www/clients/client396/web1968/web/templates/biz_blue_ii/html/pagination.php on line 135 Warning: Illegal string offset 'active' in /var/www/clients/client396/web1968/web/templates/biz_blue_ii/html/pagination.php on line 129 Warning: Illegal string offset 'active' in /var/www/clients/client396/web1968/web/templates/biz_blue_ii/html/pagination.php on line 135 Warning: Illegal string offset 'active' in /var/www/clients/client396/web1968/web/templates/biz_blue_ii/html/pagination.php on line 129 Warning: Illegal string offset 'active' in /var/www/clients/client396/web1968/web/templates/biz_blue_ii/html/pagination.php on line 135
English
Panoramic Image Viewer
Follow me on Facebook
Follow me on Google+

bretteleben.de

Add to circles

Who's Online
We have 373 guests online