Demo Articles

The following is a guide that covers how to set up your new template on your Joomla site. Here you can find an overview of the files included in the Refraction release and instructions on installing and activating the template in your Joomla install.

[span class=attention] Video Tutorial Currently Available! Launch the Joomla Template Installation Video Tutorial now! [/span]

Downloading the necessary files

The first step is to download all the necessary files needed for installation, setup and configuration. Below is a summary of each of the available packages for the Refraction release. [list class=bullet-1][li]Refraction Template (rt_refraction_j15.tgz) This file is the template package you will use to install your template into Joomla.[/li] [li]Refraction Custom Extensions (refraction-extensions-j15.zip) This package contains each of the individual custom extensions included in the Refraction template release.[/li] [li]Refraction Source PNG(s) (refraction-sources.zip) This zip contains the source PNG(s) for making modifications and customisations to the images in the template (and if applicable, the font used for the logo). You will need an image editing software (preferably Adobe/Macromedia Fireworks) to utilise the Source PNG files. [/li] [li]Refraction RocketLauncher (Joomla_RT_Refraction_j15.zip) This is the RocketLauncher pack for Refraction which is a complete and separate Joomla install which has the template pre-installed and configured. Similarly, the demo content is injected and the extensions are also pre-installed.[/li][/list]

Step 1 - Using the Joomla installer

Navigate to the Joomla administrator (http://yoursite.com/administrator) for your site. Along the top menu bar, go to Extensions → Install/Uninstall. Next, select the browser button and locate the rt_refraction_j15.tgz package on your computer that you downloaded. Then, click Upload File & Install. After installation, an introduction page will appear with the template's name, description and thumbnail, select Continue when this page appears. You should now see rt_refraction_j15 in the list of installed templates.

Step 2 - Making Refraction Default

In the Joomla Administrator, navigate to Extensions → Template Manager. You will be directed to a page which lists all the installed templates. Locate rt_refraction_j15 in the list. Select the radio button / circular icon to the left of the name. Then select the Default in button menu in the top right area of the Administrator. The Refraction template will now be the default template on your Joomla site.
[tutorial url="index.php?option=com_content&view=article&id=62&Itemid=69" img="images/stories/demo/tutorial/icon1.png" title="Installation" label="Read More..."]An overview of template files and instructions for installing and activating the template.[/tutorial] [tutorial url="index.php?option=com_content&view=article&id=63&Itemid=70" img="images/stories/demo/tutorial/icon3.png" title="Menu Options" label="Read More..."]An overview of the menu options including the top menu icon configuration.[/tutorial] [tutorial url="index.php?option=com_content&view=article&id=55&Itemid=62" img="images/stories/demo/tutorial/icon2.png" title="Extensions" label="Read More..."]Learn all about the included custom extensions and how to configure them for your site.[/tutorial] [tutorial url="index.php?option=com_content&view=article&id=64&Itemid=71" img="images/stories/demo/tutorial/icon4.png" title="Configuration" label="Read More..."]A guide to the many configurable options that can be selected within the template manager.[/tutorial] [tutorial url="index.php?option=com_content&view=article&id=65&Itemid=72" img="images/stories/demo/tutorial/icon7.png" title="Logo Editing" label="Read More..."]An overview for customizing your logo and replacing the logo text with your organization or company name and logo.[/tutorial] [tutorial url="index.php?option=com_content&view=article&id=66&Itemid=73" img="images/stories/demo/tutorial/icon5.png" title="Using Typography" label="Read More..."]A guide to using the included the typography styles for your site.[/tutorial] [tutorial url="index.php?option=com_content&view=article&id=67&Itemid=74" img="images/stories/demo/tutorial/icon6.png" title="Demo Content" label="Read More..."]A look at some of the modules and techniques used in the demo content on the frontpage of this demo.[/tutorial] [tutorial url="index.php?option=com_content&view=article&id=68&Itemid=75" img="images/stories/demo/tutorial/icon8.png" title="IE6 PNG fix" label="Read More..."]An overview of how to utilise and understand the Internet Explorer 6 PNG fix.[/tutorial] [contentheading]More Refraction Template Tutorials[/contentheading]

Continue learning how to configure and customize the Refraction template with the following guides and tutorials available in the RocketTheme members forum board.

RokBox, the successor of our popular RokZoom plugin, is a mootools powered JavaScript slideshow that allows you to quickly and easily display multiple media formats including images, videos (video sharing services also) and music. RokBox provides a theme system that allows you to create your own custom ones to fit your websites design. It includes two predefined themes, a Light theme and a Dark theme that will fit seamlessly into your site design. RokBox is as easy as pie to install and customize, providing an easy way to create your own custom themes for it.

[span class=alert]Please note that RokBox is not part of the template but is an independent download from http://www.rocketwerx.com/products/rokbox/overview.[/span]

RokBox comes in 3 formats. A standalone HTML/JavaScript solution for inclusion in any website or page; A Joomla 1.0 plugin, and a Joomla 1.5 plugin. Each Joomla! plugins come with a system and a content plugin.

We highly recommend using RokBox in Joomla 1.5 for optimal performance and ease of use.

Screenshots

[rbxshot img="http://rocketwerx.com/images/rokbox/sshot1_thumb.jpg"]RokBox Light Theme :: A screenshot of an image shown with RokBox in the default light style[/rbxshot] [rbxshot img="http://rocketwerx.com/images/rokbox/sshot2_thumb.jpg"]RokBox Dark Theme :: A screenshot of an image shown with RokBox in the optional dark style[/rbxshot] [rbxshot img="http://rocketwerx.com/images/rokbox/sshot3_thumb.jpg"]RokBox System Plugin Prefernces :: The plugin is fully configurable via the system plugin prefences parameters[/rbxshot]

Features

  • Mootools v1.11 compatible
  • 4 Customizable Transition Type: Fade, QuickSilver, Growl, Explode.
  • Support for Images, QuickTime (.mov), Windows Media Video (.wmv), Flash (.swf), YouTube, DailyMotion, MetaCafe, Google Video, Vimeo, Audio (.mp3, .wav), local and remote sites.
  • Support for albums/categories.
  • Support for Captions including support for titles and descriptions.
  • 2 Predefined Themes provided: Light Theme, Dark Theme.
  • Support for custom themes with ability to customize styles and RokBox configuration per theme.
  • Ability to auto-generate thumbnails when RokBox-ing local images.
  • Support for generate thumbnail or inline links from your Joomla! Content.

History

RokBox is a Joomla! plugin inspired by the now famous LightBox, but with a large support for multimedia content and not only images. RokBox is written by Djamil Legato.

Demo

To see an extensive demo of RokBox with descriptions and syntax, please visit http://www.rocketwerx.com/products/rokbox/demo
RokCandy is a new component from RocketTheme which provides BBcode type functionality into Joomla. Therefore, you do not need to worry about the WYSIWYG editor stripping out your custom code, or worry about your HTML abilities in order to use the various Typography and other styled elements. It changes the preset syntax, such as [example] to the relevant HTML code, once Joomla parses the article. What does that mean? Well, it means if you type [example] into your content, whether in HTML or normal WYSIWYG mode, it will always show [example] and will not be stripped away on save or reopen. All the changing to HTML, is done via Joomla when it outputs the article onto the site itself.

[rbxshot img="images/stories/demo/general/rokcandy-ini-thumb.jpg"]RokCandy default.ini file[/rbxshot] [rbxshot img="images/stories/demo/general/rokcandy-admin-thumb.jpg"]RokCandy Administrator[/rbxshot]

For example, [example title={title}]{text}[/example] can be set to output the following:-
<div class="example">
	<h3>Title</h3>
	<p>Some content</p>
</div>

How do I configure RokCandy, the Syntax?

RokCandy is outfitted with prebuilt statements, however, with the overriding ability of Joomla 1.5, you can create new ones and override them in the template files, and not have to concern yourself with editing core files. The file is called default.ini and is located in the /templates/rt_refraction_j15/html/com_rokcandy directory. Similarly, you can also add and control your own in the Administrator (Admin > Components > RokCandy). They will appear in the following format:-

[tag]{text}[/tag]=<tag>{text}</tag>
Such as
[alert]{text}[/alert]=<span class="alert">{text}</span>
As is apparent, each line is separated into distinctive sections. There are two parts, the RokCandy syntax (left of =) and the outputted HTML (right of =). You would create your own tag name and insert them between square brackets, [], followed by {text} and the closing tag with [] brackets again. This segment is followed by the = symbol and following on from that is the HTML output. Note, the {text} is required in both parts to denote what element is to be carried forward. You can use any value between the {} brackets, such as {title} or {link} as long as they are cross referenced in the HTML output as shown in the example below:-
[box title={title} link={link}]{text}[/box]=<div class="box"><h3><a href="{link}">{title}</a></h3><p>{text}</p></div>

[span class=attention]Note, the best way to understand the syntax rules is to look at the default.ini file and see what syntax we use.[/span] [readon url="index.php?option=com_content&view=article&id=56&Itemid=67"]RokCandy Examples[/readon]
RokNavMenu is now an essential ingredient of the RocketTheme templates. It provides various functions which are above and beyond what the mainmenu, and the subsequent template overrides. Therefore, much more sophisticated menus can be constructed providing you with a much greater degree of usability. It is an essential install for the integrated menu systems to operate.

How do I configure RokNavMenu?

We will take a quick look at the parameters you will find when you install this module. There are 4 columns, parameters, options, demo and description. The parameter column lists each available setting for the module; options lists the available options to choose from; demo lists the options chosen on the demo and description outlines what the module does.

Parameter

Show Title Enabled Position Menu Name Limit Levels Start Level End Level Always show submenus Menu Tag ID Menu Class Suffix Module Class Suffix Max Menu Depth Show Menu Icons Menu Icon Link

Options

Yes : No Yes : No List of positions List of menus Yes : No Number Field Number Field Yes : No Text Field Text Field Text Field Number Field Yes : No Yes : No

Demo

No No toolbar mainmenu No 0 0 No leave blank leave blank leave blank 10 No No

Description

Enable/Disable the module header Enable/Disable the module Position of the module Menu that is loaded Limit number of sub-levels Starting menu level Ending menu level Always show submenu items ID added to the menu code Class suffix to the menu Class suffix to the module Max number of menu levels Show menu icons Link menu icons
[clear]