To add a custom particle box, go to:
AdminCP >> Edit >> Edit Portal Layout
There are two example particle boxes already created that you can use as templates for building your own.
- Example_With_Code
- Example_With_Out_Code
By using the information on these two examples you have a template with which to begin building your own custom particles.
It is recommended NOT to edit these aside from viewing the examples they contain.
To add a custom particle box, click on the
Add Particle Box button at the bottom of the page.
In the title box enter a unique title for the particle box you are creating. The title will be referenced in the code and won't be visible to your users.
The body section is for your HTML code. It is
required for your particle box to function.
There are three buttons here that will insert commonly used HTML code to help you build your particle.
The
Table button will insert the basic design to mimic existing particles. The name of your particle box needs to go between the following tags:
Code:
<th class='theader'>Name of your particle box</th>
And the main body of your particle goes between these tags:
Code:
<td align='left' valign='top' class='color1'>Body goes here.</td>
The
{$lang_str['STRING']} button will allow you to insert language strings and the
<!--VARIABLE--> button will allow you to use the variables that are used in the FusionBB software.
Please note: The particle box coding section is available for more advanced particles and is NOT required . It will enable you to create complex boxes using If, While, For, and SQL calls. You should be versed in PHP Coding to use this.
The
"Current State" section determines whether your particle box is visible (
Published) or still being worked on (
Composing).
The
"Cache Time" will determine how often your particle box is "re-built" and cached into your portal or sidebars.
The
"Pull from Forums" option determines which forums you will be pulling the data from. Basically it lists the forums and when you click it lists the forum ID numbers as an easy place to find them. (This is an optional step.)
The
"Type of Data" section will eventually allow you to pull forums that are built with these data types directly. it is not finished and is an optional step.(This is an optional step.)
The
"Particle Box Placement" settings will allow you to determine where the particle box is placed on your portal page, or on the forums and in which position:
left,
right, or
center.
Click the "Add Particle Box" button when finished to return to the Edit Portal Layout page.
Visit the FusionBB Dev forums for more custom particle boxes ideas.