Search Results for: top

28 Jul 2019

Themify Builder Documentation

/ Comments Off on Themify Builder Documentation

This documentation is an extensive guide on how to use the Themify Builder, a drag and drop page builder with live edits and previews. Themify Builder works with WordPress posts and pages, as well as custom post types. Shortcodes and HTML tags are supported with the Text or HTML/Text module. The Builder can be used in both backend edit mode and frontend edit mode.

NOTE: The Themify Builder is included in the framework of all themes. If you are using a Themify theme, you don't need to install the standalone Builder plugin additionally.

To Start

To use the Builder to design your page layout, you would need to create a Page or Post first. Go to your site's WP-admin > Pages > Add New, then you will see the Builder interface in the backend. Click "Publish" to publish your page and then you can use the backend Builder interface or frontend to design your page layout. To switch to frontend: view the page on the frontend, then click "Turn On Builder" on the top admin bar and you will see the Builder interface to design your layout.

Backend Edit Mode

To use the Themify Builder in the backend:

• First add or edit a post/page.
• If you are using WordPress 5+ with Gutenberg enabled (default), you should see a Builder Block like the screenshot below.
• If Gutenberg is disabled, you will find the "Themify Builder" tab below the WordPress classic editor.

Toolbar

On the Builder Toolbar, you will find these buttons:

• Plus Button = To open module panel.
• Responsive Styling = Customize styling on Desktop, Tablet Landscape, Tablet Portrait, or Mobile.
• Undo/Redo = Undo/redo (you can use keyboard shortcuts Cmd+Z and Cmd+Shift+Z).
• Import = Import Builder content from a data file, existing posts, or pages.
• Export = Export the Builder content (export will generate a ZIP file which can be imported later using the import option).
• Layouts:
  • Load Layout = Import pre-designed Builder Layouts to the current page.
  • Save as layout = Save current layout to use on another page.
• Duplicate This Page = duplicate the page along with the Builder content.
• Page Custom CSS = Allows you to add custom CSS to the specific page.
• Interface Options = Choose your interface options such as enable hover mode and right-click menu.
• Help = Click to open the Builder Tutorial video lightbox and view the keyboard shortcuts.
• Save = Save the Builder content.
• Revisions = Revisions allow you backup and restore your previous layout. To access revisions, click on the arrow button beside the Save button. You can select to save or load a revision.

Adding Modules

• Click on the plus (+) icon found on either the top left of the toolbar or in the last row, to open the module panel.
• To add modules, you can drag & drop module to the canvas area or click on the green plus (+) button in the top right corner.

Row Options

To access the row options:

• If you have hover mode enabled, just hover over the row action button (the small purple dot). To enable/disable hover mode, go to the top toolbar > Interface Options, then toggle the "Hover Mode" switch off.
• If you have hover mode disabled, click the row action button or click any where on the row, then click the row button on the action breadcrumb.

On the row action, click on the gear icon to trigger the row option dropdown menu. The row option dropdown has these options:

• Responsive Grids: To have a different grid on desktop, tablet, and mobile: first click the device icon, then click the row grid icon.
• Row Grids: You can also set the column arrangement on mobile or tablet.
• Column Alignment: Set modules in the entire row to top, middle, or bottom alignment (Click here for more info).
• Column Direction: Set column float direction either from left-to-right or right-to-left.
• Column Gutter: The spacing/gap between columns.
• Column Height: By default, all columns within the row are full height. You can change it to auto height which means the height of the column will vary depending on the content inside the column.

On the row option dropdown menu, click the "Row Options" tab to see more options:

• Row Width:
  • Default = Row background and row content area is within the container width.
  • Boxed = Row background will be fullwidth, but the row content area will be within the container width.
  • Fullwidth = Both row background and row content area will be fullwidth completely.
• Row Height:
  • Default = Row height varies depending on the content inside the row.
  • Full Height = Row will be 100vh (viewport height) and the content inside will be by default middle aligned vertically.
• CSS Class: Add additional custom CSS classes.
• Row Anchor: Add row anchor for scrollTo anchor feature.
• ID Name: Add ID name for Sticky Scrolling feature.

Frontend Edit Mode

The frontend edit mode works similar to the backend mode except it provides a live preview.

To use the Themify Builder on the frontend:

• View any post or page on the frontend (NOTE: WordPress' default homepage is actually a blog archive page, so you would need to create a static front page to use the Builder on a homepage).
• On the frontend, from the top admin bar (make sure your WP Admin Toolbar is enabled), click "Turn On Builder".
• You will see the Builder toolbar at the top.
• Click on the green (+) icon found on the top left corner, or in the last row to open the module container.
• Drag and drop, or click the green (+) button, to add a module to the column/grid.
• On the frontend, you can dock the panel to either left or right side by dragging the panel to the left/right edge of the screen.

Using Builder on Homepage

The default WordPress homepage is actually a blog archive page which shows all of your latest posts. Please note that the Builder does not work on archive pages. To use the Builder on the homepage, first you must create a static page (e.g. "Home") and then go to WP Settings > Reading and set that "Home" static page as the front page.

To use the Themify Builder on the homepage:

• First add a new page (e.g. Home).
• Publish the page and create the Builder layout as you like.
• When you are done, go to WP Settings > Reading, on the "Front page displays" option, select the "A static page" radio button, then from the "Front page" dropdown menu, select the "Home" page that you've created.
• Leave the "Posts page" option empty (if you need to create a "Blog" page, please refer to this tutorial).

Responsive Grids

The Builder grid is responsive by default. But if you want the row grid to be different on tablet and mobile, you can use the responsive grid feature. For example: you can set the row grid to a 4-column on desktop, then change it to a 2-column on tablet, and a 1-column on mobile.

To use responsive grids:

• On desktop mode, select your desired row grids
• To change a row grid on tablet: click on the tablet icon on the toolbar, then change the row grid option
• To change a row grid on mobile: click on the mobile icon on the toolbar, then change the row grid again

Responsive Styling

This features allows you to style how your site looks like on a tablet, mobile, or desktop. To access this feature, first turn on the Builder > on the Builder toolbar select to view your site on Desktop, Tablet Landscape, Tablet Portrait, or Mobile. When these icons are selected you'll see a live preview where you can customize the styling and the module data.

Notes: When you edit the styling in both tablet or mobile view, you can add or edit the Builder content. But when you do this, note that it will apply on the desktop version as well. Only the styling is applied specific to the device you're viewing (ie. mobile styling only applies on mobile).

Builder Shortcuts

Below are some Builder shortcuts that can improve your productivity and save you time: (Watch Video)

• Double-click = Double clicking on a row, column, or a dropped module will bring up the options lightbox
• Cmd + S (PC: Ctrl+S) = Save (if a lightbox is open, it will save changes made in the lightbox, otherwise it will save changes made with the Builder)
• Escape = When the module/row option lightbox is open, press escape key to cancel/close the lightbox
• Cmd + Z (PC: Ctrl+Z) = Undo
• Cmd + Shift + Z (PC: Ctrl+Shift+Z) = Redo
• Cmd + C (PC: Ctrl+C) = Click on a module to select it, then press Cmd + C to copy the selected module
• Cmd + V (PC: Ctrl+V) = Click on a module to select it, then press Cmd + V to paste data in the selected module
• Cmd + Shift + V (PC: Ctrl+Shift+V) = Click on a module to select it, then press Cmd + Shift + V to paste styling data in the selected module
• Cmd + Up (PC: Ctrl+Up) = Click on a module to select it, then press Cmd + Up arrow key to move module up
• Cmd + Down (PC: Ctrl+Down) = Click on a module to select it, then press Cmd + Down arrow key to move module down

Builder Predesigned Layouts

Builder Layouts are predesigned layouts which you can import to any page for quicker prototyping. You can use the predesigned layouts to get your page started or create your own from scratch using the Builder.

To import predesigned layouts:

• On the Builder Toolbar > click Layouts > click Load Layouts
• Select the thumbnail you'd like to import. Then choose to either replace your current Builder layout or append it.
• If you already have custom Builder Layouts created/saved, it will be available on the "Saved" tab.

Creating Custom Builder Layouts

You can either create custom layouts from scratch or save from an existing post/page created with the Builder.

Method 1) To create new Layouts from scratch:

• Go to WordPress Admin > Themify > Builder Layouts.
• Click on "Add New" button.
• Enter the title, upload the Featured Image (optional) and click "Publish".
• Use the Builder edit panel to create the Layout as desired and click "Save" when you are done.
• The new Layouts will be available on the "Saved" tab of the "Load Layouts" lightbox.

Method 2) To save Layouts from an existing post/page:

• Go to the frontend of the page you want to save as a Layout, and turn on the Builder.
• On the Builder Toolbar > click Layouts > click Save as Layout.
• Then enter the title and upload the Image Preview (optional), and click "Done".

Layout Parts

Layout Parts are re-usable parts of a layout that can be included into the Builder content or anywhere in the post content or widget using its shortcode. Layout Parts can be edited live on the spot without directing yourself to another page or opening a lightbox. When the Layout Part is updated, any post or page using that same Layout Part will be also updated simultaneously. Layout Parts are extremely useful for showing the same content in multiple areas/pages (e.g. client logos, contact info/map, banner ads, service list, etc.).

How to create Layout Parts

You can create Layout Parts from scratch or by saving any existing module/row.

Method 1) Save any existing row/module as a Layout Part:

To save any row/module as a Layout Part, click on the element, then click on the save () icon, enter the title and check the "Layout Part" checkbox.

Method 2) Create Layout Parts from scratch:

• Go to WordPress Admin > Themify > Builder Layout Parts.
• Click on "Add New" button.
• Enter the title, upload the Featured Image (optional) and click "Publish".
• Use the Builder edit panel to create the Layout as desired and click "Save" when you are done.
• The new Layout Parts will be available on the "Saved > Parts" tab of the module panel.

How to display the Layout Parts

There are 2 methods to show the Layout Parts:

• Using the "Layout Part" module.
• Using the [themify_layout_part] shortcode.

Method 1) Using the "Layout Part" module

The "Layout Part" module works exactly the same as all other modules. Simply drop in the "Layout Part" module and select the Layout Part.

Method 2) Using the [themify_layout_part] shortcode

You can also display Layout Parts using the following shortcodes in the post content, Text widget, and inject it in the page using the Hook Content.

The Layout Part can be queried by its slug name or post ID.

• [themify_layout_part slug="client-logos"] = this means show the layout part with slug name 'client-logos'.
• [themify_layout_part id="12"] = this means show the layout part ID# 12 (find out how to post the ID number).
• You can get the Layout Part shortcode from WP-Admin > Themify > Layout Parts

Mega Menu

The Mega Menu feature enables you to make the most of the WordPress menu by showcasing featured posts and multi-column dropdowns with various links and widgets.

To use the Mega Menu:

• To make use of the Mega Menu feature, you'll first need to set up the menu at WP-Admin > Appearance > Menus.
• Once you've created the menu (follow the steps below), you can assign that menu as the 'Main Navigation,' and the mega menu will appear in the primary navigation area of your theme. Note: Mega menu support is available only in the following themes: Ultra, Shoppe, Music, Parallax, Fullpane, Peak, and Magazine. If your theme doesn't support the mega menu feature, you can still use the Builder Menu module to display it.

  

• You can display the mega menu using the Builder's Menu module. Simply drop in a Menu module, choose the menu you've configured with the mega menu feature, and then enable the "Mega Menu" option.

  

• To create Mega Posts on the mega menu dropdown:
  • Go to WP-Admin > Appearance > Menus, add a new menu or edit any existing menu.
  • Add a "Pages" or "Custom Links" and select "Mega Posts" on the Mega Menu dropdown option.
  • Next, include 'Tags' or 'Categories' as link types in the nested menu. For instance, you would set the Blog page link as the parent link and then nest the categories/tags links. When users hover over the Blog link, they will be able to see the recent posts of the corresponding categories/tags within the mega menu dropdown.
  • Note: The nested items must be Tags or Categories. This will display recent posts associated with the chosen tag/category. If the Tags option is not visible, click on the 'Screen Options' located in the top-right corner, and ensure that the 'Tags' option is checked.

    

• To set Fullwidth Columns:
  • Add a "Pages" or "Custom Links" and select "Fullwidth Columns" on the Mega Menu dropdown option.
  • Select the column layout from the preset that appears - Default is set to "Auto",
  • Then add any link (Pages, Posts, Custom Links, Tags, Categories) or widgets. This will display nested links in multiple columns.

    

• Setting Navigation Titles Above Nested Links:
  • Utilizing the 'Fullwidth Columns' option, you can also establish header titles that appear above the nested links. To achieve this, simply add an additional layer of nested links beneath the initial set of nested links, as demonstrated in the screenshot below:

    

• To set Dropdown Columns:
  • Add a "Pages" or "Custom Links", select the "Dropdown Columns" option, and then select the number of columns (2, 3, or 4).
  • Then add any link (Pages, Posts, Custom Links, Tags, Categories) or widgets. This will display the nested links in the number of columns as you selected.

    

• To add Widgets in the mega menu:
  • Select the "Widgets" link type and select the widget from the dropdown menu option.
  • Click "Add to Menu" and customize the widget as you like (eg. you can drop in a Text widget and enter your custom text).

    

Builder Import/Export

The Builder Import/Export tool can be used to share Builder layouts with clients or use it as a backup to create different versions of your layouts (i.e. export the Builder content for backup purposes which you can roll back in the future).

• To Export: on the Builder Toolbar, click Export (it will prompt you to download a zip file).
• To Import: on the Builder Toolbar, click Import, then click either import from a zip file or from existing posts/pages.

ScrollTo Row Anchor Menu (Single Page Menu)

To achieve scrollTo row anchor:

• Step 1) First enter in a Row Anchor name in Row Options (e.g. "portfolio")

  

• Step 2) Then go to WP-Admin > Menus and create a new menu. Add a new "Custom Links", on the URL option, enter the anchor name with a number sign (#) in front of it (eg. "#portfolio")

  

• Result: When the #portfolio link is clicked, or when users go the URL with the #portfolio anchor (e.g. http://yoursite.com#portfolio), it will scroll to the row where you've specified that Row Anchor = "portfolio"

Fullwidth Page Layout

Fullwidth layout is only available in Themify themes. You can create a complete fullwidth page without a sidebar and page title.

To set a fullwidth layout (available in Themify themes only):

• Add or edit a page, on the Themify Custom Panel, select:
  • Sidebar Option = no sidebar icon
  • Content Width = fullwidth
  • Hide Page title = Yes (optional: this will hide the page title so everything can be built with the Builder)

Video Background

To display a background video:

• With the Builder turned on, select the row where you want to show the video background > select Styling icon > Styling Tab
• Background Type: Select "Video"
• Background Video: Choose to upload an mp4 video, or insert a YouTube/Vimeo link.
  • NOTES:
    • Audio must be disabled in order to have video auto play in background.
    • Inserting a YouTube/Vimeo link won't allow users to toggle the video (i.e. play, pause, or mute). It will just auto play the video when users visit your site.
  • Background Image: This is a fallback background image. You'll need to insert a fallback background image because the video background does not work on mobile.

Parallax Scrolling Background Image

To display a parallax scrolling background image:

• With the Builder turned on, select Row > Options > Styling Tab, upload a "Background Image" and select "Parallax Scrolling" in the "Background Mode"
• Optional: select a "Background Position" for the image.

Slider & Ken Burns Background

To display an image background slider:

• With the Builder turned on, select Row > Options > Styling Tab
• Click "Insert Gallery" and insert a gallery by selecting library images or upload images (it will then insert a [[gallery]]shortcode in the textarea)
• Image size = Select the size of the image that you would like the images to appear
• Under "Background Slider Mode", you can select:
  • Fullcover = slider images will scale to fully cover the row.
  • Best Fit = slider images will automatically fit within the row.
  • Ken Burns = the background images will pan, zoom, and fade slowly providing a unique visual effect.

Gradient Background

To display a gradient background:

• With the Builder turned on, select the row where you want to show the gradient background > select Styling icon > Styling Tab
• Background Type: Select "Gradient".
• Background Gradient: Here you can select to showcase the gradient effect as linear or radial, and also adjust the rotation on how you would like the color gradient to appear.
  • Color gradient Bar: The color selector bar gives a preview of how your color gradient will look on your row or column.
    • Click on the color bar to add a new color to the gradient color scheme.
    • Drag the color circles to adjust the gradient.

Row/Column Frame Styling

Style all row/column edges (from top, bottom, left, and right) with the row frame styling. You can choose from 25 beautiful preset shapes or upload your own shapes (eg. you can upload your SVG or PNG file as the frame style). There are options to set frame width, height, color, and repeat. It can also be styled differently for desktop, tablet, and mobile.

To apply row/column frames:

• Row: select a Row > Styling tab (or click the brush icon) > Frames. Select the tab where you'd like to place the frame: Top, Bottom, Left, or Right. Each tab will show the following options:
  • Type = Choose from the 25 presets or add your own custom frame (support SVG or PNG files).
  • Color = Set the color and opacity of the frame (Does not apply if you set custom frame).
  • Width = Width of the frame in px, %, or em.
  • Height = Height of the frame in px, %, or em.
  • Repeat = Set the number of times you would like the frame to repeat.
  • Display below content or Display above content = Choose whether you'd like the frame to appear below or above the row content.

Entrance Animation

Animation is the transition effect that triggers when the elements enters the viewing area. It can be set to rows and modules individually.

To apply: edit any row or module and click on the "Animation" tab and you'll see the following animation effects:

• Entrance Animation: The animation will trigger when the element is visible in the viewport.
  • Delay: Enter a number of seconds to delay the animation (eg. if you enter "1.5", it will wait 1.5 seconds before the animation is triggered)
  • Repeat: Enter the number of times you'd like the animation to repeat.
• Hover Animation:
  Animation will trigger when you hover over the element.

Scroll Effects

A scroll effect is the movement of an element that is triggered by the scrolling of a page (ie. as you scroll the page, the element has an animation effect). View the demo here to see how it works.

To enable scroll effects:

• Edit any module or row, go to the Animations tab > Effects > Motion and you'll see all of the scroll effects listed:
• Vertical: Make an element scroll up or down, at various speeds and viewport.

• Horizontal: Make an element scroll left or right, at various speeds and viewport.
• Transparency: Make an element fade in, fade out, fade in out, or fade out in.
• Blur: Make an element's blur effect fade in, fade out, fade in out, or fade out in.
• Rotate: Make an element rotate left or right, at various speeds and origin points.
• Scale: Make an element grow bigger or shrink smaller, at various speeds and origin points.

Vertical Scroll:
To enable vertical scroll, select a Direction, Speed, and Viewport:

• Direction: select 'Up' or 'Down' to change the direction your element travels (up moves the element to the top of the screen, down moves the element to the bottom of the screen)
• Speed: selecting a speed will change how fast or slow the scroll effect animates (level 1 is the slowest, 10 is the fastest)
• Viewport: selecting a viewport range will control where on your screen an element's scroll effect will be active (0% is at the very bottom of your browser's screen, 100% is at the very top of the browser's screen)

Horizontal Scroll:
To enable horizontal scroll, select a Direction, Speed, and Viewport:

• Direction: select 'To Left' or 'To Right' to change the direction your element travels (left makes the element move toward the left of the screen, right makes the element move toward the right of the screen)
• Speed: selecting a speed will change how fast or slow the scroll effect animates (level 1 is the slowest, 10 is the fastest)
• Viewport: selecting a viewport range will control where on your screen an element's scroll effect will be active (0% is at the very bottom of your browser's screen, 100% is at the very top of the browser's screen)

TIP: To create a Diagonal Scroll effect, add both a Vertical + Horizontal Scroll!

Transparency:
To enable transparency, select a Direction and Viewport:

• Direction: select one of the following options
• Fade In: the element will fade in from invisible to visible
• Fade Out: the element will fade out from visible to invisible
• Fade Out In: the element will fade out, then fade back in
• Fade In Out: the element will fade in, then fade back out
• Viewport: selecting a viewport range will control where on your screen an element's scroll effect will be active (0% is at the very bottom of your browser's screen, 100% is at the very top of the browser's screen)

Blur:
To enable blur, select a Direction, Level, and Viewport:

• Direction:
• Fade In: the element will go from blurry to clear
• Fade Out: the element will go from clear to blurry
• Level: selecting a level will determine the severity of the blur effect (level 1 is the least blurry, level 10 is the most blurry)
• Viewport: selecting a viewport range will control where on your screen an element's scroll effect will be active (0% is at the very bottom of your browser's screen, 100% is at the very top of the browser's screen)

Rotate:
To enable rotate, select a Direction, Number of Spins, Transform Origin, and Viewport:

• Direction: select 'To Left' or 'To Right' to change the direction your element will spin (left makes the element spin counter-clockwise, right makes the element spin clockwise)
• Number of Spins: select a number to determine the number of spins you want
• TIP: For more subtle movements, opt for any decimal numbers under 1. For eg. A spin number of 0.25 will cause a quarter turn, or 0.05 will cause an even slighter movement)
• Transform Origin: the transform origin determines at which point on the element the spin will occur. Select a transform origin by dragging the blue dot anywhere in the transform origin box or leave it at the default Center, Center position. (eg. Selecting a transform origin of Top Left means that the Top Left corner of the element will be the most static and the rest of the element will spin around this origin point)
• Viewport: selecting a viewport range will control where on your screen an element's scroll effect will be active (0% is at the very bottom of your browser's screen, 100% is at the very top of the browser's screen)

TIP: To create cool multiple effects, you can set one or two scroll effects, for example, to start at 10-40%, and a third and fourth to begin at 41-90%.

Scale:
To enable scale, select a Direction, Scale Ratio, Transform Origin, and Viewport:

• Direction: select 'Scale Up' or 'Scale Down' to change the way the element will resize (Scale Up increases the element's size, Scale Down decreases the element's size)
• Scale Ratio: select a number to determine the how big or small the element will resize to relative to it's current size
• TIP: Scale Up at a Scale Ratio of 1.1 means the element will become 10% bigger, a Scale Ratio of 2 means the element will double in size
• Transform Origin: the transform origin determines at which point on the element the scale will occur. Select a transform origin by dragging the blue dot anywhere in the transform origin box or leave it at the default Center, Center position.
• Viewport: selecting a viewport range will control where on your screen an element's scroll effect will be active (0% is at the very bottom of your browser's screen, 100% is at the very top of the browser's screen)

TIP: To check your scroll effects on the fly, keep another tab open of the live page you're working on to refresh and quickly view your changes. View our demo here for inspiration.

Builder Sticky

The sticky effect allows you to make certain rows/modules stick on the screen when it scrolls to a certain point.

To apply: edit any row or module and click on the "Animation" tab, click on the "Sticky" tab, and you'll see the following options:

• Sticky:
  • Check "Stick at" checkbox and then select the position, either "Top Position" or "Bottom Position", that you'd like the module to stick at. Then enter the position value (eg. if you select stick at top position 0px, it means the element will stick when it is scrolled to 0px from the top of the page).
  • If you don't enable the "un-stick" option, the element will remain sticky. With the un-sticky option, you can specify when to un-stick the element. To specify un-stick: check "Un-stick when" checkbox, then select the un-stick conditions (eg. if you select un-stick when row #contact-row hits this element, it means the element will un-stick when the row with the ID name 'contact-row' scrolls to the element).
  • Z-index: Module with a greater stack order number is always in front of a module with a lower stack order. If you find an element is behind a certain element, you can increase the z-index to adjust the stacking order.

Global Style

Global Style (GS) is a time-saving feature that allows you to reuse the same styling in multiple instances across the entire site. Simply style any row, column, or module to your liking, then save it as a GS (Global Style), and reuse it by inserting it onto any other element of your choice. When you edit a GS, all the changes are automatically applied to any element using that same GS (read the announcement post for more details).

How to Save Styling as a Global Style:
You can save any element's style settings as a Global Style to have for safe keeping, or to reuse it on another module.

• To save as a Global Style: edit any module or row, go to the Styling tab > click the Global Styles big paintbrush icon (in the top right corner), click 'Save as Global Style', enter a Global Style name, click 'Yes' to apply your new Global Style.

How to Insert a Global Style:
You can reuse a Global Style by inserting it onto another module of your choice. NOTE: Once you insert a GS, the paint icon will be highlighted in a purple colour to indicate that a GS has been inserted.

• To insert a Global Style: edit any module or row, go to the Styling tab > click the Global Styles paint icon, click 'Insert Global Style' and select your Global Style of choice.

How to Edit a Global Style:
You can edit any saved Global Style. NOTE: Any changes you make will automatically be reflected on any module that is occupied by that same Global Style (ie. the changes will apply site-wide on any module with that GS).

• To edit a Global Style: edit any module or row that has an existing Global Style inserted, go to the Styling tab > click the Global Styles paint icon, click the pencil icon next to the Global Style name, make your styling changes, then click 'Save Style' to save.

How to Import, Export, and Delete a Global Style (In the Backend):
You can manage all of your Global Styles on the backend, including importing, exporting, deleting, and editing any saved Global Style.

To access the backend of Global Styles:

Option A) Edit any module or row that has a GS inserted, go to the Styling tab > click the Global Styles paint icon, click 'Insert Global Styles' > click 'Manage Styles' from the top right corner.

Option B) Go to WP Admin > Themify > Global Style.

On the GS backend, you can do the following:

• Export: Click the green export icon to export a GS.
• Import: Click the import button to import a GS.
• Delete: Click the X icon to delete a GS. NOTE: Once you delete a GS, it will affect the styling of all modules that have the GS inserted throughout the entire site.
• Edit: Click the thumbnail to edit the GS.

Visibility Control

You can set the rows and modules to be visible on specific device views (desktop, tablet, and mobile). By default, all device views are visible.

• To set Visibility: edit any row or module, click on the Styling tab, toggle the buttons to hide the device view.
  • Desktop = Hide desktop will hide object when viewport is larger than 1024px.
  • Tablet = Hide tablet will hide object when viewport is between 680px and 1024px.
  • Tablet Landscape = Hide tablet will hide object when viewport is between 680px and 1024px and the orientation is on landscape mode.
  • Mobile = Hide mobile will hide object when viewport is less than 680px.
  • Sticky Visibility = The element will be hidden when its parent row's sticky effect is active.
  • Hide All = Means the element will be hidden on all devices.

Page Break

This new feature allows you to break your Builder layout into multiple pages. Making your pages load faster while still allowing your readers access to read all of your content.

How to use Page Break:

• To add a Page Break: on the module panel, drag the "Page Break" module under the row where you want to break the page. You can drop as many Page Break modules as you want (each Page Break module will create an inner page).
• To remove the dropped Page Break: hover over the Page Break module on the layout and click on the "X" button.

Revisions

Builder Revisions gives you a "save as" like feature, allowing you to save your Builder layout with unlimited versions. The Builder will log this revision and allow you to revert back to it, if you'd like. This is great for users who suddenly make a mistake when changing something from their site and don't know how to fix it.

• To save Revisions: on the frontend Builder, next to the Save button, hover over the arrow and select "Save as Revision"
• To load Revisions: select "Load Revision" and it will prompt you whether to save the current state before loading a revision.
  • NOTE: If the revision list on the option lightbox shows a gray color and the revision link is not clickable, it means the revision does not have a Builder layout, thus it won't allow you to load an empty Builder revision.

More Tag

You can insert a read more button to trim down the text and focus on the visuals in the text module. Readers who want to read the full content can click the "read more" button.

To add a More Tag:

• Drag and drop a Text module and click on the "More" option toolbar.

Default Modules

These are the default modules that come with the Builder:

• Accordion = Displays expandable/collapsible content.
• Alert = Schedule, display for a specific number of times, show to either login/public visitors, or auto close after a certain number of seconds.
• Box = Displays text content in a box.
• Button = Display button links (it could be a single button or multiple).
• Callout = Displays a "call for action" box (heading with a link button).
• Code = Display code as text.
• Copyright = Display copyright credit text.
• Divider = Displays a divider between modules.
• Fancy Heading = Displays a main heading and a sub-heading with border divider in the middle.
• Feature = Displays an animated circle with a large icon.
• Gallery = Displays a gallery with image lightbox/zoom.
• Icon = Displays a decorative icon with an option to include an icon label.
• Image = Displays an image with title and caption.
• Layout Part = Displays the Layout Part that you've saved.
• Link Block = Display a large link block with icon, title, and a blurb.
• Login = Displays the WordPress login form with password reset feature.
• Lottie Animation = Display Lottie, a light-weight, interactive motion graphic format
• Map = Displays a Google Map.
• Menu = Displays a WordPress custom menu created in Appearance > Menus.
• HTML/Text = Uses HTML/Text to display HTML, JS, and shortcodes.
• Optin Form = Displays newsletter subscription forms (Mailchimp, etc.).
• Overlay Content = Display a burger icon which opens a Layout Part as dropdown or lightbox.
• Page Break = Split your Builder content in multiple pages with pagination.
• Post = Displays posts from any category.
• Service Menu = Displays service/pricing menus.
• Signup Form = Allows your visitors to signup an account in your WordPress site.
• Slider = Displays a slider of posts, images, videos, or text content.
• Social Share = Display social share buttons for users to share your posts/pages.
• Rating Star = Display rating stars.
• Tab = Displays tabbed content.
• Testimonials = Displays customer testimonials in a slider or grid layout.
• Text = Visual text editor with shortcodes and HTML support.
• Table of Content = Auto generate a table of content on the page based on the headings.
• Twitter = Display a Twitter account's feed (require Twitter API entered in Themify settings).
• Video = Embeds videos from YouTube, Vimeo, etc.
• Widget = Displays any WordPress widget.
• Widgetized = Displays a widget area.

Themify Builder Settings

Builder Settings (Themify theme version)

If you are using a Themify theme, the Builder settings can be found in the Themify panel > Settings > Themify Builder.

On the Builder setting panel, you should see:

• Themify Builder Options:
  • Enable/disable the Builder completely (NOTE: when the Builder is disabled, the entire Builder content will not appear on all pages)
• Animation Effects:
  • Disable appearance animation, parallax background, float scrolling and sticky scrolling on tablet, mobile, or on all devices.
• Builder Modules:
  • Disable the modules individually (NOTE: when a module is excluded, only the excluded module will not appear on the page).
• Tools:
  • Find & Replace: Find and replace all content entered in the Builder. For example: if you've moved to another domain, you can use the find & replace tool to replace all URLs in the Builder to the new domain.
  • Regenerate CSS Files: Use this tool to regenerate the Builder styling (ie. it will re-generate the Builder styling CSS files on the server when a visitor views the page).
  • Maintenance Mode: Enable maintenance mode if you don't want public visitors to see your site (ie. when you are still building the site or in the progress of setting up something on the site, you can use this tool to display a maintenance/coming soon page). When the maintenance mode is enabled, all pages on the frontend will be redirected to the selected maintenance page.

Builder Settings (Builder plugin version)

If you are using the Themify Builder plugin, the Builder settings can be found on the WordPress admin sidebar > Themify Builder > Settings. The available options on the Builder plugin settings are the same as the Themify settings (only the option interface is different).

Builder Cache & Minified Scripts

Script minification and caching allows you to improve the page site load on the frontend. Since script minification/compiling is a common cause to Javascript conflicts between plugins, it is disabled by default.

To enable script minification & Builder Cache:

• Go to Themify panel > Theme Settings > Builder Cache & Minified Scripts
• Select "Enable minification" radio to enable it. You can also enable Builder cache and gzip caching.
• To reduce file size, all Themify themes and Builder scripts (Javascript and CSS files) are minified. You can disable the minified scripts if you want to use the un-minified version.

NOTE: If you don't see the Builder Script Minification option in the Theme Settings option, it means caching is not supported with your server (either due to old PHP version or server not permitting to write cache files).

Builder Static Content

If you have WordPress Gutenberg editor enabled (Gutenberg is the new WP editor introduced in v5), you will see the Builder Block which you can move up/down like all other Gutenberg Blocks. If you have Gutenberg editor disabled, you will see the Builder content placeholder like the screen below.

The Builder content placeholder represents where the Builder content will be displayed. You can add content before or after the content placeholder. If you don't see the Builder Content Placeholder, make sure you are using the latest version and try to re-save the post/page again.

Notes:

• The Builder static content serves as your fallback content when the Builder is disabled/removed. It also allows WordPress to search your content in the Builder.
• When you update the post/page, the Builder static content will refresh/regenerate (this is normal). It will not appear on the frontend when the Builder is active.
• The Builder Content Placeholder badge only applies to WordPress versions prior to 5.0 or if you have Gutenberg disabled. If you are using WP 5.0+, the Builder content is treated as a Gutenberg Block.

Custom CSS Class

Custom CSS class is used by developers to write custom CSS to apply styling to specific elements that contain the CSS class name. The advantage of using custom CSS class is when you update the CSS styling, it will apply to all elements that contain the target class name. You only need to write the custom CSS once, then it can be reused to as many elements as you want by adding the custom class name. 

Sample Usage:

• Lets say you have a few rows or modules that you want to have the same yellow background and black text color, you would add 'yellow-box' in the "Additional CSS Class" field (all rows and modules have this field in the option lightbox).
• Then add the sample custom CSS as below. Now whichever rows or modules have that additional CSS class will have a yellow background with black text styling. When you change the CSS code, it will apply to elements automatically without having to edit the Builder.

.yellow-box {
	background: #FFEB3B;
	color: #000000;
}

Builder Addons

The Builder is extendable with Addons. Installing Builder Addons is the same as installing standard WordPress plugins. Here is a detailed tutorial on how to install addons.

FAQs

1. Does the Builder work on the homepage?
   The Builder works with all posts, pages, and any post type that has the_content enabled.  The default WordPress homepage is actually an archive page that shows the latest posts. To use the Builder on the homepage, first create a new Page and then assign that page as the Front Page in WP > Settings > Reading.
2. I've logged in, but I don't see the WP admin top bar. Why?
   If you don't see the top admin bar (WP Admin Topbar) on the frontend, it is likely disabled. To enable top admin bar, edit your user Profile and check the "Show Toolbar when viewing site" option.
3. I can turn on the Builder, but there is no grid to drop modules.
   If you don't see the Builder grid after turning on the Builder (but the module panel presents), it is likely because the template does not have the required WordPress function, the_content() or the template is using the_excerpt(). In this case, try to add a new post or page.
4. The Builder won't turn on in the frontend. Why?
   - First, make sure that you are viewing a single post or page, not an archive page (examples of archive page: search, tag, category, taxonomy archive, etc.).
   - Second, make sure the top admin toolbar is enabled in your WordPress site.
   - Lastly, it is likely due to plugin conflicts. Try to disable all plugins and check again.
5. Can I use the Builder to edit the header, sidebar, and footer?
   You can use Builder Pro to do this. It allows you to create custom header, footer, and other templates for post, page, WooCommerce and custom post types.
6. I don't use the Builder. Can I disable it?

   Method 1) You can disable the Builder in Themify > Settings > Themify Builder. If you are using the standalone Builder Plugin, deactivate the plugin will disable the Builder.

   Method 2) You can also disable the Builder in the child theme functions.php with this code:

   
   <?php
   add_filter('themify_enable_builder','custom_disable_builder',100,1);
   if(!function_exists('custom_disable_builder')){
   	function custom_disable_builder($enable){
   		return 'disable';
   	}
   }
   ?>
   

   To hide the Themify Builder tab on the Themify panel:
   - Paste the following code in the child theme functions.php:

   
   /* Add custom styles for admin part */
   function custom_child_admin_stylesheet() {
   	wp_enqueue_style( 'child-admin-style', trailingslashit( get_stylesheet_directory_uri() ) . 'child-admin-style.css' );
   }
   add_action( 'admin_enqueue_scripts', 'custom_child_admin_stylesheet' );
   

   - Create a child-admin-style.css file. In the css file, paste the following code:

   
   #themify li[aria-controls="setting-themify-builder"] {
       display: none;
   }
   

7. Once I disable the Builder, will the layouts I created with the Builder show?
   No, the Builder is required to render the layouts that are created with the Builder. Once the Builder is disabled, it will show the static content of the Builder (ie. it will show the text content without the dynamic content and styling).
8. Where are the old custom post types (Slide, Highlight, Portfolio, and Testimonial)?
   Note: The updated Themify framework 2.1.2 and Builder plugin 1.3.1. have obsolesced the following custom post types: Slide, Highlight, Portfolio, and Testimonial. To provide backward compatibility, the Highlight posts will remain functional if your site has existing Highlight posts. If you would like to continue using these custom post types, we've created a free plugin called Builder Deprecated CPT. This plugin will unlock the deprecated custom post types.
9. When I try to import/upload Builder layouts zip or txt file, it says "Sorry, this file type is not permitted for security reason"?
   This is because the file format is not allowed in your WordPress network setting. To allow more file extensions, please go to your WP Network Admin > Settings > "Upload File Type" > Add file format extensions (i.e. txt zip).
10. My WP Admin is HTTPS, when I switch to frontend that is HTTP, the Builder doesn't work.
    When you login in admin that is secured (HTTPS), the login session is captured as HTTPS domain. If your frontend URL is not HTTPS, the frontend Builder will not work because the browser treats HTTPS as a different domain. To fix this: go to WP Admin > Settings, change the "WordPress Address" and "Site Address" to HTTPS URL.
11. How do I trigger an active Tab or Accordion by using URL hash?
    First drop in a Tab module and create the tabs as you like. View the page on the frontend with Google Chrome, right-click on the tab navigation (https://cl.ly/2g2n183x2n3c) and select "Copy Link Address", now you can paste that URL as hyperlink (eg. the link URL would be something like http://yoursite.com/page-url/#tab-tab-6925-0-0-0-6925-2). This works the same for Accordion module (just right-click on the accordion title and then copy link).
12. I'm using a Themify theme and Builder, there is padding between the header and content area. How to remove it?
    That is the content container padding. To remove it, edit the page in the backend, on Themify Custom Panel, select "Content Width = Fullwidth".

    

13. Disable URL change with scrollTo anchors
    On the row anchor option, you can select "Hide anchor on URL" or you can disable it with custom code: https://themify.me/docs/theme-code-snippets#disable-url-change-with-scrollto-anchors
14. Offset scrollTo position with third party themes
    Using ScrollTo anchor feature in Builder, by default it scrolls to the top of the row. To set the scrollTo position, go to Themify > Theme Settings > Themify Builder, enter the "ScrollTo Offset" position.
15. The theme/Builder shows broken interface due to .gz issue
    Make sure your server supports .gz file. Our themes come with pre-packaged .gz compressed files to reduce file size. On Nginx server, it picks up .gz file and serves them instead of the actual asset. Please contact your host provider and ask them to enable this feature.
16. How to override Builder Post module loop template
    If you are using a Themify theme: you would create a child theme, then copy includes/loop.php file from the parent theme to <your-child-theme>/includes/loop.php. Now you can edit the child theme loop template as you want. If you want to override the loop template for other post types, you would rename it to "loop-{posttype}.php" wherein "posttype" is the slug name of your post type. For example, if you have a movie post type, the file name and path should be: <your-child-theme>/includes/loop-movie.php.

    If you are using the Builder plugin:
    the step is same as above, but the file and folder path is different. You would copy the post template from themify-builder/templates/template-blog.php to <your-child-theme>/themify-builder/template-blog.php.

Read More

26 Jul 2019

Themify Builder Pro Documentation

/ Comments Off on Themify Builder Pro Documentation

Themify Builder Pro is a theme builder that allows you to build a complete theme without any coding. It gives you total control of everything on your site: header, footer, and content templates such posts, pages, categories/archives, custom post types, and WooCommerce templates.

Video by James Welbes.

Installation

Builder Pro requires a Themify theme or the free Themify Builder plugin in order to be used. You only need to install one of them (either a Themify theme or the Builder plugin). If you are using a non-Themify theme, you can either switch to a Themify theme or install the free Builder plugin to start using the Builder Pro.

To install Builder Pro:

• First install a Themify theme or Themify Builder plugin (you only need to install one of them):
  • Option A) To install a Themify theme: login to the Member Area, download the theme zip of your choice (eg. Ultra theme), then login to your site: WP Admin > Appearance > Themes > Add New, upload the theme zip and activate the theme (learn how to install themes).
  • Option B) To install the Builder plugin: download the Builder plugin zip (free), then login to your site: WP Admin > Plugins > Add New, upload the Builder plugin zip and activate it.

• After you have a Themify theme or Builder plugin activated, install Builder Pro:
  • To install Builder Pro: login to the Member Area, download the Builder Pro plugin zip, then login to your site: WP Admin > Plugins > Add New, upload the Builder Pro plugin zip and activate it.

Pro Themes

Builder Pro uses the same theme system as WordPress' core. When you create a theme using Builder Pro, it is called a Pro Theme. A Pro Theme consists of various templates: header, footer, post template, page template, etc. When you activate or switch a Pro Theme, all of the associated templates of that Pro Theme will be active or switched. This allows you to change your entire site design quickly, just like installing a different WordPress theme. Before you start creating any templates, you would need to create a Pro Theme first so that your templates will be associated with a specific Pro Theme.

To create a Pro Theme:

• Go to WP Admin > Themify > Pro Themes, click "Add New"
• Enter a Theme Name of your choice, upload the optional theme Thumbnail image, and click "Next".
• You will then have the option to create a blank theme or import a premade theme.
  • To create a blank theme: select the "Blank" thumbnail and click "Activate".
  • To import a predesigned theme: select a theme thumbnail of your choice and click "Activate". When a predesigned theme is imported, it will automatically import the associated templates in the theme.

  

To deactivate or delete a Pro Theme:

• Go to WP Admin > Themify > Pro Themes
  • To deactivate a Pro Theme: click "Deactivate" on the activated theme thumbnail. Once a theme is deactivated, all the Pro Templates will be deactivated as well.
  • To delete a Pro Theme: click on the theme thumbnail, then click "Delete". NOTE: You can delete the activated Pro Theme. In order to delete it, you have to deactivate the theme first, then delete it.

Pro Templates

Pro Templates are the layouts that define how the page should look like on the frontend. Before you start creating any Pro Templates, learn the types of templates first to understand what they do.

Pro Template Types

• Header: The template covering the header area.
• Footer: The template covering the footer area.
• Single: A single template is used for a single post view (eg. when you view a blog post, that would be considered a single post view).
• Archive: An archive template is used on archive views (eg. when you view a blog post category, or tag pages, they are considered archive views).
• Page: The template for static pages (eg. a homepage or 404 page).
• Product Single: A product single template is used on the single product view (eg. when you view a product).
• Product Archive: A product archive template is used on product archive views (eg. product category pages, product tag pages, and the shop page would be considered product archive views).
  • NOTE: If the WooCommerce plugin is not yet activated, you won't see the Product Single and Product Archive template types.

To create a Pro Template:

• Go to WP Admin > Themify > Pro Templates, click "Add New"
  • NOTE: In order to create a Pro Template, you need to have a Pro Theme activated. If you haven't created/activated a Pro theme yet, go to Themify > Pro Themes to do so.
• Enter in the following to create a new Pro Template:
  • Name: choose a template name of your choice
  • Associated Theme: you should select your activated theme, or you can select a different theme if you want the template to be used in another theme
  • Type: select a "Template Type"
  • Display Conditions: select the "Display Conditions" to specify where to use the template, then click "Next"
• Then you will have the option to create a blank template or import from a predesigned template.
  • To create a blank template: select the "Blank" thumbnail and click "Publish".
  • To import a predesigned template: select a theme thumbnail of your choice and click "Publish".
• After the template is published, it will redirect you to the frontend to design the template.
• The frontend template edit uses the same Themify Builder to design the layout (learn how to use Themify Builder here).

  

Display Conditions

Display conditions allow you to choose when the template should be used. For example: if you want a template to be used on only specific posts or categories, you would use the display conditions.

To set Display Conditions:

• Go to WP Admin > Themify > Pro Templates, either add a new template or click a template's "Options" to edit an exisiting template's display conditions.
• On the template's options lightbox, you will see "Display Conditions"
• The first selection (a grey button) will allow you to choose whether to "Include" or "Exclude" the template (eg. if you select "Include" for all post categories, then the template will be used on all post category views).
• The second selection allows you to choose where to use the template:
  • Entire Site: It means the template will be used on the entire site (eg. for the header template, you would select entire site so the header template will appear on every page).
  • Archives: It refers to all general archive views (eg. post category pages, tag pages, custom taxonomy views, etc.)
  • Singular: It refers to all single post views (eg. single view of all post types)

• NOTE: A third selection only shows depending on the second selection. The fourth selection only shows depending on the third selection. They are further options you can choose for more specific conditions (ie. it allows you to choose the template to be included/excluded on specific posts, pages, categories, etc.).
• TIPS: You can add multiple display conditions on a template to refine the template display. For example: you can set a header template to be included on the entire site, but be excluded from a specific category. To do that, you would select "Entire Site" for the first condition, then add a new condition and select "Exclude > Categories", then select the category you want the template to be exclude from.

  

Display Condition Examples

To display a template on a few select pages only:

• On the display condition, select Include > Singular > All Pages > uncheck "All" and select the page(s) that you want to display the template on

  

To display on the entire site, but exclude on a few pages:

• On the first condition, select Include > Entire Site
• Add a new condition, select Exclude > Singular > All Pages > uncheck "All" and select the page(s) that you want to exclude

  

To display a shop header on WooCommerce shop pages:

• On the first condition, select Include > Singular > All Product
• Add a new condition, select Include > Archives > All Product Archives (the template will display on all product pages and product archives)

  

WooCommerce Templates

WooCommerce is a popular free eCommerce WordPress plugin.

Requirements:

• In order to create the product templates, you must have the WooCommerce plugin installed and activated. If you haven't installed WooCommerce yet, download the WooCommerce plugin here. Login to your site: WP Admin > Plugins > Add New, upload the WooCommerce plugin zip and activate it.
• After you have WooCommerce installed, you also need to have at least one published Product and Product Category. To add a product: go to WP Admin > Products > Add new.

To create WooCommerce templates:

• Go to WP Admin > Pro Templates, click "Add New"
• Enter the template name (eg. Product Archive Template)
• Leave "Associated Theme" as is (it should have your current activated theme selected)
• Select "Type" to "Product Archive" or "Product Single" (if you don't see the product type options, it means you don't have the WooCommerce plugin installed/activated).
  • Product Archive: It refers to the shop page, product category and product tag pages.
  • Product Single: It refers to a single product page.
• Leaving "Display Conditions" with the default selection is fine. If you want to include or exclude the template on specific views, you can further select the display options. See "Display Conditions" for more details.
  • Tips: If you want to have a different template for the shop page and product categories/tags, you would create 2 templates: set one template display condition to the shop page only and another template to display on product categories and product tags only.
• Then click "Next" and you will have the option to create a blank template or import from a predesigned template. When you click "Publish", it will direct you to the frontend to edit the template.

  

Dynamic Content

Dynamic content is a feature allowing you to display on the frontend, the dynamic content/info (such as custom fields) attached with each post. It is a powerful tool to create dynamic templates that change based on a post's content without having to do the manual work. You can use the dynamic content feature to create advanced archive layouts such as property listing site. Below are a few sample usages of dynamic content.

Displaying custom field value:

• To display custom field value, on any module that has the "Dynamic" switch (eg. Text module), enable the "Dynamic" switch, select "Custom Field" and enter the "Custom Field" name (eg. if you have a property post type with custom field slug property_price, you would enter that to display the property price custom field.
• If the custom field is a shortcode, you can enable the "Enable Shortcodes" option. Do not enable shortcode if the custom field value is not a shortcode.
• You can add text before and text after the custom field value.
• On the "Display Condition", when the custom field is empty, you can choose to hide the row, module, subrow or show the fallback value.

Displaying Post Featured Image as a background image:

• Edit the single post Pro Template
• On any row, column, or module styling, enable the "Dynamic" switch and select the "Post Featured Image". On the single post view, you will see the featured image being used as a background image.

  

Display an author's picture with the Image module:

• Edit the single post Pro Template
• Drop in an Image module
• Enable the "Dynamic" switch and select "Post Author Avatar". If you view a live post, you will see the author's picture displaying in the image module. This feature is great if you run a site with multiple authors and you want to display the author picture on each post, without having to manually change it each time.

  

Using FitText addon as the post title:

• Edit the single post Pro Template
• Drop in a FitText module (if you don't see the FitText module, you need install the FitText addon)
• Enable the "Dynamic" switch on both the "Text" and "Link" field. On the "Text" field, select "Post Title" and on the "Link" field, select "Post Permalink" (link option is optional). Now if you view a single post, you should see the FitText addon being used to display the post title.

  

Using Image Pro as an archive post layout:

• Edit the post archive Pro Template
• Drop in an Advanced Posts module and edit it
• Then on the archive post layout, then drop in an Image Pro module (if you don't see the Image Pro module, you need install the Image Pro addon)
• Enable the "Dynamic" switch on the following fields:
  • "Image URL" and select "Post Featured Image"
  • "Link Type" and select "Post Permalink" (you may select the optional "Lightbox" feature which will open the post in a lightbox)
  • "Image Title" and select "Post Title"
  • "Image Caption" and select "Post Excerpt"

    

• Now if you view a post category, you should see the Image Pro being used to display the post featured image, title (linked to single post), and post excerpt.

Adding dynamic custom CSS Class:

• Let's say your theme has a post layout option and that is stored in the post meta data (ie. custom field). You can display that layout value as the row/column custom CSS class in the template.
• Edit the single post template
• On a row option, enable "Dynamic" on the "CSS Class" field, select "Custom Field" and enter the "Custom Field" name. Now if you view a live post, you should see that custom field value being added in the row class. You can use that CSS class to apply custom CSS for unique layout styling.

  

Theme Import/Export

Theme import/export allows you to transfer your Pro themes from one site to another. Or you can use it to backup your themes.

To export a Pro theme:

• Go to WP Admin > Pro Themes
• Click on the theme thumbnail to view theme details, then click the "Export" button. It will prompt you to download a zip file (that is your theme data). When a theme is exported, it automatically exports all associated templates in the zip file.

  

To import a Pro theme:

• Go to WP Admin > Pro Themes
• Click "Import" and upload the Pro theme zip file that you previously exported. When a Pro theme is imported, it automatically imports all associated templates stored in the zip file.

  

Template Import/Export

The template import/export tool allows you to transfer select templates, instead of a whole theme and its associated templates.

To export a single Pro Template:

• Go to WP Admin > Pro Templates
• Hover over the template that you want to export and click "Export" (it will prompt you to download the template data zip file)

  

To export multiple Pro Templates:

• Go to WP Admin > Pro Templates
• Check the templates that you want to export, from the "Bulk Action" menu, select "Export" and click "Apply" (it will prompt you to download the template data zip files)

  

To import Pro Templates:

• Go to WP Admin > Pro Templates
• Click "Import" and upload the template data zip file that you previously exported

  

Builder Pro Modules

Builder Pro includes a bunch of additional modules that are specifically for template building. Pro modules are grouped as: Site, Single, Archive, Product Single, and Product Archive. The Pro modules are loaded on the module panel according to the template type that you are editing (eg. if you are editing a single template, it will show the single module group).

Pro Module Groups

• Site: General site elements such as site logo, tagline, menu, search, etc. (mainly used on header and footer templates)
• Single: Modules that are related to post elements such as post title, post meta, featured image, post content, etc. (mainly used on single post and single custom post types)
• Archive: Modules that are related to post archives such as archive title, archive posts, etc. (mainly used on archives)
• Product Single: Modules that are related to product elements such as product title, price, product image, add to cart, etc. (mainly used on product single)
• Product Archive: Modules that are related to product archives such as archive title, archive products, etc. (mainly used on product archives)

Pro Modules

• SITE
  • Cart Icon: Ajax WooCommerce cart button (ie. it displays the items that customers added to their cart). You need to have the WooCommerce plugin activated in order to use this module.
  • Menu: It displays the WordPress custom menus that you create in Appearance > Menus.
  • Search Form: It displays the WordPress search form.
  • Site Logo: It displays the site logo. You have the option to display the logo as either text or image.
  • Site Tagline: It displays the site tagline that you entered at Settings > General.

• ARCHIVE
  • Advanced Posts: It displays posts in archive views. It is the advanced version of the "Archive Posts" module which allows you to add additional modules inside the post layout.
  • Archive Description: It displays the category/taxonomy description (TIPS: to add the category description: go to Posts > Categories, edit a category and add description)
  • Archive Posts: It displays the posts in archive views.
  • Archive Title: It displays the archive title (eg. category title).

• SINGLE
  • Author Info: It displays the post's author profile such as author name, picture and biography.
  • Comments: It displays a comment list and the comment reply form.
  • Featured Image: It displays the post's featured image.
  • Post Content: It displays the post's content (you can choose either content or excerpt).
  • Post Meta: It displays the post's meta data such as published date, comment count, author, and categories.
  • Post Navigation: It displays the previous and next post link.
  • Post Title: It displays the title of the post.

• PRODUCT ARCHIVE
  • Advanced Products: It displays the products in product archive views (such as the shop page and product category pages). It is the advanced version of "Archive Products" module which allows you to add additional modules inside the product layout.
  • Archive Description: It displays the product category/tag description.
  • Archive Products: It displays the products in product archive views.
  • Archive Title: It displays the product category/tag title.

• PRODUCT SINGLE
  • Add To Cart: It displays the add to cart button.
  • Product Description: It displays the product description with an option to display either a long or short description of the product.
  • Product Image: It displays the product image.
  • Product Meta: It displays the product category and tag links.
  • Product Price: It displays the product price.
  • Product Rating: It displays the product's star ratings.
  • Product Reviews: It displays the WooCommerce product description tabs (description, customer reviews, and additional information).
  • Product Title: It displays the product title.
  • Related Products: It displays the related products.
  • Upsell Products: It displays the upsell products (TIPS: you can enter the upsell products by editing it in the backend, on the product metabox, click "Linked Products" and enter the upsell products).
  • WooCommerce Breadcrumb: It displays the WooCommerce breadcrumb navigation (normally placed at the top of the content area).

Read More