Custom Fee Fields

Custom Fee Fields is a powerful feature in Documents Seller. It allows you to charge your customers additional fee (beside the document price) depends on the value(s) they enter/selected on a field on order form. If you use custom fee field feature, please remember the following rules:

  1. Only the custom fields has Fee Field property set to Yes will be used to calculate fee for the subscription.
  2. Custom Fee Fields only works for the following custom field types: List (Single + Multiple Select), Checkboxes, Radio and Textbox.
  3. On a subscription form, there can be multiple custom fee fields. TOTAL AMOUNT CUSTOMER HAS TO PAY FOR THE ORDER = THE PRICE OF DOCUMENT + SUM OF ALL FEE FIELDS.

Radio List + Single Dropdown Custom Field Type

Let says you are creating a custom field which allow customers to if they want to receive a copy of document in print format (Ebook). So you create a custom field with following parameters:

  1. Values : Yes (+20$), No. Each item in one line.
  2. Default Values : No.
  3. Fee Values : 20, 0 . Each item in one line.
  4. Field Type : Radio List.
  5. Fee Fied: must set to Yes

In the front-end , the system will display a radio custom field with 2 options : Yes (+ 20$), No.

With the above settings:

  1. If customers choose Yes (+20$) , they will have to pay additional 20$.
  2. If customers choose No option, they won't have to pay any additional fee.

Please note the mapping 1-1 between Values and Fee Values settings of the custom field. Yes (+20$) mapped To 20 . No mapped to 10.

Checkboxes + MultiSelect Custom Field Type

You can setup a same field as Radio Custom Fee field mentioned above. The only difference is the way the fee is calculated. For Checkboxes and MultiSelect custom field, the fee which subscribers will be charged will be total fee of all selected options.

Textbox Custom Field Type

Let say you want to create a text field called Donation to allow customers to make additional donation for you (beside paying for their document fee). You can then create a new custom field with the following setting:

  1. Name : dms_donation_amount
  2. Title: Donation Amount
  3. Field Type: Text
  4. Fee Formula: [FIELD_VALUE]
  5. Fee Fied: Yes.

Now, any value customers enter into this field will be added to total order fee which customer has to pay. For example, if they enter 10, 10$ will be added to total order fee, if they enter 20, 20$ will be added to total order fee and so on. As you can see [FIELD_VALUE] will be replaced with the value users entered in the field for calculating the fee in Fee Formula.

Textbox Custom Fee Field

Understand Fee Formula

Fee Formula is a bit difficult to understand. However, once you get it, you will see that is is very powerful for fee calculation.

  1. You can use *math operators : +, -, , /** in the fee formula.
  2. When you use [FIELD_VALUE] tag in the fee formula, it will be replaced with the actual fee associated with that field for fee calculation:
    • If the field is a Text custom field, [FIELD_VALUE] will be replaced with the value subscribers enter on the textbox.
    • If the field is a single select field (Radio, Single Select box), [FIELD_VALUE] will be replaced with the fee amount corresponding with the value subscribers select for the field.
    • If the field is a multiple select field (Checkboxes, Multiple Select), [FIELD_VALUE] will be replaced with the total fee values of all the options which users select for that field.
  3. You can also use a custom fee in fee formular with the syntax: [NAME_OF_CUSTOM_FIELD_IN_UPPERCASE]. For example, if you have a textbox custom field called osm_quantity to allow users to enter quantity of the items they want to purchase, you can use the tag [OSM_QUANTITY] in the fee formula of any custom fields. Please note that when you use a custom field in fee formula, it will be replaced with a value using the same rules with [FIELD_VALUE] tag mentioned above.