Install
This is the repository archive. It installs, but the folder name will carry the branch suffix and updates will not flow.
Install straight from GitHub with WP-CLI:
wp plugin install https://github.com/mafelcahucom/handy-customizer/archive/refs/heads/master.zipWelcome to the Handy Customizer Framework GitHub repository! Explore the source code, review open issues, and stay updated with ongoing development. For detailed guidance, best practices, and complete feature insights, we strongly recommend reading the official documentation.
Description
Handy Customizer Framework is an open-source WordPress toolkit built to help WordPress Theme Developers to develop themes using the WordPress Customizer API while writing clean and minimal code only.
Why You Should Use It?
- Super Easy To Use - The Customizer API can be a headache and confusing. So Handy managed to simplify the process of adding controls to customizer.
- Avoid Code Repetition - Handy will allow you to organize your code. Instead of calling 3 methods in order to add controls, Handy simplified it by just calling one method.
- Helpful Utilities - Handy provide also a useful API for utilities, This will provide a useful methods where you can use in adding controls and providing data.
- Enhance Productivity - Because Handy simplified Customizer API, it will help you to work fast, minimally, and save a lot of time coding complicated controls.
Essential Components
- Panel - Panels serve as containers for sections and give you the option to arrange several sections together and add another level of hierarchy above controls and sections.
- Section - Sections serve as containers for controls and give you the option to arrange several controls together. Also, sections can be added to the panel.
- Control - Controls are the main Customizer object for building UI fields. Every control must be associated with a setting, and that setting will store user-entered data from the control as well as display and sanitize it in the live preview. Controls must be added to a section before they will be displayed (and sections must contain controls to be displayed).
Getting Started
Hello there! Are you ready to to learn more about Handy? Let's first take a brief look at Handy and see how we can use it to our WordPress theme development projects.
Available Controls
Below is a comprehensive list of all available controls. Each control is designed to give you flexibility and precision, allowing you to customize and manage features with ease.
- Audio Uploader
- Alignment
- Angle Picker
- Button Set
- Checkbox
- Checkbox Multiple
- Checkbox Pill
- Code Editor
- Color Picker
- Color Set
- Content Editor
- Counter
- Dashicons
- Date Picker
- Dimension
- Dropdown Custom Post
- Dropdown Page
- Dropdown Post
- Duotune
- File Uploader
- Group
- Image Checkbox
- Image Radio
- Image Uploader
- Markup
- Number
- Radio
- Range
- Repeater
- Select
- Size
- Sortable
- Switch
- Tagging
- Tagging Select
- Text
- Textarea
- Time Picker
- Toogle
- URL
- Video Uploader
Arguments
There can be some confusion about the arguments, so to help clarify, we've included comprehensive and thorough documentation on each common argument.
Utilities
In some cases we need to use WordPress Rest API to provide an internal data to our control, and we are aware that this will take some time. As a result, Handy offers helpful utilities that you may utilize to feed data into your controls.
Note
To get the best results with Handy Customizer, we strongly encourage WordPress theme developers to be familiar with the Customizer API. You’ll find an excellent and detailed handbook on developer.wordpress.org to guide you through the process.