Directorist 7.0 brings a lot of changes to improve the performance of the plugin as well as make it much more user-friendly. Using custom fields on the Add Listing page is one of the significant changes. Now, it is easier to use this feature to build the Add Listing form quickly using the drag and drop feature, besides it allows users to add two new fields, number and file upload. These features will help users to build a dynamic Add Listing form according to their custom requirements more efficiently.
Adding a custom field
To add a custom field on the Add Listing form navigate to WP Admin Dashboard → Directory Listings → Directory Builder → Add Listing Form → Form Fields. You will see a screen like below where you will locate two different field types on the right side of the screen named Preset Fields & Custom Fields.Add new custom fieldOn the custom fields section, you will find 11 different types of custom fields. Those are Text, Textarea, Number, URL, Date, Time, Color, Select, Checkbox, Radio, and File Upload. You can easily drag and drop those fields into the Add Listing form template located on the left side.
Add new custom field
Description of fields options
There are some common options located in any type of custom field, they are editable, so users can change them according to their requirements.
Label:This is the main title of the field, which is going to show in the frontend. Users will acknowledge the field according to the value of the label.
Key:This an also a very important factor for a field. Key is going to be used as meta key of this field. The value will save in the database using this key. So, this will be mostly used by developers and this needs to be a unique value.
Placeholder:A placeholder will determine a default temporary value, that will show in the frontend. This is mostly used for instruction or example of certain field data input policies. For example, a phone number field placeholder shows a default phone number as an example.
Description:You can give some detailed instructions or the purpose of the field by using the Description. This description will appear in a nice tooltip beside the field name. So, it will not take space nor will it look ugly.
Required:If you want to make this field mandatory for users to fill up with data then you need to make it required, this will give the Add Listing form validation. Users will not be able to submit any listing without filling any value in this field.
Only for Admin Use:This is also a useful option. If you want to use a custom field only in your admin panel and do not want to give access to the other users you can this option. This will make sure your front-end Add Listing form will not provide this field, you can only control it from the admin panel.
Assign to:If you want to use a field for a specific category of listing, this option will help you out here. You can select a category to assign this field only for the particular categories. If you want to use the custom field for all kinds of listing, just assign it to `Form` to show this field to any listing. This is a very useful option for websites with a lot of different types of listing.
Description of the Field Types:There are 11 different types of field types to decorate your Add Listing Form and make it more functional. These field types will help you to collect more different types of data in an easier way. Let’s have a detailed look at these field types.
Text FieldThis is the most common field, with the very simple purpose of inserting some text through this field. Most of the time users tend to use this field to insert small data into their database. This is very easy to configure by using common field options from the description stated earlier.
Textarea FieldIf you want to insert some descriptive information in the listing you can definitely use Textarea Field to fulfill your purpose. You can also determine how many rows are going to show on the field.
Number FieldWhen you need to insert some number into your listing you can use this Number Field. This field allows your users to insert only numbers but nothing in this field, this validates out other types of values but a number from this field.
URL FieldThis field is designed to input only a link or website URL to the form. This will validate the input value and check whether it is an URL or not. You are also able to determine the provided link will open in the current tab or a new tab.
Date Field
The date field made it easier to input a date by providing a date selection dropdown. It also validates the input by checking whether it is a date or not.
Time Field
Similar to the date field, the time field also provides a time selection dropdown which makes it easier for the user to select a time for the field. It also validates the field with time so users can not put any other value but time.
Color Field
The color field appears with a color picker, so the user can select a color from the picker window, and then the color code will save from it. Users do not need to collect the code and input it here. This is a very easier and effective way to input color into the form.
Select Field
Select Field allows users to select an option from a dropdown field. You can list your select options on the editor and those options will appear on the Add Listing Form. This is now very easy and quick to list down your options on the editor.
Checkbox Field
Creating a checkbox is very similar to the select field creation. You need to put some options for the checkbox exactly like the select field. This will create a nice checkbox on Add listing form.
Radio Field
Radio field’s options are similar to checkbox field options, also settings are easy to use. You can put some options and then it will show a radio field on the Add listing form.
File Upload Field
File upload is a brand new field in version 7.0. It was not present in older versions. It allows users to upload different types of files. This file upload field will be beneficial for users to make their listing more effective.
Showing Custom Fields on the Single Page Layout
After adding a custom field into the form this will show on the add listing form but this will not show on the single listing page.
If you want to show your custom field on the single listing page you need to go to the Admin menu -> Directorist Listings -> Directory Builder -> Single Page Layout -> Content section. You can see that your created custom fields are already there on the right side in the available preset fields section. Now you can drag and drop those fields to your page layout, and these will show on the single page.
That's how you can add custom fields on Add Listing Page and on Single Listing Page.
Add new custom field
Description of the Field Types:
There are 11 different types of field types to decorate your Add Listing Form and make it more functional. These field types will help you to collect more different types of data in an easier way. Let’s have a detailed look at these field types.
That's how you can add custom fields on Add Listing Page and on Single Listing Page.