Admin Page Framework

The Admin Page Framework is a collection of WordPress hooks and functions that allow WP developers an easier way of building a special section in the WordPress backend which can hold their plugin's (or theme's) settings.

It's a quick way to tie in specific plugin (or theme) options to a visual interface and allow end users easy access to all of your tool's settings.

Admin Page Framework supports many type of customization possibilities and comes with extra tools specific to various facets of the WordPress development community.

Installation:

Unpack and upload it to the /wp-content/plugins/ directory.
Activate the plugin through the 'Plugins' menu in WordPress.

What is new in this release:

• Fixed a bug that form section values of page meta box could not be displayed.

What is new in version 3.5.6:

• Fixed a bug that form section values of page meta box could not be displayed.

What is new in version 3.5.3:

• Added the ability to reset individual field values with the reset argument of the submit field type.
• Added a user meta factory class demo example.
• Added the validate() and content() methods in the admin page factory class.
• Added the fourth parameter to the validate() method of page meta box factory class to receive submit information.
• Fixed a bug that invalid field values were stored when submitting the form multiple times using validation callback methods.
• Fixed an issue in the loader plugin that after resetting the loader plugin options via the Debug tab, a warning 'You do not have sufficient permissions to access this page.' appeared.
• Fixed an issue in the user meta factory class that a PHP notice, Trying to get property of non-object..., which appeared when creating a new user.

What is new in version 3.4.6:

• Added a page that lets the user download the minified version of the framework in the demo examples.
• Added a utility class that checks requirements of servers such as PHP and MySQL versions etc.
• Added the print_type argument to the system field type.
• Added more information to the system field type.
• Added (revived) the minified version and it is now human readable.
• Fixed an issue that form fields without setting a section were not registered in pages except first added ones.
• Changed the timing of importing and exporting of the import and export field types to be done after performing validation callbacks.

What is new in version 3.3.0:

• Added the 'Select All' and 'Select None' buttons for check boxes.
• Added the [ace](https://github.com/soderlind/AceCustomFieldType) custom field type.
• Added the ability to have different menu title from the page title with the page_title and menu_title argument pass to the addSubMenuItems() method.
• Added the ability for the description field/section definition argument to accept an array to process elements as multiple paragraphs.
• Added the ability to set custom arguments to enqueuing resource(style/script) tags.
• Added an example of querying posts by custom meta key and value in the demo plugin.
• Added the ability to send emails with the submit field type.
• Added the reset custom field type.
• Added the system field type (changed from a custom field type and became built-in).
• Fixed an issue that JavaScript scripts added by widget fields could not be properly loaded in customize.php.
• Fixed an issue of the revealer custom field type that the saved selected item could not be displayed after saving the form.
• Fixed unescaped tags and attributes in tabs.
• Fixed a bug that the reset argument of the submit field type caused a loss of stored options when the form fields are not added via the load_{...} hooks and have multiple pages are added.
• Fixed an issue that when setting form elements with the load_{page slug}_{tab} hook, the fields could not be displayed if the user clicked on the sidebar menu and the tab is the default tab.
• Fixed an issue that the TinyMCE rich editor could not be enabled in widget forms.
• Fixed an issue that Quick Tags of rich editors could not be repeated.
• Fixed an issue that values set to textarea tags were not escaped.
• Optimized the process of handling field errors in post meta boxes.
• Tweaked the timing of jQuery event binding of the date, 'date_time', and 'time' custom field types.
• Tweaked the styling of remove buttons for image, media, font field types for WordPress 3.7.x or below.
• Tweaked the styling of sortable fields.
• Tweaked the styling of widget forms.
• Changed to prevent posts from being published if there are field errors of meta boxes.
• Changed the layout of meta-box field table by making the field title column to be displayed as inline-block.
• Changed the metabox factory class to accept an empty ID to be passed to let the factory class automatically generates an ID from the class name.
• Changed the timing of finalizing in-page tabs.

What is new in version 3.1.0:

• Added the options_{instantiated class name} filter to suppress the data used to display the form values.
• Added the AdminPageFramework_Debug::log() method.
• Added the ability not to set the default link to the custom post type post listing table's page in the plugin listing table page by passing an empty string to the 'plugin_listing_table_title_cell_link` key of the 'label' argument option.
• Added the date_range, date_time_range, time_range custom field type.
• Added the ability to set options for the date, date_time, and time custom field types.
• Added the hasSettingNotice() method that checks if at least one setting notice has been set or not.
• Added the admin-page-framework-subfield class selector to the div element's class attribute of field containers of sub-fields.
• Added the field_definition_{instantiated class name} filter hook that applies to all the defined field arrays.
• Added the disableSavingOptions() method that disables the functionality to save submitted form data into the options table.
• Added the setPluginSettingsLinkLabel() method which enables to set the text label to the automatically embedded link to the plugin listing table of the plugin title cell in addition to disabling the functionality.
• Added the start() method which is automatically called at the end of the constructor, which can be used when the instantiated class name cannot be determined.
• Added the ability to disable settings notices by passing false to the $_GET{'settings-notice'] key.

What is new in version 3.0.4:

• Added the ability to set a validation error message to appear at the top of a form section output.
• Fixed a bug that saved field values of page meta boxes got lost when fields are saved in a different tab but in the same page.
• Fixed a bug that the script_common_{...} filter was not functioning in meta box classes.
• Added the ability to throw a warning when undefined method is called.
• Changed the file structure of the development directory.

Requirements:

• WordPress 3.3 or higher