https://github.com/nash-ye/momtaz-nmwdhj

A WordPress forms elements API plugin.
https://github.com/nash-ye/momtaz-nmwdhj

wordpress wordpress-plugin

Last synced: about 6 hours ago
JSON representation

A WordPress forms elements API plugin.

• Host: GitHub
• URL: https://github.com/nash-ye/momtaz-nmwdhj
• Owner: nash-ye
• Created: 2013-08-16T14:28:25.000Z (over 11 years ago)
• Default Branch: master
• Last Pushed: 2019-07-21T18:52:21.000Z (over 5 years ago)
• Last Synced: 2023-08-02T13:22:10.081Z (over 1 year ago)
• Topics: wordpress, wordpress-plugin
• Language: PHP
• Homepage: https://wordpress.org/plugins/momtaz-nmwdhj/
• Size: 136 KB
• Stars: 11
• Watchers: 4
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: readme.txt
  • Funding: .github/FUNDING.yml

Awesome Lists containing this project

README

        
=== 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](https://github.com/nash-ye/Momtaz-Nmwdhj).

== 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.