Create customizer controls quick and easy with as minimum code as possible.

##This project is currently in beta stage. The current code is fully functional, but may expect radical changes in the future!

###License: GPL The license allows the usage in any projects(personal or commercial). An attribution link is not required, but very appreciated.

##Requirements:

• PHP 5.3+

##Short tutorial: ###1. Include the files

Include this file just once. Ussually, for plugin base file and for themes in functions.php.

require_once dirname(__FILE__) . "/ZeroWP/Customizer/mod.php";

###2.Create fields:

#####Step 1. Hook a function on to customize_register action:

add_action( 'customize_register', 'myprefix_customizer_fields' );
function myprefix_customizer_fields( $wp_customize ) {
	//Your customizer fields will be created here.
}

#####Step 2. Instantiate the 'Create' class:

Inside of the previously defined function instantiate the Create class.

//This is our new customizer object
$ctz = new ZeroWP\Customizer\Create( $wp_customize );

#####Step 3. Create a section and the first field:

All fields must have a parent section. In default WordPress customizer you define the section by adding this option('section' => 'your_section_id') to control settings. This framework does not need this anymore. Here you can create a section and all fields after it will be assigned automatically. Here is how it works:

// Create a section
$ctz->addSection( 'myprefix_section_1', __('Section name', 'text-domain') );

// Add the field with ID 'myprefix_color_field' to a section with ID 'myprefix_section_1'
$ctz->addField( 'myprefix_color_field', 'color', array(
	'label' => __('Color field test', 'text-domain'),
));

// Add the field with ID 'myprefix_upload_field' to a section with ID 'myprefix_section_1'
$ctz->addField( 'myprefix_upload_field', 'upload', array(
	'label' => __('Upload field test', 'text-domain'),
));

#####Step 4. Reveal your new fields.

####Here is the full code that we wrote in the previous tutorial:

add_action( 'customize_register', 'myprefix_customizer_fields' );
function myprefix_customizer_fields( $wp_customize ) {
	$ctz = new ZeroWP\Customizer\Create( $wp_customize );

	// Create a section
	$ctz->addSection( 'myprefix_section_1', __('Section name', 'text-domain') );

	// Add the field with ID 'myprefix_color_field' to a section with ID 'myprefix_section_1'
	$ctz->addField( 'myprefix_color_field', 'color', array(
		'label' => __('Color field test', 'text-domain'),
	));
	
	// Add the field with ID 'myprefix_upload_field' to a section with ID 'myprefix_section_1'
	$ctz->addField( 'myprefix_upload_field', 'upload', array(
		'label' => __('Upload field test', 'text-domain'),
	));
}

###FYI:

• All fields must have a section. This means that the fields must be created after a section was open.
• Field IDs must be unique, else the previous field with the same ID will be removed and used the last one in the list.
• If the field type is not recognized, it will be displayed as a text input.
• Printing zerowp_customizer_custom_controls() function, will return all registered field types and their class names. Note: Some of the built-in fields are missing.

##Methods:

After instantiation of $ctz = new ZeroWP\Customizer\Create( $wp_customize ); class you can use the following methods:

###Panels:

• $ctz->addPanel( $id, $title = '', $settings = array() ); - Create a new panel.
• $ctz->openPanel( $id ); - Switch to an existing panel by ID
• $ctz->closePanel(); - Close the currently open panel
• $ctz->removePanel( $id ); - Remove an existing panel by ID

####addPanel( $id, $title = '', $settings = array() )

Create a new panel and/or switch to an existing one.
To create a new panel you must specify a unique ID($id), the title($title) and optionally the settings($settings). If the $title variable is empty, the settings will be ignored and the panel will not be created, but instead will switch to an existing panel that has the passed $id. In a few words, passing only the $id is the equivalent of openPanel() method(see below fo info). Note: $settings are optional. Use only that you need.

Example:

$ctz->addPanel( 'my_panel_id', __('My Panel title', 'text-domain'), array(
	'capability'      => 'edit_theme_options',
	'description'     => __( 'Panel description', 'text-domain' ),
	'theme_supports'  => '',
	'priority'        => 10,
) );

####openPanel( $id ) & closePanel()

Switch to an existing panel with openPanel() and close it with closePanel().
Once a panel has been registered you can later access it and add sections. openPanel() method allows to open it and append new sections.
closePanel() allows to close the currently open panel.
If you want to switch to another panel you are not required to close it. It will be closed automatically and switch to the next panel.

Example:

$ctz->openPanel( 'my_panel_id'  ); //Open the panel with ID 'my_panel_id`

	// Add new sections to this panel
	
$ctz->closePanel(); //Close the panel with ID 'my_panel_id`. Does not require to pass the ID.

###Sections:

• $ctz->addSection( $id, $title = false, $settings = array() ); - Create a new section.
• $ctz->openSection( $id ); - Switch to an existing section by ID
• $ctz->closeSection(); - Close the currently open section
• $ctz->removeSection( $id ); - Remove an existing section by ID

###Fields:

• $ctz->addField( $id, $type = 'text', $settings = array() ); - Create a new field.
• $ctz->removeField( $id ); - Remove an existing field by ID