Dropdown
Adding a dropdown element to your WordPress form
Last updated
Adding a dropdown element to your WordPress form
Last updated
A dropdown element (also know as "select menu" or "select") is an element where a user can choose an item (or multiple items) from a list. For instance when you ask what color they want for their t-shirt, you could use a Dropdown element with different colors to choose from.
On the builder page, open the Form Elements panel. Search for the Dropdown
element, and drag it to your canvas. You can now edit the element and configure it as desired by following the settings and the descriptions.
By default a user can only select 1 item from the dropdown. If you require a user to be able to select multiple items or a maximum of X items, you can configure this by editing the Dropdown element, navigating to the Advanced section. And configuring the max/min selections.
By default a user is able to filter dropdown items by typing while the dropdown is opened (focused). In some use cases this might be undesired. In that case you can disable the filter by enabling "Disallow users to filter items" as shown below:
To populate the dropdown with taxonomy items e.g. Post categories (category), or WooCommerce product categories (product_cat) you can set the Retrieve method to "Specific taxonomy (categories)". Simply enter the Taxonomy slug. Optionally you can exlude specific category ID's to be excluded from the list. And to hide any empty categories as shown below.
To populate your dropdown with posts (or a custom post_type) you can set the Retrieve method to "Specific posts (post_type)". For example, you could return a list of WooCommerce products by entering products
. You may also filter based on post status, and define a limit. Ordering by title, date or other parameters is also possible.
If you require to exclude a product you may enter the post ID's separated by comma's.
When you wish to filter posts by a specific taxonomy then you can define each filter. For instance to only return products based on a the taxonomy books
and movies
, you can define a filter like so:
Alternatively you can filter based on tags like so:
Operators you may use are IN, NOT IN, AND, EXISTS
and NOT EXISTS
Since you are retrieving posts, you can also define what value you'd like to return for the dropdown items. For instance you can choose to return the Slug, ID, Title or some Custom post meta data (which allows you to return multiple values for a single item). Which allows you to use Advanced tags {fieldname;2}
as shown below, which returns both the product ID and Product price. Which can be retrieve with {fieldname;1}
and {fieldname;2}
respectively.
This element shares the same options as the Checkbox element + the following extra feature:
Distance / Duration calculation (google directions) setup instructions
Return distance in meters
Return duration in seconds
Return distance text in km/meters (metric) or miles/feet (imperial)
Return duration text in minutes