Support array of atom paths

Author: Tam

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',
 ];