Merge branch 'develop'

Author: ogorzalka

README.md

@@ -0,0 +1,73 @@
+<p align="center">
+  <a href="https://github.com/Pollora/framework">
+    <img src="resources/images/pollora-logo.svg" width="400" alt="Pollora">
+  </a>
+</p>
+
+<p align="center">
+  <a href="https://packagist.org/packages/pollora/framework"><img src="https://img.shields.io/packagist/v/pollora/framework" alt="Latest Stable Version"></a>
+  <a href="https://packagist.org/packages/pollora/framework"><img src="https://img.shields.io/packagist/dt/pollora/framework" alt="Total Downloads"></a>
+  <a href="https://codecov.io/gh/Pollora/framework"><img src="https://codecov.io/gh/Pollora/framework/branch/main/graph/badge.svg" alt="Coverage"></a>
+  <a href="https://packagist.org/packages/pollora/framework"><img src="https://img.shields.io/packagist/l/pollora/framework" alt="License"></a>
+</p>
+
+## About Pollora Framework
+
+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.
+
+### Key Features
+
+- **WordPress routing** via `Route::wp()` with template hierarchy support
+- **PHP attributes** for hooks (`#[Action]`, `#[Filter]`), post types (`#[PostType]`), taxonomies (`#[Taxonomy]`), scheduling (`#[Schedule]`), and REST routes (`#[WpRestRoute]`)
+- **Auto-discovery system** that scans and registers components automatically
+- **Blade templates** with [Sage Directives](https://log1x.github.io/sage-directives-docs/) for WordPress data
+- **Theme system** with dynamic PSR-4 autoloading, parent/child theme support, and Vite asset management
+- **WordPress authentication** guard and password hashing integration
+- **Event dispatching** for WordPress core, WooCommerce, Gravity Forms, and Yoast SEO
+- **Module system** via [nwidart/laravel-modules](https://github.com/nwidart/laravel-modules)
+
+## Documentation
+
+Full documentation is available at [github.com/Pollora/documentation](https://github.com/Pollora/documentation).
+
+## Installation
+
+Pollora is installed via the [skeleton project](https://github.com/Pollora/pollora):
+
+```bash
+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+
+
+## Testing
+
+```bash
+composer test          # Run all checks (Rector, Pint, PHPStan, Pest)
+composer test:unit     # Run Pest tests with 100% coverage requirement
+composer test:types    # Run PHPStan static analysis
+composer test:lint     # Check code style with Pint
+composer test:refacto  # Check refactoring rules with Rector
+```
+
+## Contributing
+
+Please see [CONTRIBUTING.md](CONTRIBUTING.md) for details.
+
+## Security
+
+If you discover a security vulnerability, please report it via [GitHub Security Advisories](https://github.com/Pollora/framework/security/advisories/new). See [SECURITY.md](SECURITY.md) for details.
+
+## Changelog
+
+All notable changes are documented in [CHANGELOG.md](CHANGELOG.md).
+
+## License
+
+Pollora is open-sourced software licensed under the [GPL-2.0-or-later](LICENSE).

rector.php

@@ -10,10 +10,11 @@
 return RectorConfig::configure()
     ->withPaths([
         __DIR__.'/src',
-        // __DIR__.'/tests',
+        __DIR__.'/tests',
     ])
     ->withSkip([
         AddOverrideAttributeToOverriddenMethodsRector::class,
+        __DIR__.'/tests/Unit/helpers.php',
     ])
     ->withPreparedSets(
         deadCode: true,

resources/images/pollora-logo.svg

@@ -38,6 +38,7 @@
 use Pollora\Theme\Infrastructure\Providers\ThemeServiceProvider;
 use Pollora\ThirdParty\WooCommerce\Infrastructure\Providers\WooCommerceServiceProvider;
 use Pollora\ThirdParty\WpRocket\WpRocketServiceProvider;
+use Pollora\VersionCheck\Infrastructure\Providers\VersionCheckServiceProvider;
 use Pollora\View\Infrastructure\Providers\TemplateHierarchyServiceProvider;
 use Pollora\View\ViewServiceProvider;
 use Pollora\WordPress\Config\ConstantServiceProvider;
@@ -130,6 +131,9 @@ public function register(): void
         // Hashing service provider
         $this->app->register(HashServiceProvider::class);
         $this->app->register(WordPressServiceProvider::class);
+
+        // Version check notifications
+        $this->app->register(VersionCheckServiceProvider::class);
     }
 
     /**

src/Providers/PolloraServiceProvider.php

@@ -0,0 +1,32 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Pollora\VersionCheck\Domain\Contracts;
+
+use Pollora\VersionCheck\Infrastructure\Services\PackagistVersionChecker;
+
+/**
+ * Contract for checking Pollora framework version information.
+ *
+ * Implementations are responsible for determining the currently installed
+ * version and fetching the latest available version from a remote source.
+ *
+ * @see PackagistVersionChecker
+ */
+interface VersionCheckerInterface
+{
+    /**
+     * Get the latest stable version available from the remote source.
+     *
+     * @return string|null The latest version string (e.g. "13.3.0"), or null if unavailable
+     */
+    public function getLatestVersion(): ?string;
+
+    /**
+     * Get the currently installed version of the Pollora framework.
+     *
+     * @return string|null The current version string (e.g. "13.3.0"), or null if undetermined
+     */
+    public function getCurrentVersion(): ?string;
+}

src/VersionCheck/Domain/Contracts/VersionCheckerInterface.php

@@ -0,0 +1,65 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Pollora\VersionCheck\Domain\Services;
+
+use Pollora\VersionCheck\Domain\Contracts\VersionCheckerInterface;
+
+/**
+ * Compares the installed Pollora version against the latest available version.
+ *
+ * This domain service encapsulates the version comparison logic and acts as
+ * the primary entry point for UI components (admin notice, Site Health) to
+ * determine whether an update is available.
+ *
+ * @see VersionCheckerInterface
+ */
+class VersionComparator
+{
+    public function __construct(
+        private readonly VersionCheckerInterface $checker
+    ) {}
+
+    /**
+     * Determine whether a newer version of Pollora is available.
+     *
+     * Returns false if either version cannot be determined, ensuring
+     * no false-positive update notifications are shown.
+     */
+    public function isUpdateAvailable(): bool
+    {
+        $current = $this->checker->getCurrentVersion();
+        $latest = $this->checker->getLatestVersion();
+
+        if ($current === null || $latest === null) {
+            return false;
+        }
+
+        return version_compare($latest, $current, '>');
+    }
+
+    /**
+     * Get the currently installed version.
+     *
+     * Delegates to the underlying VersionCheckerInterface implementation.
+     *
+     * @return string|null The current version string, or null if undetermined
+     */
+    public function getCurrentVersion(): ?string
+    {
+        return $this->checker->getCurrentVersion();
+    }
+
+    /**
+     * Get the latest available version.
+     *
+     * Delegates to the underlying VersionCheckerInterface implementation.
+     *
+     * @return string|null The latest version string, or null if unavailable
+     */
+    public function getLatestVersion(): ?string
+    {
+        return $this->checker->getLatestVersion();
+    }
+}

src/VersionCheck/Domain/Services/VersionComparator.php

@@ -0,0 +1,64 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Pollora\VersionCheck\Infrastructure\Providers;
+
+use Illuminate\Support\ServiceProvider;
+use Pollora\Hook\Domain\Contracts\Action;
+use Pollora\Hook\Domain\Contracts\Filter;
+use Pollora\VersionCheck\Domain\Contracts\VersionCheckerInterface;
+use Pollora\VersionCheck\Domain\Services\VersionComparator;
+use Pollora\VersionCheck\Infrastructure\Services\PackagistVersionChecker;
+use Pollora\VersionCheck\UI\Http\AdminNotice;
+use Pollora\VersionCheck\UI\Http\SiteHealthCheck;
+
+/**
+ * Service provider for the Pollora version check module.
+ *
+ * Registers version checking services in the container and hooks the
+ * admin notice and Site Health integration into WordPress when running
+ * in the admin context.
+ *
+ * Hooks registered:
+ * - `admin_notices`: Displays a dismissable update banner
+ * - `wp_ajax_pollora_dismiss_update_notice`: Handles notice dismissal via AJAX
+ * - `debug_information`: Adds Pollora version info to Site Health debug data
+ * - `site_status_tests`: Adds a version status test to Site Health
+ */
+class VersionCheckServiceProvider extends ServiceProvider
+{
+    /**
+     * Register version check services in the container.
+     *
+     * Binds the VersionCheckerInterface to the Packagist implementation
+     * and registers the VersionComparator as a singleton.
+     */
+    public function register(): void
+    {
+        $this->app->singleton(VersionCheckerInterface::class, PackagistVersionChecker::class);
+        $this->app->singleton(VersionComparator::class);
+    }
+
+    /**
+     * Boot version check hooks into WordPress admin.
+     *
+     * Only registers hooks when running in the WordPress admin context
+     * to avoid unnecessary overhead on frontend requests.
+     *
+     * @param  Action  $action  WordPress action hook service
+     * @param  Filter  $filter  WordPress filter hook service
+     */
+    public function boot(Action $action, Filter $filter): void
+    {
+        if (! function_exists('is_admin') || ! is_admin()) {
+            return;
+        }
+
+        $action->add('admin_notices', [$this->app->make(AdminNotice::class), 'render']);
+        $action->add('wp_ajax_pollora_dismiss_update_notice', [$this->app->make(AdminNotice::class), 'dismiss']);
+
+        $filter->add('debug_information', [$this->app->make(SiteHealthCheck::class), 'addDebugInfo']);
+        $filter->add('site_status_tests', [$this->app->make(SiteHealthCheck::class), 'addTests']);
+    }
+}