Bootstrap.php

<?php

namespace Plugins\HelloWorld;

use App\Core\Service\Plugin\PluginSettingService;
use Psr\Log\LoggerInterface;

/**
 * Bootstrap class for Hello World plugin initialization.
 *
 * The Bootstrap class is invoked when the plugin is enabled and provides
 * a centralized place for:
 * - Initializing default settings
 * - Registering custom services
 * - Setting up event listeners programmatically
 * - Performing one-time setup tasks
 * - Logging plugin startup
 *
 * This is optional but recommended for plugins that need custom initialization logic.
 * If no bootstrap is needed, this class can be omitted.
 *
 * The bootstrap class is specified in plugin.json:
 * "bootstrap_class": "Plugins\\HelloWorld\\Bootstrap"
 */
class Bootstrap
{
    public function __construct(
        private readonly PluginSettingService $pluginSettingService,
        private readonly LoggerInterface $logger,
    ) {}

    /**
     * Initialize the plugin.
     *
     * This method is called once when the plugin is enabled.
     * Use it for:
     * - Setting default configuration values
     * - Verifying plugin requirements
     * - Performing initial data setup
     * - Registering custom handlers
     *
     * @return void
     */
    public function initialize(): void
    {
        $this->logger->info('Hello World plugin: Bootstrap initialization started');

        try {
            // Note: Default settings are initialized via migration (Version20251214000002.php)
            // This ensures settings are properly versioned and tracked with the database schema

            // Perform any other setup tasks
            $this->setupPluginDefaults();

            $this->logger->info('Hello World plugin: Bootstrap initialization completed successfully');
        } catch (\Exception $e) {
            $this->logger->error('Hello World plugin: Bootstrap initialization failed', [
                'error' => $e->getMessage(),
                'trace' => $e->getTraceAsString(),
            ]);

            throw $e;
        }
    }

    /**
     * Setup plugin-specific defaults.
     *
     * Add any additional initialization logic here:
     * - Create default data in plugin tables
     * - Verify external dependencies
     * - Register custom handlers
     * - Setup caching
     *
     * @return void
     */
    private function setupPluginDefaults(): void
    {
        // Example: Log plugin version and configuration
        $debugMode = (bool) $this->pluginSettingService->get('hello-world', 'debug_mode', false);

        if ($debugMode) {
            $this->logger->debug('Hello World plugin: Debug mode is enabled');

            // In debug mode, log all current settings
            $allSettings = [
                'greeting_message' => $this->pluginSettingService->get('hello-world', 'greeting_message'),
                'enable_widget' => $this->pluginSettingService->get('hello-world', 'enable_widget'),
                'enable_statistics' => $this->pluginSettingService->get('hello-world', 'enable_statistics'),
                'notification_level' => $this->pluginSettingService->get('hello-world', 'notification_level'),
            ];

            $this->logger->debug('Hello World plugin: Current settings', $allSettings);
        }

        // Here you could:
        // - Verify database tables exist
        // - Create initial statistics records
        // - Register custom event listeners
        // - Setup external API connections
        // - Initialize caches
    }

    /**
     * Cleanup method called when plugin is disabled (optional).
     *
     * Use this for cleanup tasks like:
     * - Clearing caches
     * - Closing connections
     * - Removing temporary data
     *
     * Note: This is optional and only called if the method exists.
     *
     * @return void
     */
    public function cleanup(): void
    {
        $this->logger->info('Hello World plugin: Bootstrap cleanup started');

        // Perform cleanup tasks
        // Don't delete user data or settings - just cleanup temporary resources

        $this->logger->info('Hello World plugin: Bootstrap cleanup completed');
    }
}