Elxisitalia.com!
All about CMS Elxis open source.

Home News Downloads Elxis Guides F.A.Q. Elxis Wiki Elxis Forum Link SiteMap Info

How to use EIB Transition Rotator

Per la versione in Italiano clicca qua

The rotator is developed in flash and for this is request the ultimate Flash Adobe/Macromedia plug-in for browser

Features vers. 1.2:

In this version has been added the movie title. An improvement has been brought for not publishing the empty tabs. For less than 5 tabs is better using the Tab Slider Module.

Flash dimensions in pixel (W x H): 580 x 300 px
Image dimension request in pixel (W x H): 580 x 300 px:
Images folder: /modules/mod_eibmultitransitional_rotator/images/
Don't change the dimension of the movie. You can have problem to layout.

Administrative Panel:

Movie title: write a short title about the contents of your site.
Set the color of layout: choose the color you wish from nine color layouts.
Text button: insert text for button that you want (example: click here, see all, etc).
Number of Tabs: Set the number of tabs you want display. Recommended is 5.
If some sections are not filled, the number of tabs it must be equal at the number of section Tabs filled.
Random: Set Yes if you want a random sequence. No if you don't want,
Delay Time: Set the time rotations of tabs in second. Recomended is 15 seconds. If you don't want no rotation set up on Infinity.
Transition: Choose one from 5 transition effects. Set 0 to get all.
Tab Sections: Fill all fields and set the most rappresentative image of the linked article.

Change destination image folder.

If you want use media manager to upload the images you want use in EIB trantion rotator module, is better you change the folder images.
To do this open mod_eibmultitransition_rotator.php with your prefered php software the file.
Go to line 295 and modify '/modules/mod_eibmultitransition_rotator/images/' in '/images/eibmultitransition_rotator/'
The complete line will become:

$lineitem = 'picture="'.$mainframe->getCfg('live_site').'/images/eibmultitransition_rotator/'.$item['picture'].'" title="'.$item['title'].'" subtitle="'.$item['subtitle'].'" url="'.$item['url'].'" target="'.$item['target'].'" button="'.$item['button'].'" >';

Now you must create a directory called eibmultitransition_rotator in the images folder of your elxis site and copy here all content in the original module's folder /modules/mod_eibmultitransition_rotator/images/.

How to implement the tabs. (only for expert)

The flash permits to use more than 5 tabs in random. If you want to do this you must to do some implementation in two modules ffile (.php and xml).

a) mod_eibmultitransition_rotator.xml

Copy and paste the block fom line 141 to 150 many times how are the tabs you want.

<param name="@spacer" type="spacer" default="CX_MULTIROT_TAB5" label="" description="" />
<param name="title5" type="text" default="" dir="rtl" size="20" label="CX_MULTIROT_TITL" description="CX_MULTIROT_TITL_DESCR" />
<param name="subtitle5" type="text" default="" dir="rtl" size="20" label="CX_MULTIROT_STITL" description="CX_MULTIROT_STITL_DESCR" />
<param name="descr5" type="text" default="" dir="rtl" size="65" label="CX_MULTIROT_DESCR" description="CX_MULTIROT_DESCR_DESCR" />
<param name="link5" type="text" default="" dir="ltr" size="65" label="AX_SM_RNI_LNL" description="CX_MULTIROT_LINK_DESCR" />
<param name="target5" type="list" default="0" dir="ltr" label="CX_MULTIROT_TARG" description="CX_MULTIROT_TARG_DESCR">
<option value="0">CX_MULTIROT_TARG_SAMEW</option>
<option value="1">CX_MULTIROT_TARG_NEWW</option>
</param>
<param name="picture5" type="imagelist" directory="/modules/mod_eibmultitransition_rotator/images" default="" dir="ltr" label="AX_IMAGEL" description="CX_MULTIROT_PICT_DESCR" />

Rename the value of the param name modifying the final number:
example if you want add 2 tabs:
title5 will become title6 and title7,
subtitle5will become subtitle6 and subtitle7,
and so on for every content of the new blocks.
Note:
Remember also the language variable CX_MULTIROT_TAB5 in CX_MULTIROT_TAB6, CX_MULTIROT_TAB7 and create these new variables in the language files.

Copy and past the line 61 many times how are the tabs you want.

and change the numer 5 in, our example, 6 and 7

Save the file

b) mod_eibmultitransition_rotator.php

This is hardest to modify.
To simplify all I just start from the end of this file.

Copy and paste the block from line 264 to 272 many times you want add the tabs:

$items [] = array(
'picture' => $this->picture5,
'title' => $this->title5,
'subtitle' => $this->subtitle5,
'url' => $this->link5,
'target' => $this->target5,
'descr' => $this->descr5,
'button' => $this->button,
);

and rename the variables. In our example:
$this->picture5 will become $this->picture6 and $this->picture7
$this->title5 will become $this->title6 and $this->title7
and so on fo all variables in the new line blocks.

Copy and paste the line 162 many times are your added tabs.

if ($this->link5) {if (!preg_match('#^(http)#i', $this->link5)) { $this->link5 = 'http://'.$this->link5; }}

Now rename $this->link5 for every new line. In our example will become $this->link6, $this->link7.

Go to the end of line 154. copy and paste all last part of the line where the final number of variables is 5.

.$params->get('title5', '').$params->get('subtitle5', '').$params->get('link5', '').$this->target5.$params->get('descr5', '').$params->get('picture5', '')

Change the last final numer 5 in 6 and 7.
In our example the complete line will be:

$this->params = $params->get('button', '').$params->get('title1', '').$params->get('subtitle1', '').$params->get('link1', '').$this->target1.$params->get('descr1', '').$params->get('picture1', '').$params->get('title2', '').$params->get('subtitle2', '').$params->get('link2', '').$this->target2.$params->get('descr2', '').$params->get('picture2', '').$params->get('title3', '').$params->get('subtitle3', '').$params->get('link3', '').$this->target3.$params->get('descr3', '').$params->get('picture3', '').$params->get('title4', '').$params->get('subtitle4', '').$params->get('link4', '').$this->target4.$params->get('descr4', '').$params->get('picture4', '').$params->get('title5', '').$params->get('subtitle5', '').$params->get('link5', '').$this->target5.$params->get('descr5', '').$params->get('picture5', '') .$params->get('title6', '').$params->get('subtitle6', '').$params->get('link6', '').$this->target56.$params->get('descr6', '').$params->get('picture6', '').$params->get('title7', '').$params->get('subtitle7', '').$params->get('link7', '').$this->target57.$params->get('descr7', '').$params->get('picture7', '')
;

The same thing you must do with the line 151 and will become:

$this->params1 = $this->button.$this->title1.$this->subtitle1
.$this->link1.$this->target1.$this->descr1.$this->picture1.$this->title2
.$this->subtitle2.$this->link2.$this->target2.$this->descr2.$this->picture2
.$this->title3.$this->subtitle3.$this->link3.$this->target3.$this->descr3.
$this->picture3.$this->title4.$this->subtitle4.$this->link4.$this->target4
.$this->descr4.$this->picture4.$this->title5.$this->subtitle5.$this->link5
.$this->target5.$this->descr5.$this->picture5.$this->title6.$this->subtitle6
.$this->link6.$this->target6.$this->descr6.$this->picture6.$this->title7
.$this->subtitle7.$this->link7.$this->target7.$this->descr7.$this->picture7;

Copy and paste the line 149 as the same and rename all contents.
in our example will become:

if ($this->picture6 == '-1') {$this->picture6 = 'none.jpg';}
if ($this->picture7 == '-1') {$this->picture7 = 'none.jpg';}

Copy and past from line 139 to 154 many times how are your tabs

$this->title5 = eUTF::utf8_trim($params->get('title5', ''));
$this->subtitle5 = eUTF::utf8_trim($params->get('subtitle5', ''));
$this->link5 = trim($params->get('link5', ''));
$this->target5 = (intval($params->get('target5', 0)) === 1) ? '_blank' : '_self';
$this->descr5 = eUTF::utf8_trim($params->get('descr5', ''));
$this->picture5 = trim($params->get('picture5', 'default.jpg'));

and rename variables. In our example:
$this->title5 will become $this->title6 and $this->title7
$this->subtitle5 will become $this->subtitle6 and $this->subtitle7
and so on fo all variables in the new line blocks.

Copy and past the block from line 64 to 69

private $title5 = '';
private $subtitle5 = '';
private $link5 = '';
private $target5 = '_self';
private $descr5 = '';
private $picture5 = '';

Save the file

That's All !!

Your module is ready with seven tabs!!!!

Guide write by Speck - Elxisitalia.com