Listing template edit add field

Edit My Account

Edit My Listings

Edit All Listings

User Manager

Page Editor

Edit Agent Template

Edit Member Template

Edit Listing Template

Property Classes

Site Configuration

View Site Log

This screen is for the Listing Template Editor for Editing or Adding a field. The only difference will be when editing you'll have the Update and Delete buttons and when adding you will have an Add Field button.

General Options

Field Name - This is the name of the field as it will be stored in the database.

Field Type - The Type of field that this is. Field Type effect the Add listing and Edit listing forms that agents fill out. (Text, Textarea, select list, select box, etc....)

• Text - Provides agents with a standard text box to enter data into.
• Textarea - Provides agents with a larger text box to enter data into. Use full for things like remarks.
• Select - Provides agents with a drop down list based on the field elements, from which they can select one option.
• Select Multiple - Provides agents with a drop down list based on the field elements, from which they can select multiple options.Option Box
• Option Box - Provides agents with a list based on the field elements with radio options next to each item, from which they can select one option.
• Check Box - Provides agents with a list based on the field elements with radio options next to each item, from which they can select multiple options.
• Divider - Creates a divider "---------------------------" in place of the field to help break up a edit listing or add listing page's layout. No real data can be entered into this field.
• Price - Provides agents with a standard text box to enter a price into. Price should be entered without any money sign, commas, or decimals. The money sign will prefix the text box in the add listing page and ".00" will suffix it. This also tells the system to format the price as setup in the site config for all listing display pages.
• URL - Provides agents with a standard text box to enter a URL into. Agents should enter the full url including http:// the system will then create a hyperlink for then on the listing pages with from this URL.
• Email - Provides agents with a standard text box to enter an email address into. Email address will be clickable links on the listing page. NOT RECOMMENDED TO USE, as spam bots can easily read thsi address from your page and start spamming the email address entered.
• Number - Provides agents with a standard text box to enter a number value into. Will be formated with decimal points as setup in site config.
• Decimal - Provides agents with a standard text box to enter a decimal value into. Same as number, except meant for values that will always have a decimal value.
• Date - Provides agents with a standard text box to enter data into, will show and enforce the required date format as defined in the site config.
• Latitude - Provides agents with a standard text box to enter a latitude into. There can only be one latitude field defined. It is used by teh search engine when doing distance searches and by some mapping add-ons such as TransparentMaps.
• Longitude - Provides agents with a standard text box to enter a latitude into. There can only be one latitude field defined. It is used by teh search engine when doing distance searches and by some mapping add-ons such as TransparentMaps.

Required - Is this field required to be filled out?

Field Caption - The Caption for the field that will be displayed to users.

Field Elements - The choices for multiple selection Field Types such as select lists, option boxes etc. Each choice should be seperated by double pipes (||) Do not uses spaces or returns after each option, run them all together as one line. For example: Option 1||Option 2||Option 3||Option 4

Default Text - The Default text to be displayed in this field

Field Tool Tip - Add a tool tip to the field that will display a question mark icon next to the field in the listing editor/add listing page so users can click on the icon and obtain information/tips regarding completing the field.

Maximum Field Length - Configure the maximum number of characters that can be entered into the field.

Field Tool Tip - New in 2.4.4 - Adds a tool tip to the add/edit listing pages for the field. (note: requires new css settings. If upgrading or using a custom template, you can copy the a.tooltip... classes from the vertical-menu style.css file.)

Maximum Field Length - New in 2.4.4 - Maximum number of characters that can be entered into this field. Applies to text, price, url, email, number, latitude, longitude, and decimal field types.

Show Field to - Use this option to restrict who will see this field. If you have the field set to display on your site using one of the template areas or individual field rending template tags then this will determine who will see this field. Available options are:

- All Visitors - Everybody will be able to view this field.

- Members and Agents - Only registered users of your site can see this field.

- Agents Only - Only Agents will be able to view this field.

- Admin Only - Only Admins will be able to view this field on the front end of the site.

Avaliable in the following property classes - Use this option to select which property classes this field will be available in. You can select multiple classes by clicking and dragging or by holding down the "Ctrl" key while clicking.

Listing Page Options

Location on Listing Page - On the listing view page, the section of the template this field will appear in.

Field Order on Listing Page - The rank of this field on the Listing view page, the lower the number the higher on the list it will appear

Search Page Options

Allow Searching - Check this option to make the field seachable

Field Order on Search Page - The rank of this field on the Search page, the lower the number the higher on the list of options it will appear

Search Label - The Label for this field that will appear on the Search Page.

Search Type - The type of search field that should be used for this field.

• Partial Text Match - This search option presents the user with a text box to enter text into. It will then find any listings where this field contains the entered text.
• Option list of individual values - Builds a option list, that allows multiple selections, based on the field elements for this field. This option requires that a listings have ALL the selected options to be returned in the search results.
• Option list of individual values (OR search logic) - Builds a option list, that allows multiple selections, based on the field elements for this field. This option will return a listings has ANY of the selected options.
• CheckBox list of individual values - Builds a list of options from the field elements with checkboxes next to each item. This option requires that a listings have ALL the selected options to be returned in the search results.
• CheckBox list of individual values (OR search logic) - Builds a list of options from the field elements with checkboxes next to each item. This option will return a listings has ANY of the selected options.
• Pull down list of individual values - Builds a pulldown list, that allows a single selection, based on the field elements for this field.
• Distinct list - allow multiple - Builds a option list, that allows multiple selections, based on the actual field values for the existing listing. This option requires that a listings have ALL the selected options to be returned in the search results.
• Distinct list - allow multiple (OR search logic) - Builds a option list, that allows multiple selections, based on the actual field values for the existing listing. This option will return a listings has ANY of the selected options.
• Pull down menu, 1 selection only - Builds a pull down list, that allows a single selection, based on the actual field values for the existing listing.
• Checkbox list of distinct values - Builds a list of options, based on the actual field values for the existing listings, with check boxes next to each item. This option requires that a listings have ALL the selected options to be returned in the search results.
• Checkbox list of distinct values (OR search logic) - Builds a list of options, based on the actual field values for the existing listings, with check boxes next to each item. This option will return a listings has ANY of the selected options.
• Radio button list of distinct values - Builds a list of options, based on the actual field values for the existing listings, with radio options next to each item. Radio Options allow only a single selection to be made.
• Two pull downs for min/max ++ - Builds two drop down boxes, one for the user to select the minimum value from and one drop down for the maximum value. Builds the drop down by looking at the minimum value in the database and the maximum and then placing incremental values based on the Step value specified by the user. For Example if the minimum value is 1 and the maximum is 10 and you specify a step value of 2 you will get drop downs with the following options. 1,3,5,7,9,10
• Date range; two text fields - Provides two text boxes to allow user to enter two dates. Will return any listings where the date for this field is between the dates entered by the user.
• Single/Exact Date Search - Provides a text boxes to allow user to enter a date. Will return any listings where the date for this field matches the date entered by the user.
• Search For Empty(NULL) Values - Provides a check box, if check will return only listings where there is NO value entered for this field.
• Search For Non Empty Values - Provides a check box, if check will return only listings where there is a value entered for this field.

++ Step by - If you used a range selection for the Search Type then this is the value to step each available option in the range by.

Search Result Options

Display on Search Results page - Check this option to make the field show up on the search results page.

Field Order on Search Results Page - The rank of this field on the Search page. It corresponds to the {field_#} tag in the search result template. So the field with a rank of 1 will be displayed in the {field_1} spot. Having multiple fields with the same rank will cause problems.