Download the PHP package pinkcrab/perique-admin-menu without Composer

Perique Admin Menu

A module for the Perique Plugin Framework, for rendering and processing Admin Menu Pages with WordPress

Why?

WordPress admin pages can be added with a simple function, but this can easily lead into messy structural code with includes for templates and the inevitable mixing of logic and presentation in templates.

The Admin Menu module gives full access to Perique DI Container, for more separation of logic and presentation, with the added advantage of all your services being easy to test and reason with.

Requires Perique - for more details please visit our docs. https://perique.info

Setup

Include the module using composer (via CLI)

Once this has been included, we can add the module to Perique and its underlying Middleware will be added to the registration process.

Once the middleware has been included, we can use Page & Group models as part of the usual Registration process

Usage

It is possible to register either a single page or a group of pages.

Group

A page can be used to register a group of pages, that can be registered as a top level menu item, or as a sub menu item of another page.

It is possible to enqueue scripts and styles, explicitly for this group using the enqueue method. This would see those scripts and styles only loaded on the pages within the group.

Please see the group docs for more details.

Page

A page is a single menu item, that can be registered as a top level menu item, or as a sub menu item of another page.

It is possible to enqueue scripts and styles, explicitly for this page using the enqueue method.

You can also trigger a callback on page load, using the load method.

For more details on the Page model, please see the Page docs

Page Form Handling Example

In the above example the page would be use the settings from the Settings service, and if the form has been submitted, it would use the Form_Handler service to handle the form and update the view data.

Example

There is a basic example of how to use this Module as part of a plugin, please see Example Plugin

License

MIT License

http://www.opensource.org/licenses/mit-license.html

Contributions

If you would like to contribute to this or any other Perique module, please feel free to submit a PR with your changes.

All code must be supplied with matching tests and must pass PHPUNIT, PHPStan and PHPCS checks and not see a large drop in coverage.

See composer.json for details on the test and linting commands. composer all is the most important.

Change Log

• 2.0.0 - Migrated to Perique 2.0.0
• 1.0.1 - Separated out the docs and added page_hook() method to page models and sets the hook after registration.
• 1.0.0 - Finalised API for Perique 1.4.*
• 0.2.1 - Allows pages that extend Menu_Page to be registered as both parent of child pages.
• 0.2.0 - Re introduced the register() and load() methods for both Groups and Pages.
• 0.1.2 - Fixed hardcoded primary page slug in Page_Dispatcher, updated dev dependencies
• 0.1.1 - Bumped version for Collection
• 0.1.0 - Migrated from https://github.com/Pink-Crab/Module__Admin_Pages