"Horizon Slim" Documentation
Configuration and Installation instructions to come!
Wat does it do exactly ?
"Horizon Slim" Is a Joomla Module so you can put it in at any Module position. It will pull Information out of an ordinary Joomla Article to be displayed inside an horizontal acordion style box as seen above in this page.
Basically it can be used in two ways:
- to slide some Images and display the alt text of them as a transparent div overlay
- or to display Images and HTML formatted text inside the description including Links and Videos.
With the second variation you can use negetics "Horizon Slim" as a "banner Slider", a menu, an advanced image Slideshow, as graphical enhanced Article teaser just to name a few of the possibilities.
Even negetics "Horizon Slim" works pretty stable keep in mind that it is still in the beta phase.
I will try to make upcoming updates as compatible as possible but can't gurantee that they will be 100% compatible!
How does it work ?
At first I have to warn you do not use a Wysiwyg Editor to edit Articles you want to use with "Horizon Slim"Most of them will put container elements around your input. If you are using a Wysiwyg try to use the "edit source" function if avaiable.
negetics "Horizon Slim" will pull data out of an ordinary Joomla Article. You might want to create an extra section and categories to store your horizon data chunks.
"Horizon Slim" will parse either just for images or for divs containing one or two images and possible paragraphs.
Using "Horizon Slim" just with images
To do so just create an Article only containing some Images. like this:
<img src="path/to/image.jpg" alt="text for the description box" /> <img src="path/to/image.jpg" alt="text for the description box" /> <img src="path/to/image.jpg" alt="text for the description box" /> <img src="path/to/image.jpg" alt="text for the description box" />
create a new horizonSlim Module choose the Article and a module position to put it in. Set the parameters for horizonSlim as described further down in this Article and you are good to go.
Using "Horizon Slim" with Divs and custom HTML
To do this create an Article containing some HTML structure like this:
// First open a div // mandatory ! <div> // add the Background Image // mandatory ! <img src="path/to/background/image.jpg" /> // add an additional Image to fade the background to // optional <img src="path/to/fader/image.jpg" /> // add a link // this will make the hole Slide Link to the given URL // optional // add a paragraph containing your custom HTML code // optional <p> <h4>Custom HTML Code</h4> <p> you can put in here whatever you want ;) </p> </p> // close the div </div> // then add some more divs <div> <img src="path/to/background/image.jpg" /> <img src="path/to/fader/image.jpg" /> <p> <h4>More Custom HTML Code</h4> <p> you can still put in here whatever you want ;) </p> </p> </div> <div> <img src="path/to/background/image.jpg" /> <img src="path/to/fader/image.jpg" /> <p> <h4>Even More Custom HTML Code</h4> <p> and still you can here whatever you want ;) </p> </p> </div>
then create a new horizonSlim Module choose the Article and a module position to put it in. Set the parameters for horizonSlim as described further down in this Article and you will have some nice Eye-catcher for your site.
"Horizon Slim" Module Parameters
"Horizon Slim" has the following module parameters:
Article ID
The ID of the Article to parse MANDATORY
Total height
The total height of the horizon block MANDATORY
Maximum Opacity
Maximum Opacity for the overlay of non active list items
Class Name
Class Name to override the lists styles - I prefer that to using the Class Name
Width of the expanded Slide
Width of the expanded Horizon Slide - needs to be smaller than the total width the Horizon Block is allowed to occupy MANDATORY
Description div parameters
Width
The Width of the Div containing the Description.
Height
The Height of the Div containing the Description.
Slides in from
The Side the div containing the description shall slide in from
Bottom/Top/Right/Left
Maximum Opacity
Maximum Opacity of the Description Layer
Slider settings
Start Slide
The number of the first Slide to be active. Enter 'null' if you do not want a Slide to be active from the beginning. Starts counting with 1.
Hover Effect
Expand slides on mouse hover
No/Yes
Click Effect
Change active Slide on click
Yes/No
Slide Direction
The Slide direction
Right/Left
Equally sized Slides
Collapsed Slides will have equal width
No/Yes
Force Collapse
Force collapse of slides on mouse out
No/Yes
Slideshow Parameters
Auto Play
Should there be a Slideshow
No/Yes
Auto Play Speed
Auto Play Speed in milliseconds
Click stops Autoplay
Should a Click stop the Auto Play
No/Yes
Very Advanced Parameters Use only if you know what you are doing
Total Width
Total width of the horizon Block. Only needed when the block needs to be more narrow than the parent HTML Element!
Description Div Slide Speed
Description Div Slide Speed
Fade Speed
Fade Speed for the opacity Effect
Timeout Speed
Timeout Speed in milliseconds
Slide Speed
Slide Speed 1 is the fastest
Module Class Suffix
Module Class Suffix
A suffix to be applied to the CSS class of the Module. This allows for individual Module styling.
About the generated HTML Code
negetics "Horizon Slim" will produce HTML code in the following structure:
<ul id="sm67" class="negeticsHorizon" style="height:200px; width:980px;"> <li> <div class="container first" style="height:350px; width:392px;"> <div class="image" style=" background:url(/path/to/image.jpg); height:350px; width:392px;"></div> <div class="imageB" style=" background:url(/path/to/image.jpg); height:350px; width:980px;"></div> <div style="width:392px; height:350px;" class="beschreibung"> <div class="negBeBa"></div> <div class="negBeTe"> Your custom html code </div> </div> <div style="width:392px; height:350px;" class="fade"></div> </div> </li> <li> . . . </li> . . . </ul>
Here is a scheme of the nested structure:
+-ul*1--class=negeticsHorizon--------------------------------------------+
| |
| +li-+ +li-+ +li*2----------------------------------------------+ +li-+ |
| | | | | | | | | |
| | | | | | +div*3-class=container-------------------------+ | | | |
| | | | | | | | | | | |
| | | | | | | +div*4-class=image-------------------------+ | | | | |
| | | | | | | |Background Image | | | | | |
| | | | | | | +------------------------------------------+ | | | | |
| | | | | | | | | | | |
| | | | | | | +div*5--class=image------------------------+ | | | | |
| | | | | | | |Background Image | | | | | |
| | | | | | | +------------------------------------------+ | | | | |
| | | | | | | | | | | |
| | | | | | | +div*6--class=beschreibung-----------------+ | | | | |
| | | | | | | | | | | | | |
| | | | | | | | +div*6--class=negBeBa------------------+ | | | | | |
| | | | | | | | | | | | | | | |
| | | | | | | | +--------------------------------------+ | | | | | |
| | | | | | | | | | | | | |
| | | | | | | | +div*6--class=negBeTe------------------+ | | | | | |
| | | | | | | | | | | | | | | |
| | | | | | | | | DESCRIPTION TEXT/HTML | | | | | | |
| | | | | | | | | | | | | | | |
| | | | | | | | +--------------------------------------+ | | | | | |
| | | | | | | | | | | | | |
| | | | | | | +------------------------------------------+ | | | | |
| | | | | | | | | | | |
| | | | | | | +div*7--class=fade-------------------------+ | | | | |
| | | | | | | | | | | | | |
| | | | | | | +------------------------------------------+ | | | | |
| | | | | | +----------------------------------------------+ | | | |
| | | | | | | | | |
| +---+ +---+ +--------------------------------------------------+ +---+ |
| |
+------------------------------------------------------------------------+
to get more detailed Examples on how to use negetics "Horizon Slim" take a look at the Demos