Registering a Post Type

Call PostTypeRegistry::register() inside your plugin's boot() method:

use App\CMS\PostTypes\PostTypeRegistry;

public function boot(): void
{
    PostTypeRegistry::register('announcement', [
        'label'        => 'Announcements',
        'singular'     => 'Announcement',
        'icon'         => '📢',
        'supports'     => ['title', 'editor', 'thumbnail', 'excerpt'],
        'has_archive'  => true,
        'public'       => true,
        'menu_position'=> 5,
    ]);
}

Method Signature

PostTypeRegistry::register(string $slug, array $options): void

Options Reference

Key	Type	Default	Description
label	string	slug (ucfirst)	Plural display name (e.g., "Announcements")
singular	string	label	Singular display name (e.g., "Announcement")
icon	string	'📄'	Emoji or icon class for admin menus
supports	array	['title','editor']	Features: title, editor, thumbnail, excerpt, comments, revisions
has_archive	bool	false	Whether this post type has an archive listing page
public	bool	true	Whether posts of this type are publicly viewable
menu_position	int	25	Position in admin sidebar (lower = higher)

Querying Custom Post Types

Use the standard Post model scoped by type:

use App\CMS\Models\Post;

// Get all published announcements
$announcements = Post::where('post_type', 'announcement')
    ->where('status', 'published')
    ->orderBy('created_at', 'desc')
    ->get();

// Get a single announcement by slug
$post = Post::where('post_type', 'announcement')
    ->where('slug', $slug)
    ->firstOrFail();

Real Example: postify-announcements

The postify-announcements plugin registers the announcement post type in its boot() method:

// From content/plugins/postify-announcements/PostifyAnnouncements.php
public function boot(): void
{
    PostTypeRegistry::register('announcement', [
        'label'       => 'Announcements',
        'singular'    => 'Announcement',
        'icon'        => '📢',
        'supports'    => ['title', 'editor', 'thumbnail', 'excerpt'],
        'has_archive' => true,
        'public'      => true,
    ]);
}