The Image Manager Extended can be used to effortlessly create "lightbox" popup images for your site by creating the code necessary to support JCE MediaBox, RokBox or WidgetKit Lightbox style popups, in just a few clicks!
It is assumed that you either have the JCE MediaBox plugin installed and published, or some other plugin, extension or template that has Rokbox or WidgetKit Lightbox support.
There are 3 methods for creating a popup :
- Creating a popup for an image that has an associated thumbnail - This method assumes that the image to be used as the main popup image already has a thumbnailed version present in the thumbnail folder, either created during the upload process or using the Thumbnail Editor.
- Creating a popup for an image that does not have an asscociated thumbnail - No thumbnail is present and one needs to be created using the Thumbnail Editor.
- Creating a popup for an image using an alternate thumbnail image - No thumbnail is present and you wish to used a different image as the thumbnail (this can be any image at all, located in any folder).
Creating a popup for an image that has an associated thumbnail
As stated above, this method assumes that a thumbnail already exists. You can check this by selecting the image (click to the right of its name), and checking to see if the thumbnail icon is a Create Thumbnail icon or a Delete Thumbnail icon. If it is the latter, a thumbnail exists, and should be located in the 'thumbnails' folder in the same directory as the image. Proceed by following these steps:
- Click the Popup Tab.
- Select a Popup Type, eg: JCE MediaBox
- JCE Mediabox - the default choice. This requires that the JCE MediaBox plugin is installed and published.
- Window Popup - Not recommended, but a backwards compatability option to create browser window popups.
- Select the image that is to be used as the popup image by clicking on its name in the File Browser. A dialog will appear asking whether you would like to use the image's associated thumbnail. Click Yes.
- The URL field in the Popup tab will be filled with the popup image's url, and the relevant fields in the Image tab will be filled with the thumbnail image's values.
- To add a title and/or caption to the popup, enter text in the Title and Caption fields.
- To create a gallery of images in the popup, assign each popup link to the same 'group' by giving each popup the same group value.
The Group or Album field is used to associate image popups, thus creating a popup gallery, where the visitor can naviagte from one image to the next from within a single popup. To use this feature, all the images must be on the same page (or end up on the same page within the various Joomla! content items) and have the same Group or Album name.
Example: I have created 3 popup images in my content item, and assigned them all the Group name of 'gallery'. When the visitor views any of the popups by clicking on any one of the images, navigation items are included in the popup allowing the viewer to move to the other images in the Group.
Creating a popup for an image that does not have an asscociated thumbnail
- Select the image to be used in the popup blicking to the right of the image's name.
- Click the Create Thumbnail button to open the Thumbnail Editor. Select the desired values in the dialog that appears. The default values are usually adequate. Click Save.
- Follow steps 1 to 6 above.
Creating a popup for an image using an alternate thumbnail image
The procedure for this method is quite different to the above two in that we must manually specify which is the popup image and which is the thumbnail image. It is however, relatively straight forward and only takes a few more clicks than the above methods!
- With the Image tab selected, click on the image name of the image that is to be the thumbnail, ie: the image that will be clicked to launch the popup.
- Click the Popup tab.
- Select a Popup Type, eg: JCE MediaBox
- Click on the name of the image that is to be the popup image in the File Browser, ie: the image that will be disaplayed in the popup.
- As above, if this image has an associated thumbnail, you will be asked whether you would like to use this thumbnail - Click No.
The final steps are the same for each one of these methods.
Assign values to the Image if necessary (Align, Margin, Border etc.)
To remove an existing Popup, set teh Popup Type to -- Not Set --, then click the Update button.