Joomla Extensions
RokCandyLatest Version: 1.0
WYSIWYG Friendly Typography and Styling RokCandy provides BBCode style macro functionality for Joomla. It provides a WYSIWYG-safe macro syntax to allow you to easily add complex HTML with a simple BBCode macro. RokCandy changes the preset syntax, such as [example] to the relevant HTML code during the rendering of the Joomla article.
RokCandy allows you to create complex HTML output as simple macros to allow your complex content to be created quickly and easily with a minimum of fuss.
Screenshots
Examples
If the following was set in the RokCandy configuration: [example title={title}]{text}[/example] it would output the following code:That is a simple example, but the degree of sophistication is limited by your own creativity. A more complex example be can seen below:
The above example could be styled to be an expandable, 4 rounded corners element which distinct styling for the header and content divisions. As you can see, it is a complex setup via HTML to implement, and even more difficult if you have an illiterate client or content editors are in play. The following syntax could be used [complex title={title} subheader={subheader} image={image}]{text}[/complex] which is clearly simpler and easier to use.
Installation - Joomla 1.5
Downloading the Extension Files
- RokCandy Component (com_rokcandy.zip) This file is the component package you will use to install RokCandy into Joomla.
Using the Joomla Installer
From the Menu in your Joomla Administrator, go to Extensions → Install/Uninstall.
Next, browse for your com_rokcandy.zip file you downloaded and then click Upload File & Install.
Accessing the Component Page
Next, go to Components → RokCandy. You will be brought to the Macros page which lists all the current snippets, whether generated from the component defaults or from the template overrides.
How do I configure RokCandy, the Syntax?
RokCandy is distributed with default snippets for a variety of logical purposes such as for content title. However, Joomla 1.5 offers its templates the capacity to override the core of Joomla. In this manner, we can add files to the template that will override the snippets in RokCandy. Therefore, you can quickly add and edit your own macros without modifying core files.The file is called default.ini and, if you are using a RocketTheme template which uses RokCandy, it will be located in the /templates/rt_TEMPLATE_NAME_j15/html/com_rokcandy/ directory. However, if the folder does not exist, you will have to create the necessary folders as shown in the path above and create a new file named default.ini.
Also, you can also add and control your own in the Administrator: Components → RokCandy. They will appear in the following format:-
Such as 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:-
Changelog
This is the changelog for the RokCandy Component inclusive of alpha, beta and release candidate versions.
