This helper class lets you create the settings page for your plugin using the Wordpress Settings API without having to deal with the API directly.
No deeper dependencies, No framework, just a light weight helper class!
require the class, hook into admin_menu and pass the config array to class object to build your plugin settings page.
If you want to create plugin settings menu that is following WordPress best practices without having to deal with complex WorPress Settings API, then this helper class can be used.
The Benefits:
- Take away the pain of dealing with Settings API
- One config array to create everything: admin menu, settings page, sections, fields.
- Fields input is auto sanitized
- Can be used to make Tabs or Tab-less Settings page
- Can be used to add plugin action links
- Ability to override sanitization callback
- Ability to override fields display callback
Complete Details can be found in the Wiki, in the nutshell, follow the steps:
- copy the class in plugin assets folder and require the class in your plugin files (add dependency)
- hook into
admin_menuand provide a callback function - in the callback function, pass the config array to this helper class object to build your sections and fields.
Its that easy. Here is a simple example code that will create a plugin menu, 2 sections and some fields under these sections.
Here are two example plugins to demonstrate this class if you can figure out thing at your own:
- Functional / Procedural plugin example
- Object Oriented Plugin Example
This helper class can create the following:
- Plugin admin menu (top level / sub menu)
- Settings Sections (tabbed and tab-less)
- Settings fields under these sections
Following Field Types can be added using this Helper Class:
- text
- url
- number
- color
- textarea
- radio
- select
- checkbox
- multicheck
- media
- file
- posts (WP posts and Custom Post Types)
- pages (WP pages)
- password
- html
