Release of v3.2.4-alpha4

Fix database default fields to allow NULL. #1169. Fix the power list field to allow search. #1167. Remove Demo component from JCB v3 and added Hello Word component as demo in JCB v3.

admin/README.txt

@@ -9,7 +9,7 @@ The Component Builder for [Joomla](https://extensions.joomla.org/extension/compo
 
 Whether you're a seasoned [Joomla](https://extensions.joomla.org/extension/component-builder/) developer, or have just started, Component Builder will save you lots of time and money. A real must have!
 
-You can install it quite easily and with no limitations. On [gitea](https://git.vdm.dev/joomla/Component-Builder/tags) is the latest release (3.2.4-alpha3) with **ALL** its features and **ALL** concepts totally open-source and free! 
+You can install it quite easily and with no limitations. On [gitea](https://git.vdm.dev/joomla/Component-Builder/tags) is the latest release (3.2.4-alpha4) with **ALL** its features and **ALL** concepts totally open-source and free! 
 
 > Watch Quick Build of a Hello World component in [JCB on Youtube](https://www.youtube.com/watch?v=IQfsLYIeblk&list=PLQRGFI8XZ_wtGvPQZWBfDzzlERLQgpMRE&index=45)
 
@@ -144,14 +144,14 @@ TODO
 + *Author*: [Llewellyn van der Merwe](mailto:joomla@vdm.io)
 + *Name*: [Component Builder](https://git.vdm.dev/joomla/Component-Builder)
 + *First Build*: 30th April, 2015
-+ *Last Build*: 23rd August, 2024
-+ *Version*: 3.2.4-alpha3
++ *Last Build*: 18th September, 2024
++ *Version*: 3.2.4-alpha4
 + *Copyright*: Copyright (C) 2015 Vast Development Method. All rights reserved.
 + *License*: GNU General Public License version 2 or later; see LICENSE.txt
-+ *Line count*: **840006**
++ *Line count*: **848150**
 + *Field count*: **2098**
-+ *File count*: **5722**
-+ *Folder count*: **500**
++ *File count*: **5778**
++ *Folder count*: **505**
 
 > This **component** was build with a [Joomla](https://extensions.joomla.org/extension/component-builder/) [Automated Component Builder](https://www.joomlacomponentbuilder.com).
 > Developed by [Llewellyn van der Merwe](mailto:joomla@vdm.io)

admin/compiler/joomla_4/ADMIN_VIEW_CONTROLLER.php

@@ -52,7 +52,23 @@ class ###View###Controller extends FormController
 	 * @var    string
 	 * @since  1.6
 	 */
-	protected $view_list = '###views###';###ADMIN_CUSTOM_BUTTONS_CONTROLLER###
+	protected $view_list = '###views###';
+
+	/**
+	 * Referral value
+	 *
+	 * @var    string
+	 * @since  5.0
+	 */
+	protected string $ref;
+
+	/**
+	 * Referral ID value
+	 *
+	 * @var    int
+	 * @since  5.0
+	 */
+	protected int $refid;###ADMIN_CUSTOM_BUTTONS_CONTROLLER###
 
 	/**
 	 * Method override to check if you can add a new record.

admin/controllers/fieldtype.php

@@ -94,18 +94,23 @@ class ComponentbuilderControllerFieldtype extends FormController
 		}
 		elseif($user->authorise('fieldtype.reset', 'com_componentbuilder'))
 		{
-			if (FieldtypeFactory::_('Joomla.Fieldtype.Remote.Get')->reset([$guid]))
-			{
-				// set success message
-				$message = '<h1>'.Text::_('COM_COMPONENTBUILDER_SUCCESS').'</h1>';
-				$message .= '<p>'.Text::_('COM_COMPONENTBUILDER_THE_JOOMLA_FIELD_TYPE_HAS_SUCCESSFULLY_BEEN_RESET').'</p>';
-				$status = 'success';
-				$success = true;
-			}
-			else
-			{
+			try {
+				if (FieldtypeFactory::_('Joomla.Fieldtype.Remote.Get')->reset([$guid]))
+				{
+					// set success message
+					$message = '<h1>'.Text::_('COM_COMPONENTBUILDER_SUCCESS').'</h1>';
+					$message .= '<p>'.Text::_('COM_COMPONENTBUILDER_THE_JOOMLA_FIELD_TYPE_HAS_SUCCESSFULLY_BEEN_RESET').'</p>';
+					$status = 'success';
+					$success = true;
+				}
+				else
+				{
+					$message = '<h1>' . Text::_('COM_COMPONENTBUILDER_RESET_FAILED') . '</h1>';
+					$message .= '<p>' . Text::_('COM_COMPONENTBUILDER_THE_RESET_OF_THIS_JOOMLA_FIELD_TYPE_HAS_FAILED') . '</p>';
+				}
+			} catch (\Exception $e) {
 				$message = '<h1>' . Text::_('COM_COMPONENTBUILDER_RESET_FAILED') . '</h1>';
-				$message .= '<p>' . Text::_('COM_COMPONENTBUILDER_THE_RESET_OF_THIS_JOOMLA_FIELD_TYPE_HAS_FAILED') . '</p>';
+				$message .= '<p>' . \htmlspecialchars($e->getMessage()) . '</p>';
 			}
 		}
 

admin/controllers/joomla_power.php

@@ -94,18 +94,23 @@ class ComponentbuilderControllerJoomla_power extends FormController
 		}
 		elseif($user->authorise('joomla_power.reset', 'com_componentbuilder'))
 		{
-			if (JoomlaPowerFactory::_('Joomla.Power.Remote.Get')->reset([$guid]))
-			{
-				// set success message
-				$message = '<h1>'.Text::_('COM_COMPONENTBUILDER_SUCCESS').'</h1>';
-				$message .= '<p>'.Text::_('COM_COMPONENTBUILDER_THE_JOOMLA_POWER_HAS_SUCCESSFULLY_BEEN_RESET').'</p>';
-				$status = 'success';
-				$success = true;
-			}
-			else
-			{
+			try {
+				if (JoomlaPowerFactory::_('Joomla.Power.Remote.Get')->reset([$guid]))
+				{
+					// set success message
+					$message = '<h1>'.Text::_('COM_COMPONENTBUILDER_SUCCESS').'</h1>';
+					$message .= '<p>'.Text::_('COM_COMPONENTBUILDER_THE_JOOMLA_POWER_HAS_SUCCESSFULLY_BEEN_RESET').'</p>';
+					$status = 'success';
+					$success = true;
+				}
+				else
+				{
+					$message = '<h1>' . Text::_('COM_COMPONENTBUILDER_RESET_FAILED') . '</h1>';
+					$message .= '<p>' . Text::_('COM_COMPONENTBUILDER_THE_RESET_OF_THIS_JOOMLA_POWER_HAS_FAILED') . '</p>';
+				}
+			} catch (\Exception $e) {
 				$message = '<h1>' . Text::_('COM_COMPONENTBUILDER_RESET_FAILED') . '</h1>';
-				$message .= '<p>' . Text::_('COM_COMPONENTBUILDER_THE_RESET_OF_THIS_JOOMLA_POWER_HAS_FAILED') . '</p>';
+				$message .= '<p>' . \htmlspecialchars($e->getMessage()) . '</p>';
 			}
 		}
 

admin/controllers/power.php

@@ -94,18 +94,23 @@ class ComponentbuilderControllerPower extends FormController
 		}
 		elseif($user->authorise('power.reset', 'com_componentbuilder'))
 		{
-			if (PowerFactory::_('Power.Remote.Get')->reset([$guid]))
-			{
-				// set success message
-				$message = '<h1>'.Text::_('COM_COMPONENTBUILDER_SUCCESS').'</h1>';
-				$message .= '<p>'.Text::_('COM_COMPONENTBUILDER_THE_POWER_HAS_SUCCESSFULLY_BEEN_RESET').'</p>';
-				$status = 'success';
-				$success = true;
-			}
-			else
-			{
+			try {
+				if (PowerFactory::_('Power.Remote.Get')->reset([$guid]))
+				{
+					// set success message
+					$message = '<h1>'.Text::_('COM_COMPONENTBUILDER_SUCCESS').'</h1>';
+					$message .= '<p>'.Text::_('COM_COMPONENTBUILDER_THE_POWER_HAS_SUCCESSFULLY_BEEN_RESET').'</p>';
+					$status = 'success';
+					$success = true;
+				}
+				else
+				{
+					$message = '<h1>' . Text::_('COM_COMPONENTBUILDER_RESET_FAILED') . '</h1>';
+					$message .= '<p>' . Text::_('COM_COMPONENTBUILDER_THE_RESET_OF_THIS_POWER_HAS_FAILED') . '</p>';
+				}
+			} catch (\Exception $e) {
 				$message = '<h1>' . Text::_('COM_COMPONENTBUILDER_RESET_FAILED') . '</h1>';
-				$message .= '<p>' . Text::_('COM_COMPONENTBUILDER_THE_RESET_OF_THIS_POWER_HAS_FAILED') . '</p>';
+				$message .= '<p>' . \htmlspecialchars($e->getMessage()) . '</p>';
 			}
 		}
 

admin/custom/dynamicDownloadController.php

@@ -0,0 +1,16 @@
+<?php
+/**
+ *
+ *  @version		2.0.0 - September 03, 2014
+ *  @package		Component Builder
+ *  @author		    Llewellyn van de Merwe <http://www.vdm.io>
+ *  @copyright	    Copyright (C) 2014. All Rights Reserved
+ *  @license		GNU/GPL Version 2 or later - http://www.gnu.org/licenses/gpl-2.0.html
+ *
+ **/
+
+// No direct access to this file
+defined('_JEXEC') or die('Restricted access');
+?>
+###BOM###
+[CUSTOMCODE=dynamicDownloadController]

admin/helpers/componentbuilder.php

@@ -5416,7 +5416,6 @@ abstract class ComponentbuilderHelper
 		$d = DateTime::createFromFormat($format, $date);
 		return $d && $d->format($format) == $date;
 	}
-
 
 	/**
 	* The subform layouts

admin/language/en-GB/en-GB.com_componentbuilder.ini

@@ -1360,6 +1360,7 @@ COM_COMPONENTBUILDER_BULK_UPDATE_ALL_DIVERGED_SNIPPETS="Bulk Update All Diverged
 COM_COMPONENTBUILDER_BULK_UPDATE_ALL_OUT_DATED_SNIPPETS="Bulk Update All Out Dated Snippets"
 COM_COMPONENTBUILDER_BUTTON_TO_CREATE_S_WILL_SHOW_ONCE_S_IS_SAVED_FOR_THE_FIRST_TIME="Button to create %s will show once %s is saved for the first time."
 COM_COMPONENTBUILDER_CANCEL="Cancel"
+COM_COMPONENTBUILDER_CAN_NOT_SAVE_USER_WITHOUT_EMAIL_VALUE="Can not save user without email value."
 COM_COMPONENTBUILDER_CHAIN="Chain"
 COM_COMPONENTBUILDER_CHECK_YOUR_OWNER_DETAILS_IT_HAS_NOT_BEEN_SET_OPEN_THE_JCB_GLOBAL_OPTIONS_GO_TO_THE_COMPANY_TAB_AND_ADD_THE_CORRECT_COMPANY_DETAILS_THERE="Check your owner details, it has not been set. Open the JCB Global Options, go to the Company tab and add the correct company details there."
 COM_COMPONENTBUILDER_CLASS_EXTENDINGS="Class Extendings"
@@ -5866,7 +5867,7 @@ COM_COMPONENTBUILDER_JOOMLA_COMPONENT_PUBLISHING="Publishing"
 COM_COMPONENTBUILDER_JOOMLA_COMPONENT_README="Readme"
 COM_COMPONENTBUILDER_JOOMLA_COMPONENT_README_LABEL="README.md"
 COM_COMPONENTBUILDER_JOOMLA_COMPONENT_REMOVE_LINE_BREAKS_DESCRIPTION="Should we remove all line breaks ("\r", "\n") from all language strings in this component."
-COM_COMPONENTBUILDER_JOOMLA_COMPONENT_REMOVE_LINE_BREAKS_LABEL="Remove line breaks<br /><small>from language strings</small>"
+COM_COMPONENTBUILDER_JOOMLA_COMPONENT_REMOVE_LINE_BREAKS_LABEL="Remove line breaks<br /><small>from language strings<br>This switch will be removed since it must always be true for J4+.</small>"
 COM_COMPONENTBUILDER_JOOMLA_COMPONENT_SALES_SERVER_DESCRIPTION="Select your sales server for this component"
 COM_COMPONENTBUILDER_JOOMLA_COMPONENT_SALES_SERVER_LABEL="Sales Server"
 COM_COMPONENTBUILDER_JOOMLA_COMPONENT_SAVE_WARNING="Alias already existed so a number was added at the end. You can re-edit the Joomla Component to customise the alias."
@@ -7487,7 +7488,7 @@ COM_COMPONENTBUILDER_LIBRARY_NOTE_NO_BEHAVIOUR_THREE_DESCRIPTION="There is no be
 COM_COMPONENTBUILDER_LIBRARY_NOTE_NO_BEHAVIOUR_THREE_LABEL="No Behaviour"
 COM_COMPONENTBUILDER_LIBRARY_NOTE_NO_BEHAVIOUR_TWO_DESCRIPTION="There is no behaviour set for this library. This means JCB will not add any files unless you custom code it in somewhere."
 COM_COMPONENTBUILDER_LIBRARY_NOTE_NO_BEHAVIOUR_TWO_LABEL="No Behaviour"
-COM_COMPONENTBUILDER_LIBRARY_NOTE_YES_BEHAVIOUR_LIBRARY_DESCRIPTION="We are working on this feature it is not yet ready, but soon enough you will be able to build real Joomla library integration here."
+COM_COMPONENTBUILDER_LIBRARY_NOTE_YES_BEHAVIOUR_LIBRARY_DESCRIPTION="To effectively integrate a PHP library into your component, leverage the [Powers] Area within JCB. This feature empowers you to seamlessly incorporate Composer packages as well as standard PHP class structures into your component, ensuring a robust and maintainable solution."
 COM_COMPONENTBUILDER_LIBRARY_NOTE_YES_BEHAVIOUR_LIBRARY_LABEL="Set Behaviour"
 COM_COMPONENTBUILDER_LIBRARY_NOTE_YES_BEHAVIOUR_ONE_DESCRIPTION="All the library files linked to this library will always be added to a view if linked to the view."
 COM_COMPONENTBUILDER_LIBRARY_NOTE_YES_BEHAVIOUR_ONE_LABEL="Set Behaviour"
@@ -7999,7 +8000,7 @@ COM_COMPONENTBUILDER_REPOSITORY_GUID_DESCRIPTION="Globally Unique Identifier"
 COM_COMPONENTBUILDER_REPOSITORY_GUID_HINT="Auto Generated"
 COM_COMPONENTBUILDER_REPOSITORY_GUID_LABEL="GUID"
 COM_COMPONENTBUILDER_REPOSITORY_ID="Id"
-COM_COMPONENTBUILDER_REPOSITORY_JOOMLA_FIELD_TYPE="Joomla Field Type"
+COM_COMPONENTBUILDER_REPOSITORY_JOOMLA_FIELD_TYPES="Joomla Field Types"
 COM_COMPONENTBUILDER_REPOSITORY_JOOMLA_POWER="Joomla Power"
 COM_COMPONENTBUILDER_REPOSITORY_MODIFIED_BY_DESC="The last user that modified this Repository."
 COM_COMPONENTBUILDER_REPOSITORY_MODIFIED_BY_LABEL="Modified By"
@@ -9246,9 +9247,12 @@ COM_COMPONENTBUILDER_UPDATE_ALL="Update All"
 COM_COMPONENTBUILDER_UPDATE_ALL_DIVERGED_SNIPPETS="Update All Diverged Snippets"
 COM_COMPONENTBUILDER_UPDATE_ALL_ITEMS_FOUND_WITH_THIS_DATABASE_SEARCH_WITH_THE_REPLACE_VALUE="Update all items found with this database search, with the replace value."
 COM_COMPONENTBUILDER_UPDATE_ALL_OUT_DATED_SNIPPETS="Update All Out Dated Snippets"
+COM_COMPONENTBUILDER_UPDATE_OF_USER_S_S_FAILEDS="Update of user %s (%s) failed!%s"
 COM_COMPONENTBUILDER_UP_TO_DATE="Up to date"
 COM_COMPONENTBUILDER_USAGE="Usage"
 COM_COMPONENTBUILDER_USED_IN="Used in"
+COM_COMPONENTBUILDER_USER_CREATION_FAILED="User creation failed!"
+COM_COMPONENTBUILDER_USER_S_S_CREATION_FAILEDS="User %s (%s) creation failed!%s"
 COM_COMPONENTBUILDER_USE_BATCH="Use Batch"
 COM_COMPONENTBUILDER_USE_BATCH_DESC="Allows users in this group to use batch copy/update method."
 COM_COMPONENTBUILDER_USE_KEY="Use Key"

admin/layouts/table.php

@@ -18,12 +18,28 @@ use Joomla\CMS\HTML\HTMLHelper as Html;
 use Joomla\CMS\Layout\LayoutHelper;
 use VDM\Joomla\Utilities\StringHelper;
 
-$table_id = (isset($displayData['id'])) ? $displayData['id'] : StringHelper::random(7);
-$name = (isset($displayData['name'])) ? $displayData['name'] : false;
-$table_class = (isset($displayData['table_class'])) ? $displayData['table_class'] : 'uk-table';
-$table_container_class = (isset($displayData['table_container_class'])) ? $displayData['table_container_class'] : 'uk-overflow-auto';
-$headers = (isset($displayData['headers'])) ? $displayData['headers'] : [Text::_('COM_COMPONENTBUILDER_NO'), Text::_('COM_COMPONENTBUILDER_HEADERS'), Text::_('COM_COMPONENTBUILDER_FOUND')];
-$items = (isset($displayData['items'])) ? $displayData['items'] : 6;
+// Extract all keys from $displayData as individual variables.
+extract($displayData);
+
+// Assign default values for variables that might not be present in $displayData.
+
+// The 'table_id' parameter, defaulting to a randomly generated value if not set or is null.
+$table_id = $id ?? StringHelper::random(7);
+
+// The 'name' parameter, defaulting to false if not set or is null.
+$name ??= false;
+
+// The 'table_class' parameter, defaulting to 'uk-table' if not set or is null.
+$table_class ??= 'uk-table';
+
+// The 'table_container_class' parameter, defaulting to 'uk-overflow-auto' if not set or is null.
+$table_container_class ??= 'uk-overflow-auto';
+
+// The 'headers' parameter, defaulting to an array of default header values if not set or is null.
+$headers ??= [Text::_('COM_COMPONENTBUILDER_NO'), Text::_('COM_COMPONENTBUILDER_HEADERS'), Text::_('COM_COMPONENTBUILDER_FOUND')];
+
+// The 'items' parameter, defaulting to 6 if not set or is null.
+$items ??= 6;
 
 ?>
 <div class="<?php echo $$table_container_class; ?>">

admin/models/fields/namespaces.php

@@ -40,9 +40,9 @@ class JFormFieldNamespaces extends JFormFieldList
 	protected function getOptions()
 	{
 		// Get the user object.
-		$user = JFactory::getUser();
+		$user = Factory::getUser();
 		// Get the databse object.
-		$db = JFactory::getDBO();
+		$db = Factory::getDBO();
 		$query = $db->getQuery(true);
 		$query->select($db->quoteName(array('a.guid','a.name','a.namespace','a.type','a.power_version'),array('guid','use_name','namespace','type','version')));
 		$query->from($db->quoteName('#__componentbuilder_power', 'a'));
@@ -60,7 +60,7 @@ class JFormFieldNamespaces extends JFormFieldList
 			}
 		}
 		// get the input
-		$jinput = JFactory::getApplication()->input;
+		$jinput = Factory::getApplication()->input;
 		// get the id
 		$power_id = $jinput->getInt('id', 0);
 		// if we have an id we remove all classes of the same namespace and name
@@ -74,17 +74,17 @@ class JFormFieldNamespaces extends JFormFieldList
 		// if none was found, we add this to set an alternative to set custom
 		if (!$items)
 		{
-			$options[] = JHtml::_('select.option', '', JText::_('COM_COMPONENTBUILDER_NONE_FOUND'));
+			$options[] = Html::_('select.option', '', Text::_('COM_COMPONENTBUILDER_NONE_FOUND'));
 		}
 		if ($items)
 		{
 			if ($this->multiple === false)
 			{
-				$options[] = JHtml::_('select.option', '', JText::_('COM_COMPONENTBUILDER_SELECT_AN_OPTION'));
+				$options[] = Html::_('select.option', '', Text::_('COM_COMPONENTBUILDER_SELECT_AN_OPTION'));
 			}
 			foreach($items as $item)
 			{
-				$options[] = JHtml::_('select.option', $item->guid, str_replace('.','\\', $item->namespace) . ' [' . $item->use_name . '] (v' . $item->version . ' - ' . $item->type . ')');
+				$options[] = Html::_('select.option', $item->guid, str_replace('.','\\', $item->namespace) . ' [' . $item->use_name . '] (v' . $item->version . ' - ' . $item->type . ')');
 			}
 		}
 		return $options;

admin/models/forms/custom_code.xml

@@ -141,6 +141,7 @@
 			label="COM_COMPONENTBUILDER_CUSTOM_CODE_TYPE_LABEL"
 			description="COM_COMPONENTBUILDER_CUSTOM_CODE_TYPE_DESCRIPTION"
 			class="btn-group btn-group-yesno"
+			default="0"
 			required="true">
 			<!-- Option Set. -->
 			<option value="1">

admin/models/forms/joomla_component.xml

@@ -284,7 +284,7 @@
 			label="COM_COMPONENTBUILDER_JOOMLA_COMPONENT_REMOVE_LINE_BREAKS_LABEL"
 			description="COM_COMPONENTBUILDER_JOOMLA_COMPONENT_REMOVE_LINE_BREAKS_DESCRIPTION"
 			class="btn-group btn-group-yesno"
-			default="0"
+			default="1"
 			required="true">
 			<!-- Option Set. -->
 			<option value="1">

admin/models/forms/power.xml

@@ -235,10 +235,10 @@
 					label="COM_COMPONENTBUILDER_POWER_NAMESPACE_LABEL"
 					layout="joomla.form.field.subform.repeatable-table"
 					multiple="true"
-					buttons="add,remove,move"
+					buttons="add,remove"
 					icon="list"
 					max="30"
-					min="1"
+					min="0"
 					nested_depth="1">
 					<form hidden="true" name="list_namespace_modal" repeat="true">
 						<!-- Use Field. Type: Text. (joomla) -->
@@ -493,7 +493,8 @@
 					type="namespaces"
 					name="use"
 					label="COM_COMPONENTBUILDER_POWER_USE_LABEL"
-					class="list_class span12"
+					class="span12"
+					layout="joomla.form.field.list-fancy-select"
 					multiple="false"
 					default="0"
 					button="false"

admin/models/forms/repository.xml

@@ -156,7 +156,7 @@
 			<option value="2">
 				COM_COMPONENTBUILDER_REPOSITORY_JOOMLA_POWER</option>
 			<option value="3">
-				COM_COMPONENTBUILDER_REPOSITORY_JOOMLA_FIELD_TYPE</option>
+				COM_COMPONENTBUILDER_REPOSITORY_JOOMLA_FIELD_TYPES</option>
 		</field>
 		<!-- Type Field. Type: List. (joomla) -->
 		<field
@@ -261,9 +261,9 @@
 			label="COM_COMPONENTBUILDER_REPOSITORY_ACCESS_REPO_LABEL"
 			description="COM_COMPONENTBUILDER_REPOSITORY_ACCESS_REPO_DESCRIPTION"
 			class="btn-group btn-group-yesno"
-			default="">
+			default="0">
 			<!-- Option Set. -->
-			<option value="">
+			<option value="0">
 				COM_COMPONENTBUILDER_REPOSITORY_GLOBAL</option>
 			<option value="1">
 				COM_COMPONENTBUILDER_REPOSITORY_OVERRIDE</option>

admin/models/repositories.php

@@ -200,7 +200,7 @@ class ComponentbuilderModelRepositories extends ListModel
 				0 => 'COM_COMPONENTBUILDER_REPOSITORY_SELECT_AN_OPTION',
 				1 => 'COM_COMPONENTBUILDER_REPOSITORY_SUPER_POWER',
 				2 => 'COM_COMPONENTBUILDER_REPOSITORY_JOOMLA_POWER',
-				3 => 'COM_COMPONENTBUILDER_REPOSITORY_JOOMLA_FIELD_TYPE'
+				3 => 'COM_COMPONENTBUILDER_REPOSITORY_JOOMLA_FIELD_TYPES'
 			);
 			// Now check if value is found in this array
 			if (isset($targetArray[$value]) && StringHelper::check($targetArray[$value]))