[5.4] Add support for custom registration menu link in com_users login menu item (joomla#45715)

* Add custom registration link to login menu

---------

Co-authored-by: Brian Teeman <[email protected]>
Co-authored-by: Quy Ton <[email protected]>

Author: 3 people

administrator/language/en-GB/com_users.ini

@@ -127,9 +127,12 @@ COM_USERS_FIELD_LOGOUT_REDIRECTMENU_LABEL="Menu Item Logout Redirect"
 COM_USERS_FIELD_LOGOUT_REDIRECT_CHOICE_DESC="'Internal URL' lets you manually enter any internal URL in the Redirect field. 'Menu Item' lets you directly select an existing menu item.<br>For a multilingual site, it is recommended to use 'Menu Item'."
 COM_USERS_FIELD_LOGOUT_REDIRECT_CHOICE_LABEL="Choose Logout Redirect Type"
 COM_USERS_FIELD_LOGOUT_REDIRECT_ERROR="Only one of the logout redirect fields should have a value."
+COM_USERS_FIELD_REGISTRATION_DESC="Set a Menu Item to utilize a custom registration page."
+COM_USERS_FIELD_REGISTRATION_LABEL="Registration Page"
 COM_USERS_FIELD_NOTEBODY_LABEL="Note"
 COM_USERS_FIELD_OPTIONS_LOGIN="Login"
 COM_USERS_FIELD_OPTIONS_LOGOUT="Logout"
+COM_USERS_FIELD_OPTIONS_REGISTRATION="Registration"
 COM_USERS_FIELD_REVIEW_TIME_LABEL="Review Date"
 COM_USERS_FIELD_SUBJECT_LABEL="Subject"
 COM_USERS_FIELD_USER_ID_LABEL="User"

components/com_users/tmpl/login/default.xml

@@ -180,6 +180,22 @@
 					description="COM_USERS_FIELD_IMAGE_ALT_EMPTY_DESC"
 				/>
 			</fieldset>
+
+			<fieldset name="registration" label="COM_USERS_FIELD_OPTIONS_REGISTRATION">
+				<field
+					name="customRegLinkMenu"
+					type="modal_menu"
+					label="COM_USERS_FIELD_REGISTRATION_LABEL"
+					description="COM_USERS_FIELD_REGISTRATION_DESC"
+					disable="separator,alias,heading,url"
+					select="true"
+					new="true"
+					edit="true"
+					clear="true"
+					>
+					<option value="">JOPTION_SELECT_MENU_ITEM</option>
+				</field>
+			</fieldset>
 		</fieldset>
 	</fields>
-</metadata>
+</metadata>

components/com_users/tmpl/login/default_login.php

@@ -11,6 +11,7 @@
 defined('_JEXEC') or die;
 
 use Joomla\CMS\Component\ComponentHelper;
+use Joomla\CMS\Factory;
 use Joomla\CMS\HTML\HTMLHelper;
 use Joomla\CMS\Language\Text;
 use Joomla\CMS\Plugin\PluginHelper;
@@ -120,8 +121,21 @@ class="btn btn-secondary w-100 <?php echo $button['class'] ?? '' ?>"
         <a class="com-users-login__remind list-group-item" href="<?php echo Route::_('index.php?option=com_users&view=remind'); ?>">
             <?php echo Text::_('COM_USERS_LOGIN_REMIND'); ?>
         </a>
-        <?php if ($usersConfig->get('allowUserRegistration')) : ?>
-            <a class="com-users-login__register list-group-item" href="<?php echo Route::_('index.php?option=com_users&view=registration'); ?>">
+        <?php
+        if ($usersConfig->get('allowUserRegistration')) :
+            $regLinkMenuId = $this->params->get('customRegLinkMenu');
+            $regLink = 'index.php?option=com_users&view=registration';
+
+            if ($regLinkMenuId) {
+                $menu = Factory::getApplication()->getMenu();
+                $item = $menu->getItem($regLinkMenuId);
+
+                if ($item) {
+                    $regLink = 'index.php?Itemid=' . $regLinkMenuId;
+                }
+            }
+            ?>
+            <a class="com-users-login__register list-group-item" href="<?php echo Route::_($regLink); ?>">
                 <?php echo Text::_('COM_USERS_LOGIN_REGISTER'); ?>
             </a>
         <?php endif; ?>