Skip to content

Admin Settings

Ben Gillbanks edited this page Jul 28, 2020 · 3 revisions

Toolbelt intentionally keeps settings to a minimum, however there are a number of ways to customize settings for theme and plugin developers.

You can check out the docs for each feature to see what settings can be altered.

For the plugin as a whole, there are also additional settings that can be applied. These are useful for sites where you don't want users to edit the settings, or where you want to change things like style settings that affect all of the features.

TOOLBELT_DISABLE_ADMIN

If the TOOLBELT_DISABLE_ADMIN define is defined then the plugin admin will not be displayed.

define( 'TOOLBELT_DISABLE_ADMIN', true );

toolbelt_options

By default Toolbelt stores options in a single database entry. However this can be overriden with the toolbelt-options filter.

The filter allows you to send back a list of the active modules. If anything other than null is returned the database options will be ignored entirely.

function my_toolbelt_options() {
    return array(
        'social-menu' => 'on',
        'breadcrumbs' => 'on',
    );
}
add_filter( 'toolbelt_options', 'my_toolbelt_options' );

This can be used on client projects. You can set up a filter to enable the options you want, combined with the TOOLBELT_DISABLE_ADMIN, and then place it in an mu-plugin. This will stop clients from enabling/ disabling features that may disrupt the website.

Clone this wiki locally