Adding a new custom field is simple. When you're in Mosets Tree's back-end, click Custom Field and click New icon on top.

 

A 'Custom Field: New' page will appear. First thing you want to do is choose the type of custom field you would like to create. Below are the explainations on each of the available options here.

Caption

Caption is the name of the custom field. Every custom field must have a caption as it uniquely identifies the field to the users and admin. Caption should be short and precise. Sometimes, certain fields are self-explanatory and caption is not needed. Checking the Hide Caption checkbox will disable the caption from appearing.

Field Elements

Some fields such as Select List, Select Multiple, Checkbox and Radio Button requires multiple choices to allow users to choose one of more selection. Field Elements is where you enter these choices, or elements. Elements has to be entered one after another, separated by the pipe character '|'. ie: Yes|No.

Prefix and Suffix text to display during field modification

This option allow you to display additional information about a field when user is adding or modifying a listing. Prefix text will appear before a custom field while suffix text will appear after a custom field.

Prefix and Suffix text during display

The function is similar with above with the exception that these only appears during output in front-end. This is useful when you're displaying values that has associated metrics. ie: kg, acres etc.

Size

Size allows you to define the size of a custom field. For example:

• Text: Length of the input field
• Multiline Textbox: Number of rows of the textbox
• Select Multiple: Number of selections to display before a scrollbar appears

Published

This is the main switch that disable or enable the use of a particular custom field. Setting this to No will remove it from view in the front-end and edit page. This however will not remove the data entered to the field.

Shown in details view

Data entered to a field is displayed in 2 places in the front-end - Details view and Summary view. This option allows you to configure if a custom field is displayed in the details view.

Shown in summary view

Similar to above, except that this option allow you to configure if a custom field is displayed in the summary view.

Simple Searchable

Mosets Tree provides 2 methods to search for listings. One of them is Simple Search. This is provided by mod_mt_search module and consist of a single text input field. When users search through this module, the search word will be matched against fields that are marked as Simple Searchable. If you would like a field to be simple searchable, set Yes for this option.

 

It is not advisable to have too many fields set to simple searchable, as it will affect the speed of the searches. It is recommended to have only Name and Description field set as simple searchable.

Advanced Searchable

The second search method is Advanced Search which appears in a dedicated page. This page is accessible through a link in mod_mt_search. Advanced search allow users to locate listings that meet specific criteria. Set this to Yes if you would like a field to appear in Advanced Search page.

Required Field

Setting Required Field to yes ensure that data is entered to a custom field before user can proceed to save a listing.

Hidden Field

Setting Hidden Field to yes will make this field unavailable during front-end editing. You can still however display this field in details and summary view (configured above). To completely hide a field in the front-end, you need to remove it from details, summary view and select 'No' for Simple Searchable and Advanced Searchable.