From f3ce0d25f9775827bbe091b6d2a03eb497e90585 Mon Sep 17 00:00:00 2001 From: Olivier Gorzalka Date: Thu, 1 Oct 2026 17:56:44 +0200 Subject: [PATCH 1/3] docs: README and Packagist description for discovery Say what Pollora is in the first line, link the site's why, compare and guide pages, show the attribute style, recommend the CLI, and fix the requirements (PHP 8.4+ for a new project, Laravel 13.34, WordPress 7.1+). --- README.md | 45 +++++++++++++++++++++++++++++++++++++-------- composer.json | 2 +- 2 files changed, 38 insertions(+), 9 deletions(-) diff --git a/README.md b/README.md index 1f1d8c8c..a7bd7f9f 100644 --- a/README.md +++ b/README.md @@ -11,9 +11,29 @@ License

-## About Pollora Framework +## About Pollora -Pollora is a framework that bridges **Laravel** and **WordPress**, combining Laravel's architecture patterns with WordPress's content management capabilities. It allows developers to use Laravel's service providers, dependency injection, Blade templates, and Eloquent ORM while maintaining full WordPress functionality. +**Pollora is the Laravel framework for WordPress.** WordPress runs inside a Laravel application: the front end uses Laravel routing, controllers, Blade and Eloquent, while the WordPress admin, database, editors' workflow and plugins keep working as usual. Hooks, post types, taxonomies and REST routes are declared with PHP 8 attributes and registered by auto-discovery. + +[Website](https://pollora.dev) · [Documentation](https://pollora.dev/getting-started/installation/) · [Why Pollora](https://pollora.dev/why/) · [Pollora vs Acorn, Sage, Radicle and Corcel](https://pollora.dev/compare/) · [1-minute tour](https://www.youtube.com/watch?v=Wk1VzPapqM8) + +```php +use Pollora\Attributes\Filter; +use Pollora\Attributes\PostType; +use Pollora\Attributes\PostType\HasArchive; +use Pollora\Attributes\PostType\Supports; + +#[PostType] +#[HasArchive] +#[Supports(['title', 'editor', 'thumbnail'])] +class Book {} + +class Seo +{ + #[Filter('document_title_parts')] + public function title(array $parts): array { /* ... */ return $parts; } +} +``` ### Key Features @@ -32,19 +52,28 @@ Full documentation is available at **[pollora.dev](https://pollora.dev)**. ## Installation -Pollora is installed via the [skeleton project](https://github.com/Pollora/pollora) — see the [installation guide](https://pollora.dev/getting-started/installation/): +Create a project with the [Pollora CLI](https://github.com/Pollora/cli), or with Composer through the [skeleton](https://github.com/Pollora/pollora). See the [installation guide](https://pollora.dev/getting-started/installation/): ```bash +composer global require pollora/cli +pollora new my-project --ddev + +# or composer create-project pollora/pollora my-project ``` -See the [skeleton README](https://github.com/Pollora/pollora) for detailed setup instructions. - ## Requirements -- PHP ^8.3 -- Laravel 13.x -- WordPress 6.9+ +- PHP 8.4+ for a new project (the skeleton's lock file ships Symfony 8; this package alone accepts PHP 8.3) +- Laravel 13.34 (Pollora's version numbers follow the Laravel release it is built on) +- WordPress 7.1+ + +## Learn more + +- [WordPress hooks with PHP 8 attributes](https://pollora.dev/guides/wordpress-hooks-php-attributes/) +- [Custom post types and taxonomies with PHP attributes](https://pollora.dev/guides/custom-post-types-php-attributes/) +- [How Pollora runs WordPress inside Laravel](https://pollora.dev/guides/how-pollora-runs-wordpress-inside-laravel/) +- [AI coding agents for WordPress projects (Nectar)](https://pollora.dev/guides/ai-coding-agents-wordpress/) ## Testing diff --git a/composer.json b/composer.json index 3983876d..fd89485f 100644 --- a/composer.json +++ b/composer.json @@ -1,6 +1,6 @@ { "name": "pollora/framework", - "description": "Laravel & WordPress blend for coding as sweet as honey. Join the hive!", + "description": "The Laravel framework for WordPress: Laravel routing, Blade and Eloquent, with PHP 8 attributes for hooks, post types, taxonomies and REST routes.", "license": "MIT", "homepage": "https://pollora.dev", "support": { From e0fb454df97fb9de37dec9b5d53a15587cecb8a5 Mon Sep 17 00:00:00 2001 From: Olivier Gorzalka Date: Thu, 1 Oct 2026 18:02:15 +0200 Subject: [PATCH 2/3] docs: compare link wording --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index a7bd7f9f..f03729bf 100644 --- a/README.md +++ b/README.md @@ -15,7 +15,7 @@ **Pollora is the Laravel framework for WordPress.** WordPress runs inside a Laravel application: the front end uses Laravel routing, controllers, Blade and Eloquent, while the WordPress admin, database, editors' workflow and plugins keep working as usual. Hooks, post types, taxonomies and REST routes are declared with PHP 8 attributes and registered by auto-discovery. -[Website](https://pollora.dev) · [Documentation](https://pollora.dev/getting-started/installation/) · [Why Pollora](https://pollora.dev/why/) · [Pollora vs Acorn, Sage, Radicle and Corcel](https://pollora.dev/compare/) · [1-minute tour](https://www.youtube.com/watch?v=Wk1VzPapqM8) +[Website](https://pollora.dev) · [Documentation](https://pollora.dev/getting-started/installation/) · [Why Pollora](https://pollora.dev/why/) · [How Pollora compares with Acorn, Sage, Radicle and Corcel](https://pollora.dev/compare/) · [1-minute tour](https://www.youtube.com/watch?v=Wk1VzPapqM8) ```php use Pollora\Attributes\Filter; From 5f632732d205bdb08166e4141c9bc3b93e44a02a Mon Sep 17 00:00:00 2001 From: Olivier Gorzalka Date: Thu, 1 Oct 2026 18:02:32 +0200 Subject: [PATCH 3/3] docs: credit Roots and Corcel --- README.md | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/README.md b/README.md index f03729bf..f0ef2d6b 100644 --- a/README.md +++ b/README.md @@ -97,6 +97,10 @@ If you discover a security vulnerability, please report it via [GitHub Security All notable changes are documented in [CHANGELOG.md](CHANGELOG.md). +## Credits + +Pollora builds on the work of [Roots](https://roots.io), a constant source of inspiration: themes, blocks and plugins are built with `@roots/vite-plugin`, the project follows the Bedrock layout with `roots/bedrock-autoloader`, and Blade ships [Sage Directives](https://github.com/Log1x/sage-directives). The WordPress models are built on [Colt](https://github.com/Pollora/colt), a fork of [Corcel](https://github.com/corcel/corcel). + ## License Pollora is open-sourced software licensed under the [MIT license](LICENSE).