Changes between Version 2 and Version 3 of DolphinAdminPagesBlocks

Timestamp:

Sep 14, 2009, 4:08:17 PM (15 years ago)

Author:

IgorL

Comment:

--

DolphinAdminPagesBlocks

@@ -22 +22 @@
 '''[[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]] 
+'''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 in Dolphin 6.1.6 ==
+
+We decided to shed some light on this subject because it's really not so obvious in Dolphin 6.1.6 regarding creation of language-file based HTML 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.
+
+ * Now we can create a language key for the caption of our block. Navigate to '''Settings -> Language Settings''' and click the '''Add a new language key''' link.
+
+ Type '''_My New Block''' in the '''New language 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. Skip the field '''Language string parameters''' if you don't want to include any changeable PHP-generated parameters in this block.
+
+ Then create language strings for all the languages that you have created, for example:[[BR]]
+ '''My New Block''' for the English language[[BR]]
+ '''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.
+
+ * Now comes the hardest part - key creation for the block's content. You should know how to use phpMyAdmin or any other interface which you can use to interact with the database. Log into this interface and open the table '''PageCompose'''.[[BR]]
+ Search for the block you have created: click the '''Search''' button and type '''_My New Block''' in the '''Caption''' field.[[BR]]
+ Open the found record for edition.[[BR]]
+ Replace the '''Echo''' function with the '''PHP''' function in the '''Func''' field.[[BR]]
+ Replace the '''Content''' with the following PHP code:
+{{{
+echo '<p><span style="color: green;">' . _t("_My New Block Content") . '</span></p>';
+}}}
+ This way you will be able to create a language key '''_My New Block Content''' which will be rendered by the '''_t''' function.[[BR]]
+ Click '''Go''' to save the changes.
+
+ * Now you only need to create this new language key (see above) and recompile the block by navigating again to '''Builders -> Pages Builder -> Homepage''', clicking the block's caption and saving it again.