== Page Blocks ==

Each page of your Dolphin installation consists of blocks. Using the Page Builder, you can add new blocks as remove, enable, disable and rearrange blocks, according to your needs.[[br]]
'''
=== Adding Blocks ===
[[br]]'''
'''Choose a page from the Pages drop down list which will than populate the pages blocks.[[br]]
Further down the page click and drag a '''_HTML Block''' and drop it where ever you want the block to appear on your page.[[br]]
You need to set the block properties by clicking on the block which will load that block property window.[[br]]
Fill out the Caption Lang Key field, Visibility and the content field to your needs.[[br]]
For information on Language Keys visit the [DolphinAdminLanguagesSettings Language Keys] section.'''[[br]][[br]]
'''
=== Disable Blocks ===
'''[[br]]
'''If you want to remove a block but may want to use it at a later time you can make it inactive by clicking and dragging the block you want disabled down to the Inactive section.[[br]]
You could also click on the block to open the property window and uncheck the visible for: '''Guest & Member''' but this could get messy later on.[[br]][[br]]
'''
=== Reactivating Blocks ===
'''[[br]]
''' Find the block in the Inactive section, click and drag it back to where you want it displayed on the page (In the Active blocks section).[[br]][[br]]
'''
=== Deleting Blocks ===
'''[[br]]
'''Locate the block you no longer want or need anymore, click on the block to open its property window and press delete.[[br]]
'''Warning! If you delete a block it will also be deleted from the page builder and the database as well'''.[[br]]

=== Creating language-file and HTML-based blocks ===

First of all, you cannot use language keys directly in the HTML editor, so, in the Builders you should create only an HTML stem of your block and specify some text which later will be replaced by language keys.

Let's create a test block for your homepage and make it language file and HTML-based.

 * So, navigate to '''Builders -> Pages Builder -> Homepage''', point the mouse cursor on the '''_HTML Block''' in the '''Samples''' area and drag it into the '''Active Blocks''' area placing among other blocks.
 * Click on the '''_HTML Block''' link of this block in the '''Active Blocks''' area. Think of a caption for this block and specify a language key for this caption in the '''Caption Lang Key''' field, for example: '''_My New Block'''
 * Now click the '''HTML''' icon in the editor toolbox. And now you can create your HTML stem and content for this block, for example:
{{{
<font color="green">My New Block</font>
}}}
 Click the '''Save''' button.
 * Select whether the new Page Block will be visible for Guests and/or Members.
 * Set the Cache for seconds (leave set at the default setting of "0" to make no changes)
 * Fill in the HTML content box for the content of your Page Block. To edit the HTML code, click the HTML button on the Tiny MCE menu. Not all code will work in the HTML box.

 * Now we can create a language key for the caption of our block. Navigate to '''Settings -> [DolphinAdminLanguagesSettings Language Settings]''' and click the '''Add key''' link.
   * Type '''_My New Block''' in the '''key name''' field. 
   * Choose the appropriate category in the '''Category''' drop-down menu, for example: '''Misc''' or type a new category in the adjacent field.
   * Then create language strings for all the languages that you have created, for example:
      * '''My New Block''' for the English language
      * '''Mon nouveau bloc''' for the French language
   * Click the '''Save changes''' button. You should see the window notifying that the new key is successfully created and the language file is successfully compiled.