Club Free Legacy

Joomla Extensions

FREE

RokSprocketLatest Version: J2.5 / J3.1 1.8.10

RokSprocket
Joomla 2.5Joomla 3.1

A Revolutionary Multi-Purpose Content Module RokSprocket is a revolutionary new extension for Joomla 2.5 designed to give you an incredible level of control over how you present your content. Sophisticated content filters, robust layout modes and options, integration with multiple content providers, and a streamlined no-nonsense interface all contribute to a powerful yet user friendly experience from start to finish.

Extension Features

  • Multiple layout options: Features, Tabs, Lists, Mosaic & Headlines
  • 7 supported content providers: Joomla, K2, Seblod, EasyBlog, Content Builder, FieldsAttach, & Zoo
  • Advanced cumulative filters: specific and dynamic filters
  • Advanced sorting rules: automatic, manual, mixed or random
  • Individual article display and configuration
  • Inline article previews
  • Inline article details and editing
  • RokGallery/MediaManager support
  • Dynamic settings / configurations
  • Module shortcodes

Advanced Custom Administrator

RokSprocket has a custom control interface, built with ajax to be intuitive, user friendly and powerful.

RokSprocket

Layout Modes

RokSprocket has multiple layout modes to display your content: Features, Tabs, Lists, Mosaic & Headlines.

Features

Features is a content slideshow/showcase layout mode. It can display both images and text, or images only, with varying options on their display.

RokSprocket

RokSprocket

Lists

Lists is a vertical display content mode, with accordion support.

RokSprocket RokSprocket

Tabs

Tabs is a tabbed content display mode, presenting content in dynamically sizing tabs.

RokSprocket RokSprocket

Mosaic

Mosaic displays content dynamically in blocks, that can be rearranged via tags or ordering commands.

RokSprocket

Headlines

Headlines is a content ticket layout mode. It can displays lines of text in succession.

RokSprocket

RokSprocket

Installation - Joomla 2.5.x

  • Download the latest roksprocket.zip from the RokSprocket Download section (see right).
  • Install at Admin → Extensions → Install/Uninstall → Choose File → Select file → Upload File & Install

RokSprocket

  • Upon successful installation, you will see the install notices. If performing an update, some will appear blue.

RokSprocket

  • Go to Extensions → Module Manager → New → RokSprocket Module to create a RokSprocket module.

RokSprocket

RokSprocket

Basic Module Controls & Info

The content provider and layout type of every RokSprocket instant appears in the module manager listing.

RokSprocket

RokSprocket has a fully customized module interface, which includes all the typical options associated with a module such as title.

RokSprocket

  • 1. Module title
  • 2. Position name
  • 3. Module options (tabbed)
  • 4. Show/Hide module title
  • 5. Publish/Unpublish module
  • 6. Set access, e.g. Public
  • 7. Module shortcode
  • 8. Current content provider/layout type
  • 9. RokSprocket version

Module Shortcode

Every RokSprocket module has its own unique shortcode. Copy the entire reference, such as [module-155], into an article and it will load RokSprocket inside of the content.

Note: This uses the same functionality as the {loadposition POSITION_NAME} plugin built within Joomla, but circumvents the need to create a module position.


Content Provider & Layout Type

RokSprocket has support for several content providers/CCK, as well as multiple layout options:

Content Provider(s):

  • Joomla
  • Zoo
  • Seblod
  • K2

Layout Type(s):

  • Features
  • Headlines
  • Lists
  • Tabs

RokSprocket RokSprocket


Joomla Content Filter Rules

RokSprocket has a powerful content selection and ordering system, providing you with the tools to display content in a manual, dynamic or mixed fashion, via an user friendly, intuitive interface.

RokSprocket

Add Specific Articles

The first method of filtering is Add Specific Articles, which allows you to manually select articles, regardless of category.

RokSprocket

Click Add Specific Articles then the document icon that appears in the inputbox. This will load the article selection popup. Select your article.

RokSprocket

You can add as many articles as you like. Select the + or — icons to add or delete articles.

RokSprocket

Add Filters

The second method of filtering is Add Filter, where you can select articles through rules, such as category. These are cumulative so you can use several at once to create super filters.

RokSprocket

  • Title: 'contains', 'beings with', 'ends with' or 'is'; Text.
  • Alias: 'contains', 'beings with', 'ends with' or 'is'; Text.
  • Article Text: 'contains'; Text.
  • Published: 'yes' or 'no'.
  • Featured: 'yes' or 'no'.
  • Category: List of Categories.
  • Created Date: 'within last', 'exactly', 'before', 'after', 'today', 'yesterday', 'this week', 'this month' or 'this year'; Number; 'days', 'weeks', 'months' or 'years'.
  • Last Modified Date: 'within last', 'exactly', 'before', 'after', 'today', 'yesterday', 'this week', 'this month' or 'this year'; Number; 'days', 'weeks', 'months' or 'years'.
  • Last Modified By: Popup of all Users.
  • Author: Popup of all Users.
  • Rating: 'equals', 'greater than', 'less than', 'is not'; Number.
  • Hits: 'equals', 'greater than', 'less than', 'is not'; Number.
  • Language: List of all Languages.
  • Access: List of all Access Groups.

Sorting

There are three sorting options: Automatic, Manual and Random.

Automatic sort: 'ascending' or 'descending':

RokSprocket

  • Title
  • Alias
  • Category
  • Created Date
  • Last Modified Date
  • Last Modified By
  • Author
  • Rating
  • Hits

Manual sort:

You can manually arrange the articles display in the left pane via the move icon/button. Also, you can combine automatic and manual sort by specifying automatic sort criteria for new articles added before or after the sort.

RokSprocket

For example, you can manually sort the first three articles, then have the rest ordered automatically, such as by ascending category.

RokSprocket

Random sort: This will randomly sort your filtered articles.


Article Display & Configuration

Articles are displayed dynamically based on the filtering/sorting criteria set. You can configure article specific options and preview details.

RokSprocket

  • 1. Article Title
  • 2. Category of Article
  • 3. Preview article / article info
  • 4. Show/Hide article configuration
  • 5. Article creation date/time
  • 6. Move / ordering icon
  • 7. Configuration options

Preview Article / Article Info

Select the eye icon in the article display to preview the article. Note: Template styling will not be applied, this is raw output only.

RokSprocket

Hover over the info icon in the article display to view the article details. You can Edit the article from this view.

RokSprocket

Configuration Options

Each Layout Mode has its own configuration options, inclusive of: Title, Description, Image, Link, Icon. Note: Only options that are applicable to the layout mode will be displayed.

RokSprocket

There are up to 5 properties available for each option:

  • None: Does not display the element.
  • Default: Displays the default, as configured in the layout mode settings.
  • Article {property}: Displays the associated element from the article.
  • Custom: Display a custom value.
  • MediaManager/RokGallery: Load a specific image from the image source selected.

RokSprocket RokSprocket RokSprocket

RokSprocket RokSprocket

Layout Mode Specific Configuration Options:

Features:

  • Title
  • Description
  • Image
  • Link

Headlines:

  • Image
  • Link

Lists:

  • Title
  • Image
  • Link

Tabs:

  • Title
  • Icon
  • Link

Layout Options

Configuration options will appear dynamically based on what layout type you have chosen. Hover over the various options to reveal tips describing the parameter.

RokSprocket

Features

Features is a content slideshow/showcase layout mode. It can display both images and text, or images only, with varying options on their display.

RokSprocket
  • Display Limit: Set the number of articles to display (0 for unlimited).
  • Theme: Choose between Slideshow or Showcase.
  • Article Titles: Show or Hide the individual article titles.
  • Article Text: Show or Hide the individual article text.
  • Arrow Navigation: Show, Hide or only Show on Hover, the navigation arrows.
  • Pagination: Show or Hide, the page indicators.
  • Animation: Crossfade, Top to Bottom, Right to Left, Bottom to Top, Left to Right, Top-Right to Bottom-Left, Top-Left to Bottom-Right, Bottom-Left to Top-Right, Bottom-Right or Randomize.
  • Autoplay: Enable or Disable the automatic transitioning of panes.
  • Autoplay Delay: Set the number of seconds between autoplay transitions.
  • Image Resize: Enable or Disable, and set the Max Width and Max Height, of the images.

Article Defaults:

Configure the default options, as used in the left pane for individual article configuration.

  • Default Title: None or Article Title.
  • Default Article Text: None or Article Text.
  • Default Article Image: None, Article Image, Custom, Intro Image or Full Image.
  • Default Link: None, Article Link, Custom, Link A, Link B or Link C.

Headlines

Headlines is a content ticket layout mode. It can displays lines of text in succession.

RokSprocket
  • Display Limit: Set the number of articles to display (0 for unlimited).
  • Label Text: Set the text of the label prefixing the articles.
  • Preview Length: Set the number of words to be displayed.
  • Arrow Navigation: Show or Hide, the navigation arrows.
  • Animation: Slide and Fade, Fade or None.
  • Autoplay: Enable or Disable the automatic transitioning of panes.
  • Autoplay Delay: Set the number of seconds between autoplay transitions.
  • Image Resize: Enable or Disable, and set the Max Width and Max Height, of the images.

Article Defaults:

Configure the default options, as used in the left pane for individual article configuration.

  • Default Article Image: None, Article Image, Custom, Intro Image or Full Image.
  • Default Link: None, Article Link, Custom, Link A, Link B or Link C.

Lists

Lists is a vertical display content mode, with accordion support.

RokSprocket
  • Display Limit: Set the number of articles to display (0 for unlimited).
  • Collapsible Preview: Enable or Disable an accordion format.
  • Preview Length Set the number of words to be displayed.
  • Preview per Page: Set the number of articles page.
  • Arrow Navigation: Show or Hide, the navigation arrows.
  • Pagination: Show or Hide, the page indicators.
  • Autoplay: Enable or Disable the automatic transitioning of panes.
  • Autoplay Delay: Set the number of seconds between autoplay transitions.
  • Image Resize: Enable or Disable, and set the Max Width and Max Height, of the images.

Article Defaults:

Configure the default options, as used in the left pane for individual article configuration.

  • Default Title: None or Article Title.
  • Default Article Image: None, Article Image, Custom, Intro Image or Full Image.
  • Default Link: None, Article Link, Custom, Link A, Link B or Link C.

Tabs

Tabs is a tabbed content display mode, presenting content in dynamically sizing tabs..

RokSprocket
  • Display Limit: Set the number of articles to display (0 for unlimited).
  • Tab Position: Top, Bottom, Left or Right.
  • Animation: Slide and Fade, Fade or None.
  • Autoplay: Enable or Disable the automatic transitioning of panes.
  • Autoplay Delay: Set the number of seconds between autoplay transitions.
  • Image Resize: Enable or Disable, and set the Max Width and Max Height, of the images.

Article Defaults:

Configure the default options, as used in the left pane for individual article configuration.

  • Default Title: None or Article Title.
  • Default Article Icon: None, Article Image, Custom, Intro Image or Full Image.
  • Default Link: None, Article Link, Custom, Link A, Link B or Link C.

Other Module Options

Typical additional/advanced module options are contained with the RokSprocket tabbed interface.

Click on Assignments to designate which pages the particular RokSprocket module will appear on.

RokSprocket

Click on Advanced to control various settings, such as Caching and Module Class Suffix.

RokSprocket

Empty Ordering in Mosaic not kept

Due to a limitation of Joomla!, whenever you have a form field saved as empty, after saving it will get reverted to its default value found in the XML

This is the case with Ordering in Mosaic too. If you remove all the Ordering types and save, the next time they will be reverted to what's default in the XML: Default, Date, Title, Random

If you really need an empty Ordering, the only workaround is to overwrite that portion of XML from whitin your template.

Assuming you are on Metropolis, you want to change directory to /templates/rt_metropolis/roksprocket/layouts/mosaic/ and in here create (or edit if already present) a file named options.xml

Inside the options.xml file you want the following content:


<config>
<fields name="params">
<fieldset name="roksprocket" overwrite="true">
<field name="mosaic_ordering" type="multiselect" default="" label="ROKSPROCKET_ORDERING" description="ROKSPROCKET_ORDERING_DESC" optionorder="59" class="layout layout_mosaic">
<option value="default">ROKSPROCKET_MOSAIC_ORDERING_DEFAULT</option>
<option value="title">ROKSPROCKET_MOSAIC_ORDERING_TITLE</option>
<option value="date">ROKSPROCKET_MOSAIC_ORDERING_DATE</option>
<option value="random">ROKSPROCKET_MOSAIC_ORDERING_RANDOM</option>
</field>
</fieldset>
</fields>
</config>

Changelog

This is a non-exhaustive changelog for RokSprocket, inclusive of any alpha, beta, release candidate and final versions.

Joomla 2.5.x / 3.0.x

Legend:

* -> Security Fix
# -> Bug Fix
+ -> Addition
^ -> Change
- -> Removed
! -> Note

----------- 1.8.10 Release [01-May-2013] -----------

BUG
# Extra reload of Mosaic once the page loads to ensure everything is in place

IMPROVEMENT
# More accurate autoplay delay now waits for all the animations to end before starting to count again

----------- 1.8.9 Release [24-Apr-2013] -----------

BUG
# v1.8.8 Not working with Advanced Module Manager and Caching
# RokSprocket breaks site, when it fails to pass requirements, and has a widget published

----------- 1.8.8 Release [22-Apr-2013] -----------

BUG
# "LOAD MORE" "LOAD ALL" message toggle only works on first roksprocket mosaic of page
# Can't add specific articles if there's an apostrophe in the title
# RokInjectionModule unpublished module issue
# workaround for invasive and non-joomla techniques used by Advanced Module Manager
# issue with html thats breaking roksprocket admin with the em tag for WP version
# Error while retrieving the Filters DataSet:
# CLONE - After activating RokSprocket the RokSprocket widget automatically appears in the Inactive Widgets
# CLONE - Warning: Invalid argument supplied for foreach() in /Applications/MAMP/htdocs/rtwpplain/wp-content/plugins/wp_rokgallery/widgets/rokgallery.php on line 212
# 'getFromPath' issue when MooTools More was not loaded.
# untranslated language strings in admin for RS
# bug in seblod getAuthors() function in seblod items.php

NEW FEATURE
# Add shortcode replace to widget texts 
# Strips Layout. Shows strips of blocks and cycle through them choosing between 8 different animations.

----------- 1.8.7 Release [12-Mar-2013] -----------

BUG
# wrong number of items retrieved via ajax
# roksprocket "load all" does not load all
# easyblog Integration - problem with 'featured' filter

----------- 1.8.6 Release [08-Mar-2013] -----------

BUG
# Warning: DOMDocument::schemaValidate()
# Fatal error: Uncaught exception 'InvalidArgumentException'
# Errors on some layouts when no items present for layouts
# Load more button can be clicked only once and then disappears
# Roksprocket not honoring filter for K2 provider in front-end
# RokSprocket Tabs issue with showing K2 article images.
# Unable to load renderer class in ADMIN
# Error: All changes have been successfully saved.

IMPROVEMENT
# Warning: Division by zero
# load english language in admin for non-english sites

----------- 1.8.5 Release [01-Mar-2013] -----------

BUG
# Issue with missing rendering module using RokInjectModule

----------- 1.8.4 Release [27-Feb-2013] -----------

BUG
# the "ALL" keyword is missing in Mosaic language file
# Uninstall needs to remove roksprocket entries from the rokcommon_config table
# Issues when passing content to Joomla content plugins
# Not picking up extra field defined image fields for K2
# wrong number of items retrieved via ajax

IMPROVEMENT
# Remove duplicate sql query runs on data retrieval
# Optimize Provider field lookup queries

----------- 1.8.3 Release [01-Feb-2013] -----------

BUG
# RokInjectModule ignores published/unpublished status
# js errors when there is no content to display
# Rocksproket and Easyblog ACL problem
# Warning: Invalid argument supplied for foreach() in /components/com_roksprocket/lib/RokSprocket/Provider/K2.php on line 180
# module settings not displaying correctly with missioncontrol
# resetting 'display limit' or 'preview length' to infinity not working
# Bad styling for RokSprocket Popup window
# Wrong styling when you click on the top buttons in RokSprocket admin
# RS Not Retrieving nested categories in WP
# Drafts appearing on frontend of RS in WP
# 3rd party SEF issues
# After activating RokSprocket the RokSprocket widget automatically appears in the Inactive Widgets
# Manual ordering not working in certain situations
# JS checks to prevent the layouts scripts to fail in extremely rare cases
# double slash created by JSON request
#  JRequest to JInput update for Joomla 2.5 and 3.0 compatibility
# Fatal error: Call to undefined function roksprocket_checktoken()
# UTF BUG + Fix
# Layouts are displaying wrong author name
# Loading of MooTools More in case of Lists using the Accordion setting
# json error while savin and strict standards in /Zoo/Filter.php on line 66
# strict standards in /Provider/Zoo.php on line 155
# roksprocket lists arrows not hiding
# Error when activating RokSprocket
# Strict standards: Creating default object from empty value

IMPROVEMENT
# Duplicate articles in Mosaic if "Random sort" is set under "Content Filter Rules"
# Filtered Article List is always empty
# non-default path settings not being used for images
# Content Plugins need to be run before the truncate process
# WP Duplicate articles in Mosaic if "Random sort" is set under "Content Filter Rules"

TASK
# Updated moofx library

----------- 1.8.2 Release [16-Nov-2012] -----------
# Random transition in showcase can cause the slides to get stuck in offset positions
# error while trying to insert image into post via Mmage Library
# Error while trying to remove a RokSprocket item
# Issue when xcache is configured on the host incorrectly.

----------- 1.8.1 Release [07-Nov-2012] -----------
# RokSprocket not showing for module edit in some cases on J2.5

----------- 1.8.0 Release [01-Nov-2012] -----------
# Fixed styling not pulled from assigned template
# Fixed mosaic column layout issues in certain browsers
+ Joomla 3.0 Compatibility

----------- 1.6.1 Release [04-Sept-2012] -----------
# roksprocket mosaic is not using article alias
# Words previews limiter not working properly with non-latin characters
# Animation issue in Opera preventing callbacks to be triggered      

# Mosaic optimizations: Devices with orientation change capability will trigger a redraw of mosaic to keep things in order
# Limit front end queries based on Display Limit
# Speed up Joomla SEF route determination

----------- 1.6.0 Release [01-Aug-2012] -----------
# Per-article parameter tooltips shouldn't render HTML as it could potentially break the rest of the page
# Ajax returned HTML is not honoring proper SEF rendering
# Missing Select in Admin - Lists Layout uses Text field in frontend but has no selection for it in the back
# Two description text field selectors in admin on right side for zoo
# Missing Image for New Providers in drop down list
# Storage Filter in article picker not affecting results
# Default Article Image Dropdown language string for EasyBlog needs changed
# content builder custom image not appearing in front end of mosaic
# Features Layout: fast click on arrows can potentially break the layout
# still an extra selector for Zoo Features Article Defaults
# Incorrect urls being generated for ajax load more calls.
# Preview of per-item (eye icon) is broken
# easyblog options show seblod in title
# easyblog articles not showing in preview and not appearing on frontend
# Features animation not working properly on IE7

# Add EasyBlog content provider
# Description per-article parameter needs some user-friendly concept for giving more room to write in
# Ability to disable author and created date in Mosaic view
# Add support for filtering on Created By Alias
# Features, Lists, Headlines and Tabs Layouts are now supporting swipe gesture for changing slide on touch-enabled devices
# Add Excerpt and Content Fields to text selector in Easy Blog Provider
# Words count in preview length parameter now takes into account HTML tags
# Add support for selectable main content for headlines and tabs layouts
# Added filters for Publish Up and Publish Down

# Fields Attach Integration
# Set the default text to be the "MetaDescription"
# Mosaic is now built-in
# Responsive logic and JS hooks
# Add support for Easy Blog
# Add Support for Content Builder
# Add support for Fields Attached

----------- 1.5.6 Release [27-Jun-2012] -----------
# non-matching ids for images, links, and texts for SeBlod
# Default image not always being set for SeBlod when images only exist in custom fields
# getter and setter for publish up and down date sometimes returning null
# SeBlod not retrieving custom field data not stored in introtext or fulltext fields
# Extra Select List field appearing in non-Joomla providers

----------- 1.5.5 Release  [09-Jun-2012] -----------
# Error when setting link via default on per item

----------- 1.5.4 Release  [07-Jun-2012] -----------
# Lists: Failing to strip HTML when ... isn't triggered
# Roksprocket load more spins infinitely - "INVALID JSON DATA"
# Warning when default per item link is set but there is no default link.

----------- 1.5.3 Release [01-Jun-2012] -----------
# The parameter "roksprocket.layouts.mosaic" must be defined.
# Internal 500 error on Save module
# When you set RokSprocket to automatically add new articles, article title and read more link are not generated at the frontend
# RokSprocket does not honor publish up and down dates.
# Random SORT ORDER hangs Mosaic on front-end
# Joomla and Seblod trashed articles showing up in module
# Roksprocket should gracefully handle "no content" in Headlines

----------- 1.5.2 Release [03-May-2012] -----------
# Incorrect fixed image size in features showcase layout
# Ajax save not keeping the value of certain dropdowns after success
# Label of per-article item in Tabs layout is now named "Tab Label" rather than just "Title"
# Updated moofx library
# New Tags and Multiselect custom fields            

----------- 1.5.1 Release [01-May-2012] -----------
# Incorrect fixed image size in features showcase layout
# Ajax save not keeping the value of certain dropdowns after success
# Label of per-article item in Tabs layout is now named "Tab Label" rather than just "Title"
# Updated moofx library
# New Tags and Multiselect custom fields

----------- 1.5 Release [10-Apr-2012] -----------
# K2 SEF Urls not getting fully article alias
# Append '...' in Lists and Headlines only when there's more text to show
# Layouts with Autoplay disabled were throwing an error on Frontend
# Failure when saving module with "Save as Copy"
# Duplicating a module from the Modules Manager won't copy over the per-article items
# Cached images loading from Ajax have the wrong pathing
# Huge speed improvements on back-end
# Layouts coming from template have no way to inject language items
# Setup per layout language files and cleanup i18n in general

----------- 1.4 Release [02-Apr-2012] -----------
# Fixed upgrade problem with Joomla 2.5.4

----------- 1.3 Release [02-Apr-2012] -----------
# Fix issue with RokSprocket Tabs layout non-active image hyperlinks bleed through to active panel
# Features showcase autoplay wouldn't cycle when pagination is hidden
# Access is duplicated with Advanced Module Manager
# Custom Titles in Tabs not picking up as expected
# Invalid JSON errors when articles contain invalid JSON
# Save of module doesn't keep per item params of non-displayed articles
# CSS and JS in admin have a version appended to force a cache clear on new updates
# Updated moofx library

----------- 1.2 Release [19-Mar-2012] -----------
# Fixed Development mode issues in plugin
# Double modal popup on page load for the Images Picker caused by events attached twice
# Per Item parameters not having quotes removed in when magic_quotes_gpc is on
# Fix Issue with Layouts where titles rendered the full article rather than the article title itself
# Fixed Issue with Layouts and "Article Link" in SEF mode
# Better handling of accordion indicator in multi-line titles
# Image missing from lists layout
# Warning happening when system temp directory is accessed in some instances
# Full Advanced Module Manager compatibility
# Lists Layout now links the title if a link is detected
# Implemented auto-play functionality for Headlines, Lists and Tabs
# Animations Dropdown in Features have now a representation of how the animation is going to look like
# Implemented "Load More" system for Admin
# Layout specific image resizing support
# Added Show/Hide toggler to display per-article fields

----------- 1.1 Release [08-Mar-2012] -----------
# Per Item fields assigned to Article not properly inheriting the expected value
# Missing "php" on a php <? open tag causing issues with shorttags disabled
# Image Picker not always attaching the modal on a new Module Creation
# Showcase arrows events were not attached properly causing the navigation to be stuck
# Language strings don't get translated on rendering.
# Moved phpQuery library to single-file implementation
# Per Item images set to "Article Image" were storing an unhandled value
# Roksprocket version not showing up correctly
# Fixed animations issues on Features for Firefox versions prior 4
# Ajax Save of a RokSprocket Module in IE9 leads to a blank page redirect with JSON strings.
# Features layout title, description and link elements not collapsing
# Features layout read more button not positioned properly
# K2 has bad path for images
# Implemented button to easily copy to clipboard the Shortcode
# Remove necessity of XSL PHP extension.


----------- 1.0 Release [01-Mar-2012] -----------
! Initial Release

------- Initial Changelog Creation -------
Member Login: