Improving Error Messages and UX for Admin Dokan Commission Settings

[sazz-pranto]

Overview:
Dokan's new commission structure provides two calculation types: Fixed and Category-Based. Each requires a Percentage Fee and a Flat Fee to calculate the final commission. Currently, users must input values for both fields, even if the value is 0.
While error messages for missing inputs in the Fixed type are clear, those in the Category-Based type are confusing. Additionally, the "Save" button placement and lack of auto-scroll to errors contribute to user confusion.

Key Observations and Issues

1. Ambiguity in Error Messages for Category-Based Commission Type:

Current Behavior:

• If the Percentage Fee is missing, the error says: "Admin commission is required."
• If the Flat Fee is missing, the error also says: "Admin commission is required."

Problem:
The message does not specify which field (Percentage Fee or Flat Fee) is missing, leading to confusion. This leaves users uncertain about what needs to be corrected. Some users reported that they thought the fixed rate should also be set while configuring a category-based commission rate.

2. Error Visibility Issues:

Current Behavior:

• The "Save" button is positioned at the bottom of the page.
• It does not automatically scroll up to the problematic fields or display the error prominently.

Problem:
Users may not notice the error message, as the section on that page is quite long.

Suggested Enhancements

1. Improved Error Messages:
Modify error messages for the Category-Based Commission type like:
When there's no percentage fee: "Percentage fee is required for category-based commission."
When there's no flat fee: "Flat fee is required for category-based commission."
A more specific error message can also be introduced for both types of commission indicating that zero must be inserted in case of the absence of a percentage/flat rate fee.

2. Auto-Scroll to Errors:
Implement functionality to automatically scroll to the first field with an error when the user clicks "Save."
Highlight the erroneous fields with a distinct color (e.g., red border) for better visibility.

By implementing these enhancements, Dokan can significantly improve the user experience for setting up commission structures, fostering greater user satisfaction and reducing support queries.

Video for a better understanding of the current behavior: https://d.pr/v/ja2nvO

Tested on Dokan Lite version 3.14.6