nystudio107\templatecomments\web\twig\CommentsTwigExtension

Complexity

Total Complexity

8

Size/Duplication

Total Lines	56
Duplicated Lines	0 %

Importance

Changes

0

4 Methods

Rating	Name	Duplication	Size	Complexity
A	getFunctions()	0	4	1
A	getTokenParsers()	0	11	3
A	getName()	0	3	1
A	originalSource()	0	8	3

<?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 nystudio107\templatecomments\TemplateComments;
use nystudio107\templatecomments\web\twig\tokenparsers\CommentsTokenParser;
use nystudio107\templatecomments\web\twig\tokenparsers\CommentBlockTokenParser;

use Craft;

/**

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

 */

Missing @category tag in class comment

Missing @license tag in class comment

Missing @link tag in class comment

class CommentsTwigExtension extends \Twig_Extension
{
    // Public Methods
    // =========================================================================

    /**

Missing short description in doc comment

     * @inheritdoc
     */

Missing @return tag in function comment

    public function getName()
    {
        return 'template-comments';
    }

    /**

Missing short description in doc comment

     * @inheritdoc
     */

Missing @return tag in function comment

    public function getFunctions()
    {
        return [
            new \Twig_Function('source', [$this, 'originalSource'], ['needs_environment' => true, 'is_safe' => ['all']]),
        ];
    }

    /**

Missing short description in doc comment

     * @inheritdoc
     */

Missing @return tag in function comment

    public function getTokenParsers(): array
    {
        $parsers = [];
        if (TemplateComments::$settings->templateCommentsEnabled) {
            $parsers[] = new CommentsTokenParser();
        }
        if (TemplateComments::$settings->blockCommentsEnabled) {
            $parsers[] = new CommentBlockTokenParser();
        }

        return $parsers;
    }

    /**
     * Returns a template content without rendering it.
     *
     * @param \Twig_Environment $env

Missing parameter comment

     * @param string           $name          The template name

Expected 12 spaces after parameter type; 11 found

     * @param bool             $ignoreMissing Whether to ignore missing templates or not

Expected 14 spaces after parameter type; 13 found

     *
     * @return string The template source
     */
    function originalSource($env, $name, $ignoreMissing = false)

It is generally recommended to explicitly declare the visibility for methods.

    {
        $loader = TemplateComments::$originalTwigLoader;
        try {
            return $loader->getSourceContext($name)->getCode();
        } catch (\Twig_Error_Loader $e) {
            if (!$ignoreMissing) {
                throw $e;
            }
        }
    }
}