Information for AForms Eats v1.1.2 and AForms Eats PRO v1.2.0.
Details tab
Auto Item
Adds a fixed detail line. You can also add conditions.
Available in both FREE and PRO editions.
| Name | This is a name of the detail. |
| Category | If you want to display a category name in the detail, please enter it. |
| Price | This is an amount of the detail. |
| Quantity | Normally, you can only choose “Fixed To 1”. |
| Tax Rate | This is a tax rate of the detail. If left blank, the tax rate in the form settings will be applied. |
| Required Labels | This is the condition for adding this detail to the details. |
Group
This is a box for grouping products. It appears in the navigation bar.
Available in both FREE and PRO editions.
| Image | This is an image representing the group, but normally not displayed. |
| Name | This is a name of the group. |
| Visibility | When “Invisible” is selected, the group will disappear from the navigation bar. |
| Note | This is a text description of the group. It is displayed above the product list. * About fields that can write HTML. |
Product Item
This is a product (food or drink) that can be ordered.
Available in both FREE and PRO editions.
| Image | The image of the product. This is a very important element. Use good pictures. In the built-in style, the product image will be displayed in an area of 292 pixels wide and 250 pixels high. |
| Name | This is a name of the product. |
| State | The status of the product. If you set it to “Disabled”, the product will be displayed as out of stock on the form. If you set it to “Hidden”, it will disappear from the form. |
| Note | This is a text description of the product. * About fields that can write HTML. |
| Price | This is a price of the product. |
| Tax Rate | This is a tax rate of the product. If left blank, the tax rate in the form settings will be applied. |
| Ribbons | When checked, the product will be marked with a “SALE” or “Recommended” ribbon. |
| Choice1..5 | PRO edition only. Used in “Combination Products”. Refer Building customer-selectable combo meals — Combination Products for detail. |
Choice Group
This is a box for options of “Combination Products”.
PRO edition only.
| Image | This is an image representing the group, but normally not displayed. |
| Name | This is a name of the group. |
| Note | This is a note of the group. * About fields that can write HTML. |
Choice Product
This is an option of “Combination Products”.
PRO edition only.
| Image | This is an image of the product. This is a very important element. Use good pictures. In the built-in style, the product image will be displayed in an area of 292 pixels wide and 250 pixels high. |
| Name | This is a name of the product. |
| State | The status of the product. If you set it to “Disabled”, the product will be displayed as out of stock on the form. If you set it to “Hidden”, it will disappear from the form. |
| Note | This is a note of the product. * About fields that can write HTML. |
| Price | Enter the difference that will occur when the customer chooses this option. For example, in the case of “Upgrade Medium to Large for +$0.5”, the price of Large would be “0.5”. |
| Ribbons | When checked, the product will be marked with a “SALE” or “Recommended” ribbon. |
Price Watcher
This component monitors the order amount and attaches a label if it is within the specified range.
The “order amount” refers to the total amount, excluding tax, at the time this component is executed. The components are executed from top to bottom.
Available in both FREE and PRO editions.
| Lower Limit Value | Lower limit of the range. If there is nothing special, leave it blank. |
| Includes Lower Limit Value | Whether or not to include the case where the value is the same as the lower limit. |
| Higher Limit Value | Higher limit of the range. If there is nothing special, leave it blank. |
| Includes Higher Limit Value | Whether or not to include the case where the value is the same as the higher limit. |
| Labels | Labels to be given if the value is in the range. |
Attribute Watcher
It monitors the specified component in Attributes and attaches labels if the input value matches.
PRO edition only.
| Target | This is the component to be monitored. You can choose from the components registered in the Attributes tab, but only Radio Buttons and Dropdowns will work. |
| Pattern | Pattern to use for matching with input value. Only exact matching is supported. In other words, matching will only succeed if the input value exactly matches to the pattern. |
| Labels | Labels attached when matching is successful. |
Stop
Specify a condition and stop the form submission if the condition is met. In that case, an error message will be displayed.
Available in both FREE and PRO editions.
| Message | This is an error message displayed when the form submission is stopped. |
| Required Labels | This is the condition to stop the form submission. Please note that it is when the conditions are met that the error occurs. |
Rate Item
Adds a detail line for the specified percentage of the order amount.
The “order amount” refers to the total amount, excluding tax, at the time this component is executed. The components are executed from top to bottom.
This component is similar to an Auto Item, but the difference is that the price is variable.
PRO edition only.
| Name | This is a name of the detail. |
| Category | If you want to display a category name in the detail, please enter it. |
| Percentage | Specify the rate as a percentage of the order amount. |
| Quantity | Normally, you can only choose “Fixed To 1”. |
| Tax Rate | This is a tax rate of the detail. If left blank, the tax rate in the form settings will be applied. |
| Required Labels | This is the condition for adding this detail to the details. |
Attributes tab
Name
Available in both FREE and PRO editions.
| Name | This is a name of the field. |
| Input Required | Whether the input is required or not. |
| Split Input Field | If you select “Split,” the input fields will be separated for first and last name. |
| Input Restriction | Whether or not to restrict the input to certain character types. |
| Note | This is a note of the field. * About fields that can write HTML. |
Mail Address
Available in both FREE and PRO editions.
| Name | This is a name of the field. |
| Input Required | Whether the input is required or not. |
| Confirmation Input | If you select “Confirm,” a field for confirmation will appear. In this case, the component will also check if the characters entered in the two input fields are the same or not. |
| Note | This is a note of the field. * About fields that can write HTML. |
Phone Number
Available in both FREE and PRO editions.
| Name | This is a name of the field. |
| Input Required | Whether the input is required or not. |
| Split Input Field | If you select “Split,” the input field will be divided into three. |
| Note | This is a note of the field. * About fields that can write HTML. |
Address
Available in both FREE and PRO editions.
| Name | This is a name of the field. |
| Input Required | Whether the input is required or not. |
| Auto Compeletion | If you select “Yubinbango (Japan)”, this component will search for addresses in Japanese zip codes and auto-complete them. |
| Note | This is a note of the field. * About fields that can write HTML. |
DateTime
This is a component that allows the customer to choose the date and time. It can be used to let the customer select the “Preferred pickup date and time”.
For more details, please refer to How to use the DateTime item (linking with Opening Hours).
PRO edition only.
| Name | This is a name of the field. |
| Input Required | Whether the input is required or not. |
| Opening Hours Provider | AForms Eats is designed to retrieve opening hours from an external source. Please select the source of your opening hours. |
| Set Id | This input field will be displayed when Opening Hours is selected as the provider of the opening hours. Please enter the Set Id of Opening Hours. |
| Preparation Time | Specify how much time is required from the time of order to the desired date and time of pickup. |
| Present Up To | Specify how many days later you want to be able to choose the desired date of pickup. |
| Ticks Of Options | Specify the number of minutes to make choices for the desired time of pickup. |
| Note | This is a note of the field. * About fields that can write HTML. |
Checkbox
This is a generic check box. Available in both FREE and PRO editions.
| Name | This is a name of the field. |
| Input Required | Setting it to “Required” will cause an error to occur if the customer does not check the box. |
| Initial Value | Whether it is initially checked or not. |
| Note | This is a note of the field. * About fields that can write HTML. |
Radio Button
A generic radio button. Available in both FREE and PRO editions.
| Name | This is a name of the field. |
| Input Required | Whether the input is required or not. |
| Options | Enter options. |
| Initial Value | If you want it to be selected from the beginning, enter it. |
| Note | This is a note of the field. * About fields that can write HTML. |
Dropdown
A generic dropdown. Available in both FREE and PRO editions.
| Name | This is a name of the field. |
| Input Required | Whether the input is required or not. |
| Options | Enter options. |
| Initial Value | If you want it to be selected from the beginning, enter it. |
| Note | This is a note of the field. * About fields that can write HTML. |
Multiple Checkbox
This is a generic component that displays a list of checkboxes. Available in both FREE and PRO editions.
| Name | This is a name of the field. |
| Input Required | If you set it to “Required,” the customer will get an error if he/she hasn’t selected at least one of options. |
| Options | Enter options. |
| Initial Value | If you want it to be selected from the beginning, enter it. |
| Note | This is a note of the field. * About fields that can write HTML. |
Text
A generic text input field. Available in both FREE and PRO editions.
| Name | This is a name of the field. |
| Input Required | Whether the input is required or not. |
| Number of Lines | Whether to make the input field multi-line or not. |
| Width of Input Field | Select the width of the input field. |
| Placeholder | You can specify a placeholder to be displayed in the unentered state. It is normal to display an input example. |
| Note | This is a note of the field. * About fields that can write HTML. |
Memory
This component memorizes data when the form is submitted. And when the customer visits the form again, then it fills the form with the memorized data.
The target components of memorization are: Name, Mail Address, Phone Number and Address.
PRO edition only.
| Visibility | Whether to display this input field or not. Since this component works even if it is invisible, you can have it memorize without question asked. |
| Name | This is a name of the field. Since this component is displayed as a checkbox, you should name it as something like “Memorize input data”. |
| Initial Value | You can select the default value. |
| Note | This is a note of the field. * About fields that can write HTML. |
| Duration of Retention | The period of time for which the input is stored. |
Html
This component inserts the arbitrary HTML fragment into the form.
PRO edition only.
| Content | Input the HTML content. * About fields that can write HTML. |
| Always Show | If you select “Yes”, the content will be displayed on the confirmation screen as well. If you choose “No”, the information will only be displayed on the input screen. |
reCAPTCHA v3
Adds Google’s reCAPTCHA v3 to the form. The input field will not be displayed.
Available in both FREE and PRO editions.
Google reCAPTCHA v3 scores the humanity of a sender on a scale of 0 to 1 when a form is submitted.
This component processes the score into three levels: Pass, Soft-Pass, and Failure.
| Site Key | You can get it from the reCAPTCHA console. |
| Secret Key | You can get it from the reCAPTCHA console. |
| Action | A string that identifies the user’s action. Refer: Actions |
| Soft-Pass Score | If the score is lower than the number specified here, the rating will be Soft-Pass. In this case, AForms Eats will not trust the order and will skip the notification email to the administrator. This rating is not visible to the customer. |
| Failure Score | If the score is lower than the number specified here, the rating will be Failure. In this case, AForms Eats will block the order and the customer will receive an error message. |
About fields that can write HTML
AForms Eats has complete programmatic control over the HTML in the form.
So, although there are some fields where you can write HTML, you can only write static HTML in them.
You cannot write javascript or css. It also does not support embedding shortcodes.
Furthermore, you cannot use jQuery to change the DOM of the form from outside.
Also, the strings you write here will be checked by the security function of WordPress, and any parts that are deemed dangerous will be removed.
For example, the block property and the opacity property of css written in the style attribute will be removed.
You can write names of the css-class freely, so it is recommended to use external CSS for styling.
en_US
ja
AForms
AForms Eats