Your Guide to Setting Up and Using RokGallery for WordPress
RokGallery is a large plugin that consists of several different parts. You can use it to create pages, widgets, and manages images uploaded to the main RokGallery administrator. It is centrally controlled via RokGallery Admin accessible in the administrative sidebar on the backend of WordPress.
RokGallery enables you to create and manage galleries which can be used to sort and arrange photos you wish to have appear within your site. You can customize how and where various images are presented to visitors, and maintain full control over them through a single, centralized component.
Administering RokGallery can take some getting used to, though it does deliver absolute control over your images and their appearance on your site.
Accessing the main RokGallery Administrator within WordPress is fairly easy. You simply need to navigate to Admin → RokGalleryAdmin once the plugin is activated.
RokGallery's Component Administrator is broken into two main areas.
The four large icons on the left represent image-level options.
The four icons on the right represent gallery-level controls.
Filters have a range of variables such as gallery, file type, published, etc. to allow you to sort your images for simple and efficient management. Statistics for the filters appear on the right-side of the row.
On the image panes themselves, you can unpublish the individual image, go into the Image Editor, delete the image from RokGallery, and see how many views, likes, and tags each image has. You can also check out the original image's basic details such as the file name and size by either entering the image editor or selecting the information option that appears while hovering over the image with the cursor.
The Tag popup gives you the ability to set tags (and assign a gallery) to an image. Because galleries are tag-based, you could add the tags for multiple galleries in order to have an image (or images) appear in multiple tag galleries.
RokGallery uses a digital-negative approach to image management. This allows you to keep the original image intact while assigning a gallery tag (or tags) creates new copies of the image with the appropriate gallery-specific settings (width, height, cropping, etc.) so they work seamlessly with the specified gallery.
The tag popup allows you to select a gallery for quick tag associations, add/remove specific tags, and apply those changes to the selected image(s). Keep in mind that some changes will require background jobs before they take effect. This can take anywhere from a few seconds to a few minutes, depending on your host.
The Jobs Manager gives you a real-time look at processes being executed by RokGallery. When you change the size or tag gallery association of a photo, it renders a new file that matches the specifications needed to meet these needs. This takes time, and the Jobs Manager is a great resource to check and see if your changes are not appearing on your site correctly due to misconfiguration or the time required to process these requests.
Refresh: Refreshes the status of all current and completed jobs in the list.
Clean: Removes completed jobs from the list.
Wipe All: Removes all jobs from the list.
Update Individual Job: Updates the status of an individual job.
Delete Individual Job: Removes an individual job from the list.
Galleries: Select an existing gallery, or create a new one.
Name: Enter or change the name for the current or new gallery.
Tags: Enter tag(s) for the gallery, separated by commas, which should be present on associated images.
Images Set the image preferences for images appearing within the tag gallery.
Thumbnails Size Sets the image preferences for thumbnails associated with images presented in as part of the gallery.
The Galleries Manager allows you to create and manage tag galleries which are used to determine which images should display in various locations on your site. For example, a RokGallery widget can be set to display a specific tag gallery, based on the tags assigned to the specific gallery (and images within that gallery).
For example, setting up a gallery with the tag
Gallery1 would allow for any image with the same tag to appear in any widget with that gallery assigned. You can add multiple tags to a single gallery with commas between tags.
Galleries enable you to also set a specific image size for any images displayed via the gallery tags. For example, if you want to have 640x480 images appear in a slideshow on the front page, this is configurable through the Galleries Manager. You can also opt to have the original image's aspect ratio retained or to have the changes forced, depending on your individual needs. Keep in mind that a gallery displaying with multiple aspect ratios may adjust in shape and form with each image displayed. Any changes made here will create a new image file, leaving your original image completely intact and available for full image viewing via RokBox or in a separate browser tab.
Thumbnails are used in some gallery display settings to give users a quick overview of all of the images in a specific gallery. By clicking on a thumbnail, the image selected is sent to the primary viewing area in the module, linked to a different page or area of the site, or made larger via a RokBox popup.
You can also opt to adjust the ordering of images within a gallery, publish all images assigned to a gallery, or delete the gallery itself. In addition, the Galleries manager gives you the ability to automatically delete slices created for the gallery when an image is removed, freeing up some space on your server.
The Browse button opens a file browser enabling you to select one or more image files to upload to RokGallery. This is useful if you would prefer not to click and drag files manually into this popup, or if your browser does not support that functionality.
The Upload button initiates the upload process for selected files. You will see the upload status update during upload.
Uploading images to RokGallery using the built-in file uploader is the best way to get images into RokGallery. The standard media uploader included in Joomla will add files to the media folders, but won't actually include them in RokGallery's directory.