Builder HTML Module

(Difference between revisions)
Jump to: navigation, search
(Created page with "<br /> ← Back to Builder Codex Home")
 
Line 1: Line 1:
 +
The '''HTML''' adds a place for post or page content to render. It also supports the use of shortcodes and execution of PHP code.
 +
 
<br />
 
<br />
[[:Builder_Test|← Back to Builder Codex Home]]
+
 
 +
==Adding an HTML Module==
 +
 
 +
To add an HTML Module to your Layout, click '''Add Module''' and select the HTML Module from the list of available Modules.
 +
 
 +
<br />
 +
 
 +
[[File:add-html-module.png|800px|link=]]
 +
 
 +
<br />
 +
 
 +
==HTML Module Settings==
 +
 
 +
Once the HTML Module has been selected and added to the Layout, the '''Modify HTML Module Settings''' box will appear. Customize the settings of the HTML Module by selecting from the following options.
 +
 
 +
<br />
 +
 
 +
[[File:Content-module-settings.png|800px|link=]]
 +
 
 +
<br />
 +
 
 +
'''Available Content Module settings include:'''
 +
 
 +
*'''Name''' - For widget identification purposes
 +
*'''HTML''' - Add your static HTML, shortcode or PHP code
 +
*'''Sidebars''' - Widget areas to the left, right or on both sides of the HTML Module
 +
*'''Style''' - **Varies by child theme** - If the active child theme (theme design) provides [[Builder_Modules:_Alternate_Module_Styles|Alternate Module Style]] options for this module, select the desired style.
 +
*'''Enable PHP''' - "No" or "Yes" – Enabling this option allows for processing of PHP code inside the module. Always review PHP code if taken from a third party, as it could pose a serious security threat.
 +
*'''Remove Wrapper Div''' - "No" or "Yes" – Enabling this option is only recommended for advanced users as this can cause layout issues if not properly handled. When Builder renders Modules, it wraps the output in a series of divs to keep the Layout structure properly intact and to allow the styling to be properly applied. The HTML 0odule is unique in allowing the output to be removed from these containing div wrappers. If the "Remove Wrapper Div" option is enabled, the output entered in the HTML input will be output without the wrappers, allowing you to create complex output that breaks out of the Layout structure. It is for this reason that it should only be used by advanced users.
 +
 
 +
<br />
 +
 
 +
Click the '''Save''' button to save the HTML Module Settings. You'll now see the HTML Module added to your Layout, denoting the configuration of sidebars (if applicable).
 +
 
 +
<br />
 +
 
 +
[[File:HTML-Module-in-layout.png|800px|link=]]
 +
 
 +
==Advanced Note==
 +
 
 +
The HTML Module isn't limited to just static HTML content. You can also use shortcodes and PHP code to add generated content. PHP support must first be activated with the Enable PHP option below.
 +
 
 +
Using shortcodes is preferred over PHP code as allowing PHP code has security risks.
 +
 
 +
==Generic CSS Class==
 +
 
 +
<code>.builder-module-html</code>
 +
 
 +
==See also==
 +
 
 +
*[[Builder_Layouts:_Introduction|Introduction to Builder Layouts]]
 +
* [[Builder_Layouts_Video_Overview|Video Overview]]
 +
* [[Creating_a_Builder_Layout|Creating a Builder Layout]]
 +
** [[Builder_Modules|Builder Modules]]
 +
*** [[Builder_Header_Module|Header Module]]
 +
*** [[Builder_Navigation_Module|Navigation Module]]
 +
*** [[Builder_Image_Module|Image Module]]
 +
*** [[Builder_Widget_Bar_Module|Widget Bar Module]]
 +
*** [[Builder_Content_Module|Content Module]]
 +
*** [[Builder_HTML_Module|HTML Module]]
 +
*** [[Builder_Footer_Module|Footer Module]]
 +
**[[Builder_Modules:_Sidebars|Sidebars]]
 +
*** [[Builder_Duplicate_Sidebar_Widget| Builder Duplicate Sidebar Widget]]
 +
** [[Builder_Modules:_Alternate_Module_Styles|Alternate Module Styles]]
 +
* [[Applying_Builder_Layouts| Applying Layouts to Specific Posts/Pages]]
 +
 
 +
 
 +
<br />
 +
[[:Builder|← Back to Builder Codex Home]]

Revision as of 12:40, July 24, 2013

The HTML adds a place for post or page content to render. It also supports the use of shortcodes and execution of PHP code.


Contents

Adding an HTML Module

To add an HTML Module to your Layout, click Add Module and select the HTML Module from the list of available Modules.


Add-html-module.png


HTML Module Settings

Once the HTML Module has been selected and added to the Layout, the Modify HTML Module Settings box will appear. Customize the settings of the HTML Module by selecting from the following options.


Content-module-settings.png


Available Content Module settings include:

  • Name - For widget identification purposes
  • HTML - Add your static HTML, shortcode or PHP code
  • Sidebars - Widget areas to the left, right or on both sides of the HTML Module
  • Style - **Varies by child theme** - If the active child theme (theme design) provides Alternate Module Style options for this module, select the desired style.
  • Enable PHP - "No" or "Yes" – Enabling this option allows for processing of PHP code inside the module. Always review PHP code if taken from a third party, as it could pose a serious security threat.
  • Remove Wrapper Div - "No" or "Yes" – Enabling this option is only recommended for advanced users as this can cause layout issues if not properly handled. When Builder renders Modules, it wraps the output in a series of divs to keep the Layout structure properly intact and to allow the styling to be properly applied. The HTML 0odule is unique in allowing the output to be removed from these containing div wrappers. If the "Remove Wrapper Div" option is enabled, the output entered in the HTML input will be output without the wrappers, allowing you to create complex output that breaks out of the Layout structure. It is for this reason that it should only be used by advanced users.


Click the Save button to save the HTML Module Settings. You'll now see the HTML Module added to your Layout, denoting the configuration of sidebars (if applicable).


HTML-Module-in-layout.png

Advanced Note

The HTML Module isn't limited to just static HTML content. You can also use shortcodes and PHP code to add generated content. PHP support must first be activated with the Enable PHP option below.

Using shortcodes is preferred over PHP code as allowing PHP code has security risks.

Generic CSS Class

.builder-module-html

See also



← Back to Builder Codex Home

Personal tools
Namespaces
Variants
Actions
iThemes Codex
Codex Navigation
Toolbox