Stable release of v4.0.0-alpha1

First alpha release of Component Builder towards Joomla 4 (very unstable...).

admin/compiler/joomla_4/SITE_ROUTE_HELPER.php

@@ -0,0 +1,141 @@
+<?php
+/**
+ * @package    Joomla.Component.Builder
+ *
+ * @created    4th September 2022
+ * @author     Llewellyn van der Merwe <https://dev.vdm.io>
+ * @git        Joomla Component Builder <https://git.vdm.dev/joomla/Component-Builder>
+ * @copyright  Copyright (C) 2015 Vast Development Method. All rights reserved.
+ * @license    GNU General Public License version 2 or later; see LICENSE.txt
+ */
+
+// No direct access to this JCB template file (EVER)
+defined('_JCB_TEMPLATE') or die;
+?>
+###BOM###
+namespace ###NAMESPACEPREFIX###\Component\###ComponentNameSpace###\Site\Helper;
+
+use Joomla\CMS\Factory;
+use Joomla\CMS\Language\Text;
+use Joomla\CMS\Language\Multilanguage;
+use Joomla\CMS\Component\ComponentHelper;
+use Joomla\CMS\Categories\CategoryNode;
+use Joomla\CMS\Categories\Categories;
+
+// No direct access to this file
+\defined('_JEXEC') or die;
+
+/**
+ * ###Component### Component Route Helper
+ *
+ * @since       1.5
+ */
+abstract class RouteHelper
+{
+	protected static $lookup;###ROUTEHELPER###
+
+	protected static function _findItem($needles = null,$type = null)
+	{
+		$app      = Factory::getApplication();
+		$menus    = $app->getMenu('site');
+		$language = isset($needles['language']) ? $needles['language'] : '*';
+
+		// Prepare the reverse lookup array.
+		if (!isset(self::$lookup[$language]))
+		{
+			self::$lookup[$language] = [];
+
+			$component  = ComponentHelper::getComponent('com_###component###');
+
+			$attributes = array('component_id');
+			$values     = array($component->id);
+
+			if ($language != '*')
+			{
+				$attributes[] = 'language';
+				$values[]     = array($needles['language'], '*');
+			}
+
+			$items = $menus->getItems($attributes, $values);
+
+			foreach ($items as $item)
+			{
+				if (isset($item->query) && isset($item->query['view']))
+				{
+					$view = $item->query['view'];
+
+					if (!isset(self::$lookup[$language][$view]))
+					{
+						self::$lookup[$language][$view] = [];
+					}
+
+					if (isset($item->query['id']))
+					{
+						/**
+						 * Here it will become a bit tricky
+						 * language != * can override existing entries
+						 * language == * cannot override existing entries
+						 */
+						if (!isset(self::$lookup[$language][$view][$item->query['id']]) || $item->language != '*')
+						{
+							self::$lookup[$language][$view][$item->query['id']] = $item->id;
+						}
+					}
+					else
+					{
+						self::$lookup[$language][$view][0] = $item->id;
+					}
+				}
+			}
+		}
+
+		if ($needles)
+		{
+			foreach ($needles as $view => $ids)
+			{
+				if (isset(self::$lookup[$language][$view]))
+				{
+					if (Super___0a59c65c_9daf_4bc9_baf4_e063ff9e6a8a___Power::check($ids))
+					{
+						foreach ($ids as $id)
+						{
+							if (isset(self::$lookup[$language][$view][(int) $id]))
+							{
+								return self::$lookup[$language][$view][(int) $id];
+							}
+						}
+					}
+					elseif (isset(self::$lookup[$language][$view][0]))
+					{
+						return self::$lookup[$language][$view][0];
+					}
+				}
+			}
+		}
+
+		if ($type)
+		{
+			// Check if the global menu item has been set.
+			$params = ComponentHelper::getParams('com_###component###');
+			if ($item = $params->get($type.'_menu', 0))
+			{
+				return $item;
+			}
+		}
+
+		// Check if the active menuitem matches the requested language
+		$active = $menus->getActive();
+
+		if ($active
+			&& $active->component == 'com_###component###'
+			&& ($language == '*' || in_array($active->language, array('*', $language)) || !Multilanguage::isEnabled()))
+		{
+			return $active->id;
+		}
+
+		// If not found, return language specific home link
+		$default = $menus->getDefault($language);
+
+		return !empty($default->id) ? $default->id : null;
+	}
+}