feat(amm): module filtering via onPrepareModuleList + conditions engine

Frontend modules filtered based on condition sets mapped via ConditionsHelper::shouldDisplay('com_modules', moduleId). Modules with no conditions pass through. Graceful skip if tables don't exist. Implements #160.
2026-06-23 12:33:27 -05:00
parent 5b1fe5f806
commit 36bfe59115
1 changed files with 64 additions and 0 deletions
@@ -2904,4 +2904,68 @@ class MokoSuiteClient extends CMSPlugin implements BootableExtensionInterface
 			Log::add('Cache auto-clear failed: ' . $e->getMessage(), Log::WARNING, 'mokosuiteclient');
 		}
 	}
+
+	// ------------------------------------------------------------------
+	// Advanced Module Manager — Conditions-based filtering (#160)
+	// ------------------------------------------------------------------
+
+	/**
+	 * Filter the site module list based on ConditionsHelper rules.
+	 *
+	 * Modules that have no condition mappings pass through unchanged.
+	 * Modules with condition sets are evaluated; only those whose
+	 * conditions are satisfied for the current request are kept.
+	 *
+	 * @param   array|null  &$modules  The list of module objects Joomla will render.
+	 *
+	 * @return  void
+	 *
+	 * @since   02.47.52
+	 */
+	public function onPrepareModuleList(?array &$modules): void
+	{
+		if ($modules === null || !$this->getApplication()->isClient('site'))
+		{
+			return;
+		}
+
+		// Only filter if the conditions map table exists
+		try
+		{
+			$db     = Factory::getContainer()->get(\Joomla\Database\DatabaseInterface::class);
+			$tables = $db->getTableList();
+			$prefix = $db->getPrefix();
+
+			if (!\in_array($prefix . 'mokosuiteclient_conditions_map', $tables, true))
+			{
+				return;
+			}
+		}
+		catch (\Throwable $e)
+		{
+			return;
+		}
+
+		$filtered = [];
+
+		foreach ($modules as $module)
+		{
+			$moduleId = (int) ($module->id ?? 0);
+
+			if ($moduleId <= 0)
+			{
+				$filtered[] = $module;
+				continue;
+			}
+
+			// ConditionsHelper::shouldDisplay returns true when no conditions
+			// are mapped (module shows everywhere) or when conditions pass.
+			if (\Moko\Component\MokoSuiteClient\Administrator\Helper\ConditionsHelper::shouldDisplay('com_modules', $moduleId))
+			{
+				$filtered[] = $module;
+			}
+		}
+
+		$modules = $filtered;
+	}
 }