nystudio107 / craft-twigpack

src/Twigpack.php

<?php
/**
 * Twigpack plugin for Craft CMS 3.x
 *
 * Twigpack is the conduit between Twig and webpack, with manifest.json &
 * webpack-dev-server HMR support
 *
 * @link      https://nystudio107.com/
 * @copyright Copyright (c) 2018 nystudio107
 */

namespace nystudio107\twigpack;

use Craft;
use craft\base\Model;
use craft\base\Plugin;
use craft\cloud\cli\controllers\UpController;
use craft\events\CancelableEvent;
use craft\events\PluginEvent;
use craft\events\RegisterCacheOptionsEvent;
use craft\events\TemplateEvent;
use craft\services\Plugins;
use craft\utilities\ClearCaches;
use craft\web\Application;
use craft\web\twig\variables\CraftVariable;
use craft\web\View;
use nystudio107\twigpack\models\Settings;
use nystudio107\twigpack\services\Manifest as ManifestService;
use nystudio107\twigpack\variables\ManifestVariable;
use yii\base\Event;
use yii\web\NotFoundHttpException;

/**
 * Class Twigpack
 *
 * @author    nystudio107
 * @package   Twigpack
 * @since     1.0.0
 *
 * @property  ManifestService $manifest
 */
class Twigpack extends Plugin
{
    // Static Properties
    // =========================================================================

    /**
     * @var ?Twigpack
     */
    public static ?Twigpack $plugin = null;

    /**
     * @var string
     */
    public static string $templateName = '';

    // Static Methods
    // =========================================================================
    /**
     * @var string
     */
    public string $schemaVersion = '1.0.0';

    // Public Properties
    // =========================================================================
    /**
     * @var bool
     */
    public bool $hasCpSection = false;
    /**
     * @var bool
     */
    public bool $hasCpSettings = false;

    /**
     * @inheritdoc
     */
    public function __construct($id, $parent = null, array $config = [])
    {
        $config['components'] = [
            'manifest' => ManifestService::class,
        ];

        parent::__construct($id, $parent, $config);
    }

    // Public Methods
    // =========================================================================

    /**
     * @inheritdoc
     */
    public function init(): void
    {
        parent::init();
        self::$plugin = $this;
        // Install our event listeners
        $this->installEventListeners();
        // Log that we've loaded
        Craft::info(
            Craft::t(
                'twigpack',
                '{name} plugin loaded',
                ['name' => $this->name]
            ),
            __METHOD__
        );
    }

    /**
     * Clear all the caches!
     */
    public function clearAllCaches(): void
    {
        // Clear all of Twigpack's caches
        self::$plugin->manifest->invalidateCaches();
    }

    /**
     * Inject the error entry point JavaScript for auto-reloading of Twig error
     * pages
     */
    public function injectErrorEntry(): void
    {
        if (Craft::$app->getResponse()->isServerError || Craft::$app->getResponse()->isClientError) {
            /** @var ?Settings $settings */
            $settings = self::$plugin->getSettings();
            if ($settings && !empty($settings->errorEntry) && $settings->useDevServer) {
                try {
                    $errorEntry = $settings->errorEntry;
                    if (is_string($errorEntry)) {
                        $errorEntry = [$errorEntry];
                    }
                    foreach ($errorEntry as $entry) {
                        $tag = self::$plugin->manifest->getJsModuleTags($entry, false);
                        if ($tag !== null) {
                            echo $tag;
                        }
                    }
                } catch (NotFoundHttpException $e) {
                    // That's okay, Twigpack will have already logged the error
                }
            }
        }
    }

    // Protected Methods
    // =========================================================================

    /**
     * Install our event listeners.
     */
    protected function installEventListeners(): void
    {
        // Remember the name of the currently rendering template
        // Handler: View::EVENT_BEFORE_RENDER_PAGE_TEMPLATE
        Event::on(
            View::class,
            View::EVENT_BEFORE_RENDER_PAGE_TEMPLATE,
            static function(TemplateEvent $event) {
                self::$templateName = $event->template;
            }
        );
        // Handler: CraftVariable::EVENT_INIT
        Event::on(
            CraftVariable::class,
            CraftVariable::EVENT_INIT,
            static function(Event $event) {
                /** @var CraftVariable $variable */
                $variable = $event->sender;
                $variable->set('twigpack', ManifestVariable::class);
            }
        );
        // Handler: Plugins::EVENT_AFTER_INSTALL_PLUGIN
        Event::on(
            Plugins::class,
            Plugins::EVENT_AFTER_INSTALL_PLUGIN,
            function(PluginEvent $event) {
                if ($event->plugin === $this) {
                    // Invalidate our caches after we've been installed
                    $this->clearAllCaches();
                }
            }
        );
        // Handler: ClearCaches::EVENT_REGISTER_CACHE_OPTIONS
        Event::on(
            ClearCaches::class,
            ClearCaches::EVENT_REGISTER_CACHE_OPTIONS,
            function(RegisterCacheOptionsEvent $event) {
                Craft::debug(
                    'ClearCaches::EVENT_REGISTER_CACHE_OPTIONS',
                    __METHOD__
                );
                // Register our caches for the Clear Cache Utility
                $event->options = array_merge(
                    $event->options,
                    $this->customAdminCpCacheOptions()
                );
            }
        );
        // Clears cache after craft cloud/up is run, which Craft Cloud runs on deploy
        // Handler: UpController::EVENT_AFTER_UP
        if (class_exists(UpController::class)) {
            Event::on(
                UpController::class,
                UpController::EVENT_AFTER_UP,
                function (CancelableEvent $event) {

The parameter $event is not used and could be removed.

                    $this->clearAllCaches();
                }
            );
        }

        // delay attaching event handler to the view component after it is fully configured
        $app = Craft::$app;
        if ($app->getConfig()->getGeneral()->devMode) {
            $app->on(Application::EVENT_BEFORE_REQUEST, function() use ($app) {
                $app->getView()->on(View::EVENT_END_BODY, [$this, 'injectErrorEntry']);
            });
        }
    }

    /**
     * Returns the custom Control Panel cache options.
     *
     * @return array
     */
    protected function customAdminCpCacheOptions(): array
    {
        return [
            // Manifest cache
            [
                'key' => 'twigpack-manifest-cache',
                'label' => Craft::t('twigpack', 'Twigpack Manifest Cache'),
                'action' => [$this, 'clearAllCaches'],
            ],
        ];
    }

    /**
     * @inheritdoc
     */
    protected function createSettingsModel(): ?Model
    {
        return new Settings();
    }
}