[6.0] Allow adding additional layout base path to form fields (#44590)

* Allow adding addition layout paths to FormField fields
* Allow adding layout include paths via form XML
* Move layout include path to __set method
* Use auto add for layout include path
* Rename parameter and  add as string
* Add since tag
* Remove mistake
* Add template override possibility
* CS
* Add layoutPaths to getter method
* Remove unnecessary method
* Cleanup set method
* Improve layout set/generation
* Code style

Author: bembelimen

libraries/src/Form/FormField.php

@@ -21,6 +21,7 @@
 use Joomla\Database\DatabaseAwareTrait;
 use Joomla\Database\DatabaseInterface;
 use Joomla\Database\Exception\DatabaseNotFoundException;
+use Joomla\Filesystem\Path;
 use Joomla\Registry\Registry;
 use Joomla\String\Normalise;
 use Joomla\String\StringHelper;
@@ -398,6 +399,14 @@ abstract class FormField implements DatabaseAwareInterface, CurrentUserInterface
      */
     protected $renderLabelLayout = 'joomla.form.renderlabel';
 
+    /**
+     * Additional layout paths to look for layout files
+     *
+     * @var   array
+     * @since __DEPLOY_VERSION__
+     */
+    protected $layoutPaths = [];
+
     /**
      * The data-attribute name and values of the form field.
      * For example, data-action-type="click" data-action-type="change"
@@ -474,6 +483,7 @@ public function __get($name)
             case 'validationtext':
             case 'showon':
             case 'parentclass':
+            case 'layoutPaths':
                 return $this->$name;
 
             case 'input':
@@ -591,6 +601,10 @@ public function __set($name, $value)
                 $this->$name = (int) $value;
                 break;
 
+            case 'layoutIncludePath':
+                $this->layoutPaths = \is_array($value) ? $value : explode(',', (string) $value);
+                break;
+
             default:
                 // Detect data attribute(s)
                 if (str_starts_with($name, 'data-')) {
@@ -658,7 +672,7 @@ public function setup(\SimpleXMLElement $element, $value, $group = null)
         $attributes = [
             'multiple', 'name', 'id', 'hint', 'class', 'description', 'labelclass', 'onchange', 'onclick', 'validate', 'pattern', 'validationtext',
             'default', 'required', 'disabled', 'readonly', 'autofocus', 'hidden', 'autocomplete', 'spellcheck', 'translateHint', 'translateLabel',
-            'translate_label', 'translateDescription', 'translate_description', 'size', 'showon', ];
+            'translate_label', 'translateDescription', 'translate_description', 'size', 'showon', 'layoutIncludePath'];
 
         $this->default = isset($element['value']) ? (string) $element['value'] : $this->default;
 
@@ -1060,7 +1074,13 @@ public function renderField($options = [])
 
         $data = array_merge($this->collectLayoutData(), $data);
 
-        return $this->getRenderer($this->renderLayout)->render($data);
+        $renderer = $this->getRenderer($this->renderLayout);
+
+        if (isset($options['layoutIncludePath']) && is_dir(Path::check($options['layoutIncludePath']))) {
+            $renderer->addIncludePaths($options['layoutIncludePath']);
+        }
+
+        return $renderer->render($data);
     }
 
     /**
@@ -1372,7 +1392,13 @@ protected function getLayoutPaths()
     {
         $renderer = new FileLayout('default');
 
-        return $renderer->getDefaultIncludePaths();
+        $paths = $renderer->getDefaultIncludePaths();
+
+        foreach ($this->layoutPaths as $path) {
+            array_unshift($paths, JPATH_ROOT . '/' . ltrim((string) $path, '/'));
+        }
+
+        return $paths;
     }
 
     /**