0
Welcome Guest! Login
0 items Join Now

RokGallery: User Guide

Your Guide to Setting Up and Using RokGallery for WordPress


RokGallery Administrator Overview

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.

How to Get to the RokGallery Administrator

Accessing the main RokGallery Administrator within WordPress is fairly easy. You simply need to navigate to Admin → RokGalleryAdmin once the plugin is activated.

Understanding the Administrator

1
Image Controls
Provides image-specific control options.
2
Gallery Controls
Gives you the ability to see jobs status, manage galleries, configure RokGallery settings, and upload new images.
3
Filter 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.

RokGallery's Component Administrator is broken into two main areas.

  1. The four large icons on the left represent image-level options.

    • Publish: This button publishes images highlighted in the image area below. You can highlight images by clicking and dragging your mouse over them. A blue box will appear as you drag, indicating which images your selection area affects. You can tell an image is published by the presence of a green triangle in the upper-right corner of the image box.
    • Unpublish: This option unpublishes currently-published images selected in the image area below. These images will not appear on the frontend, or any gallery widgets they are presently linked to.
    • Tag: The Tag button opens a popup that will give you the option to assign tags to a particular image, as well as assign it to a gallery. This gallery can then be used to present the image on the site either as a direct injection into a post or via a RokGallery module.
    • Delete: This option gives you the ability to delete an image from RokGallery. Once deleted, it will no longer be available to appear on your site.
  2. The four icons on the right represent gallery-level controls.

    • Jobs: Shows a popup log of all previous and current operations, such as imports. This is a good place to go if you have recently made changes to an image or gallery and do not see them on the frontend. This is typically due to the time required to process changes made to image files on the backend.
    • Galleries: Allows you to create, delete and manage all tag galleries. This popup is also available within a RokGallery widget when you have a gallery assigned. Changes made in this popup will impact all instances of the tag gallery.
    • Settings: Gives you access to configuration for general aspects of RokGallery.
    • Upload: This button opens a HTML5/Flash drag and drop image uploader.
  3. 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.

Tags

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.

Jobs Manager

1
Refresh
Refreshes the status of all current and completed jobs in the list.
2
Clean
Removes completed jobs from the list.
3
Wipe All
Removes all jobs from the list.
4
Update Individual Job
Updates the status of an individual job.
5
Delete Individual Job
Removes an individual job from the list.

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.

  1. Refresh: Refreshes the status of all current and completed jobs in the list.

  2. Clean: Removes completed jobs from the list.

  3. Wipe All: Removes all jobs from the list.

  4. Update Individual Job: Updates the status of an individual job.

  5. Delete Individual Job: Removes an individual job from the list.

Galleries Manager

1
Galleries
Select an existing gallery, or create a new one.
2
Name
Enter or change the name for the current or new gallery.
3
Tags
Enter tag(s) for the gallery, separated by commas, which should be present on associated images.
4
Images
Set the image preferences for images appearing within the tag gallery.
5
Thumbnails Size
Sets the image preferences for thumbnails associated with images presented in as part of the gallery.
  1. Galleries: Select an existing gallery, or create a new one.

  2. Name: Enter or change the name for the current or new gallery.

  3. Tags: Enter tag(s) for the gallery, separated by commas, which should be present on associated images.

  4. Images Set the image preferences for images appearing within the tag gallery.

  5. 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.

Upload

1
Browse
Opens a file browser enabling you to select one or more image files to upload to RokGallery.
2
Upload
Initiates the upload process for selected files. You will see the upload status update during upload.
  1. 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.

  2. 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.


Found errors? Think you can improve this documentation? Please edit this page. You can also view the history of this page.