Toolbox Settings

You can find the settings and options panel for Toolbox in your Dashboard > Settings section.

The settings and options consists of a number of tabs, each having a specific set of settings.

1. Main settings tab

On the main settings tab you will find options for settings for CPT’s, adding the *Toolbox tab to your nodes settings panels and adding the Google Maps API key for use within ACF and Toolbox. Let’s go over each setting:

Google Maps API key

Enter a valid API key to enable selecting addresses on Google Maps fields and the ability to drag Google Map fields into your layouts.

Activate postid on all fieldtypes

Adds an option to get fields from a postid, term_id or options page.

Display both fieldlabel and fieldname in dropdown

Add the fieldname in the dropdown as well, if labels alone are too confusing or generic.

2. Timber Templates

This section holds settings for Twig and Timber Templates. Options are added when Timber Library plugin is added to the site.

Enable Twig Templates CPT

Adds a Custom Post Type that is used to sync Twig Templates. The templates can be included or imported in Timber Posts to reuse templates by other templates or on seperate modules.

Allow these user roles to edit Twig Templates and Timber Posts Templates

Used to set the roles that have access to the Twig Templates and Template areas of the Timber Posts Module. If user does not have access, the CPT isn’t loaded and template area in modules are locked.

Twig Templates Editor Theme

Set the theme used for the (CodeMirror) editor used for the Twig Templates CPT.

Enable shortcode

This shortcode allows you to generate custom shortcodes based on Twig Templates. This is disabled by default, needs to be enabled to be able to use it.

Enable Twig Debug Messages on failure

Enable display of an error message when template doesn’t compile. If left unchecked, it doesn’t return anything.

Enable Toolbox Query Debug

Echo the Query parameters to the browser for extra debugging

Enable Timber Template on following Custom Fieldtypes

When Timber Library plugin is added to the site, you can manipulate the field directly when using the Toolbox Field Module in Beaver Builder. An extra Twig Template field will be added to the module to edit.

3. Beaver Builder / Beaver Theme

Force these post-types into Full Width layout

If you are using the Beaver Builder theme and/or Beaver Builder child-theme you can enable Default Full Width layouts on selected CPT’s. If you don’t, you will have a sidebar next to your layout.

Enable extra connections on selected modules

This option allows you to disable/enable some of the options Toolbox adds to the Rows, Columns and Modules panels. By default it will be activated and an extra Tab will be added to every node’s settings panel. The Tab is called “* Toolbox”.

On this tab you will find the Conditional Logic section and the Custom Attributes section, which are described later on in the documentation.

This option also changes some of the default modules settings so that it allows them to accept connections from within Beaver Themer.

Disable code check on Code Fields

Beaver builder uses a syntax checker to validate your html. When it return as invalid, Beaver Builder won’t allow you to save it until corrected. Because we can write our Twig templates in a way that it will render valid HTML, but is checked as being invalid as HTML, you can (temporarily) disable code-checking to allow saving anyway.

Enable Emmet in Timber Posts Module

A feature added in version 1.2.1 is the optional use of Emmet in the Twig templates. Emmet is a helper, that allows you to write complex HTML using a single line of code. More info can be found here: https://www.emmet.io

Enable custom snippets in Timber Posts Module

A feature added in version 1.2.1 is the ability to add custom snippets. If you regularly find yourself adding the same code, or need a set of code blocks to start out with, you will be able to add those using a few lines of javascript.

3. UIkit CSS/JS

Load UIkit CSS and JS

UIkit is our go-to framework, because of it’s descriptive classnames and extensive documentation. When the included UIkit CSS and JS is enqueued you need to use HTML only to unleash UIkit’s features.

4. Conditional Filters

Here you will find settings for the conditional filters in Toolbox.

Server timezone

Set the timezone to the server’s location to be able to evaluate the datetime correctly.

5. License

License Key

Click the “Enter License” button and enter your license-key that has been sent to you after purchase. This will enable you to receive updates from within your WordPress Dashboard.

6. Tools

Import Twig Files to Posts

Timber uses actual files to include or import. You can copy/move generated twig templates from site A to B by using an SFTP client and copying the .twig files found the site’s “uploads/twig_templates” folder from site A to B. To be able to edit them, use this button to import them to the CPT, after which they will be synced.

Export Twig Posts to Files

When you use the default WP Export/Import features to transfer data between sites, it has not generated the files that are needed for the include or import in templates. This button will generate all necessary files, one for each post in the Twig Templates CPT. Alternatively you can edit/publish each seperate Twig Template post, if needed a file will be generated in your site’s “uploads/twig_templates” folder.