Doc Section: Advanced
Bundle Grid Builder in your theme
Selling WordPress themes? The theme author license lets you bundle Grid Builder Pro in your themes. Your buyers get the Pro features with the theme, without a key of their own; you ship its updates with your theme updates. What you get Bundle it Skins, filters and layouts made for your theme go in its...
Filters and events
Filter Use vlt_grid_query_args WP_Query arguments of a grid. vlt_grid_item_html HTML of one item. vlt_grid_config A layout’s settings after they are read. vlt_grid_css_classes Classes listed in the Custom CSS help (Pro). vlt_grid_empty_message The “No items found” text. vlt_grid_breakpoints Tablet and mobile widths. vlt_grid_image_size Image size of a layout. vlt_grid_sources Content sources of the editor. vlt_grid_template, vlt_grid_template_vars...
Editor controls
Add sections and fields of your own to the sidebar; values are saved with the layout in $config['extra']. Fields can add a class to the grid or set a CSS property, per device. Field types: toggle, select, number, text, textarea, color, image, separator. Extra fields for Media images: vlt_grid_image_controls.
Custom layouts and tiles
A theme layout type is a folder with layout.php (with Name: and Description: headers) that returns its settings. Each setting is available as the CSS variable --vlt-gb-{key} on the grid and to its script.js. Tiles patterns A pattern is the number of columns, then the tiles as width (columns) and height (in column widths, 1...
Theme templates
Every file in the plugin’s templates/ folder can be replaced from the theme at the same path, in a vlt-grid-builder folder. A child theme wins over the parent theme. Register a style so it shows up in the editor; its style.css and script.js load only where it is used. A registered style without its file...
Settings
Portfolio → Settings (or Grid Layouts → Settings without the portfolio): Tab Options Portfolio Turn the portfolio on or off; the project, category and tag addresses. Breakpoints Screen widths where grids switch to their tablet and mobile settings. Defaults: tablet up to 1024 px, mobile up to 767 px. Match them to your theme. Image...
Grid Builder Pro
Grid Builder Pro is a separate plugin that adds to the free one (keep both active). Its sections appear in the same sidebar. Without Pro, these sections show a short note. Settings you made with Pro are kept if you turn it off.
Extra features
Small features added by VLThemes Toolkit that work in the theme out of the box. Noise background A subtle film grain over the whole site. Turn it on in Appearance → Customize → Noise Background and set its Opacity. Z-Index controls whether the grain sits above or below the page content. Sticky elements in Elementor...
Events
Callback DOM event When onInit layermenu:init Instance created. onChange layermenu:change A transition starts (level already updated). onComplete layermenu:complete A transition ends. onDestroy layermenu:destroy Instance destroyed.
Methods
Clicking quickly never breaks the menu: a new step finishes the running transition first. Creating a second instance on the same element destroys the first one.
