This repository is the source of the documentation of Pollora, the Laravel framework for WordPress, published at pollora.dev. Read it there for search, navigation and the latest version; open pull requests here to change it: the site copies these pages, so a fix made anywhere else is overwritten on the next sync.

Read the docs on pollora.dev · Framework · Skeleton · Changelog

Getting Started

• Installation — Setup with Composer, DDEV, and environment configuration
• Getting Started — Build your first Pollora application
• Server Configuration — Apache/Nginx setup, directory protection, reverse proxy & HTTPS
• IDE Integration — Configure your editor for optimal DX
• Environment Management — Managing WordPress constants and .env

Routing & Controllers

• Routing — Route::wp(), WordPress conditions, and hybrid Laravel+WP routing
• Controllers — Controllers with dependency injection
• Middleware — Request/response filtering and authentication

Content Management

• Post Types — #[PostType] attribute, config-based registration
• Post Type Attributes Reference — Every attribute available for post type registration
• Taxonomies — #[Taxonomy] attribute, custom taxonomies
• Typed Meta — #[Meta] properties, Meta::of(), typed reads and writes, REST schema
• Block Bindings — #[BlockBinding] sources, typed meta in core blocks, bindable Blade blocks
• Options — WordPress options with Laravel's fluent API

WordPress Integration

• Hooks — #[Action] / #[Filter] attributes, hookable classes
• Asynchronous Actions — ->async() and #[Async]: run an action after the request, through WP-Cron, Action Scheduler or a Laravel queue
• Authentication — WordPress authentication guard
• Roles & Capabilities — $user->can(), @can, #[Role], #[ModifyRole], post types with their own capabilities
• WP REST API — #[WpRestRoute] attribute, custom REST endpoints
• Abilities — #[Ability] attribute, the WordPress Abilities API for AI agents and MCP
• WP-CLI Commands — Custom Artisan-style WP-CLI commands
• WordPress Config — Managing WordPress constants via Laravel config
• WordPress Logging — WordPress error logging through Laravel
• Translations — __() routing between Laravel's translator and WordPress's .po/.mo catalogues

Frontend & Theming

• Theming — Theme structure, Blade templates, parent/child themes
• Assets — Vite integration, HMR, Tailwind CSS
• Blocks — Custom Gutenberg blocks with Vite and JSX
• Patterns — Gutenberg block patterns and categories

Monitoring & Tooling

• Dashboard & Status — Admin dashboard, pollora:status command, --json output
• Nectar — AI Context — AI guidelines, agent skills, and MCP tools for AI-assisted development

Advanced Features

• Discovery — Auto-discovery system for PHP attributes
• Modules — Modular architecture with nwidart/laravel-modules
• Plugins — Plugin development with modern tooling
• Events & Listeners — WordPress event dispatching and Laravel listeners
• WordPress Events Reference — Every WordPress and plugin event Pollora dispatches
• Scheduling — #[Schedule] attribute, WordPress cron management
• AJAX — Handling AJAX requests
• Menu — Admin menu management

Requirements

Dependency	Version
PHP	8.4+ for a new project (the framework alone accepts 8.3)
Laravel	13.35
WordPress	7.1+

Contributing

Contributions are welcome: see the contributing guide. Report security issues privately, as described in the security policy.

License

The Pollora documentation is open-source software licensed under the MIT license. © RuBee group