nystudio107\templatecomments\TemplateComments

Complexity

Total Complexity

31

Size/Duplication

Total Lines	183
Duplicated Lines	0 %

Importance

Changes

0

11 Methods

Rating	Name	Duplication	Size	Complexity
A	installSiteComponents()	0	4	2
A	installTemplateEventListeners()	0	13	5
A	installCpComponents()	0	4	2
A	installEventListeners()	0	10	5
A	createSettingsModel()	0	3	1
A	init()	0	18	1
A	installSiteEventListeners()	0	4	2
A	addComponents()	0	10	5
A	installCpEventListeners()	0	4	2
A	installTemplateComponents()	0	6	4
A	enabledForTemplate()	0	5	2

<?php
/**
 * Template Comments plugin for Craft CMS 3.x
 *
 * 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) 2018 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 nystudio107\templatecomments\models\Settings;
use nystudio107\templatecomments\web\twig\CommentsTwigExtension;
use nystudio107\templatecomments\web\twig\CommentTemplateLoader;

use Craft;
use craft\base\Plugin;
use craft\events\TemplateEvent;
use craft\web\View;

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 indented incorrectly; expected 2 spaces but found 4

 * @package   TemplateComments

Tag value indented incorrectly; expected 1 spaces but found 3

 * @since     1.0.0

The tag in position 3 should be the @author tag

Tag value 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 $plugin;

    /**

Missing short description in doc comment

     * @var Settings $settings
     */
    public static $settings;

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

    /**

Missing short description in doc comment

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

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

    /**

Missing short description in doc comment

     * @inheritdoc
     */

Missing @return tag in function comment

    public function init()
    {
        parent::init();
        // Initialize properties
        self::$plugin = $this;
        self::$settings = $this->getSettings();
        // Add in our Craft components
        $this->addComponents();
        // Install our global event handlers
        $this->installEventListeners();

        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()
    {
        $request = Craft::$app->getRequest();
        // Install only for non-console site requests
        if ($request->getIsSiteRequest() && !$request->getIsConsoleRequest()) {
            $this->installSiteComponents();
        }
        // Install only for non-console AdminCP requests
        if ($request->getIsCpRequest() && !$request->getIsConsoleRequest()) {
            $this->installCpComponents();
        }
    }


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

Missing @return tag in function comment

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

    /**
     * Install components for AdminCP requests only
     */

Missing @return tag in function comment

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

    /**
     * Install our event listeners
     */

Missing @return tag in function comment

    protected function installEventListeners()
    {
        $request = Craft::$app->getRequest();
        // Install only for non-console site requests
        if ($request->getIsSiteRequest() && !$request->getIsConsoleRequest()) {
            $this->installSiteEventListeners();
        }
        // Install only for non-console AdminCP 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 AdminCP requests only
     */

Missing @return tag in function comment

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

    /**

Missing short description in doc comment

     * @inheritdoc
     */

Missing @return tag in function comment

    protected function createSettingsModel()
    {
        return new Settings();
    }

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

    /**
     * Install our template components
     */

Missing @return tag in function comment

    private function installTemplateComponents()

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

    {
        $devMode = Craft::$app->getConfig()->getGeneral()->devMode;
        if (!self::$settings->onlyCommentsInDevMode
            || (self::$settings->onlyCommentsInDevMode && $devMode)) {

Closing parenthesis of a multi-line IF statement must be on a new line

            Craft::$app->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
            || (self::$settings->onlyCommentsInDevMode && $devMode)) {

Closing parenthesis of a multi-line IF statement must be on a new line

            // Remember the name of the currently rendering template
            Event::on(
                View::class,
                View::EVENT_BEFORE_RENDER_PAGE_TEMPLATE,
                function (TemplateEvent $event) {
                    $view = Craft::$app->getView();
                    if ($this->enabledForTemplate($event->template)) {
                        $view->getTwig()->setLoader(new CommentTemplateLoader($view));
                    }
                }
            );
        }
    }

    /**
     * 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));
    }
}