RokGallery Frontend
The frontend of RokGallery is dynamic, allowing the user to sort the gallery by: Created, Updated, Title, Loves & Views, as well as by View: Grid 3, Grid 4 and Grid 2.
In the individual image view, the file info of the original image, the slice info of the showcased image, plus its META data, are shown.
RokGallery Administrator Overview
Access the RokGallery Component at Admin → Components → RokGallery
This section is an introduction to the general interface of RokGallery, specific instructions on the functions, such as filtering, will be explained below.
#1 Image Controls
- Publish
- Unpublish
- Tag
- Delete
#2 Gallery Controls
- Jobs: A log of all previous and current operations, such as imports.
- Galleries: Create, Delete and Manage all tag galleries.
- Settings: Configuration the general aspects of RokGallery.
- Upload: A HTML5/Flash drag and drop image uploader.
#3/4 Filters
The filters have a range of variables such as gallery, file type, published etc... to allow you to sort your images for management in an efficient and simple manner. Statistics for the filters appear at #4.
RokGallery Photo Upload
RokGallery uses a HTMl5 file uploader, or Flash for unsupported browsers.
- Go to Admin → Components → RokGallery
- Click the Upload button
- Either Drag and Drop the files, or click Browse and find
- Click Upload
- Monitor progress
- Click Close once completed
RokGallery Jobs and Gallery View
All photos will appear at Admin → Components → RokGallery. RokGallery has support for multiple image selection, either by drag and highlight with the cursor, or via individual selection with the Shift Key and click.
Jobs Manager
The Jobs Manager provides you a log of operations undergoing or undergone in RokGallery. You can view:
- Import status, with time stamps
- Slice status, with time stamps
- Clear all Jobs
- Delete individual Jobs via the trash icon
- Refresh individuals Jobs via the reload icon
RokGallery Galleries Manager
RokGallery is a tagged based gallery component, therefore, Galleries are controlled by tags and not specific photos in albums. Subsequently, you can easily have one master photo in multiple albums with ease.
A single image can appear in numerous galleries based on its tag, and also can be different sizes based on the gallery settings, without editing the original image.
- Dropdown: To create a new Gallery, select Create New, or the name of another Gallery to edit it
- Name: Set the name of the Gallery
- Tags: Set the tags that are associated with the gallery (separate via a comma)
- Images: Set the maximum height and width of the full image
- Thumbnails Size: Set the height and width of the thumbnails
- Background Color: Set the background color for the thumbnail surround
- Aspect Ratio: Check if you wish to keep the dimensions of the image intact, or cropped.
Remember to Publish a Gallery after clicking Save. If you make any changes to a Gallery, whether in the Galleries Manager, or in the Image Slice Editor, you will need to re-Save in the Galleries Manager for the changes to take place on the site.
RokGallery Image Editor
RokGallery has a very advanced image editor, akin to a native application. The various parts will be discussed below.
After selecting the edit button, you will be able to edit the META data of the image, the image itself, plus delete or publish the image.
- Title: The name of the image file to be displayed on the frontend gallery
- Slug: The individual identifier for an image (we recommend not to change)
- Description: The description of the image file shown on the frontend gallery
- Tags: Add the tags that you wish to associate with the image
- Slicing: Edit the image
Publish:Show or Hide an image for specific tags/galleries.
In the Slice Editor, you can edit the META data and the actual image. You can crop the image, similar to that of an native application, with a set or variable marquee, in addition to Zoom controls. Edits in the Slice Editor are on a per gallery/tag basis.
The original image that was uploaded is maintained, as a new image is created after applying the crop. This can be reverted at any time from the Slice Editor.
Additionally, you can also Share the slice via the Share button, or Delete the image via the Delete button, from the Image Editor:
RokGallery Multi-Tagging
Tagging is at the core of RokGallery, and with its multi-selection ability, you can easily manage tags across multiple images with great ease. Simply highlight several images and click Tags. Here, you can add, remove, or change any common tags applied to your selection.
If you wanted to quickly move several images to another gallery, simply change their tag.
RokGallery Filtering
A system based on tagging needs an advanced search facility, so RokGallery employs a simple but powerful filtering mechanism:
Filter Type
- Tags
- Gallery
- Published
- File Size
- Width
- Height
Filter Operation
- Is
- Is Not
- Contains
- Does not Contain
- Greater than
- Lesser than
Order by Type (Asc/Des)
- Title
- Created At
- Updated At
- File Size
- Width
- Height
Filters are not singular and can be applied cumulatively:
Changelog
This is a non-exhaustive changelog for RokGallery, inclusive of any alpha, beta, release candidate and final versions.
Joomla 2.5.x / 3.1.x
Legend:
* -> Security Fix
# -> Bug Fix
+ -> Addition
^ -> Change
- -> Removed
! -> Note
----------- 2.26 Release [02-May-2013] -----------
BUG
# Error in details page when SEF is on for Joomla 3.1
----------- 2.25 Release [24-Apr-2013] -----------
BUG
# RokGallery breaks site, when it fails to pass requirements, and has a widget published
----------- 2.24 Release [17-Apr-2013] -----------
BUG
# Admin filter won't hide the scrollbar when inactive
# After activating RokGallery the RokGallery widget automatically appears in the Inactive Widgets
# Quick-edit breaks RokGallery Pages
# Upload error in Multisite
# Strict Standards: in /views/detail/view.html.php
# Warning: Invalid argument supplied for foreach() in /Applications/MAMP/htdocs/rtwpplain/wp-content/plugins/wp_rokgallery/widgets/rokgallery.php on line 212
NEW FEATURE
# RokBox 2 Support
----------- 2.23 Release [08-Mar-2013] -----------
BUG
# Warning: DOMDocument::schemaValidate()
# Fatal error: Uncaught exception 'InvalidArgumentException'
# Manual ordering does not work
# Uninstall needs to clean entries in rokcommon_config
# JRequest to JInput update
# "TypeError: moofx(...) is null"
# j3 settings buttons missing
# j3 settings layout issue
TASK
^ Updated moofx library
----------- 2.22 Release [27-Nov-2012] -----------
# undefined index in /router.php
# Cannot call method 'getChildren' of null gallerypicker.js: 33
# Slideshow responsive module set with no captions can potentially throw JS errors
# RokGallery failing to import files when there are a large amount of files already in the database.
----------- 2.21 Release [14-Nov-2012] -----------
# Joomla 3.0.x compatibility
# slice title breaking with special characters (such as %)
# RokGallery not obeying DB in reload of page
# Javascript file paths in RokGallery missing slashes
# RokGallery Button conflicts with 'Article Button'
# Article Rokgallery Tool Read More Cycles Endlessly
# RokGallery Editor Filter function dropdown scrollbar gets borked in Chrome
# RokCommon Library Version (2.6.2) does not match the RokCommon System Plug-in Version (2.6.1) PERSISTS
# Different thumbnail navi display for initial load and Refresh
# Slideshow.js doesn't work in IE8
# RokGallery Component screen - drag rubber band around thumbs borkage in Chrome
# Strict Standards warnings for RokGallery
# Upload percentage and bytes miscalculated in Firefox
# Notice: Undefined property: stdClass::$language_title
----------- 2.20 Release [07-Nov-2012] -----------
# Force newer RokCommon Version
----------- 2.19 Release [02-Nov-2012] -----------
# jSelectArticle override can cause possible issues with Article Picker
# strict standards in /editors-xtd/rokgallery/rokgallery.php
# issue with autoplay in chrome
# strict standards in /com_rokgallery/router.php
# Slideshow module inoperable in webkit browsers
# Fatal error: Class RokgalleryController
# fatal error and js error in module settings
# Fatal Error on RokGallery Pages with new Wordpress RokCommon
# RokGallery-Gallery-View-create-Gallery-SAVE-error-Chrome
# RokSprocket_module-create-Gallery-popup
----------- 2.17 Release [04-Sept-2012] -----------
# Captions of first slide in Slideshow not showing
----------- 2.16 Release [03-Aug-2012] -----------
# Assets not being installed causing JS errors
----------- 2.15 Release [01-Aug-2012] -----------
# Upload image gets a JSON error
# Notice on Job Creation (when uploading a file)
# RokGallery Image Slice Captions not showing correctly
# Potential JavaScript errors when element not properly rendered in the DOM
# Incorrect Paths
# Animations now use GPU when supported and fallback on CPU
# Layouts are now supporting swipe gesture for changing slide on touch-enabled devices
# GalleryPicker from the content allows to now insert responsive ready images.
# Slideshow Layout is now responsive
# New Responsive Showcase Layout
----------- 2.14 Release [27-Jun-2012] -----------
# RokGallery error in v2.13
# RokGallery_Forms_Fields_GalleryManager::getInput() error
# js conflict that only occurs in widgets overrides
# Beggining from the WP 3.4 the AJAX calls are returning 0
# Error durning saving new slice
# RokGallery doesn't load the Caption and title from slice
# sliders for drop down select lists always showing
# The Next & Previous buttons in the Gallery View (frontend) don't work
# Add no gallery selected message for frontend
----------- 2.13 Release [01-Jun-2012] -----------
# Notice when using rokgallery logo picker
# Error when using Load More on Gallery Image Picker
----------- 2.12 Release [01-Jun-2012] -----------
# Incorrect language strings for Advanced module settings
# Absent background-image parameter from custom HTML module
----------- 2.11 Release [15-May-2012] -----------
# "Uncaught exception: Unable to find Link Type page"
# Enabling 'show headings' and leaving the headings text empty wouldn't default to the Menu Item title
# wrong object type passed to view class
# Warning: Missing arguments for RokGallery_Site_DetailModel::__construct()
----------- 2.10 Release [02-May-2012] -----------
# Prev and Next buttons missing in RokBox album type popup when gallery name includes slashes or hyphens
# Animations in Showcase module weren't triggering the 'visibility', causing the read-more to overlaps each other
# rokgallery widget breaks when no gallery is selected
# Link to Full Image in RokBox not an option for Menu->Gallery Grid View
# Adding Menu Item Model Slice Editor
----------- 2.7 Release [01-Mar-2012] -----------
Bug Fixes:
# Admin Messages not firing
# On initial Install if you choose to activate plugin errors out
# Removal of RokGallery database tables was Successful! message shows on initial install without rokcommon installed
# Includes causing bad output w/o rokcommon installed
# post content disapeers with rokgallery diabled
# share button broken in slice editor
# loves js in frontend is broken
# rokgallery_rewrite_flush broken in posttype
# gantry/rokgallery js conflict breaks template overrides
# Backward Compatibility Issue with RokCommon 2.7 and RokGallery 2.6
# Broken Language String with double underscore in posttype form and language file
# Quicktags not inserting image link only image path
# the options in the gallery page (created via custom post type) aren't saving
# bulk activation of rokgallery + rokcommon causes crash
# permalink (guid in db table) saving with html encoded
Improvement:
# Replace rg_db_check() in the includes.php
New Features:
# add rokgallery button in html mode of editor
# rokgallery menu meta box needs to be checked by default in menu page
Task:
# change sliders in rokgallery post type to tabs
----------- 2.6 Release [04-Feb-2012] -----------
# Color chooser javascript broken
# frontend js is broken
# activation hooks cause an issue with symbolically linked dirs
# activation hook needs to create the uploads folder
# $slices = $slices->getData(); breaks in wp version
# Add multi-select functionality for forms
# Widget Settings not saving after platform updates
# Add post link selector popup to slice editor
# bug in the gallery selector when no galleries are defined
# Gallery sorts not showing up in frontend
# there are existing references to com_rokgallery in the rokgallery core
# RokGallery Header for WordPress needs improvement
# bug in the gallery selector when no galleries are defined
# getContent is not a function in xtd-editor plugin
- remove Functions Class
+ mootips need to be added for all forms
----------- 2.4 Release [16-Dec-2011] -----------
# Detail Page is listing incorrect Image Dimensions
# Language fixes
# editor-ext rokgallery button broken in frontend for editing
# DOM selection of Prev and Next arrows in Showcase and Slideshow isn't accurate and could get swapped in some scenarios
# RokGallery xtd-editor plugin is broken
# Create RokGallery System Plugin for 1.7, add stripping function for 1.5
# Update all file headers to match in System Plugin for 1.7
# fix issues in css whe displayed in default joomla template
# gallerypicker for menu items offers admin menu item
# Create Helper file
----------- 1.4 Release -----------
# 500 - Gallery with ID "" not found
# Uncaught exception: Could not parse dsn
# remove navigation options that are not working yet
# Galleries with spaces and underscores not interpreted by RokBox as galleries
# Page title/heading and page suffix not rendering on gallery pages
# Load More acting weird when total_items is less than the items_per_page count, causing infinite loops
----------- 1.3 Release -----------
# Module instances being removed on package update
# 500 - Gallery with ID "" not found error
# Slideshow issues and stuck on first image (Joomla! 1.7)
------- 1.2 Release -------
# Add Keep-Alive feature to com_rokgallery to stop timeouts for Ajax operations
# RokBox arrows don't appear with some Gallery Names
# Fix missing prefix in SQL for constraints
# Animations missing and not up to date in the module
------- 1.1 Release -------
# Background files being added while paging will throw off paging
# PHP safe_mode doesn't let jobs process.
# InnoDB check missing
# InnoDB should check for YES or DEFAULT in Engines
# Uncaught Exception PDO Connection
# RokGallery_Model_GalleryTable not found
# Long identifier names causing problems
+ Add parameter to enable/disable the progress loading bar when autoplay is enabled
------- 1.0 Release -------
! Initial Release
------- Initial Changelog Creation -------
Joomla 1.5.x
Legend:
* -> Security Fix
# -> Bug Fix
+ -> Addition
^ -> Change
- -> Removed
! -> Note
----------- 2.18 Release [17-Oct-2012] -----------
# Bug fixes
----------- 2.17 Release [04-Sept-2012] -----------
# Captions of first slide in Slideshow not showing
----------- 2.16 Release [03-Aug-2012] -----------
# Assets not being installed causing JS errors
----------- 2.13 Release [01-Jun-2012] -----------
# Notice when using rokgallery logo picker
# Error when using Load More on Gallery Image Picker
----------- 2.12 Release [01-Jun-2012] -----------
# Incorrect language strings for Advanced module settings
# Absent background-image parameter from custom HTML module
----------- 2.11 Release [15-May-2012] -----------
# "Uncaught exception: Unable to find Link Type page"
# Enabling 'show headings' and leaving the headings text empty wouldn't default to the Menu Item title
# wrong object type passed to view class
# Warning: Missing arguments for RokGallery_Site_DetailModel::__construct()
----------- 2.10 Release [02-May-2012] -----------
# Prev and Next buttons missing in RokBox album type popup when gallery name includes slashes or hyphens
# Animations in Showcase module weren't triggering the 'visibility', causing the read-more to overlaps each other
# rokgallery widget breaks when no gallery is selected
# Link to Full Image in RokBox not an option for Menu->Gallery Grid View
# Adding Menu Item Model Slice Editor
----------- 2.7 Release [01-Mar-2012] -----------
Bug Fixes:
# Admin Messages not firing
# On initial Install if you choose to activate plugin errors out
# Removal of RokGallery database tables was Successful! message shows on initial install without rokcommon installed
# Includes causing bad output w/o rokcommon installed
# post content disapeers with rokgallery diabled
# share button broken in slice editor
# loves js in frontend is broken
# rokgallery_rewrite_flush broken in posttype
# gantry/rokgallery js conflict breaks template overrides
# Backward Compatibility Issue with RokCommon 2.7 and RokGallery 2.6
# Broken Language String with double underscore in posttype form and language file
# Quicktags not inserting image link only image path
# the options in the gallery page (created via custom post type) aren't saving
# bulk activation of rokgallery + rokcommon causes crash
# permalink (guid in db table) saving with html encoded
Improvement:
# Replace rg_db_check() in the includes.php
New Features:
# add rokgallery button in html mode of editor
# rokgallery menu meta box needs to be checked by default in menu page
Task:
# change sliders in rokgallery post type to tabs
----------- 2.6 Release [04-Feb-2012] -----------
# Color chooser javascript broken
# frontend js is broken
# activation hooks cause an issue with symbolically linked dirs
# activation hook needs to create the uploads folder
# $slices = $slices->getData(); breaks in wp version
# Add multi-select functionality for forms
# Widget Settings not saving after platform updates
# Add post link selector popup to slice editor
# bug in the gallery selector when no galleries are defined
# Gallery sorts not showing up in frontend
# there are existing references to com_rokgallery in the rokgallery core
# RokGallery Header for WordPress needs improvement
# bug in the gallery selector when no galleries are defined
# getContent is not a function in xtd-editor plugin
- remove Functions Class
+ mootips need to be added for all forms
----------- 2.4 Release [16-Dec-2011] -----------
# Detail Page is listing incorrect Image Dimensions
# Language fixes
# editor-ext rokgallery button broken in frontend for editing
# DOM selection of Prev and Next arrows in Showcase and Slideshow isn't accurate and could get swapped in some scenarios
# RokGallery xtd-editor plugin is broken
# Create RokGallery System Plugin for 1.7, add stripping function for 1.5
# add version check for xtd-editor button, because of system plugin on event
# Missing Enable with Progress param
# fix issues in css whe displayed in default joomla template
# gallerypicker for menu items offers admin menu item
# add frontend check to rokgallery for joomla version less than 1.5.3
# Create Helper file
----------- 1.4 Release -----------
# 500 - Gallery with ID "" not found
# Uncaught exception: Could not parse dsn
# remove navigation options that are not working yet
# Galleries with spaces and underscores not interpreted by RokBox as galleries
# Page title/heading and page suffix not rendering on gallery pages
# Load More acting weird when total_items is less than the items_per_page count, causing infinite loops
----------- 1.3 Release -----------
# admin joomla menu broken when using khepri reamped in rokgallery
# 500 - Gallery with ID "" not found error
------- 1.2 Release -------
# Add Keep-Alive feature to com_rokgallery to stop timeouts for Ajax operations
# RokBox arrows don't appear with some Gallery Names
# Fix missing prefix in SQL for constraints
------- 1.1 Release -------
# Background files being added while paging will throw off paging
# PHP safe_mode doesn't let jobs process.
# InnoDB check missing
# InnoDB should check for YES or DEFAULT in Engines
# Uncaught Exception PDO Connection
# RokGallery_Model_GalleryTable not found
# Long identifier names causing problems
+ Add parameter to enable/disable the progress loading bar when autoplay is enabled
------- 1.0 Release [07-July-2011] -------
! Initial Release
------- Initial Changelog Creation -------
