[6.0] Numbers custom fields plugin

administrator/components/com_admin/sql/updates/mysql/6.0.0-2025-08-17.sql

@@ -0,0 +1,2 @@
+INSERT INTO `#__extensions` (`package_id`, `name`, `type`, `element`, `folder`, `client_id`, `enabled`, `access`, `protected`, `locked`, `manifest_cache`, `params`, `custom_data`, `ordering`, `state`) VALUES
+(0, 'plg_fields_number', 'plugin', 'number', 'fields', 0, 1, 1, 0, 1, '', '{"min":"1.0","max":"100.0","step":"0.1","currency":"0","position":"0","decimals":"2"}', '', -1, 0);

administrator/components/com_admin/sql/updates/postgresql/6.0.0-2025-08-17.sql

@@ -0,0 +1,2 @@
+INSERT INTO "#__extensions" ("package_id", "name", "type", "element", "folder", "client_id", "enabled", "access", "protected", "locked", "manifest_cache", "params", "custom_data", "ordering", "state") VALUES
+(0, 'plg_fields_number', 'plugin', 'number', 'fields', 0, 1, 1, 0, 1, '', '{"min":"1.0","max":"100.0","step":"0.1","currency":"0","position":"0","decimals":"2"}', '', -1, 0);

administrator/language/en-GB/plg_fields_number.ini

@@ -0,0 +1,19 @@
+; Joomla! Project
+; (C) 2025 Open Source Matters, Inc. <https://www.joomla.org>
+; License GNU General Public License version 2 or later; see LICENSE.txt
+; Note : All ini files need to be saved as UTF-8
+
+PLG_FIELDS_NUMBER="Fields - Number"
+PLG_FIELDS_NUMBER_LABEL="Number (%s)"
+PLG_FIELDS_NUMBER_PARAMS_CURRENCY_LABEL="Format as Currency"
+PLG_FIELDS_NUMBER_PARAMS_DECIMALS_LABEL="Number of Decimals"
+PLG_FIELDS_NUMBER_PARAMS_MAX_DESC="Maximum value that can be chosen (only limits the up/down arrows)."
+PLG_FIELDS_NUMBER_PARAMS_MAX_LABEL="Maximum"
+PLG_FIELDS_NUMBER_PARAMS_MIN_DESC="Minimum value that can be chosen (only limits the up/down arrows)."
+PLG_FIELDS_NUMBER_PARAMS_MIN_LABEL="Minimum"
+PLG_FIELDS_NUMBER_PARAMS_POSITION_LABEL="Symbol Position"
+PLG_FIELDS_NUMBER_PARAMS_POSITION_OPTION_AFTER="After"
+PLG_FIELDS_NUMBER_PARAMS_POSITION_OPTION_BEFORE="Before"
+PLG_FIELDS_NUMBER_PARAMS_STEP_LABEL="Step Increment"
+PLG_FIELDS_NUMBER_PARAMS_SYMBOL_LABEL="Currency Symbol"
+PLG_FIELDS_NUMBER_XML_DESCRIPTION="This plugin lets you create new fields of type 'number' in any extensions where custom fields are supported."

administrator/language/en-GB/plg_fields_number.sys.ini

@@ -0,0 +1,7 @@
+; Joomla! Project
+; (C) 2025 Open Source Matters, Inc. <https://www.joomla.org>
+; License GNU General Public License version 2 or later; see LICENSE.txt
+; Note : All ini files need to be saved as UTF-8
+
+PLG_FIELDS_NUMBER="Fields - Number"
+PLG_FIELDS_NUMBER_XML_DESCRIPTION="This plugin lets you create new fields of type 'number' in any extensions where custom fields are supported."

installation/sql/mysql/base.sql

@@ -299,14 +299,15 @@ INSERT INTO `#__extensions` (`package_id`, `name`, `type`, `element`, `folder`,
 (0, 'plg_fields_list', 'plugin', 'list', 'fields', 0, 1, 1, 0, 1, '', '', '', 7, 0),
 (0, 'plg_fields_media', 'plugin', 'media', 'fields', 0, 1, 1, 0, 1, '', '', '', 8, 0),
 (0, 'plg_fields_note', 'plugin', 'note', 'fields', 0, 1, 1, 0, 1, '', '{"class":"alert alert-info","heading":"h4"}', '', 9, 0),
-(0, 'plg_fields_radio', 'plugin', 'radio', 'fields', 0, 1, 1, 0, 1, '', '', '', 10, 0),
-(0, 'plg_fields_sql', 'plugin', 'sql', 'fields', 0, 1, 1, 0, 1, '', '', '', 11, 0),
-(0, 'plg_fields_subform', 'plugin', 'subform', 'fields', 0, 1, 1, 0, 1, '', '', '', 12, 0),
-(0, 'plg_fields_text', 'plugin', 'text', 'fields', 0, 1, 1, 0, 1, '', '', '', 13, 0),
-(0, 'plg_fields_textarea', 'plugin', 'textarea', 'fields', 0, 1, 1, 0, 1, '', '{"rows":10,"cols":10,"maxlength":"","filter":"\\\\Joomla\\\\CMS\\\\Component\\\\ComponentHelper::filterText"}', '', 14, 0),
-(0, 'plg_fields_url', 'plugin', 'url', 'fields', 0, 1, 1, 0, 1, '', '', '', 15, 0),
-(0, 'plg_fields_user', 'plugin', 'user', 'fields', 0, 1, 1, 0, 1, '', '', '', 16, 0),
-(0, 'plg_fields_usergrouplist', 'plugin', 'usergrouplist', 'fields', 0, 1, 1, 0, 1, '', '', '', 17, 0),
+(0, 'plg_fields_number', 'plugin', 'number', 'fields', 0, 1, 1, 0, 1, '', '{"min":"1.0","max":"100.0","step":"0.1","currency":"0","position":"0","decimals":"2"}', '', 10, 0),
+(0, 'plg_fields_radio', 'plugin', 'radio', 'fields', 0, 1, 1, 0, 1, '', '', '', 11, 0),
+(0, 'plg_fields_sql', 'plugin', 'sql', 'fields', 0, 1, 1, 0, 1, '', '', '', 12, 0),
+(0, 'plg_fields_subform', 'plugin', 'subform', 'fields', 0, 1, 1, 0, 1, '', '', '', 13, 0),
+(0, 'plg_fields_text', 'plugin', 'text', 'fields', 0, 1, 1, 0, 1, '', '', '', 14, 0),
+(0, 'plg_fields_textarea', 'plugin', 'textarea', 'fields', 0, 1, 1, 0, 1, '', '{"rows":10,"cols":10,"maxlength":"","filter":"\\\\Joomla\\\\CMS\\\\Component\\\\ComponentHelper::filterText"}', '', 15, 0),
+(0, 'plg_fields_url', 'plugin', 'url', 'fields', 0, 1, 1, 0, 1, '', '', '', 16, 0),
+(0, 'plg_fields_user', 'plugin', 'user', 'fields', 0, 1, 1, 0, 1, '', '', '', 17, 0),
+(0, 'plg_fields_usergrouplist', 'plugin', 'usergrouplist', 'fields', 0, 1, 1, 0, 1, '', '', '', 18, 0),
 (0, 'plg_filesystem_local', 'plugin', 'local', 'filesystem', 0, 1, 1, 0, 1, '', '{}', '', 1, 0),
 (0, 'plg_finder_categories', 'plugin', 'categories', 'finder', 0, 1, 1, 0, 1, '', '', '', 1, 0),
 (0, 'plg_finder_contacts', 'plugin', 'contacts', 'finder', 0, 1, 1, 0, 1, '', '', '', 2, 0),

installation/sql/postgresql/base.sql

@@ -305,14 +305,15 @@ INSERT INTO "#__extensions" ("package_id", "name", "type", "element", "folder",
 (0, 'plg_fields_list', 'plugin', 'list', 'fields', 0, 1, 1, 0, 1, '', '', '', 7, 0),
 (0, 'plg_fields_media', 'plugin', 'media', 'fields', 0, 1, 1, 0, 1, '', '', '', 8, 0),
 (0, 'plg_fields_note', 'plugin', 'note', 'fields', 0, 1, 1, 0, 1, '', '{"class":"alert alert-info","heading":"h4"}', '', 9, 0),
-(0, 'plg_fields_radio', 'plugin', 'radio', 'fields', 0, 1, 1, 0, 1, '', '', '', 10, 0),
-(0, 'plg_fields_sql', 'plugin', 'sql', 'fields', 0, 1, 1, 0, 1, '', '', '', 11, 0),
-(0, 'plg_fields_subform', 'plugin', 'subform', 'fields', 0, 1, 1, 0, 1, '', '', '', 12, 0),
-(0, 'plg_fields_text', 'plugin', 'text', 'fields', 0, 1, 1, 0, 1, '', '', '', 13, 0),
-(0, 'plg_fields_textarea', 'plugin', 'textarea', 'fields', 0, 1, 1, 0, 1, '', '{"rows":10,"cols":10,"maxlength":"","filter":"\\\\Joomla\\\\CMS\\\\Component\\\\ComponentHelper::filterText"}', '', 14, 0),
-(0, 'plg_fields_url', 'plugin', 'url', 'fields', 0, 1, 1, 0, 1, '', '', '', 15, 0),
-(0, 'plg_fields_user', 'plugin', 'user', 'fields', 0, 1, 1, 0, 1, '', '', '', 16, 0),
-(0, 'plg_fields_usergrouplist', 'plugin', 'usergrouplist', 'fields', 0, 1, 1, 0, 1, '', '', '', 17, 0),
+(0, 'plg_fields_number', 'plugin', 'number', 'fields', 0, 1, 1, 0, 1, '', '{"min":"1.0","max":"100.0","step":"0.1","currency":"0","position":"0","decimals":"2"}', '', 10, 0),
+(0, 'plg_fields_radio', 'plugin', 'radio', 'fields', 0, 1, 1, 0, 1, '', '', '', 11, 0),
+(0, 'plg_fields_sql', 'plugin', 'sql', 'fields', 0, 1, 1, 0, 1, '', '', '', 12, 0),
+(0, 'plg_fields_subform', 'plugin', 'subform', 'fields', 0, 1, 1, 0, 1, '', '', '', 13, 0),
+(0, 'plg_fields_text', 'plugin', 'text', 'fields', 0, 1, 1, 0, 1, '', '', '', 14, 0),
+(0, 'plg_fields_textarea', 'plugin', 'textarea', 'fields', 0, 1, 1, 0, 1, '', '{"rows":10,"cols":10,"maxlength":"","filter":"\\\\Joomla\\\\CMS\\\\Component\\\\ComponentHelper::filterText"}', '', 15, 0),
+(0, 'plg_fields_url', 'plugin', 'url', 'fields', 0, 1, 1, 0, 1, '', '', '', 16, 0),
+(0, 'plg_fields_user', 'plugin', 'user', 'fields', 0, 1, 1, 0, 1, '', '', '', 17, 0),
+(0, 'plg_fields_usergrouplist', 'plugin', 'usergrouplist', 'fields', 0, 1, 1, 0, 1, '', '', '', 18, 0),
 (0, 'plg_filesystem_local', 'plugin', 'local', 'filesystem', 0, 1, 1, 0, 1, '', '{}', '', 1, 0),
 (0, 'plg_finder_categories', 'plugin', 'categories', 'finder', 0, 1, 1, 0, 1, '', '', '', 1, 0),
 (0, 'plg_finder_contacts', 'plugin', 'contacts', 'finder', 0, 1, 1, 0, 1, '', '', '', 2, 0),

plugins/fields/number/number.xml

@@ -0,0 +1,97 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<extension type="plugin" group="fields" method="upgrade">
+	<name>plg_fields_number</name>
+	<author>Joomla! Project</author>
+	<creationDate>2025-03</creationDate>
+	<copyright>(C) 2025 Open Source Matters, Inc.</copyright>
+	<license>GNU General Public License version 2 or later; see LICENSE.txt</license>
+	<authorEmail>admin@joomla.org</authorEmail>
+	<authorUrl>www.joomla.org</authorUrl>
+	<version>6.0.0</version>
+	<description>PLG_FIELDS_NUMBER_XML_DESCRIPTION</description>
+	<namespace path="src">Joomla\Plugin\Fields\Number</namespace>
+	<files>
+		<folder>params</folder>
+		<folder plugin="number">services</folder>
+		<folder>src</folder>
+		<folder>tmpl</folder>
+	</files>
+	<languages>
+		<language tag="en-GB">language/en-GB/plg_fields_number.ini</language>
+		<language tag="en-GB">language/en-GB/plg_fields_number.sys.ini</language>
+	</languages>
+	<config>
+		<fields name="params">
+			<fieldset name="basic">
+				<field
+					name="min"
+					type="number"
+					label="PLG_FIELDS_NUMBER_PARAMS_MIN_LABEL"
+					description="PLG_FIELDS_NUMBER_PARAMS_MIN_DESC"
+					default="1.0"
+					filter="float"
+				/>
+
+				<field
+					name="max"
+					type="number"
+					label="PLG_FIELDS_NUMBER_PARAMS_MAX_LABEL"
+					description="PLG_FIELDS_NUMBER_PARAMS_MAX_DESC"
+					default="100.0"
+					filter="float"
+				/>
+
+				<field
+					name="step"
+					type="number"
+					label="PLG_FIELDS_NUMBER_PARAMS_STEP_LABEL"
+					default="1.0"
+					filter="float"
+				/>
+
+				<field
+					name="currency"
+					type="radio"
+					label="PLG_FIELDS_NUMBER_PARAMS_CURRENCY_LABEL"
+					layout="joomla.form.field.radio.switcher"
+					default="0"
+					filter="integer"
+					>
+					<option value="0">JNO</option>
+					<option value="1">JYES</option>
+				</field>
+
+				<field
+					name="symbol"
+					type="text"
+					label="PLG_FIELDS_NUMBER_PARAMS_SYMBOL_LABEL"
+					filter="string"
+					showon="currency:1"
+				/>
+
+				<field
+					name="position"
+					type="list"
+					label="PLG_FIELDS_NUMBER_PARAMS_POSITION_LABEL"
+					default="0"
+					filter="integer"
+					showon="currency:1"
+					>
+					<option value="0">PLG_FIELDS_NUMBER_PARAMS_POSITION_OPTION_BEFORE</option>
+					<option value="1">PLG_FIELDS_NUMBER_PARAMS_POSITION_OPTION_AFTER</option>
+				</field>
+
+				<field
+					name="decimals"
+					type="int"
+					label="PLG_FIELDS_NUMBER_PARAMS_DECIMALS_LABEL"
+					min="0"
+					max="10"
+					default="2"
+					filter="int"
+					showon="currency:1"
+				/>
+			</fieldset>
+		</fields>
+	</config>
+</extension>

plugins/fields/number/params/number.xml

@@ -0,0 +1,73 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<form>
+	<fields name="fieldparams">
+		<fieldset name="fieldparams">
+			<field
+				name="min"
+				type="number"
+				label="PLG_FIELDS_NUMBER_PARAMS_MIN_LABEL"
+				description="PLG_FIELDS_NUMBER_PARAMS_MIN_DESC"
+				filter="float"
+			/>
+
+			<field
+				name="max"
+				type="number"
+				label="PLG_FIELDS_NUMBER_PARAMS_MAX_LABEL"
+				description="PLG_FIELDS_NUMBER_PARAMS_MAX_DESC"
+				filter="float"
+			/>
+
+			<field
+				name="step"
+				type="number"
+				label="PLG_FIELDS_NUMBER_PARAMS_STEP_LABEL"
+				default="1.0"
+				filter="float"
+			/>
+
+			<field
+				name="currency"
+				type="radio"
+				label="PLG_FIELDS_NUMBER_PARAMS_CURRENCY_LABEL"
+				layout="joomla.form.field.radio.switcher"
+				default="0"
+				filter="integer"
+				>
+				<option value="0">JNO</option>
+				<option value="1">JYES</option>
+			</field>
+
+			<field
+				name="symbol"
+				type="text"
+				label="PLG_FIELDS_NUMBER_PARAMS_SYMBOL_LABEL"
+				filter="string"
+				showon="currency:1"
+			/>
+
+			<field
+				name="position"
+				type="list"
+				label="PLG_FIELDS_NUMBER_PARAMS_POSITION_LABEL"
+				default="0"
+				filter="integer"
+				showon="currency:1"
+				>
+				<option value="0">PLG_FIELDS_NUMBER_PARAMS_POSITION_OPTION_BEFORE</option>
+				<option value="1">PLG_FIELDS_NUMBER_PARAMS_POSITION_OPTION_AFTER</option>
+			</field>
+
+			<field
+				name="decimals"
+				type="int"
+				label="PLG_FIELDS_NUMBER_PARAMS_DECIMALS_LABEL"
+				default="2"
+				filter="integer"
+				showon="currency:1"
+				min="0"
+				max="10"
+			/>
+		</fieldset>
+	</fields>
+</form>

plugins/fields/number/services/provider.php

@@ -0,0 +1,46 @@
+<?php
+
+/**
+ * @package     Joomla.Plugin
+ * @subpackage  Fields.number
+ *
+ * @copyright   (C) 2025 Open Source Matters, Inc. <https://www.joomla.org>
+ * @license     GNU General Public License version 2 or later; see LICENSE.txt
+ */
+
+\defined('_JEXEC') or die;
+
+use Joomla\CMS\Extension\PluginInterface;
+use Joomla\CMS\Factory;
+use Joomla\CMS\Plugin\PluginHelper;
+use Joomla\DI\Container;
+use Joomla\DI\ServiceProviderInterface;
+use Joomla\Event\DispatcherInterface;
+use Joomla\Plugin\Fields\Number\Extension\Number;
+
+return new class () implements ServiceProviderInterface {
+    /**
+     * Registers the service provider with a DI container.
+     *
+     * @param   Container  $container  The DI container.
+     *
+     * @return  void
+     *
+     * @since   __DEPLOY_VERSION__
+     */
+    public function register(Container $container)
+    {
+        $container->set(
+            PluginInterface::class,
+            function (Container $container) {
+                $plugin     = new Number(
+                    $container->get(DispatcherInterface::class),
+                    (array) PluginHelper::getPlugin('fields', 'number')
+                );
+                $plugin->setApplication(Factory::getApplication());
+
+                return $plugin;
+            }
+        );
+    }
+};

plugins/fields/number/src/Extension/Number.php

@@ -0,0 +1,27 @@
+<?php
+
+/**
+ * @package     Joomla.Plugin
+ * @subpackage  Fields.number
+ *
+ * @copyright   (C) 2025 Open Source Matters, Inc. <https://www.joomla.org>
+ * @license     GNU General Public License version 2 or later; see LICENSE.txt
+ */
+
+namespace Joomla\Plugin\Fields\Number\Extension;
+
+use Joomla\Component\Fields\Administrator\Plugin\FieldsPlugin;
+use Joomla\Event\SubscriberInterface;
+
+// phpcs:disable PSR1.Files.SideEffects
+\defined('_JEXEC') or die;
+// phpcs:enable PSR1.Files.SideEffects
+
+/**
+ * Fields Number Plugin
+ *
+ * @since  __DEPLOY_VERSION__
+ */
+final class Number extends FieldsPlugin implements SubscriberInterface
+{
+}

plugins/fields/number/tmpl/number.php

@@ -0,0 +1,32 @@
+<?php
+
+/**
+ * @package     Joomla.Plugin
+ * @subpackage  Fields.Number
+ *
+ * @copyright   (C) 2025 Open Source Matters, Inc. <https://www.joomla.org>
+ * @license     GNU General Public License version 2 or later; see LICENSE.txt
+ */
+
+defined('_JEXEC') or die;
+
+use Joomla\CMS\Language\Text;
+
+$value    = $field->value;
+$min      = $field->fieldparams->get('min', null);
+$currency = $field->fieldparams->get('currency', 0);
+$decimals = $field->fieldparams->get('decimals', 2);
+$symbol   = $field->fieldparams->get('symbol', 2);
+$position = $field->fieldparams->get('position', 2);
+
+if (is_numeric($value)) {
+    $value = (float)$value;
+    if ($currency) {
+        $formattedCurrency = number_format($value, $decimals, Text::_('DECIMALS_SEPARATOR'), Text::_('THOUSANDS_SEPARATOR'));
+        $value = $position ? ($formattedCurrency . $symbol) : ($symbol . $formattedCurrency) ;
+    }
+} else {
+    $value = $min ?? '';
+}
+
+echo $value;