Options Definitely

Description

Options Definitely is a framework for developers that allows them to easily add options and their input fields to the WordPress admin so that a user can manage them. You can add new menus and options pages, add fields to those pages and organize them in multiple tabs and settings sections.

The plugin belongs to the group of Definitely plugins which aim at making adding backend components in WordPress easier and more standardized for developers. All Definitely plugins bundle a custom library that handles functionality which is shared across all these plugins, for example handling the field types and their controls.

The library comes with several common field types and validation functions included, including repeatable fields, where you can group a few fields together and allow the user to add more and more of them. All the fields have a validation mechanism, so you can specify what the user is allowed to enter and print out custom error messages.

For an extensive list of features, please visit the Features page in the Options Definitely Wiki.

This plugin is a framework.
When you activate the plugin, it will not change anything visible in your WordPress site. The plugin is a framework to make things easier for developers.
In order to benefit by this framework, you or your developer should use its functionality to do what the framework is supposed to help with.

Usage

Options Definitely is very easy to use. Although you need to be able to write some PHP code to use the library, setting up settings pages with tabs, sections and fields should be quite straightforward. All you need to know is:

  • how to hook into a WordPress action
  • how to call a single class function
  • how to handle an array

For a detailed guide and reference on how to use this framework, please read the Wiki on Github. Once you get familiar with the options you have, you will be able to create complex options interfaces in just a few minutes.

Note: This plugin requires PHP 5.3.0 at least.

Options Definitely is just one among a group of Definitely plugins which allow developers to build their admin interfaces more quickly. You might also wanna check out:
Post Types Definitely

Screenshots

  • an options page created with the plugin
  • PHP code to create the options page above

Installation

  1. Upload the entire options-definitely folder to the /wp-content/plugins/ directory.
  2. Activate the plugin through the ‘Plugins’ menu in WordPress.
  3. Add all the options you like, for example in your plugin or theme.

FAQ

How do I use the plugin?

You can use the framework anywhere you like, for example in your theme’s functions.php or somewhere in your own plugin or must-use plugin. For a detailed guide and reference on how to use this framework, please read the Wiki on Github.

Why don’t I see any change after having activated the plugin?

Options Definitely is a framework plugin which means it does nothing on its own, it just helps other developers getting things done way more quickly.

Where should I submit my support request?

I preferably take support requests as issues on Github, so I would appreciate if you created an issue for your request there. However, if you don’t have an account there and do not want to sign up, you can of course use the wordpress.org support forums as well.

How can I contribute to the plugin?

If you’re a developer and you have some ideas to improve the plugin or to solve a bug, feel free to raise an issue or submit a pull request in the Github repository for the plugin.

You can also contribute to the plugin by translating it. Simply visit translate.wordpress.org to get started. Note that you can help not only translating the plugin, but also the underlying library WPDLib.

Contributors & Developers

“Options Definitely” is open source software. The following people have contributed to this plugin.

Contributors

“Options Definitely” has been translated into 1 locale. Thank you to the translators for their contributions.

Translate “Options Definitely” into your language.

Interested in development?

Browse the code, check out the SVN repository, or subscribe to the development log by RSS.

Changelog

0.6.7

  • Enhanced: on WordPress 4.7 settings are now registered globally using the enhanced register_meta() implementation
  • Fixed: datetime and time fields no longer switch the time back by an hour automatically
  • Fixed: in datetime and date fields it is no longer possible to accidentally change the month by scrolling
  • Fixed: datetime and date fields better support locale special characters

0.6.6

  • Fixed: select fields no longer show twice when a placeholder is specified

0.6.5

  • Tweaked: updated the plugin initialization library
  • Tweaked: updated the Select2 and Datetimepicker JavaScript plugins
  • Fixed: dropdowns no longer close immediately after opening them

0.6.4

  • Fixed: WPDLib now has type “wordpress-muplugin” so that it is not loaded outside of a project

0.6.3

  • Fixed: uncaught JavaScript error with datetimepicker

0.6.2

  • Enhanced: WYSIWYG field experience is now more similar to the default post editor, including media and link buttons
  • Tweaked: updated the Select2 and Datetimepicker JavaScript plugins
  • Fixed: the selected value of a multiselect field is now properly displayed
  • Fixed: the rows attribute now works correctly for textareas and WYSIWYG
  • Fixed: updated the media picker JavaScript plugin for more flexibility and some bug fixes
  • Fixed: updated the map picker JavaScript plugin for more flexibility and some bug fixes

0.6.1

  • Tweaked: plugin now uses wordpress.org language packs
  • Tweaked: updated plugin initialization library
  • Fixed: “Settings saved” message does not show twice anymore on an options screen
  • Fixed: admin notice no longer shows on each site when the plugin is activated network-wide
  • Fixed: numeric validation of floating point numbers
  • Fixed: formatting floating point numbers more precise than 2 digits

0.6.0

  • Added: a new action is available to easily enqueue scripts on specific settings pages only
  • Added: new field type map (can store either address or latitude and longitude)
  • Enhanced: the plugin can now easily be used as a must-use plugin or as a library in any plugin or theme
  • Enhanced: media field type can now alternatively store URL instead of attachment ID
  • Enhanced: options keys ‘terms’ and ‘users’ (for related objects) now accept ‘any’ as value (similar to ‘posts’)
  • Fixed: critical validation bug in WYSIWYG
  • Fixed: step validation for decimal numbers
  • Fixed: images now display correctly in media preview

0.5.1

  • Fixed: critical issue in wpod_get_options()
  • Fixed: on PHP 5.2 the plugin now terminates appropriately

0.5.0

  • First stable version