Differences

This shows you the differences between two versions of the page.

--- services:pvw:conf:boxes [2015/03/16 11:25]
r2d2 created
+++ services:pvw:conf:boxes [2015/03/16 12:41]
r2d2 [Boxes Block]
@@ Line 1: / Line 1: @@
-====== Site Boxes ======
+====== Boxes Block ======
+The **boxes** block is a special [[blocks|preset block]] that allows you to fastly create multiples colums. Depending on the number of boxes you have defined, the site will display Bootstrap colums, each containing a //box//, meaning:
+    * An (optionnal) title
+    * A piece of text that can contains any HTML tags.
+Columns number can be only 2,3,4,6 or 12.
+===== Activating Boxes =====
+First you have to activate the [[blocks|'boxes' block]], where you want it to be displayed, ie:
+<code php>
+$pvw_conf['blocks_on']['home']=array('jumbo','boxes');
+</code>
+Next you have to define the list of boxes you want to display for each block type, using the following syntax :
+<code php>
+$pvw_conf['boxes_on']['TYPE']=array('BOXNAME','BOXNAME1','BOXNAME2');
+</code>
+Where :
+  * **TYPE** is the block type where they appears : either **home** or **foot**
+  * **BOXNAME**, (BOXNAME1,BOXNAME2) are the name of your boxes. Beware that this name is used in the CSS ID name and thus should only include letters, digits underscore or hyphen. (Don't put spaces in the name)
+Example :
+<code php>
+$pvw_conf['boxes_on']['home']=array('box_home1','box_home2','box_home3');
+</code>
+===== Defining Boxes =====
+To define a box, you should use the following syntax
+<code php>
+$pvw_conf['boxes']['MY_NAME']['title']  ="MY_TITLE";
+$pvw_conf['boxes']['MY_NAME']['content']="MY_CONTENT";
+</code>
+Where :
+  * **MY_NAME** is the unique name of your box, as defined in the //boxes_on// array.
+  * **MY_TITLE** (optionnal) is the title shown in the box top
+  * **MY_CONTENT** (required) is the content of the box, either as text or HTML
+Example:
+<code php>
+$pvw_conf['boxes']['box_home1']['title']  ="Version 5 released";
+$pvw_conf['boxes']['box_home1']['content']="We have just released a new version of Analoger, that you will find in our Donwload page ";
+$pvw_conf['boxes']['box_home2']['title']  ="Special Promo";
+$pvw_conf['boxes']['box_home2']['content']="
+<p>We are currently a great promo on Analoger for only $1</p>
+<p><a href='http://www.dontcrack.com'>Check out the details here</a></p>";
+//$pvw_conf['boxes']['box_home3']['title']=''; // no title needed for this box
+$pvw_conf['boxes']['box_home3']['content']="<a href='http://www.plugivery.com'><img src='/static/domain_name/img/box3_img.jpg'></a>";
+</code>
 {{indexmenu_n>30}}