pollora/entity

A modern PHP package for WordPress custom post types and taxonomies

1.1 2025-09-26 09:32 UTC

Requires

• php: ^8.1
• johnbillion/extended-cpts: ^5.0
• pollora/wordpress-args: dev-main

Requires (Dev)

• laravel/pint: ^v1.22.1
• mockery/mockery: ^2.0.x-dev
• pestphp/pest: ^v3.8.2
• phpstan/phpstan: ^2.1.16

GPL-2.0-or-later

• Amphibee

README

A modern PHP 8.2+ library for easily managing WordPress custom post types and taxonomies with a fluent interface and hexagonal architecture.

Features

• 🚀 Modern PHP 8.2+ with type declarations
• 🏗️ Fluent interface for easy configuration
• 🔧 Built on top of Extended CPTs library
• 📐 Hexagonal architecture for better separation of concerns
• 🧪 Fully tested with PestPHP
• 💡 Intuitive method naming with dedicated methods for boolean properties

Installation

composer require pollora/entity

Documentation

• Post Types Documentation - Complete guide for creating and configuring custom post types
• Taxonomies Documentation - Complete guide for creating and configuring custom taxonomies

Quick Start

Post Types

use Pollora\Entity\PostType;

PostType::make('book', 'Book', 'Books')
    ->public()
    ->showInRest()
    ->hasArchive()
    ->supports(['title', 'editor', 'thumbnail'])
    ->menuIcon('dashicons-book-alt');

Taxonomies

use Pollora\Entity\Taxonomy;

Taxonomy::make('genre', 'book', 'Genre', 'Genres')
    ->hierarchical()
    ->showInRest()
    ->showInQuickEdit();

Architecture

This package follows hexagonal architecture principles:

1. Domain Layer: Core business logic (Entity, PostType, Taxonomy)
2. Application Layer: Services that orchestrate operations
3. Adapter Layer: WordPress integration adapters

The Domain layer remains independent of external dependencies, defining interfaces (ports) that adapters implement.

Testing

The package includes comprehensive unit tests using PestPHP with WordPress function mocks:

composer test

Test Structure

• tests/helpers.php: Global WordPress function mocks
• tests/ext_cpts_helpers.php: Extended CPTs namespace function mocks
• tests/bootstrap.php: Test environment setup

License

This package is open-source software licensed under the MIT license.