Update on v2.0.2 (changes towards the next release)

Here's an update on the current version, which includes changes towards the next release still in development.

componentbuildercustomadminheaderstabs.php

@@ -8,27 +8,28 @@
  * @copyright  Copyright (C) 2015 Vast Development Method. All rights reserved.
  * @license    GNU General Public License version 2 or later; see LICENSE.txt
  */
-namespace VDM\Plugin\Content\ComponentbuilderCustomAdminHeadersTabs\Extension;
-
-use Joomla\CMS\Form\Form;
-use Joomla\CMS\Plugin\CMSPlugin;
-use Joomla\CMS\Component\ComponentHelper;
-use VDM\Joomla\Utilities\ArrayHelper;
 
 // No direct access to this file
 defined('_JEXEC') or die('Restricted access');
 
+JLoader::register('ComponentbuilderHelper', JPATH_ADMINISTRATOR . '/components/com_componentbuilder/helpers/componentbuilder.php'); 
+
+use Joomla\CMS\Form\Form;
+use Joomla\CMS\Plugin\CMSPlugin;
+use VDM\Joomla\Utilities\ArrayHelper;
+use Joomla\CMS\Component\ComponentHelper;
+
 /**
  * Content - Componentbuilder Custom Admin Headers Tabs plugin.
  *
  * @package   ComponentbuilderCustomAdminHeadersTabs
- * @since     4.0.0
+ * @since     2.0.2
  */
-final class ComponentbuilderCustomAdminHeadersTabs extends CMSPlugin
+class PlgContentComponentbuilderCustomAdminHeadersTabs extends CMSPlugin
 {
 
 	/**
-	 * Affects constructor behaviour. If true, language files will be loaded automatically.
+	 * Affects constructor behavior. If true, language files will be loaded automatically.
 	 *
 	 * @var    boolean
 	 * @since  1.0
@@ -38,8 +39,8 @@ final class ComponentbuilderCustomAdminHeadersTabs extends CMSPlugin
 	/**
 	 * Runs on content preparation of form.
 	 *
-	 * @param   Form     $form  The form
+	 * @param   JForm     $form  The form
-	 * @param   \stdClass  $data  The data
+	 * @param   stdClass  $data  The data
 	 *
 	 * @return  boolean
 	 *
@@ -53,7 +54,7 @@ final class ComponentbuilderCustomAdminHeadersTabs extends CMSPlugin
 		if (strpos($context, 'com_componentbuilder.custom_admin_view') === 0)
 		{
 			// Add the forms path
-			Form::addFormPath(__DIR__ . '/../../forms');
+			Form::addFormPath(__DIR__ . '/forms');
 			// add the admin view params for privacy integration
 			$form->loadFile('custom_admin_view');
 			// update all editors to use this components global editor

componentbuildercustomadminheaderstabs.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<extension type="plugin" version="5.0" group="content" method="upgrade">
+<extension type="plugin" version="3.10" group="content" method="upgrade">
 	<name>PLG_CONTENT_COMPONENTBUILDERCUSTOMADMINHEADERSTABS</name>
 	<creationDate>7th November, 2024</creationDate>
 	<author>Llewellyn van der Merwe</author>
@@ -7,8 +7,7 @@
 	<authorUrl>https://dev.vdm.io</authorUrl>
 	<copyright>Copyright (C) 2015 Vast Development Method. All rights reserved.</copyright>
 	<license>GNU General Public License version 2 or later; see LICENSE.txt</license>
-	<version>4.0.0</version>
+	<version>2.0.2</version>
-	<namespace path="src">VDM\Plugin\Content\ComponentbuilderCustomAdminHeadersTabs</namespace>
 	<description>PLG_CONTENT_COMPONENTBUILDERCUSTOMADMINHEADERSTABS_XML_DESCRIPTION</description>
 
 	<!-- Scripts to run on installation -->
@@ -16,16 +15,15 @@
 
 	<!-- Language files -->
 	<languages folder="language">
-		<language tag="en-GB">en-GB/plg_content_componentbuildercustomadminheaderstabs.ini</language>
+		<language tag="en-GB">en-GB/en-GB.plg_content_componentbuildercustomadminheaderstabs.ini</language>
-		<language tag="en-GB">en-GB/plg_content_componentbuildercustomadminheaderstabs.sys.ini</language>
+		<language tag="en-GB">en-GB/en-GB.plg_content_componentbuildercustomadminheaderstabs.sys.ini</language>
 	</languages>
 
 	<!-- Plugin files -->
 	<files>
-		<folder plugin="componentbuildercustomadminheaderstabs">services</folder>
+		<filename plugin="componentbuildercustomadminheaderstabs">componentbuildercustomadminheaderstabs.php</filename>
 		<filename>index.html</filename>
+		<folder>language</folder>
 		<folder>forms</folder>
-		<folder>services</folder>
-		<folder>src</folder>
 	</files>
 </extension>

forms/custom_admin_view.xml

@@ -1,8 +1,8 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- default paths of custom_admin_view form points to componentbuilder -->
 <form
-	addruleprefix="VDM\Component\Componentbuilder\Administrator\Rule"
+	addrulepath="/administrator/components/com_componentbuilder/models/rules"
-	addfieldprefix="VDM\Component\Componentbuilder\Administrator\Field"
+	addfieldpath="/administrator/components/com_componentbuilder/models/fields"
 >
 	<fields name="params">
 	<fieldset name="custom_admin_view_headers" label="PLG_CONTENT_COMPONENTBUILDERCUSTOMADMINHEADERSTABS_CLASS_HEADERS">

language/en-GB/en-GB.plg_content_componentbuildercustomadminheaderstabs.ini

@@ -1,6 +1,6 @@
 PLG_CONTENT_COMPONENTBUILDERCUSTOMADMINHEADERSTABS="Content - Componentbuilder Custom Admin Headers Tabs"
 PLG_CONTENT_COMPONENTBUILDERCUSTOMADMINHEADERSTABS_DESCRIPTION="This plugin is used to set custom admin class custom headers."
-PLG_CONTENT_COMPONENTBUILDERCUSTOMADMINHEADERSTABS_XML_DESCRIPTION="<h1>Content - Componentbuilder Custom Admin Headers Tabs (v.4.0.0)</h1> <div style='clear: both;'></div><p>This plugin is used to set custom admin class custom headers.</p><p>Created by <a href='https://dev.vdm.io' target='_blank'>Llewellyn van der Merwe</a><br /><small>Development started 10th March, 2024</small></p>"
+PLG_CONTENT_COMPONENTBUILDERCUSTOMADMINHEADERSTABS_XML_DESCRIPTION="<h1>Content - Componentbuilder Custom Admin Headers Tabs (v.2.0.2)</h1> <div style='clear: both;'></div><p>This plugin is used to set custom admin class custom headers.</p><p>Created by <a href='https://dev.vdm.io' target='_blank'>Llewellyn van der Merwe</a><br /><small>Development started 8th December, 2020</small></p>"
 PLG_CONTENT_COMPONENTBUILDERCUSTOMADMINHEADERSTABS_CLASS_HEADERS="Class Headers"
 PLG_CONTENT_COMPONENTBUILDERCUSTOMADMINHEADERSTABS_ADD_CUSTOM_ADMIN_VIEW_MODEL_LABEL="Target Custom Admin View<br />Model Header"
 PLG_CONTENT_COMPONENTBUILDERCUSTOMADMINHEADERSTABS_ADD_CUSTOM_ADMIN_VIEW_MODEL_DESCRIPTION="Only use this option if you have a <b>getItem</b> as your <b>Main Get</b>."

language/en-GB/en-GB.plg_content_componentbuildercustomadminheaderstabs.sys.ini

@@ -1,6 +1,6 @@
 PLG_CONTENT_COMPONENTBUILDERCUSTOMADMINHEADERSTABS="Content - Componentbuilder Custom Admin Headers Tabs"
 PLG_CONTENT_COMPONENTBUILDERCUSTOMADMINHEADERSTABS_DESCRIPTION="This plugin is used to set custom admin class custom headers."
-PLG_CONTENT_COMPONENTBUILDERCUSTOMADMINHEADERSTABS_XML_DESCRIPTION="<h1>Content - Componentbuilder Custom Admin Headers Tabs (v.4.0.0)</h1> <div style='clear: both;'></div><p>This plugin is used to set custom admin class custom headers.</p><p>Created by <a href='https://dev.vdm.io' target='_blank'>Llewellyn van der Merwe</a><br /><small>Development started 10th March, 2024</small></p>"
+PLG_CONTENT_COMPONENTBUILDERCUSTOMADMINHEADERSTABS_XML_DESCRIPTION="<h1>Content - Componentbuilder Custom Admin Headers Tabs (v.2.0.2)</h1> <div style='clear: both;'></div><p>This plugin is used to set custom admin class custom headers.</p><p>Created by <a href='https://dev.vdm.io' target='_blank'>Llewellyn van der Merwe</a><br /><small>Development started 8th December, 2020</small></p>"
 PLG_CONTENT_COMPONENTBUILDERCUSTOMADMINHEADERSTABS_CLASS_HEADERS="Class Headers"
 PLG_CONTENT_COMPONENTBUILDERCUSTOMADMINHEADERSTABS_ADD_CUSTOM_ADMIN_VIEW_MODEL_LABEL="Target Custom Admin View<br />Model Header"
 PLG_CONTENT_COMPONENTBUILDERCUSTOMADMINHEADERSTABS_ADD_CUSTOM_ADMIN_VIEW_MODEL_DESCRIPTION="Only use this option if you have a <b>getItem</b> as your <b>Main Get</b>."

script.php

@@ -13,129 +13,83 @@
 defined('_JEXEC') or die('Restricted access');
 
 use Joomla\CMS\Factory;
-use Joomla\CMS\Version;
-use Joomla\CMS\Installer\InstallerAdapter;
 use Joomla\CMS\Language\Text;
-use Joomla\Filesystem\File;
+use Joomla\CMS\Filesystem\File;
-use Joomla\Filesystem\Folder;
+use Joomla\CMS\Filesystem\Folder;
 
 /**
  * Content - Componentbuilder Custom Admin Headers Tabs script file.
  *
- * @package ComponentbuilderCustomAdminHeadersTabs
+ * @package PlgContentComponentbuilderCustomAdminHeadersTabs
  */
 class plgContentComponentbuilderCustomAdminHeadersTabsInstallerScript
 {
-	/**
-	 * The CMS Application.
-	 *
-	 * @since  4.4.2
-	 */
-	protected $app;
-
-	/**
-	 * A list of files to be deleted
-	 *
-	 * @var    array
-	 * @since  3.6
-	 */
-	protected array $deleteFiles = [];
-
-	/**
-	 * A list of folders to be deleted
-	 *
-	 * @var    array
-	 * @since  3.6
-	 */
-	protected array $deleteFolders = [];
-
-	/**
-	 * Constructor
-	 *
-	 * @param   InstallerAdapter  $adapter  The object responsible for running this script
-	 */
-	public function __construct($adapter)
-	{
-		// get application
-		$this->app = Factory::getApplication();
-
-		if (is_file(JPATH_ROOT . '/plugins/content/componentbuildercustomadminheaderstabs/componentbuildercustomadminheaderstabs.php'))
-		{
-			$this->deleteFiles[] = '/plugins/content/componentbuildercustomadminheaderstabs/componentbuildercustomadminheaderstabs.php';
-		}
-	}
 
 	/**
 	 * Called before any type of action
 	 *
 	 * @param   string  $route  Which action is happening (install|uninstall|discover_install|update)
-	 * @param   InstallerAdapter  $adapter  The object responsible for running this script
+	 * @param   Joomla\CMS\Installer\InstallerAdapter  $adapter  The object responsible for running this script
 	 *
 	 * @return  boolean  True on success
 	 */
 	public function preflight($route, $adapter)
 	{
-		// set application to local method var, just use $this->app in future [we will drop $app in J6]
+		// get application
-		$app = $this->app;
+		$app = Factory::getApplication();
 
 		// the default for both install and update
-		$jversion = new Version();
+		$jversion = new JVersion();
-		if (!$jversion->isCompatible('5.0.0'))
+		if (!$jversion->isCompatible('3.8.0'))
 		{
-			$app->enqueueMessage('Please upgrade to at least Joomla! 5.0.0 before continuing!', 'error');
+			$app->enqueueMessage('Please upgrade to at least Joomla! 3.8.0 before continuing!', 'error');
 			return false;
 		}
 
-		// remove old files and folders
+		if ('install' === $route)
-		$this->removeFiles();
+		{
+
+			// check that componentbuilder is installed
+			$pathToCore = JPATH_ADMINISTRATOR . '/components/com_componentbuilder/helpers/componentbuilder.php';
+			if (!is_file($pathToCore))
+			{
+				$app->enqueueMessage('Joomla Component Builder must first be installed from <a href="https://www.joomlacomponentbuilder.com/ " target="_blank">Joomla Component Builder</a>.', 'error');
+				return false;
+			}
+
+			// load the helper class
+			JLoader::register('ComponentbuilderHelper', JPATH_ADMINISTRATOR . '/components/com_componentbuilder/helpers/componentbuilder.php');
+
+			// block install
+			$blockInstall = true;
+
+			// check the version of JCB
+			$manifest = ComponentbuilderHelper::manifest();
+			if (isset($manifest->version) && strpos($manifest->version, '.') !== false)
+			{
+				// get the version
+				$jcbVersion = explode('.', $manifest->version);
+				// check that we have JCB 3.0.14 or higher installed
+				if (count($jcbVersion) == 3 && $jcbVersion[0] >= 3 &&
+					(
+						($jcbVersion[0] == 3 && $jcbVersion[1] == 0 && $jcbVersion[2] >= 14) ||
+						($jcbVersion[0] == 3 && $jcbVersion[1] > 0) ||
+						$jcbVersion[0] > 3)
+					)
+				{
+					$blockInstall = false;
+				}
+			}
+
+			// allow install if all conditions are met
+			if ($blockInstall)
+			{
+				$app->enqueueMessage('Please upgrade to JCB v3.0.14 or higher before installing this plugin.', 'error');
+				return false;
+			}
+
+		}
 
 		return true;
 	}
-
-	/**
-	 * Called before any type of action
-	 *
-	 * @param   string  $route  Which action is happening (install|uninstall|discover_install|update)
-	 * @param   InstallerAdapter  $adapter  The object responsible for running this script
-	 *
-	 * @return  boolean  True on success
-	 */
-	public function postflight($route, $adapter)
-	{
-		// set application to local method var, just use $this->app in future [we will drop $app in J6]
-		$app = $this->app;
-
-		return true;
-	}
-
-	/**
-	 * Remove the files and folders in the given array from
-	 *
-	 * @return  void
-	 * @since   5.0.2
-	 */
-	protected function removeFiles()
-	{
-		if (!empty($this->deleteFiles))
-		{
-			foreach ($this->deleteFiles as $file)
-			{
-				if (is_file(JPATH_ROOT . $file) && !File::delete(JPATH_ROOT . $file))
-				{
-					echo Text::sprintf('JLIB_INSTALLER_ERROR_FILE_FOLDER', $file) . '<br>';
-				}
-			}
-		}
-
-		if (!empty($this->deleteFolders))
-		{
-			foreach ($this->deleteFolders as $folder)
-			{
-				if (is_dir(JPATH_ROOT . $folder) && !Folder::delete(JPATH_ROOT . $folder))
-				{
-					echo Text::sprintf('JLIB_INSTALLER_ERROR_FILE_FOLDER', $folder) . '<br>';
-				}
-			}
-		}
-	}
 }

services/index.html

@@ -1 +0,0 @@
-<html><body bgcolor="#FFFFFF"></body></html>

services/provider.php

@@ -1,47 +0,0 @@
-<?php
-/**
- * @package    Joomla.Component.Builder
- *
- * @created    30th April, 2015
- * @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 file
-defined('_JEXEC') or die('Restricted access');
-
-use Joomla\CMS\Factory;
-use Joomla\CMS\Plugin\PluginHelper;
-use Joomla\CMS\Extension\PluginInterface;
-use Joomla\Event\DispatcherInterface;
-use Joomla\DI\ServiceProviderInterface;
-use Joomla\DI\Container;
-use VDM\Plugin\Content\ComponentbuilderCustomAdminHeadersTabs\Extension\ComponentbuilderCustomAdminHeadersTabs;
-
-return new class () implements ServiceProviderInterface {
-	/**
-	* Registers the service provider with a DI container.
-	*
-	* @param   Container  $container  The DI container.
-	*
-	* @return  void
-	* @since   4.3.0
-	*/
-	public function register(Container $container)
-	{
-		$container->set(
-			PluginInterface::class,
-			function (Container $container) {
-				$plugin = new ComponentbuilderCustomAdminHeadersTabs(
-					$container->get(DispatcherInterface::class),
-					(array) PluginHelper::getPlugin('content', 'componentbuildercustomadminheaderstabs')
-				);
-				$plugin->setApplication(Factory::getApplication());
-
-				return $plugin;
-			}
-		);
-	}
-};

src/Extension/index.html

@@ -1 +0,0 @@
-<html><body bgcolor="#FFFFFF"></body></html>