Product documentation / Joomla & VirtueMart

PremiumCheckout Suite.

Practical setup and operation guides for building a clearer VirtueMart cart and checkout without replacing VirtueMart’s pricing, tax, payment or order authority.

View the product

Version 1.0.4 English

Complete guide. 7 chapters.

Chapter 04 / 07

Shopper Fields and Conditional Rules

Use native VirtueMart shopper fields and add guided display rules without weakening required-field validation.

On this page

Shopper fields come from VirtueMart

Premium Checkout Suite reads the published VirtueMart shopper fields, their ordering, required state and address context. Create, publish and order fields in the native VirtueMart shopper-field manager.

  • Use VirtueMart to create or rename a field.
  • Use VirtueMart to decide whether it is required.
  • Use VirtueMart to decide whether it belongs to billing, delivery or registration.
  • Use Premium Checkout Suite conditional rules only for contextual show, hide or require behaviour.

Country and State/Region

The State/Region choices depend on the selected Country and the states configured in VirtueMart. If the list is empty, first confirm that the country has published states and that the country field appears before the state field.

  1. Open the checkout as a guest.
  2. Select the country.
  3. Wait for the state choices to refresh.
  4. Select a state and continue.
If State/Region is missing
Check the native VirtueMart country and state records, field publication and ordering. The extension does not invent state data.

Different delivery address

When the store permits alternative delivery details, the shopper can choose a separate address. Billing and delivery fields keep their native VirtueMart address contexts.

Test both paths: one order that uses the billing address for delivery and one that enters a separate delivery address. Confirm that the success and print views show the correct address once, without duplicated native blocks.

Signed-in customer details

Signed-in shoppers can see account-backed details in a protected, read-only presentation. The Edit details action opens the appropriate native account workflow instead of allowing unsafe browser-only changes to authoritative account data.

Always test the flow as a guest, a normal retail customer and any wholesale shopper group used by the store.

Create a guided conditional-field rule

Open Components – Premium Checkout Suite – Conditional fields and select New rule. The builder asks for one choice at a time.

  1. Choose the field affected by the rule.
  2. Choose Show when matched, Hide when matched or Require when matched.
  3. Choose Billing / primary, Alternative delivery or Both.
  4. Select Match all or Match any.
  5. Add one or more conditions.
  6. Review the summary and save the rule.
  7. Enable the rule after checking its meaning.

Condition sources include shopper fields, payment method, shipment method, cart product, cart category and shopper group. Available comparisons include equals, does not equal, contains, does not contain, is one of, is not one of, empty and not empty.

Required fields stay safe

If a rule hides a field that VirtueMart normally requires, the server applies the reviewed conditional result. Do not use template edits or browser scripts to bypass required-field validation.

Conditional shopper fields builder with Hide, Show and Require rule choices
The guided builder starts with the intended outcome and then reveals the field, conditions and review steps.

Practical rule examples

Show a company field

Show VAT number when Customer type equals Business. Apply it to Billing / primary.

Require delivery instructions

Require Delivery instructions when Shipment method equals Local delivery.

Hide a field for pickup

Hide Delivery notes when Shipment method equals Store pickup.

Wholesale information

Show Purchase order reference when Shopper group is one of the approved wholesale groups.

Use the actual field and method names available in the current website. A missing or unpublished source cannot match a rule.

Verify a conditional rule

  1. Open a private storefront window.
  2. Reach the checkout with a product that satisfies the intended scenario.
  3. Change the source value and confirm the field responds.
  4. Submit without the field when it should be optional or hidden.
  5. Submit without the field when it should be required and confirm validation blocks the order.
  6. Repeat with the rule disabled and confirm normal VirtueMart behaviour returns.

If a rule does not run, confirm that it is enabled, its field still exists, its address context is correct and all referenced methods, products, categories or shopper groups are published.

Complete official reference / Version 1.0.4

View the published source

The people behind the code

Need help with a specific setup?

Open the relevant chapter first. If the issue remains, contact support with your Joomla, VirtueMart and extension versions and a privacy-safe description of the result.