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.
