Add support for OctoberCMS / WinterCMS (#27)

* Update Configuration.php

Add support for hint paths configuration

* Update ComponentTokenParser.php

Is enabled hint path support, prepare the hint path

* update hint param handle style, add test

* update readme for OctoberCMS and WinterCMS

* update readme for OctoberCMS and WinterCMS

* update readme for OctoberCMS and WinterCMS

* fixes

---------

Co-authored-by: Giorgio Pogliani <[email protected]>

Author: marcomessa

README.md

@@ -97,7 +97,44 @@ final class TwigEnvironmentConfigurator
 }
 ```
 
+### OctoberCMS / WinterCMS
+
+In OctoberCMS / WinterCMS you need to hook into ```cms.page.beforedisplay``` event inside your plugin's boot method in order to access twig instance.
+Then you can use your plugin hint path to choose a views subfolder as component's folder.
+
 ## Usage
+es. 
+```
+plugins
+|__namespace
+   |__pluginname
+      |__views
+         |__components
+            |__button.htm
+```
+
+```php
+ public function boot(): void
+    {
+        Event::Listen('cms.page.beforeDisplay', function ($controller, $url, $page) {
+            $twig = $controller->getTwig();
+
+            Configuration::make($twig)
+                ->setTemplatesPath('namespace.pluginname::components', hint: true)
+                ->useCustomTags()
+                ->setup();
+        });
+    }
+```
+
+then in your htm files
+
+```
+<x-button>...</x-button>
+```
+
+Alle features like subfolders are supported, like ```<x-forms.input></x-forms.input>``` will refer to ```plugins/namespace/pluginname/views/forms/input.htm```
+
 
 The components are just Twig templates in a folder of your choice (e.g. `components`) and can be used anywhere in your Twig templates. The slot variable is any content you will add between the opening and the close tag.
 

src/Configuration.php

@@ -18,6 +18,8 @@ class Configuration
 
     protected string $templatesPath = 'components';
 
+    protected bool $needsHintPath = false;
+
     protected bool $isUsingTemplatesExtension = true;
 
     protected string $templatesExtension = 'twig';
@@ -40,9 +42,10 @@ public static function make(Environment $twig): Configuration
      * @param string $path
      * @return Configuration
      */
-    public function setTemplatesPath(string $path): self
+    public function setTemplatesPath(string $path, bool $hint = false): self
     {
         $this->templatesPath = rtrim($path, DIRECTORY_SEPARATOR);
+        $this->needsHintPath = $hint;
 
         return $this;
     }
@@ -52,6 +55,11 @@ public function getTemplatesPath(): string
         return $this->templatesPath;
     }
 
+    public function getNeedsHintPath(): bool
+    {
+        return $this->needsHintPath;
+    }
+
     public function useTemplatesExtension(bool $isUsing = true): self
     {
         $this->isUsingTemplatesExtension = $isUsing;

src/TokenParser/ComponentTokenParser.php

@@ -31,16 +31,21 @@ public function getComponentPath(string $name)
 
         $componentPath = rtrim($this->configuration->getTemplatesPath(), DIRECTORY_SEPARATOR) . DIRECTORY_SEPARATOR . $name;
 
-        if ($this->configuration->isUsingTemplatesExtension()) {
-            $componentPath .= '.' . $this->configuration->getTemplatesExtension();
+        if ($this->configuration->getNeedsHintPath()) {
+            $componentPath = rtrim($componentPath, '.');
+            $componentPath = str_replace('/', '.', $componentPath);
+        } else {
+            if ($this->configuration->isUsingTemplatesExtension()) {
+                $componentPath .= '.' . $this->configuration->getTemplatesExtension();
+            }
         }
 
         return  $componentPath;
     }
 
     public function parse(Token $token): Node
     {
-        list($variables, $name) = $this->parseArguments();
+        [$variables, $name] = $this->parseArguments();
 
         $slot = $this->parser->subparse([$this, 'decideBlockEnd'], true);
 

tests/ComponentTokenParserTest.php

@@ -0,0 +1,50 @@
+<?php
+
+namespace Performing\TwigComponents\Tests;
+
+use Performing\TwigComponents\Configuration;
+use Performing\TwigComponents\TokenParser\ComponentTokenParser;
+use PHPUnit\Framework\TestCase;
+
+class ComponentTokenParserTest extends TestCase
+{
+    public function testGetComponentPathWithHintPath()
+    {
+        $loader = new \Twig\Loader\FilesystemLoader(__DIR__ . '/templates');
+        $twig = new \Twig\Environment($loader);
+
+        $config = Configuration::make($twig)
+            ->setTemplatesPath('mynamespace.myplugin::components', hint: true)
+            ->setTemplatesExtension('twig')
+            ->useCustomTags();
+
+        $this->assertTrue($config->getNeedsHintPath());
+        $this->assertEquals($config->getTemplatesPath(), 'mynamespace.myplugin::components');
+        $this->assertEquals($config->getTemplatesExtension(), 'twig');
+
+        $parser = new ComponentTokenParser($config);
+        $componentPath = $parser->getComponentPath('test/component');
+        $this->assertEquals('mynamespace.myplugin::components.test.component', $componentPath);
+    }
+
+    public function testGetComponentPathWithoutHintPath()
+    {
+        $loader = new \Twig\Loader\FilesystemLoader(__DIR__ . '/templates');
+        $twig = new \Twig\Environment($loader);
+
+        $config = Configuration::make($twig)
+            ->setTemplatesPath('_components', hint: false)
+            ->setTemplatesExtension('twig')
+            ->useCustomTags();
+
+        $this->assertFalse($config->getNeedsHintPath());
+        $this->assertEquals($config->getTemplatesPath(), '_components');
+        $this->assertEquals($config->getTemplatesExtension(), 'twig');
+
+        $parser = new ComponentTokenParser($config);
+
+        $componentPath = $parser->getComponentPath('test/component');
+
+        $this->assertEquals('_components/test/component.twig', $componentPath);
+    }
+}