nystudio107\templatecomments\web\twig\CommentTemplateLoader

Complexity

Total Complexity

4

Size/Duplication

Total Lines	35
Duplicated Lines	0 %

Importance

Changes	3
Bugs	0	Features	0

2 Methods

Rating	Name	Duplication	Size	Complexity
A	getSourceContext()	0	13	2
A	_resolveTemplate()	0	9	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\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)
    {
        $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 Twig_Source($prefix . file_get_contents($template) . $suffix, $name, $template);

The class Twig_Source has been deprecated: since Twig 2.7, use "Twig\Source" instead

    }

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