The Advanced Validator module for Magento 2 allows you to implement custom validation rules for checkout fields. You can use regular expressions to validate fields like city, postcode, and more during the checkout process.

You can install the Advanced Validator module by manually adding the files to your Magento project.

1. Download the module files.
2. Unpack them into the following directory: app/code/M2S/AdvancedValidator/

After installation, enable the module by running the following commands:

bin/magento setup:upgrade

bin/magento module:enabled M2S_AdvancedValidator

bin/magento flush:cache

Once installed and enabled, the Advanced Validator module can be configured from the Magento Admin Panel.

1. Navigate to the Configuration Page:
   • Go to Stores > Configuration > M2S > Advanced Validator.

• Field ID: enabled
• Type: Select (Yes/No)
• Default Value: Yes

Description:
This option enables or disables the module. When set to Yes, the custom validation rules defined in the settings will be applied during checkout.

• Field ID: validation_json_regex
• Type: Grid of Columns (Country codes, Validation Key, Regex, Message)

Description:
This setting allows you to define custom validation rules for specific checkout fields using regular expressions. The columns you will see in the Admin Panel are:

• Country codes: Country codes of the field to validate.
• Validation Key: A unique identifier for the validation rule.
• Regex: Regular expression used for validation.
• Message: Custom error message shown when validation fails.

• Field ID: fields_validation
• Type: Grid of Columns (Field code, Validation Key, Validation Enabled, Form Type)

Description:
This setting maps specific fields to the validation rules defined above. You can assign validation rules to various fields in the checkout process, such as city or postcode. It also includes options to enable or disable validation for each field and select the form type it applies to (Shipping Address, Billing Address, or All Forms).

• Field code: The checkout field code where the validation rule should be applied.
• Validation Key: The validation key defined in the Custom Validation Regex List that should be used for the selected field.
• Validation Enabled: A toggle (Yes/No) to enable or disable validation for the field.
• Form Type: Defines the form the validation rule applies to: All forms, Shipping Address, Billing Address.

• Field ID: shipping_address_path
• Type: Text
• Default Value: /shipping-step/children/shippingAddress/children/shipping-address-fieldset/children

Description:
This field allows you to define a custom path for the shipping address. If your checkout flow has a custom structure, specify the path where the shipping address is located.

• Field ID: billing_address_path
• Type: Text
• Default Value: /billing-step/children/payment/children/afterMethods/children/billing-address-form/children/form-fields/children

1. In the Custom Validation Regex List, define a rule to accept only alphanumeric characters, hyphens, and underscores, ensuring that each Validation Key is unique. Optionally, you can also define Country Codes (e.g., PL, US) to restrict validation to specific countries.

2. In the Fields Validation Rules, map the city field to the custom-city-validation key:

The Sorting Configuration section allows you to configure the sort order of the fields on the checkout page.

In this scenario, you have the city field set to appear first, followed by the postcode field in the checkout forms:

1. In the Sorting Configuration, define the sort order for the city and postcode fields:

2. The city field will appear before the postcode field, ensuring a consistent and logical order based on your configuration.

This sorting configuration allows store admins to control the layout and order of fields in the checkout process, enhancing the user experience.

The Label Configuration section allows you to define custom labels for checkout fields.

In this scenario, you want to customize the label for the city field in the checkout form:

1. In the Label Configuration, set the label for the city field:

This configuration allows store admins to control the text displayed for each field during the checkout process.

The Class Configuration section allows you to specify custom CSS classes for checkout fields.

In this scenario, you want to assign a CSS class to the city field:

1. In the Class Configuration, set the CSS class for the city field:

This configuration allows store admins to control the appearance of fields by applying custom CSS classes.

• Developed by Piotr Wlosek
• piotr.wlosekx@gmail.com