Skip to Content
Account
Enter the email address on your account.
Forgot Your Username?
Enter your password.
Forgot Your Password?

Or continue with

Developer

ProductType Form Field

3 Min Read
On This Page

ProductTypeField is a ListField subclass that renders a dropdown of available product types. Four core types are built in. Additional types are injected at runtime through the onJ2CommerceGetProductTypes plugin event, so third-party app plugins can register proprietary product types without modifying core files.

Key Classes

ClassFilePurpose
ProductTypeFieldadministrator/components/com_j2commerce/src/Field/ProductTypeField.phpRenders the product-type dropdown; fires GetProductTypes event
J2CommerceHelperadministrator/components/com_j2commerce/src/Helper/J2CommerceHelper.phpProvides plugin()->event() dispatcher shortcut

Core Product Types

The following types are always present regardless of installed plugins.

ValueLanguage key
simpleCOM_J2COMMERCE_PRODUCT_TYPE_SIMPLE
variableCOM_J2COMMERCE_PRODUCT_TYPE_VARIABLE
configurableCOM_J2COMMERCE_PRODUCT_TYPE_CONFIGURABLE
downloadableCOM_J2COMMERCE_PRODUCT_TYPE_DOWNLOADABLE

The list is sorted alphabetically by translated label before being returned.

Plugin Event: onJ2CommerceGetProductTypes

ProductTypeField::getProductTypes() fires this event after building the core list, passing $types by reference so plugins can append entries directly.

DetailValue
Event nameonJ2CommerceGetProductTypes
Fired byProductTypeField::getProductTypes()
Argument$types — passed by reference ([&$types])
Plugin groupj2commerce

Registering a Custom Product Type

// File: plugins/j2commerce/app_yourplugin/src/Extension/AppYourPlugin.php

declare(strict_types=1);

namespace J2Commerce\Plugin\J2Commerce\App\YourPlugin\Extension;

use Joomla\CMS\Plugin\CMSPlugin;
use Joomla\CMS\Language\Text;
use Joomla\Event\SubscriberInterface;

class AppYourPlugin extends CMSPlugin implements SubscriberInterface
{
    public static function getSubscribedEvents(): array
    {
        return [
            'onJ2CommerceGetProductTypes' => 'onJ2CommerceGetProductTypes',
        ];
    }

    public function onJ2CommerceGetProductTypes(\Joomla\Event\Event $event): void
    {
        $types = &$event->getArgument(0); // passed by reference as positional arg
        $types['bundle'] = Text::_('PLG_J2COMMERCE_APP_YOURPLUGIN_PRODUCT_TYPE_BUNDLE');
    }
}

Note: J2CommerceHelper::plugin()->event('GetProductTypes', [&$types]) passes the array as a positional argument, not a named key. Access it with $event->getArgument(0).

Caching

Options are cached in ProductTypeField::$cachedTypes (static property) for the lifetime of the request. Call ProductTypeField::clearCache() if you need to force a rebuild — for example, after programmatically installing a plugin during the same request.

// File: your-script.php

use J2Commerce\Component\J2commerce\Administrator\Field\ProductTypeField;

// Force rebuild after plugin install
ProductTypeField::clearCache();
$types = ProductTypeField::getProductTypes();

XML Usage

<!-- File: administrator/components/com_j2commerce/forms/product.xml (example) -->

<form addfieldprefix="J2Commerce\Component\J2commerce\Administrator\Field">
    <fieldset name="basic">
        <field
            name="product_type"
            type="ProductType"
            label="COM_J2COMMERCE_FIELD_PRODUCT_TYPE_LABEL"
            description="COM_J2COMMERCE_FIELD_PRODUCT_TYPE_DESC"
            required="true"
            default="simple"
        />
    </fieldset>
</form>

XML Attributes

AttributeTypeDefaultDescription
typestring—Must be ProductType
defaultstring—Default selected value, e.g. simple
requiredboolfalseMark field as required
multipleboolfalseAllow multi-select (uncommon; not standard usage)

All standard Joomla ListField attributes (label, description, class, filter, readonly, disabled) also apply.

Usage in Plugin Forms

When a shipping or app plugin needs to restrict configuration to specific product types, embed this field in the plugin's own config.xml:

<!-- File: plugins/j2commerce/app_yourplugin/config.xml -->

<?xml version="1.0" encoding="UTF-8"?>
<config>
    <fields name="params">
        <fieldset name="basic" label="COM_PLUGINS_BASIC_FIELDSET_LABEL">
            <field
                name="applicable_product_type"
                type="ProductType"
                addfieldprefix="J2Commerce\Component\J2commerce\Administrator\Field"
                label="PLG_J2COMMERCE_APP_YOURPLUGIN_FIELD_PRODUCT_TYPE_LABEL"
                description="PLG_J2COMMERCE_APP_YOURPLUGIN_FIELD_PRODUCT_TYPE_DESC"
                default="simple"
            />
        </fieldset>
    </fields>
</config>
  • Product Types — Architecture of product type variants

Still stuck? Our team can help.

Back to Top