Automatically fill checkout fields with information already stored in a signed-in customer's account. This saves customers from entering details such as their company, phone number, or address again.
Use one of the following plugins, depending on where you store customer information:
| Plugin | Source data |
|---|---|
| Documents Seller - Joomla User Custom Fields | Published Joomla user custom fields. The mapping selector also offers the account's username, name (full name), and email. |
| Documents Seller - Community Builder | Fields stored in the customer's Community Builder profile. Community Builder must be installed and enabled. |
Both plugins use the Fields mapping setting in the Documents Seller custom field editor. The mapping connects a checkout field to the corresponding source field; the field names do not have to match.
Joomla user custom fields appear by their titles in the mapping selector. Use fields belonging to Joomla users; custom fields created for articles or other content are not offered.
For example, if you have a Joomla user custom field titled Business Phone, open the Documents Seller Phone field and select Business Phone in Fields mapping. The signed-in customer's saved phone number can then fill the checkout field.
Community Builder fields appear by their stored field names, such as cb_company or cb_phone if you have created fields with those names. Select the actual field used on your site.
Enable the profile integration you intend to use. When several profile plugins are enabled, Documents Seller uses the first available set of mapping options and the first non-empty set of profile data. It does not combine Joomla and Community Builder fields into one source.
For example, a site using Community Builder could configure these mappings:
| Documents Seller checkout field | Community Builder source field |
|---|---|
| Company | cb_company |
| Phone | cb_phone |
| City | cb_city |
These source names are examples; use the names offered by your site's mapping selector. For lists, radio buttons, and checkboxes, make sure the source values match the choices configured in the checkout field. Choose compatible field types, especially for fields that can contain several selected values.
To remove a mapping, choose Select Field in Fields mapping and save.
Customers can review and edit the populated values before submitting the order. Their checkout changes are saved with the order; these plugins do not update the Joomla account or Community Builder profile.
Profile mapping applies to signed-in customers. Guests enter their information normally. Fields still follow their usual default values, validation, access, and document assignment settings.
If checkout is restoring previously entered information from the current session, it uses that information before loading profile data. This also preserves the customer's entries when they return after a validation error. Use a fresh browser session when testing a changed profile or mapping.
When a profile integration returns mapped data, Documents Seller uses that data instead of loading details from the customer's previous order. It does not fill the remaining fields from that order. If no integration returns data, checkout can reuse the signed-in customer's most recent order details. Checkout also supplies the Joomla account name and email when those checkout values have not already been set.