Nmwdhj

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.

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

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.