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 Installation and Usage
Written by Andreas Berger   
Thursday, 08 January 2009 17:34

A step for step tutorial on how to install and use the bretteleben.de Simple Picture Slideshow Plugin.

Installation

1.) Log into your administration interface


2.) Go to "Extensions" > "Install/Uninstall"


3.) Select the Package File with the bretteleben.de Simple Picture Slideshow Plugin


4.) Click "Upload file & Install"


5.) If everything worked fine, you get the message "Install Plugin Success"


6.) Select "Extensions" > "Plugin Manager"


7.) Find the "bretteleben.de Simple Picture Slideshow" and click it


8.) The first section of parameters controls the layout of the slideshow.
The first parameter is the width of your slideshow in pixel.


9.) The next parameter is the height of your slideshow in pixel.



Pictures larger than set here are scaled by the visitors browser according to these settings. Smaller pictures are not enlarged. If possible you should offline scale your pictures to the width and height they will display because scaling by the visitors browser results in a loss of quality and it increases the time your page takes to load without any additional benefit for your visitor.


10.) The next parameter sets the position of the gallery within the available space. You may choose between left - centered - right, float left and float right. The last two options allow the gallery to get wrapped by your text. They also increase the dependence from the used template and will not always show the desired results!


11.) Background Color: The background color of your slideshow is of importance if you use pictures of different size or pictures with proportions different from the settings above. It prevents the next Pictures to be visible below the current one. Set the hexadecimal color-value without the leading pound key (#), e.g. ffffff for white.


12.) "Sort Order" sets the order the images are shown. You may choose between alphabetic ascending, alphabetic descending, old to new and new to old (both use "last changed" not "created"!) and random.


13.) Next sections sets the values for the animation.
"Time to show" is the time in seconds a picture is shown between two fades.


14.) "Duration of Fading" is the time you set for the fading itself, again in seconds. In most cases 1 will do fine.


15.) The plugin moves transparency from 100% to 0% (or vice versa). "Fading steps" sets the stepwidth used. A value of 5 means, that the transparency is changed in 5 steps, each of 20%. 50 sets 50 steps, each of 2%. The higher this value the more smooth the fading but also the more computationally intensive. Setting a to high value when using large images may cause the set times to be excessed. Just try out.


16.) The next parameter sets if your slideshow starts automatically on pageload.


This option may be activated regardless of displaying controls. They do not influence this feature.


17.) The next section is about the optional control elements.
The first parameter sets if you want to show them at all.


18.) The second parameter sets which elements to show, if they get shown left or right and in what sort order.



This all is set with a combination of the values 1, 2, 3, 4, 5, and the minus sign "-".
1 ... the Counter
2 ... Link/Button Start
3 ... Link/Button Stop
4 ... Link/Button Back
5 ... Link/Button Next
'-' ... the minus sign splits the elements into left and right. If omitted, all elements are shown at the right.

Samples:
1-2345 . . . . the counter at the left, the four links/buttons at the right
415 . . . . back-button/link, counter, next-button/link, all of them at the right side (no minus sign)
415- . . . . same elements again, this time all at the left side


19.) The next 4 parameters set what you want to use for the links.


- Left empty, the plugin shows the automatically installed default buttons.

- Insert any text and the text is shown.

- Instead of text links you may also use buttons. Just insert the name of the image-file you want to be used (including the suffix). The plugin detects .jpg, .gif and .png and searches for the corresponding file in the set folder (we will set this a little later, by default it is "/images/stories/besps_buttons"). If the file exists, the image is shown.


20.) If you activate "Show captions?", you have the possibility to add Title and Text to your images.


Even when deactivated, Captions can be used to replace the (otherwise used by default) image filename as ALT-, TITLE-text.


21.) "Position of Captions" sets if the captions (and text) are shown crossfading over the lower part of the image or below the image.


22.) "Use links?" allows - if activated - to set links for the images.


23.) Image root configures the path to the folder you are uploading (directly or stored in subfolders) your images. By default this parameter is set to /images/stories/ (and this folder is also used when the parameter is empty). In most cases this setting will fit your needs and there is no reason to change it. Only if you have organized your images in a folder structure outside of /images/stories/, put the path here.
The set value of this parameter will be added to the folder name you insert in the code in your article automatically by the plugin and must not be repeated in the article.


24.) Buttonfolder
If you are going to use custom buttons for the navigation between sets, this is the place to put the path to the folder you uploaded this buttons. By default this parameter is set to /images/stories/besps_buttons/ (and this folder is also used when the parameter is empty).


25.) Stylesheet

If you have modified the default stylesheet besps.css or want to use a completely different stylesheet, you have the possibility to save it - with a different name - to the folder /plugins/content/plugin_besps and choose it here.
This has the advantage that your renamed stylesheet does not get overwritten during an update like the default stylesheet besps.css.


26.) JavaScript

If you have modified the default JavaScript besps.js or want to use a completely different JavaScript, you have the possibility to save it - with a different name - to the folder /plugins/content/plugin_besps - and choose it here.
This has the advantage that your renamed JavaScript does not get overwritten during an update like the default JavaScript besps.js.

 


27.) Preload

This parameter offers the possibility to reduce the time, the page takes to load by replacing pictures with one small dummy-picture. This "besps.png" comes with the plugin and is stored in the folder /plugins/content/plugin_besps automatically. On pageload the script replaces this dummy with the actual images.

The default setting of the plugin is to load all pictures with your page. If you set a number larger than 3 (the script needs at least 3 pictures to start), the pictures beyond this number will get loaded by the JavaScript on pageload.

 

Samples:
Your folder contains 10 pictures, the parameter is empty, all pictures are loaded with the page.
Your folder contains 10 pictures, the parameter is set to 3, 3 pictures are loaded with the page, 7 by script afterwards.
Your folder contains 10 pictures, the parameter is set to 5, 5 pictures are loaded with the page, 5 by script afterwards. ...

The feature is rather experimental at the moment, the JavaScript does not check if it is showing the real image or the dummy. If you use it, please do extended testing on it. Records about your experiences are most welcome!


28.) The parameter "Foldername as ID" gives you the possibility to set the name of the folder, from which the images are taken, as identity of the surrounding div-container of the slideshow. (id="foldername").



The plugin contains in the folder (Joomla-Installation)/plugins/content/plugin_besps the style sheet besps.css. This style sheet is loaded after the css-settings the plugin writes to the head-section of the page and gives you the possibility to overwrite every single setting. This works anyway and applies to all "simple picture slideshows" on your site.
Setting a unique identity gives you furthermore the possibility to use this identity as a CSS-Selector and use individual styles for one single slideshow .


29.) Activate the plugin


30.) Click "Save" - done


 

Usage


Next we need the images. We upload them to a folder in (Joomla-Installation)/images/stories.


1.) Go to "Site" > "Media Manager"


2.) Navigate to the folder "Media" > "stories"


3.) Create a new subfolder for your images. In this sample I choose the name "simpleslideshow"


4.) Navigate to the new folder.


5.) ... and upload your images to it. The plugin accepts images of type ".jpg", ".gif" and ".png".


6.) optional: If you want to display custom image-buttons for your control-elements, we have to take care of these images too. So, again navigate to the folder "Media" > "stories".

 

And create a folder called besps_buttons. This is the place the plugin looks for the images you set in point 19 (Installation).

And therefore we upload them here.

Notice: The plugin does NOT create this folder automatically.


7.) Next, go to "Article Manager" and open the article you want to display the gallery.


8.) At the place you want the slideshow to be shown insert the code to call it.

The code consists of the call {*besps}{/besps*} (without the asterisks) and contains the name of the folder with your images. The path to this folder "/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 "/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.

How to show title and text with our images or modify the current slideshow from the default-settings in the backend, find out in the second part of this howto (link at the end of the page).


9.) Save - done!


A survey of the possibilities to call, extend and modify galleries with the code in the content item: Howto Plugin Code




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 (41)
So far so good .... in fact very good
31 Friday, 06 January 2012 07:07
Neville Rodrigues

tried somre other plugins but they wouldn't work on multiple uses

yours does ... Thank you ... excellent plugin

danke
30 Thursday, 05 January 2012 15:32
vian

hallo andreas,

die simple-picture-slideshow habe ich erstmals eingesetzt & bin sehr zufrieden mit diesem einfach zu konfigurierenden tool. (fast) alles klappt bestens (eine krise ist überstanden, bei der ich allerdings nicht ganz verstanden habe, was sie auslöste. habe das ganze neu installiert, danach lief es wieder rund.)

danke auch für die anleitung, sie hat die einarbeitung vereinfacht.

schöne grüße aus berlin
vian

Joomla 1.7
29 Thursday, 05 January 2012 10:07
Yann L.

Hi, the plugin looks great, but this tutorial don't match with Joomla 1.7.

I didn't find the "stories" directory. I've only "banners", "illustrations" and "sampledata" in Media. And a simple windows search shows there's no longer a stories directory.
How it works with 1.7?
I hope I am understandable, and sorry for the bad English.

Thanks for help

@Yann L.
Wednesday, 11 January 2012 16:15
A. Berger

Hi Yann!

The version for Joomla!1.6 and Joomla!1.7 refers to the default image folder of these Joomla! versions which is /images/ (whilst it has been /images/stories/ in Joomla!1.5). The tutorial states this and no worry, it works with Joomla!1.7 :)

Best regards
Andreas

showing code instead of pictures
28 Monday, 12 December 2011 05:12
btealtn

Hi. I love this plugin and have used it on a couple of other websites. But I cannot get it working on this one: sca.heymisterdesigns.com. It is showing the code instead of the pictures.

I have the plugin enabled and have doublechecked the path.

plugin -  /images/stories/
module - {*besps}slideshow/frontpage{/besps*}
actual path - images/stories/slideshow/frontpage

Thank you for the help.

@btealtn
Tuesday, 13 December 2011 20:30
A. Berger

Hi btealtn!

Seems you already switched to another extension. Anyway, if somebody else has problems getting the plugin to work at a module-position, please check the page "FAQ&Troubleshooting" for information about this issue.

Best regards
Andreas

Not working on 1.5.20 site
27 Monday, 21 November 2011 14:58
Russ

Hi the images dont change automatically for me, also controls dont seem to work (when I enable them) - it will load a different image when the page is refreshed so seems to be getting the containing folder info. Source code looks OK, I've compared it to a working example.

Can you help?

Many thanks

@russ
Monday, 21 November 2011 21:50
A. Berger

Hi russ!

Sounds like either an extension (or a snippet in the index.php of your template) prevents the JavaScript /plugins/content/plugin_besps/besps.js from getting linked from the page head or another JavaScript causes a failure.
If you could provide a link to the page, I will have a look at it.

Best regards
Andreas

SUPER und DANKE!!!!!
26 Sunday, 13 November 2011 20:29
Udo

Ich, 64 Jahre, hab es dank Deiner Beschreibung geschafft.
DANKE für die SUPER Beschreibung.

About navigation buttons
25 Saturday, 05 November 2011 06:23
John77

?ello and thank you for an excellent plugin.

I was wondering whether it is possible to hide navigation button in a slideshow in article A , but show the buttons in a different slideshow in article B . I obviously cannot do this from the  plugin manager where i have to choose whether the buttons will show for every article that uses the plugin

Thanks in advance

@John77
Monday, 07 November 2011 20:48
A. Berger

Hi John77!

Have a look at the page "Howto Plugin Code" (menu at the left), it explains how to use the feature "Parameter Overrides" which allows to override the values you set in the backend for a specific slideshow by adding "parameter=value" pairs to the code in the article.
This way you can create unlimited slideshows with different settings each.

Best regards
Andreas

Transparent backgroung
24 Thursday, 03 November 2011 23:23
Amy Lewis

Hi and thanks for writing such an easy to use Plugin. It worked perfectly from the start.
Is there any way to opt for no background color (transparent)?

Thank you!

@Amy Lewis
Thursday, 03 November 2011 23:30
A. Berger

Hi Amy!

Yes and No :)
Yes, it is possible, just set the background color to a value like e.g. "transparent" and you will get a transparent background because this setting gets misinterpreted by the browser - anyway, it helps to understand the second part of my answer which is:

No, because a transparent background has the unwanted side-effect that the next image in the row gets visible (100%) to early if you are using semi-transparent images or images of different size (and I suppose you do, because otherwise a transparent background wouldn't make any sense).

Best regards
Andreas

slideshow measures
23 Thursday, 03 November 2011 12:00
luigi

hello, if I want a slideshow with different measures (height and width) in several articles I can do?

@luigi
Thursday, 03 November 2011 20:14
A. Berger

Hi Luigi!

Check the page "Howto Plugin Code" (menu at the left), it explains the feature "Parameter Overrides" that allows to set values different from the settings in the backend for a single slideshow by adding "parameter=value" pairs to the code in the article.

Best regards
Andreas

image pathway
22 Wednesday, 02 November 2011 20:09
juan

I think I am really going to like this plugin, but am having trouble with the install.  The /images/stories/ directory does not appear in my Media Manager directory.  Any suggestions. Joomla! v.1.6.

@juan
Wednesday, 02 November 2011 21:13
A. Berger

Hi juan!

The plugin uses by default the standard image folder of the respective Joomla! version (/images/stories for Joomla!1.5 and /images for Joomla!1.6 and Joomla1.7).  Therefore - in most cases - you won't need any changes. If you want to use another folder as your root image folder, the parameter ""Image root" allows to change this behavior.

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 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 487 guests online