Gallery Display plugin
This plugin will insert a gallery or a slideshow. A Marker is replaced with a
gallery template or slideshow type. The marker begins with "{rsg2_display:"
and is folllowed by parameters and ends with "}" In the examples below a " "
is insterted so it doesn't match and try for unknown slideshow
{ rsg2_display: template, GID}
{ rsg2_display: template, GID, parameter=value, parameter=value, ...}
{ rsg2_display: slideshow_parth, 5}
{rsg2_display: slideshow_parth, 5}
{ rsg2_display: slideshowone, 5}
{rsg2_display: slideshowone, 5}
{ rsg2_display: slideshow_phatfusion, 5}
{rsg2_display: slideshow_phatfusion, 5}
Gallery view
{rsg2_display: semantic, 1}
Single Image
{rsg2_singledisplay:9}
Gallery Display plugin
This plugin will insert a gallery or a slideshow. A Marker is replaced with a
gallery template or slideshow type. The marker begins with "{rsg2_display:"
and is folllowed by parameters and ends with "}" In the examples below a " "
is insterted so it doesn't match and try for unknown slideshow
{ rsg2_display: template, GID}
{ rsg2_display: template, GID, parameter=value, parameter=value, ...}
{ rsg2_display: slideshow_parth, 5}
{rsg2_display: slideshow_parth, 5}
{ rsg2_display: slideshowone, 5}
{rsg2_display: slideshowone, 5}
{ rsg2_display: slideshow_phatfusion, 5}
{rsg2_display: slideshow_phatfusion, 5}
Gallery view
{rsg2_display: semantic, 1}
Single Image
{rsg2_singledisplay:9}
The display plugin RSG2_Plugin_DisplayGallery is used to display any gallery with any template in any Joomla content like articles or components that supports content plugins. Make sure to publish the plugin in the plugin manager and lowercase your template names. In the following pages you will see examples of the display plugin in action.
Installation instructions:
- Download the RSG2_Plugin_DisplayGallery plugin.
- install the plugin using the Joomla Extensions install utility.
- ENABLE the new RSG2_Plugin_DisplayGallery plugin with the Joomla backend plugin manager.
Using the plugin:
The syntax for the usage of the plugin is:
{rsg2_display: templatename, GID}
where:
- templatename is a parameter string for setting the RSGallery2 template (usually "semantic")
- GID is a parameter integer to specify the gallery to display.
How-to detemine the GID?
Browse to the (sub)gallery of RSGallery2 you want to display. In this example we use the sub gallery of the first gallery with different SEF settings:
undefined3&Itemid=107
undefined3
undefined3.html
The three (3) in the URL's above are the GID.
Notes:
- The template name is the directoryname found at \JOOMLAROOT\components\com_rsgallery2\templates\).
- If you use different templates on the same page that use different versions of the same Javascript libraries, you will probably have display issues.
- Pagination in the plugin doesn't work at the moment of writing.
This is an example of the content display plugin with template semantic and the first gallery (1). The syntax is: {rsg2_display: semantic, 1} Please note that the subgallery of gallery one is included. Also, here you can see the pagination of RSGallery2 which does not function when the gallery is put in contents with this display plugin. To avoid this use the "display_thumbs_maxPerPage=4" parameter as described in the plugin info.
{rsg2_display: semantic, 1}
This is an example of the content display plugin with template slideshowone and the second gallery (2). The syntax is: {rsg2_display: slideshowone, 2}
{-REMOVED-rsg2_display: slideshowone, 2}
This is an example of the content display plugin with template slideshow_parth and the second gallery (2). The syntax is: {rsg2_display: slideshow_parth, 2}
{rsg2_display: slideshow_parth, 2}
The display plugin plg_rsg2_singledisplay is used to display any (published) RSGallery2 image in Joomla content like articles or components that supports content plugins. Make sure to publish the plugin in the plugin manager. A few examples of this plugin in action are shown at the bottom.
Installation instructions:
- Download the plg_rsg2_singledisplay plugin.
- install the plugin using the Joomla Extensions install utility.
- ENABLE the new plg_rsg2_singledisplay plugin with the Joomla 1.5 backend plugin manager.
Using the plugin:
The syntax for the usage of the plugin is:
{rsg2_singledisplay: imageid, size, caption, format}
where:
- imageid: Backend > Components > RSGallery2 > Items: use the number from the ID column.
- size: thumb, display or original.
- caption: true (use the item desciption as a caption) or false (no caption).
- format: text-align style property
Examples:
1. This is an example of the single image display plugin with syntax: {rsg2_singledisplay:27,thumb,true,left}, so it's a thumb sized image with description (if there is any) and the style property of the div element with class rsgSingleDisplay in which this image is placed is "left":
{rsg2_singledisplay:27,thumb,true,left}
2. This is an example of the single image display plugin with syntax: {rsg2_singledisplay:27,display,true,right}, so it's a display sized image with description (if there is any) and the style property of the div element with class rsgSingleDisplay in which this image is placed is "right":
{rsg2_singledisplay:27,display,true,right}
3. This is an example of two images next to each other with the single image display plugin with syntax: {rsg2_singledisplay:28,thumb,false,left;float:left} {rsg2_singledisplay:28,thumb,false,left;float:left}, so it's thumb sized images without description and the style property of the div element with class rsgSingleDisplay in which this image is placed is "left;float:left" for both images:
{rsg2_singledisplay:28,thumb,true,left;float:left} {rsg2_singledisplay:28,thumb,true,left;float:left} This text is put just after the } of the plugin text and it will be next to the image because of the floating. We'll need to "clear the float" now with this HTML code
<div style="clear:both;">
4. This is an example of two images next to each other with the single image display plugin with syntax: {rsg2_singledisplay:27,thumb,false,left;float:left} {rsg2_singledisplay:27,thumb,false,left}, so it's thumb sized images without description and the style property of the div element with class rsgSingleDisplay in which this image is placed is "left;float:left" for the first image, but "left" for the second image (this influences the position of the text after the final } of the second image):
{rsg2_singledisplay:27,thumb,false,left;float:left} {rsg2_singledisplay:27,thumb,false,left} with some text that does not show up next to the image.
5. This is an example of two images above each other, to show what a diffence the format argument can make, with the single image display plugin with syntax: {rsg2_singledisplay:21,thumb,false,left} {rsg2_singledisplay:21,thumb,false,left}, so it's thumb sized images without description and the style property of the div element with class rsgSingleDisplay in which this image is placed is "left" for both images:
{rsg2_singledisplay:21,thumb,false,left} {rsg2_singledisplay:21,thumb,false,left} with some text.
As you can see, CSS styling and the text-align property of the div (with class rsgSingleDisplay) in which the image is positioned can influence the position of the images. With appropriate padding/margins some space between images can be achieved. The text-alingn property you can give with the plugin arguments, the CSS styling may come from your Joomla template (on this page the default Joomla 1.5 rhuk_milkyway template).
Note: plg_rsg2_singledisplay_3.0_J25.zip is used here, e.g. the RSGallery2 single image display plugin version 3.0 for Joomla 2.5.