Support array of atom paths

CHANGELOG.md

@@ -1,3 +1,7 @@
+## 1.0.5 - 2023-06-08
+### Changed
+- `atoms` config option now supports an array of paths
+
 ## 1.0.4 - 2020-02-15
 ### Fixed
 - Fix error when using nested atom name (`/`) in closing tag

composer.json

@@ -1,7 +1,7 @@
 {
  "name": "ether/atom",
  "description": "Adding enhanced modularity to Craft CMS Twig templating",
- "version": "1.0.4",
+ "version": "1.0.5",
  "type": "craft-plugin",
  "license": "MIT",
  "minimum-stability": "dev",

src/Atom.php

@@ -53,21 +53,25 @@ public static function renderAtom (
  ) : void {
  $view = Craft::$app->getView();
 
- $template = self::$_config['atoms'] . '/' . $handle;
+ $atomPaths = self::$_config['atoms'];
+ if (!is_array($atomPaths)) $atomPaths = [$atomPaths];
 
  $variables['children'] = new Markup($children, 'utf8');
 
- if (!$view->doesTemplateExist($template))
+ foreach ($atomPaths as $path)
  {
- Craft::error(
- "Error locating template: {$template}",
- __METHOD__
- );
+ $template = $path . '/' . $handle;
 
- return;
+ if ($view->doesTemplateExist($template)) {
+ echo $view->renderTemplate($template, $variables);
+ return;
+ }
  }
 
- echo $view->renderTemplate($template, $variables);
+ Craft::error(
+ "Error locating template: {$handle}",
+ __METHOD__
+ );
  }
 
 }

src/config.php

@@ -7,6 +7,7 @@
  * _Defaults to `_atoms`_
  *
  * The location of your atoms, relative to your `templates` directory.
+ * Can also be an array of paths, in descending order of priority.
  */
  'atoms' => '_atoms',
 ];