wp-kit/registry
This is a wp-kit component that handles PostType and Taxonomy registration., (*1)
This component was built to run within an Illuminate\Container\Container so is perfect for frameworks such as Themosis, Assely and wp-kit/theme., (*2)
wp-kit/registry is fully comptaible with Themosis and if you are using Themosis you'll notice it already has a PostTypeBuilder and a TaxonomyBuilder but wp-kit/registry just simplifies the process by providing an OOP approach to registering PostTypes and Taxonomies., (*3)
Installation
If you're using Themosis, install via Composer in the Themosis route folder, otherwise install in your Composer driven theme folder:, (*4)
composer require "wp-kit/registry"
Setup
Add Service Provider
Just register the service provider and facade in the providers config and theme config:, (*5)
//inside theme/resources/config/providers.config.php
return [
//
WPKit\Registry\RegistryServiceProvider::class,
//
];
Add PRS4 Class Reference (Themosis Only)
Just add the following line to resources/config/loading.config.php in the Themosis theme folder:, (*6)
'Theme\\Taxonomies\\' => themosis_path('theme.resources').'taxonomies',
'Theme\\PostTypes\\' => themosis_path('theme.resources').'postTypes',
Add Config & View File
The recommended method of installing config files for wp-kit components is via wp kit vendor:publish command., (*7)
First, install WP CLI, and then install this component, wp kit vendor:publish will automatically be installed with wp-kit/utils, once installed you can run:, (*8)
wp kit vendor:publish, (*9)
For more information, please visit wp-kit/utils., (*10)
Alternatively, you can place the config file(s), post type file(s) and taxonomy file(s) in your theme/resources/config, theme/resources/postTypes and theme/resources/taxonomies directories manually., (*11)
Usage
Adding Classes
wp-kit\registry comes with two classes that can extended, WPKit\Registry\PostType and WPKit\Registry\Taxonomy., (*12)
Any custom PostTypes and Taxonomies should be added inside resources/shortcodes within the namespace Theme\PostType or Theme\Taxonomy., (*13)
Here is an example PostType class., (*14)
Here is an example Taxonomy class., (*15)
Get Involved
To learn more about how to use wp-kit check out the docs:, (*16)
View the Docs, (*17)
Any help is appreciated. The project is open-source and we encourage you to participate. You can contribute to the project in multiple ways by:, (*18)
- Reporting a bug issue
- Suggesting features
- Sending a pull request with code fix or feature
- Following the project on GitHub
- Sharing the project around your community
For details about contributing to the framework, please check the contribution guide., (*19)
Requirements
Wordpress 4+, (*20)
PHP 5.6+, (*21)
License
wp-kit/registry is open-sourced software licensed under the MIT License., (*22)