README

What is this repository for?

Beaver Builder Extra Fields allows for the use of custom fields in your custom modules. There are currently the following extra fields:

- toggle field A multi-option button like field that could substitute for yes/no selectboxes or one/two/three options. It has no set constraints on number of options though but make sure it fits on screen.

- slider-field using the jquery-ui allows for easy creation of sliders with full-range, min-and-up and up-to-max ranges. Can use step-size. see https://jqueryui.com/slider/ for available options.

- sliderrange-field using the jquery-ui allows for easy creation of sliders with both min and max range. Can use stepsize. see https://jqueryui.com/slider/ for available options.

- pdf-field allows for linking to pdf-files (actually not my work, see docblock in directory )

• Version version 1.0

How do I get set up?

1. download the zip-file
2. go to /plugins/new plugins
3. install zip-file
4. activate

or

1. upload zip-file contents to wp-contents/plugins/ using a FTP-client
2. activate the plugin in the admin-panel

using the fields

In custom modules register a module and add the field type as you would any other field, for instance:

Toggle

#!php


            'my_favorite_animal'   => array(
                'type'          => 'toggle',
                'label'         => __( 'Favorite Animal', 'textdomain' ),
                'default'       => 'kitten',
                'options'       => array(
                    'cat'			=> __( 'Cat', 'textdomain' ),
                    'unicorn'		=> __( 'Unicorn', 'textdomain' ),
                    'hamster'		=> __( 'Hamster', 'textdomain'),
                ),
                'toggle'		=> array (
                    'cat'		=> array (
                        'fields'	=> array ( 'name', 'size' ),
                    ),
                    'unicorn'		=> array (),
                    'hamster'		=> array (),
                ),
                'hide'			=> array(),
                'trigger'		=> array(),
                'oncolor'		=> '#333333',
                'offcolor'		=> '#d1d1d1',
            ),

Slider

#!php

			'number_of_unicorns'      => array(
				'type'		=> 'slider',
				'label'		=> __( 'Unicorns' , 'textdomain' ),
				'settings'	=> array (
					'min'       => 0,					// min value for slider
			    	'max'       => 60,				// max value for slider
			    	'value'     => 30,				// default value to use when not set
			    	'range'		=> 'min', 			// optional: min|max , do not set if no min- or max-range needed
			    	'step'      => 5,					// optional: step size, default to one
			    	'color'     => '#666666',
			  ),
			),

Slider Range

#!php

			'number_of_kittens'      => array(
			  'type'        => 'sliderrange',
			  'label'       => __( 'Kittens' , 'textdomain' ),
			  'settings'     => array (
			      'min'       => 0,		// min value for slider
			      'max'       => 10,	// max value for slider
			      'value'     => 2,		// default value to use when not set
			      'step'      => 2,		// step size
			      'color'     => '#666666',
			  ),
			),

Dependencies

Since your custom modules will need to be sure to have the custom field available, make sure to test for the existence of the bbExtraFields class at the top of your modules code (somewhere right after the opening <?php tag. If not, don't register the module and return. it won't show in Beaver Builder until you reactivate the bb-extra-fields plugin.

#!php

	if ( ! class_exists ( bbExtraFields ) ) { return; }