nash-ye / Momtaz Nmwdhj

=== Nmwdhj === Contributors: alex-ye Tags: api, html, settings, options, forms, form Requires at least: 3.1 Tested up to: 4.0 Stable tag: 1.3.4 License: GPLv2 or later License URI: http://www.gnu.org/licenses/gpl-2.0.html

Nmwdhj is an API for creating forms elements via code.

== Description ==

= Important Notes: =

1. This plugin requires at least PHP 5.3.x .
2. This plugin is for developers, not general users.

Nmwdhj is an API for creating, editing and rendering forms programmatically. This plugin doesn't have a GUI, It's only a helper library for the PHP & WP developers.

You can use this plugin to create individual form elements in the meta boxes, front-end, or anything else you might want a form for.

= Basic Examples = You can use this plugin in many ways depending on your needs, this examples only for learning purposes:

• Simple WordPress Search Form:

Nmwdhj\create_element( array( 'type' => 'form', 'atts' => array( 'method' => 'GET', 'role' => 'search', 'action' => home_url( '/' ), ), 'elements' => array( 'search' => array( 'name' => 's', 'type' => 'input_search', 'value' => get_search_query(), 'atts' => array( 'placeholder' => _x( 'Search this site...', 'placeholder' ), 'class' => 'search-text', 'required' => true, ), ), 'submit' => array( 'type' => 'input_submit', 'value' => __( 'Search' ), ), ), ) )->output();

• Simple Login Form:

Nmwdhj\create_element( array( 'type' => 'form', 'atts' => array( 'method' => 'POST', ), ) ) ->add( array( 'name' => 'user_name', 'type' => 'input_text', 'label' => __( 'User Name' ), ) ) ->add( array( 'name' => 'user_pass', 'type' => 'input_password', 'label' => __( 'Password' ), ) ) ->add( array( 'name' => 'user_submit', 'type' => 'input_submit', 'value' => __( 'Submit' ), ) ) ->output();

= Contributing = Developers can contribute to the source code on the Nmwdhj GitHub Repository.

== Installation ==

1. Upload and install the plugin
2. Use the rich API to powerful your theme/plugin.

== Changelog ==

= 1.3.4 =

• Sort the priority array elements correctly.

= 1.3.3 =

• Additional methods in the Nmwdhj\Manager class, to store the elements objects.
• A better way to instance the element object via Nmwdhj\create_element function.

= 1.3.2 =

• Use loose comparison when check the selected and checked values.
• Add '+options' to append a group of element options at once.

= 1.3.1 =

• Fix some serious bugs in FieldSet,Checkboxes elements and Select view.

= 1.3 =

• Better directory structure.
• Code formatting improvements and optimizations.
• Introduce the PriorityArray and EventManager classes.
• Recode the Elements Views and remove the Decorators classes. ...etc

= Breaking Changes =

• Nmwdhj 1.3 is NOT completely compatible with any pervious version, so please don't update unless you know what you are doing!

= 1.2.1 =

• Fix the error when you use Nmwdhj/decorate_element() function.
• Add the ability to set the value-options directly by the constructor method.

= 1.2 =

• Remove the "Momtaz" prefix form the plugin title and classes names.
• Remove the not-needed custom view-key from the elements classes.
• Rewrite the plugin to use PHP namespaces.
• Add the Nmwdhj/Exception class.
• Add the plugin link on Github.
• Fix some minor bugs.

= Breaking Changes =

• Nmwdhj 1.2 is NOT compatible with any pervious version, so please don't update unless you know what you are doing!

= 1.1 =

• Enhance the check_class() method with the PHP function is_subclass_of().
• implement some easy methods to Add/Remove/Check the CSS 'class' attribute.
• implement a smart attributes system, you can now store the attributes as an objects.
• Replace any use for the deprecated PHP function is_a() by the instanceof operator.

= Breaking Changes =

• The behavior of set_value_callback() method has changed, it's now accept an optional list of permeates, if you want to pass an array of arguments please use the new method set_value_callback_array().

= 1.0 =

• The Initial version.