nystudio107 / craft-templatecomments

src/TemplateComments.php

<?php
/**
 * Template Comments plugin for Craft CMS
 *
 * Adds a HTML comment to demarcate each Twig template that is included or extended.
 *
 * @link      https://nystudio107.com/

The tag in position 1 should be the @copyright tag

 * @copyright Copyright (c)  nystudio107

@copyright tag must contain a year and the name of the copyright holder

 */

PHP version not specified

Missing @category tag in file comment

Missing @package tag in file comment

Missing @author tag in file comment

Missing @license tag in file comment

namespace nystudio107\templatecomments;

use Craft;
use craft\base\Model;
use craft\base\Plugin;
use craft\events\TemplateEvent;
use craft\web\View;
use nystudio107\templatecomments\models\Settings;
use nystudio107\templatecomments\web\twig\CommentsTwigExtension;
use nystudio107\templatecomments\web\twig\CommentTemplateLoader;
use nystudio107\templatecomments\web\twig\TemplateCommentsParser;
use Twig\Loader\LoaderInterface;
use yii\base\Event;

/**
 * Class TemplateComments
 *
 * @author    nystudio107

The tag in position 1 should be the @package tag

Content of the @author tag must be in the form "Display Name <username@example.com>"

Tag value for @author tag indented incorrectly; expected 2 spaces but found 4

 * @package   TemplateComments

Tag value for @package tag indented incorrectly; expected 1 spaces but found 3

 * @since     1.0.0

The tag in position 3 should be the @author tag

Tag value for @since tag indented incorrectly; expected 3 spaces but found 5

 *
 */

Additional blank lines found at end of doc comment

Missing @category tag in class comment

Missing @license tag in class comment

Missing @link tag in class comment

class TemplateComments extends Plugin
{
    // Static Properties
    // =========================================================================

    /**

Missing short description in doc comment

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

    /**

Missing short description in doc comment

     * @var ?Settings $settings
     */
    public static ?Settings $settings = null;

    /**

Missing short description in doc comment

     * @var ?LoaderInterface
     */
    public static ?LoaderInterface $originalTwigLoader = null;

    // Public Properties
    // =========================================================================

    /**

Missing short description in doc comment

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

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

    /**

Missing short description in doc comment

     * @inheritdoc
     */

Missing @return tag in function comment

    public function init(): void
    {
        parent::init();
        // Initialize properties
        self::$plugin = $this;
        /** @var ?Settings $settings */

The open comment tag must be the only content on the line

Missing short description in doc comment

The close comment tag must be the only content on the line

        $settings = $this->getSettings();
        self::$settings = $settings;
        // Defer some setup tasks until Craft is fully initialized:
        Craft::$app->onInit(function() {

Expected 1 space after FUNCTION keyword; 0 found

The opening parenthesis of a multi-line function call should be the last content on the line.

            // Add in our Craft components
            $this->addComponents();
            // Install our global event handlers
            $this->installEventListeners();
        });

For multi-line function calls, the closing parenthesis should be on a new line.

        Craft::info(
            Craft::t(
                'templatecomments',
                '{name} plugin loaded',
                ['name' => $this->name]
            ),
            __METHOD__
        );
    }

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

    /**
     * Add in our Craft components
     */

Missing @return tag in function comment

    protected function addComponents(): void
    {
        $request = Craft::$app->getRequest();
        if (!$request->getIsConsoleRequest()) {
            // Do nothing at all on AJAX requests
            if ($request->getIsAjax()) {
                return;
            }

            // Install only for site requests
            if ($request->getIsSiteRequest()) {
                $this->installSiteComponents();
            }

            // Install only for Control Panel requests
            if ($request->getIsCpRequest()) {
                $this->installCpComponents();
            }
        }
    }

    /**
     * Install components for site requests only
     */

Missing @return tag in function comment

    protected function installSiteComponents(): void
    {
        if (self::$settings->siteTemplateComments) {
            $this->installTemplateComponents();
        }
    }

    /**
     * Install components for Control Panel requests only
     */

Missing @return tag in function comment

    protected function installCpComponents(): void
    {
        if (self::$settings->cpTemplateComments) {
            $this->installTemplateComponents();
        }
    }

    /**

Missing short description in doc comment

     * @inheritdoc
     */

Missing @return tag in function comment

    protected function createSettingsModel(): ?Model
    {
        return new Settings();
    }

    /**
     * Install our event listeners
     */

Missing @return tag in function comment

    protected function installEventListeners()
    {
        $request = Craft::$app->getRequest();
        // Do nothing at all on AJAX requests
        if (!$request->getIsConsoleRequest() && $request->getIsAjax()) {
            return;
        }
        // Install only for non-console site requests
        if ($request->getIsSiteRequest() && !$request->getIsConsoleRequest()) {
            $this->installSiteEventListeners();
        }
        // Install only for non-console Control Panel requests
        if ($request->getIsCpRequest() && !$request->getIsConsoleRequest()) {
            $this->installCpEventListeners();
        }
    }

    /**
     * Install site event listeners for site requests only
     */

Missing @return tag in function comment

    protected function installSiteEventListeners()
    {
        if (self::$settings->siteTemplateComments) {
            $this->installTemplateEventListeners();
        }
    }

    /**
     * Install site event listeners for Control Panel requests only
     */

Missing @return tag in function comment

    protected function installCpEventListeners()
    {
        if (self::$settings->cpTemplateComments) {
            $this->installTemplateEventListeners();
        }
    }

    // Private Methods
    // =========================================================================

    /**
     * Install our template components
     */

Missing @return tag in function comment

    private function installTemplateComponents(): void

Private method name "TemplateComments::installTemplateComponents" must be prefixed with an underscore

    {
        $devMode = Craft::$app->getConfig()->getGeneral()->devMode;
        if (!self::$settings->onlyCommentsInDevMode || $devMode) {
            $view = Craft::$app->getView();
            self::$originalTwigLoader = $view->getTwig()->getLoader();
            $view->registerTwigExtension(new CommentsTwigExtension());
        }
    }

    /**
     * Install our template event listeners
     */

Missing @return tag in function comment

    private function installTemplateEventListeners()

Private method name "TemplateComments::installTemplateEventListeners" must be prefixed with an underscore

    {
        $devMode = Craft::$app->getConfig()->getGeneral()->devMode;
        if (!self::$settings->onlyCommentsInDevMode || $devMode) {
            // Remember the name of the currently rendering template
            Event::on(
                View::class,
                View::EVENT_BEFORE_RENDER_PAGE_TEMPLATE,
                function(TemplateEvent $event) {

Expected 1 space after FUNCTION keyword; 0 found

                    $view = Craft::$app->getView();
                    $twig = $view->getTwig();
                    if ($this->enabledForTemplate($event->template)) {
                        $twig->setLoader(new CommentTemplateLoader($view));
                        $twig->setParser(new TemplateCommentsParser($twig));
                    }
                }
            );
        }
    }

    /**
     * Is template parsing enabled for this template?
     *
     * @param string $templateName

Missing parameter comment

     *
     * @return bool
     */
    private function enabledForTemplate(string $templateName): bool

Private method name "TemplateComments::enabledForTemplate" must be prefixed with an underscore

    {
        $ext = pathinfo($templateName, PATHINFO_EXTENSION);
        return (self::$settings->templateCommentsEnabled
            && in_array($ext, self::$settings->allowedTemplateSuffixes, false));
    }
}