Download the PHP package sergeliatko/wpsettings without Composer

WPSettings

WordPress Settings API Framework

This PHP package helps speed up the development of your settings screens in WordPress admin. The framework allows you to easily add options, settings sections and admin pages to WordPress admin, including managing registering, sanitizing, properly adding and displaying your settings according to both WordPress Settings API and best coding standards.

Who this is useful for

WPSettings framework is intended to help plugin and theme developers who need to quickly create consistent admin interfaces in WordPress no matter how large or small their projects. It is especially useful for developers who use WordPress as a "spare wheel" and may not be very experienced with WordPress specifics and its proprietary logic.

Is it overkill to use a framework such as this that helps you interact with WordPress Settings API? Is it secure to rely on code that you do not yourself control?

Following more than 10 years of deep WordPress development, including admin interfaces that always appear native to WordPress, I coded this framework primarily for my own uses, and it has become something that I use on all of my projects. Simply put, this saves me tons of time and headache!

As regards security, the library is completely open source, and you may always fork it on GitHub, customize to your own liking, and even create a pull request to allow others to benefit from your new feature. The code will remain public and be available to all of us. And, if you want to suggest features or take part in feature votes or simply support the project, you're most welcome to do so.

How it works

WPSettings Framework

With WPSettings Framework, adding a simple text field to General Settings in WordPress admin and all the code that sanitizes the option value in the database can be accomplished simply as follows:

• one line to load the library in your project main file:

• and the actual snippet:

...and that's it. Seriously, that's all the code needed to make it happen.

WordPress Settings API

Now count the lines of PHP necessary to get the same (cleanly registered and properly sanitized) result for the same option using the standard WordPress Settings API:

6 lines with WPSettings framework vs 30 lines using WordPress Settings API. Sure, if you add more options - not all of them will take 30 lines, but still it is easily 5 times faster in coding and eliminates the huge undertaking of learning the WordPress Settings API’s hidden tips and tricks.

The best part

WPSettings Framework takes care of:

• Adding single or multiple admin pages and/or submenu pages as well as their introductory texts to WordPress admin area.
• Adding single or multiple settings sections to existing or your custom admin pages.
• Adding setting fields to existing or your custom settings sections:
  • text inputs (all common types: hidden, text, url, email, password, tel, number, range, date etc.).
  • checkboxes (single and multiples) and radio buttons (again single and multiple).
  • text areas.
  • dropdowns (allows option groups as well).
  • any custom coded field you want (you will be surprised just how flexible the framework is).
• Adding descriptions to your custom settings sections and help messages to your setting fields.
• Registration of your options in the WordPress database.
• Sanitizing the user data input for most of the option types (you may use your own sanitize functions when needed).
• Proper handling of the option default values - does not save the defaults in the database, makes sure it is returned when no value is provided, allows forcing the default value if the user missed the value input (very useful for text options).

WPSettings Framework allows you to rewrite any functionality of the main classes providing your own extensions.

Installation

Using composer

Install the latest version of the framework with:

Using git

Install the latest version of the framework with:

Install all the required libraries:

As a submodule

Git submodules are a powerful tool, which allows you to easily include a third-party project of your own while still treating them as two separate projects. Rather than provide an in-depth explanation of the benefits and use of submodules, it's recommended you take a moment and read through the submodules page in the official Git documentation. When you're ready to dive in, the following command generates a clone of WPSettings as a submodule:

Do not forget the required libraries:

Manually

Download zip files for all necessary libraries:

• WPSettings
• FormFields
• HTML

And extract them in your project resources folder.

Loading the framework classes

Using composer

Composer will load the framework automatically.

Manually

If loading the classes manually (after manual installation or after installation with git), make sure the autoload.php files in all 3 libraries are included in your project:

Basic usage

Adding a setting

Please see src/Setting.php for additional details and accepted parameters.

Adding a settings section

Please see src/Section.php for additional details and accepted parameters.

Adding admin page

Please see src/Page.php for additional details and accepted parameters.

Extending the core functionality

Following classes may be extended:

• Setting
• Section
• Page

To do so, extend the class with your code and add _class key with your extension class fully qualified name as value to the parameters array.

For details see src/Factory.php

Getting option value from database

Please use get_option() WordPress function to get option value from the database. The framework deliberately does not save all your settings inside one option to stay as close as possible to WordPress default functionality and allow you to benefit from WordPress native hooks and filters over your options, thus keeping your code even more compatible with other WordPress functions.

Documentation is on its way...

While the full documentation is still in development, the code source has extensive comments and parameters descriptions to help you to get the idea of possibilities.

I would be most appreciative of your contributions to the project documentation via README.md file edits as well as posting your documentation suggestions to issues.

Support WPSettings Financially

Support WPSettings and help fund the project via the GitHub Sponsorship Program. For a price of a cup of coffee, you can access to early updates and tips. If you're using the framework for your commercial projects, I recommend you choose a bigger contribution plan to obtain the feature voting power and/or my personal support via chat.

Code review, product guidelines and consulting services are also available to help your product development. Feel free to contact me to discuss your project.

Also, all the funds collected will be used to cover the expenses of the project documentation and promotion.

About

Current version

• 0.1

Requirements

• PHP >= 7.3
• WordPress >= 4.7
• sergeliatko/form-fields >= 1.0.8
• sergeliatko/html >= 1.0.5 (required by sergeliatko/form-fields)

Feature requests, Questions, Support and Bug Reports

Please submit your questions and requests in GitHub Issues .

Licence

WPSettings is licenced under GPL-3.0. See LICENCE file for details.

Author

Serge Liatko - contact(at)sergeliatko.com - https://sergeliatko.com

Build with

• PHPStorm
• Wampserver
• WordPress