nystudio107 / craft-templatecomments

src/web/twig/CommentTemplateLoader.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\web\twig;

use Craft;
use craft\web\twig\TemplateLoader;
use craft\web\twig\TemplateLoaderException;
use Twig\Source;

/**

Missing short description in doc comment

 * @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

 */

Missing @category tag in class comment

Missing @license tag in class comment

Missing @link tag in class comment

class CommentTemplateLoader extends TemplateLoader
{
    /**

Missing short description in doc comment

Parameter $name should have a doc-comment as per coding-style.

     * @inheritdoc
     */

Missing @return tag in function comment

    public function getSourceContext($name): Source
    {
        $template = $this->_resolveTemplate($name);

        if (!is_readable($template)) {
            throw new TemplateLoaderException($name, Craft::t('app', 'Tried to read the template at {path}, but could not. Check the permissions.', ['path' => $template]));
        }
        $escapedName = addslashes($name);
        $prefix = "{% comments '{$escapedName}' %}" . PHP_EOL;
        $suffix = PHP_EOL . "{% endcomments %}";

        return new Source($prefix . file_get_contents($template) . $suffix, $name, $template);
    }

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

    /**

Missing short description in doc comment

Parameter $name should have a doc-comment as per coding-style.

     * @inheritdoc
     */

Missing @return tag in function comment

    private function _resolveTemplate(string $name): string
    {
        $template = $this->view->resolveTemplate($name);

The method resolveTemplate() does not exist on null.

        if ($template !== false) {
            return $template;
        }

        throw new TemplateLoaderException($name, Craft::t('app', 'Unable to find the template “{template}”.', ['template' => $name]));
    }
}