Joomla Extensions

CLUB

RokStoriesLatest Version: J1.5 2.2 - J2.5/J3.0 1.13

RokStories
J 1.5J 2.5J 3.0

Easy to Use Dynamic Featured Content RokStories is a great module to display your articles and accompanying images as a featured item. The module itself is facilitated by Mootools to transition between images and articles seamlessly. Perfect for showcasing featured articles or image on your site.

RokStories provides a vast assortment of configuration options and parameters to give you more control over how your dynamic content is displayed as well as providing a lightweight and fast loading experience.

NOTICE: This extension is a legacy module available for Joomla 1.5 and 2.5. For Joomla 2.5, it has been replaced by RokSprocket.

Summary Features

  • Content Transition: The module transitions through content items, whether they are full text, a single image or combination of both.
  • Article Controls: Advanced selectors for content, choose from categories, sections and authors and control the order.
  • Customisable Opacity: Thumbnails can be set from transparent to opaque
  • Navigation Interactions: Parameters to set whether to change news by clicking or hovering over the thumbnails
  • K2 Support: Fully compatible with the powerful content constructive component K2.
  • Standalone Styling: Inbuilt theme allows the module to be used on any site.

Screenshots

RokStories

History

RokStories first made an appearance with the May 2009 Joomla Template Release, the SolarSentinel template. It was made a standalone module in June 2009 with its own independent styling to allow it to be used on any template.

Installation - Joomla 1.5

Downloading the Extension Files

  • RokStories Module (mod_rokstories.zip) This file is the module package you will use to install RokStories into Joomla.

Using the Joomla Installer

From the Menu in your Joomla Administrator, go to Extensions → Install/Uninstall.

Next, browse for your mod_rokstories.zip file you downloaded and then click Upload File & Install.

installation

Accessing the Module Page

Next, go to Extensions → Module Manager. From the list, find RokStories and open it to be brought to the RokStories Module Manager page, which lists all the available options for the module.

Requirements

RokStories has the following requirements in order to operate:-
  • Joomla 1.5x - ensure you are using the latest version

Configuration

Below is a list of options that appear in Extensions → Module Manage → RokStories.

K2 Content options only appear after the K2 component has been installed

Load built-in StyleSheet: The module has inbuilt module styling so set this to Yes if you wish for it to work standalone. As we override this file from the template, you still need to set this to Yes for the styling to work.

Layout Type: RokStories is built with two layout types, these are Showcase and Default. Showcase is a slideshow type format, with the focus on the images with preview arrows and the ability to disable the text entirely; in contrast to Default mode which is more traditional, with a series of images being display with their accompanying content. It is best to see live examples to see the differences.

Content Type: Choose between two content types, either Joomla Core Content or K2 Content. Select whichever is most applicable to your content management.

Joomla Section: If you selected Joomla Core Content as your content type, then this option allows you to specify a particular section which RokStories will load their content from.

Joomla Category: If you selected Joomla Core Content as your content type, then this option allows you to specify a particular category which RokStories will load their content from.

Joomla Frontpage Items: Set to Show if you wish to load articles that are set to appear for the Frontpage Content Component or set to Hide if you wish for them to not appear.

K2 Category Filter: If you selected K2 Content as your content type, then this option allows you control whether to load your content from all K2 Categories or make a selection from a list.

K2 Filter Items by Category: If you chose Select as your K2 Category Filter option, then this setting will become active in which you can select the categories you wish to load the module content from.

K2 Featured Items: Select between Show or Hide depending on whether you wish for the Feature Items in K2 to appear in RokStories.

Item Image Size: Specific the image size you wish to use from the K2 component. Either, XSmall, Small, Medium, Large or XLarge.

Max Number of Articles: Set a limiting value for the number of articles to publish in RokStories, this is most prominent when using default mode as each article displays a thumbnail.

Item Ordering: Set the order of the module content. For example, if you set to Oldest First then the oldest content item will be loaded in tab 1. There are a variety of options to chose from.

Allowed HTML Tags: The module automatically strips out all HTML tags and leaves just the content and the first image. This is to prevent the module from being distorted by incompatible HTML code. However, this option allows you to specify specific HTML tabs that will not be stripped, ideal if you still wish to add some diversity to your content. Simply insert the text of the tag, minus the < > elements, separated by commas such as a,i,br which will not strip all links, all italic text and line breaks.

Content Position: Either Left or Right for the position of the text, the images will be placed on the opposite side. Also, there is an option for None if you wish to use RokStories as a slideshow, best with the Showcase layout type enabled.

Show Title: Show or Hide the title being displayed from the content item.

Show Date: Control whether the creation date of the content item appears in RokStories.

Show Article: Set to Hide if you wish to display just the image and no text.

Show Link: Select whether to show the Read More button or to hide it.

Width of thumbnail (px): Set, in pixels, the width of the thumbnails, only applicable to the Default layout type.

Width of thumbnail display (px): Set, in pixels, the width of the large image, only applicable to the Default layout type.

Author: This option allows you to select articles from a particular author.

First Article: Control which content item appears first in RokStories, set the number of the article (its order number from the article manager).

Thumb Opacity: Set the opacity of thumbnails, between 0 and 1. Only applicable to the Default layout type.

Navigation Interaction: Choose between Click or Mouseover as the trigger to transition the content items.

Autoplay: Enable this option for RokStories to automatically rotate through its articles.

Autoplay Delay (ms): Set the number of milliseconds (1000 milliseconds = 1 second) for each article to appear before it rotates to the next article.

Show Label Title: Show or Hide the caption on top of the main image display. Only applicable to the Showcase layout type.

Show Previews on Arrows: Select whether to show preview of the next image when hovering over the arrows. Only applicable to the Showcase layout type.

Fixed Previews: Choose whether to have the previews in a fixed position or not. Only applicable to the Showcase layout type.

Linked Labels: Control whether the label / captions link to the full content item. Only applicable to the Showcase layout type.

Changelog

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

Joomla 2.5.x / Joomla 3.0.x

Legend:

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

------- 1.13 Release [21-Mar-2013] -------
# JRequest to JInput update for Joomla 2.5 and 3.0 compatibility
# Caching not working

------- 1.12 Release [04-Jan-2013] -------
# minor security update pertaining to a now defunct rokmodule dependency

------- 1.11 Release [20-Nov-2012] -------
# Fixed clicking rokstories left arrow not showing left hand image
# Fixed strict standards errors
+ Joomla! 3.0 Compatibility 

------- 1.10 Release [04-Jun-2012] -------
# javascript errors in showcase layout
# version 1.9 broke some thumbnail functions

------- 1.9 Release [19-Mar-2012] -------
# RokStories rt-gallery-title not showing
# Error: this.titlesFx is undefined rokstories.js Line: 12

------- 1.8 Release [13-Mar-2012] -------
# Missing Alias in SEF Link
# Rokstories Read-More menu landing page issue

------- 1.7 Release [21-Feb-2012] -------
# Fixed read more error

------- 1.6 Release [14-Feb-2012] -------
+ Added support for K2 content format to J! 2.5

------- 1.5 Release [24-Jan-2012] -------
24-Jan-2012 Djamil Legato
# Joomla 2.5 compatibility fixes

------- 1.4 Release [13-Jul-2011] -------
13-Jul-2011 Djamil Legato
# Fixed navigation issue in Showcase layout
# Fixed arrows previews

------- 1.3 Release [01-Jun-2011] -------

01-Jun-2011 Djamil Legato
# Fixed autoplay

------- 1.2 Release [20-Apr-2011] -------

20-Apr-2011 Djamil Legato
# Removed extra '>' rendered char from Layout 7
+ Added 'Random' articles ordering
# Fixed issue where full images could get loaded twice affecting a bit the performances
+ Added Layout 8

------- 1.1 Release [21-Mar-2011] -------

20-Dec-2010 Djamil Legato
# Fixed Layout 6 issue in MooTools 1.2 version under Chrome
+ Added Layout 7

------- 1.0 Release [20-Feb-2011] -------

! Initial release.

------- Initial Changelog Creation -------

Joomla 1.5.x

Legend:

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

------- 2.2 Release [20-Apr-2011] -------

20-Apr-2011 Djamil Legato
# Removed extra '>' rendered char from Layout 7
+ Added 'Random' articles ordering
# Fixed issue where full images could get loaded twice affecting a bit the performances
+ Added Layout 8

------- 2.1 Release [03-Jan-2011] -------

03-Jan-2011 Djamil Legato
# Fixed autoplay not starting correctly on load in the MooTools 1.11 version

------- 2.0 Release [22-Dec-2010] -------

20-Dec-2010 Djamil Legato
# Fixed Layout 6 issue in MooTools 1.2 version under Chrome
+ Added Layout 7

------- 1.9 Release [01-Sep-2010] -------

01-Sep-2010 Djamil Legato
+ Added Layout 6 - Scroller
# Fixed error when arrows disabled in layouts 2 and 5

------- 1.8 Release [30-Jun-2010] -------

30-Jun-2010 Djamil Legato
+ Added support for MT 1.2

------- 1.7 Release [29-Apr-2010] -------

29-Apr-2010 Djamil Legato
# Added new layout - 'Masked Showcase'
# Fixed warning error showing on >= php 5.3

------- 1.6 Release [09-Mar-2010] -------

09-Mar-2010 Djamil Legato
# Fixed links on images that didn't take on the right page

------- 1.5 Release [30-Jan-2010] -------

25-Jan-2010 Djamil Legato
# Changed ID of admin in sample data
+ Added option "Arrows Placement" that can be either 'inside' or 'outside'

------- 1.4 Release [24-Jan-2010] -------

20-Jan-2010 Djamil Legato
# Sample Data is now tied to the DB prefix of choice and not to "jos_" only
# Various IE6 and IE7 CSS fixes
+ Added new "Linked Titles" option that allows to link the articles titles.
# Fixed issue with linked images where "&"s weren't converted to "&".

------- 1.3 Release [1-Dec-2009] -------

21-Nov-2009 James Spencer
# Fixed layout3 javascript error

------- 1.2 Release [18-Nov-2009] -------

18-Nov-2009 Brian Towles
# Added bug fix for PHP 5.3

------- 1.1 Release [23-Oct-2009] -------

23-Oct-2009 Djamil Legato
+ New Layout (Layout 4)

28-Oct-2009 James Spencer
+ Added disable preview arrows option
^ Updated the show/hide label title option

------- 1.0 Release [31-Aug-2009] -------

28-Aug-2009 Djamil Legato
+ New Layout

------- 0.9 Release [17-Aug-2009] -------

17-Aug-2009 Djamil Legato
# Fixed issue on Linked Images

------- 0.8 Release [12-Aug-2009] -------

12-Aug-2009 Djamil Legato
+ Multiple instances of RokStories is now possible
+ Added multi-language support for Read More button

------- 0.7 Release [1-Aug-2009] -------

31-Aug-2009 Djamil Legato
# Fixed a minor warning thrown using Firefox

------- 0.6 Release [26-Jun-2009] -------

26-Jun-2009 Andy Miller
# Fixed issue with margins when you swapped the content sides

26-Jun-2009 Djamil Legato
# Fixed content height calculation that was returned wrong when the page loaded too fast
# CSS minor fixes
+ Layout2 implementation with previewers: Showcase!
+ CSS for Layout2
# Fixed a JS error when no content was published in RokStories
+ You can now choose the content position (left/right)

------- 0.5 Release [25-Jun-2009] -------

24-Jun-2009 Andy Miller
+ Added support for K2 content format
+ Added checks for K2 installation in the module params
+ Added date option
+ Added more extensive ordering options
# Fixed the scenario of changing the thumb size without deleting images

24-Jun-2009 Djamil Legato
# Issue on Import Data that in one case didn't error out correctly
^ Width of thumbnail display is now fixed
+ Width of thumbnail display allows 'auto' option that will set the width based on the full image size
# Safari issues on load rendering
# Fixed CSS rule that wasn't showing the Spinner
# Check for Thumbnail class existence to avoid conflicts

------- 0.4 Release [16-Jun-2009] -------

16-Jun-2009 Djamil Legato
+ Default Light and Dark themes
+ Option to disable builtin CSS and theme
+ Built-in RokModule check
+ Import Sample Data directly from the module
+ Options for enabling/disabling title, article, link

------- 0.3 Release [03-May-2009] -------

03-May-2009 Djamil Legato
# Fixed subpages problem
# SEF fix

------- 0.2 Release [30-Apr-2009] -------

30-Apr-2009 Djamil Legato
# Various fixes

------- 0.1 Release [29-Apr-2009] -------

! Initial release. 

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