PHPackages gturpin/post-type-handler - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Utility & Helpers](/categories/utility) 4. / 5. gturpin/post-type-handler ActiveLibrary[Utility & Helpers](/categories/utility) gturpin/post-type-handler ========================= Helper class to quickly manage PostType and Taxonomy declarations 0.2.0(2y ago)7599↓50%4[1 issues](https://github.com/gturpin-dev/PostTypeHandler/issues)1PHPPHP >=7.4 Since Jun 10Pushed 2y ago1 watchersCompare [ Source](https://github.com/gturpin-dev/PostTypeHandler)[ Packagist](https://packagist.org/packages/gturpin/post-type-handler)[ RSS](/packages/gturpin-post-type-handler/feed)WikiDiscussions main Synced 1mo ago READMEChangelogDependenciesVersions (24)Used By (1) PostTypeHandler =============== [](#posttypehandler) Helper class to quickly manage PostType and Taxonomy declarations [![Packagist](https://camo.githubusercontent.com/3b5b5e18ecdab973e7a88e331e188c55a056dc57371cca43c1a9e02b946a0810/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6774757270696e2f706f73742d747970652d68616e646c65722e7376673f7374796c653d666c61742d73717561726526636f6c6f72423d626c7565)](https://packagist.org/packages/gturpin/post-type-handler?color=red)[![Packagist](https://camo.githubusercontent.com/c62cac81fb78863e1c5e1ee5aeb797d087160e9e953131448b3dbd110b544e2c/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f6774757270696e2f706f73742d747970652d68616e646c65722e7376673f7374796c653d666c61742d73717561726526636f6c6f72423d626c7565)](https://packagist.org/packages/gturpin/post-type-handler) Features -------- [](#features) - Easily add new Post Types or update existing ones - Easily add new Taxonomies - Easily link Post Types to Taxonomies & vice versa - Easily add new columns to the admin and manage them ( populate, sort, reorder ) - Easily add admin taxonomy filters Installation ------------ [](#installation) **Install with composer** Run the following in your terminal to install the package with composer ``` composer require gturpin/post-type-handler ``` The package use the autoloader, so don't forget to register the autoloader. If you don't know how see the basic example below. Basic Usage ----------- [](#basic-usage) Below is a basic example of setting up a simple PostType. ``` // don't forget to import your autoloader require_once __DIR__ . '/vendor/autoload.php'; use PostTypeHandler\PostType; $post_type_handler = new PostType( 'Book' ); $post_type_handler->register(); ``` You can set the dashicon like that : ``` $post_type_handler->set_icon( 'dashicons-book' ); // Just the dashicon name also works $post_type_handler->set_icon( 'book' ); ``` You can add custom $options and $labels to the PostType declaration. ``` $labels = [ 'add_new' => __( 'my add_new', 'context' ), 'all_items' => __( 'my all_items', 'context' ), ]; $options = [ 'public' => true, 'menu_icon' => 'dashicons-admin-post', 'rewrite' => [ 'slug' => 'my-post-type', ], ]; $post_type_handler = new PostType( 'Book', $options, $labels ); $post_type_handler->register(); ``` You can also set the taxonomies for the PostType if they are previously registered. ``` $post_type_handler = new PostType( 'Book' ); // add multiple taxonomies $post_type_handler->set_taxonomies( [ 'custom-taxonomy', 'post_tag' ] ); // or add a single taxonomy $post_type_handler->set_taxonomies( 'custom-taxonomy' ); $post_type_handler->register(); ``` Otherwise you can register a new Taxonomy and then even add it to the PostType declaration. ``` use PostTypeHandler\Taxonomy; // Register the Taxonomy $taxonomy_handler = new Taxonomy( 'custom-taxonomy' ); $taxonomy_handler->register(); // Add it to the PostType in PostType declaration $post_type_handler = new PostType( 'Book' ); $post_type_handler->set_taxonomies( 'custom-taxonomy' ); $post_type_handler->register(); ``` Or you can set the taxonomy to a Post Type that is already registered. ``` $taxonomy_handler = new Taxonomy( 'custom-taxonomy' ); // This is a post type slug and must be lower case! // Also works with an array and/or variable: [ 'book', $post_type_handler ] $taxonomy_handler->set_post_types( 'book' ); $taxonomy_handler->register(); ``` You can give the Taxonomy object itself to the PostType. ``` $taxonomy_handler = new Taxonomy( 'custom-taxonomy' ); $taxonomy_handler->register(); $post_type_handler = new PostType( 'Book' ); // Also works with an array : [ 'post_tag', $taxonomy_handler ] $post_type_handler->set_taxonomies( $taxonomy_handler ); $post_type_handler->register(); ``` You can do the same with an existing CPT, like Post : ``` $posts = new PostType( 'Post' ); $posts->set_taxonomies( 'custom-taxonomy' ); $posts->register(); ``` You can also remove a taxonomy from a Post Type. ``` $posts = new PostType( 'Post' ); $posts->remove_taxonomy( 'post_tag' ); $posts->register(); ``` Manage Post Types columns ------------------------- [](#manage-post-types-columns) I will explain some examples of how to manage the columns for a Post Type. 1. Register the Post Type. 2. Manipulate the columns. 3. Save the changes by re-registering the Post Type. ### Add a new column [](#add-a-new-column) To add new columns to a Post Type you can do the following ``` // Call the columns function to get access to the column manager and add a new column $post_type_handler->columns()->add( [ 'custom-slug' => __( 'Custom label', 'context' ), 'year' => __( 'Year', 'context' ), ] ); // You can also pass only one slug and label $post_type_handler->columns()->add( 'custom-slug', 'Custom label' ); ``` ### Hide a column [](#hide-a-column) To hide a column you can do the following ``` // Call the columns function to get access to the column manager and hide a built-in column or a custom one $post_type_handler->columns()->hide( [ 'custom-slug', 'date' ] ); // You can also hide only one column $post_type_handler->columns()->hide( 'year' ); ``` ### Set all columns [](#set-all-columns) You can set all columns at once By doing this you must take a look at the [Manage columns hook](https://developer.wordpress.org/reference/hooks/manage_post_type_posts_columns/) to prevent unwanted columns ``` // Call the columns function to get access to the column manager and set all columns $post_type_handler->columns()->set( [ 'custom-slug' => __( 'Custom label', 'context' ), 'year' => __( 'Year', 'context' ), ] ); ``` ### Populate a column [](#populate-a-column) To populate a column you can do the following - You can only populate one column at once - You must display the content and not return it - You can't use this to populate a [built-in column](https://developer.wordpress.org/reference/hooks/manage_post_type_posts_columns/#more-information) ``` // Call the columns function to get access to the column manager and populate a column $post_type_handler->columns()->populate( 'custom-slug', function( $column, $post_id ) { echo get_the_title( $post_id ); } ); $post_type_handler->columns()->populate( 'year', function( $column, $post_id ) { echo get_the_date( 'Y', $post_id ); } ); ``` You can also add new columns to existing and built in post types ``` $posts = new PostType( 'Post' ); $posts->columns()->add( 'id' ); $posts->columns()->populate( 'id', function( $column, $post_id ) { echo $post_id; } ); $posts->register(); ``` ### Make a column sortable [](#make-a-column-sortable) To make a column sortable you can do the following - You must make the column slug in key and value of the array - The value must be the meta key to sort using - Don't forget to populate the column before you make it sortable! ``` // Call the columns function to get access to the column manager and make a column sortable $post_type_handler->columns()->sortable( [ 'rating' => 'rating', // You can add true to make the sort by numeric order // or false to make it by alphabetical order which is the default 'year' => [ 'year', true ], ] ); ``` ### Order the columns [](#order-the-columns) You may want to order the columns, even the native ones, do the following - Set the final position, starting from 0 - Avoid duplicate and negative positions in your array! ``` $post_type_handler->columns()->order( [ // Reorder the native columns 'title' => 5, // Use large numbers to be sure that the column will be at the end 'cb' => 15, 'custom-slug' => 1, 'rating' => 3, 'author' => 8, ] ); ``` ### Adding taxonomy filters to the edit screen [](#adding-taxonomy-filters-to-the-edit-screen) To add taxonomy filters to the edit screen you can do the following - Add a list of taxonomies slugs - The order is important because the filters will be displayed that order! ``` $post_type_handler->set_taxonomy_filters( [ 'custom-taxonomy', ] ); ``` Hooks ----- [](#hooks) Hook typeHook nameParamsDescriptionFiltergt\_post\_type\_{$post\_type}\_labelsarray $labelsCustom the labels for the post typeFiltergt\_post\_type\_{$post\_type}\_optionsarray $optionsCustom the options for the post typeFiltergt\_post\_type\_{$post\_type}\_check\_slug\_conflictboolean $checkCheck for slug conflicts. Requires DB query.Filtergt\_taxonomy\_{$post\_type}\_labelsarray $labelsCustom the labels for the taxonomyFiltergt\_taxonomy\_{$post\_type}\_optionsarray $optionsCustom the options for the taxonomyTODOS ----- [](#todos) - Can also add taxonomy by sending the object itself ( by the object itself, maybe with a \_\_tostring method ) - Adding a way to manage Columns - Hide columns and defaults for each post type - Adding new columns to the admin screen - Set columns order - Set the entire columns array - Populate any column with a custom function - Can sort each columns with their values ( numerically / alphabetically ) - Adding a function to easily add icon without using the $options array - Adding a way to manage the Filters on screen admin - Set an array to order them and keep an order - Add a class to manage the taxonomies - Adding new Taxonomies - Can work on existing taxonomies ( post\_tag & category ) - Can be registered on a post type directly ( by the slug or the object itself, maybe with a \_\_tostring method ) - Can work on existing post types ( update options and labels ) - Add the @link/author/license to the main class - Same columns but for the taxonomies - Can delete row actions ( edit, view, trash, delete ) from the admin screen ( 'post\_row\_actions' ) - Check if we can do the same for adding ones - Check to add/remove bulk edit actions - Check if we can add/update/remove the list above the bulk actions ( all / published etc ... ) ### Health Score 27 — LowBetter than 49% of packages Maintenance17 Infrequent updates — may be unmaintained Popularity23 Limited adoption so far Community14 Small or concentrated contributor base Maturity47 Maturing project, gaining track record Bus Factor1 Top contributor holds 90.6% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~19 days Recently: every ~78 days Total 23 Last Release 1011d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/0a8bc6cca8c45cc7c0b42f4526aed0a0eb0dfafb7332f0f83c0cf2899cdd0625?d=identicon)[gturpin-dev](/maintainers/gturpin-dev) --- Top Contributors [![gturpin-dev](https://avatars.githubusercontent.com/u/34162504?v=4)](https://github.com/gturpin-dev "gturpin-dev (77 commits)")[![charmoney](https://avatars.githubusercontent.com/u/12037677?v=4)](https://github.com/charmoney "charmoney (8 commits)") --- Tags hacktoberfesthacktoberfest-2022phpwordpresswordpress-php-library ### Embed Badge ![Health badge](/badges/gturpin-post-type-handler/health.svg) ``` [![Health](https://phpackages.com/badges/gturpin-post-type-handler/health.svg)](https://phpackages.com/packages/gturpin-post-type-handler) ``` PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)