HEX
Server: Microsoft-IIS/10.0
System: Windows NT ITPWINWEBSVR22 10.0 build 20348 (Windows Server 2022) AMD64
User: www.conferencesearch.co.uk (0)
PHP: 8.3.30
Disabled: NONE
Upload Files
File: D:/web/matomo.vdk/plugins/TagManager/Commands/GenerateTag.php
<?php

/**
 * Matomo - free/libre analytics platform
 *
 * @link https://matomo.org
 * @license http://www.gnu.org/licenses/gpl-3.0.html GPL v3 or later
 */

namespace Piwik\Plugins\TagManager\Commands;

use Piwik\Plugins\CoreConsole\Commands\GeneratePluginBase;

class GenerateTag extends GeneratePluginBase
{
    protected function configure()
    {
        $this->setName('generate:tagmanager-tag');
        $this->setDescription('Generate Tag');
        $this->addRequiredValueOption('pluginname', null, 'The name of an existing plugin');
        $this->addRequiredValueOption('tagname', null, 'The name of the tag you want to create');
    }

    /**
     * @return int
     */
    protected function doExecute(): int
    {
        $pluginName = $this->getPluginName();
        $this->checkAndUpdateRequiredPiwikVersion($pluginName);

        $tagName = $this->getTagName();
        $tagId = str_replace(array('-', ' '), '', $tagName);
        $tagClass = $tagId . 'Tag';

        $exampleFolder  = PIWIK_INCLUDE_PATH . '/plugins/TagManager';
        $replace        = array(
            'TagManager' => $pluginName,
            'CustomImage' => $tagId,
            'customImage' => lcfirst($tagId),
            'Custom Image' => $tagName,
            'Piwik\Plugins\\' . $pluginName . '\Template\Tag\BaseTag' => 'Piwik\Plugins\TagManager\Template\Tag\BaseTag',
            'parameters, ' . $pluginName => 'parameters, TagManager'
        );
        $whitelistFiles = array(
            '/Template',
            '/Template/Tag',
            '/Template/Tag/CustomImageTag.php',
            '/Template/Tag/CustomImageTag.web.js',
        );

        $this->copyTemplateToPlugin($exampleFolder, $pluginName, $replace, $whitelistFiles);

        $this->makeTranslationIfPossible($pluginName, $tagName, $tagClass . 'Name');
        $this->makeTranslationIfPossible($pluginName, "This is the description for " . $tagName, $tagClass . 'Description');
        $this->makeTranslationIfPossible($pluginName, "", $tagClass . 'Help');

        $this->writeSuccessMessage(array(
            sprintf('Tag for %s in folder "plugins/%s/Template/Tag" generated.', $pluginName, $pluginName),
            'You can now start implementing the tag',
            'Enjoy!'
        ));

        return self::SUCCESS;
    }

    /**
     * @return string
     * @throws \RuntimeException
     */
    private function getTagName()
    {
        $tagName = $this->getInput()->getOption('tagname');

        $validate = function ($testname) {
            if (empty($testname)) {
                throw new \InvalidArgumentException('You have to enter a tag name');
            }

            if (preg_match("/^[0-9]/", $testname)) {
                throw new \InvalidArgumentException('The tag name may not start with a number.');
            }

            if (preg_match("/[^A-Za-z0-9 -]/", $testname)) {
                throw new \InvalidArgumentException('Only alpha numerical characters, whitespaces, and dashes are allowed as a tag name.');
            }

            return $testname;
        };

        if (empty($tagName)) {
            $tagName = $this->askAndValidate('Enter the name of the tag (CamelCase): ', $validate);
        } else {
            $validate($tagName);
        }

        $tagName = ucfirst($tagName);

        return $tagName;
    }

    protected function getPluginName()
    {
        $pluginNames = $this->getPluginNames();
        $invalidName = 'You have to enter the name of an existing plugin';

        return $this->askPluginNameAndValidate($pluginNames, $invalidName);
    }
}