In this section you will learn how to:

By default, there are two listing input forms in the system:

See the default listing input form for 'Homes for Sale' listing type on the Pic.1. The listing input forms use the syntax which you can see in the notes (Pic.1.) to display the fields.

The administrator can change field names, add new fields to this form and modify the look and feel of a field.

Pic.1. Default Listing Input Form.

Change a Caption of a Field

For instance, you want to change 'Price $' to 'Selling Price $' and 'Baths' to 'Number of Baths' on the 'Add Listing' page (Pic.1.).

The 'Baths' field is a common field for all listing types.

To find common fields:

To edit a field caption:

The field caption will change automatically in the template (see Pic.2).

The 'Price' field is a specific field for the 'Homes for Sale' listing type.

To find specific fields:

To edit a field caption:

The field caption will change automatically in the template (see Pic.2).

Notice: If you change IDs of the existing fields, you will have to change them in the templates, where these IDs are used.

Pic.2. Changed Names of the Existing Listing Fields.

Add New Listing Fields

To add a new field, e.g., 'Distance to Downtown' field (float type):

To display this field after the 'Baths' field on the listing input form:

    <tr>

            <td>{$form_fields.Baths.caption}:</td><td colspan="5">{input property=Baths}</td>

    </tr>

    This code displays the 'Baths' field (its caption and input box). (Pic.3.)

    <tr>

            <td>{$form_fields.DistanceToDowntown.caption}:</td><td>{input property=DistanceToDowntown}</td>

    </tr>

These lines display the 'Distance to Downtown' field (its caption and input box). (Pic.3.)

If you don't specify your own template for this field, this field will be displayed like in the default template (float.tpl). Pic.3 shows how the field will look like:

Pic.3. Added Listing Field.

Modify the Look and Feel of a Field

The look and feel of a field is determined by templates of a relevant field type. These templates are located at /templates/[Theme Name]/field_types/input . This folder contains a set of templates for each database field type.

To display input form fields, use the following syntax:

{input property = [Listing Field ID] template = [Your Template Name]}

If you do not specify the template (template = [Your Template Name]), the system will display the default template of a type.

E.g., the 'Price' field is the integer type and you specify {input property = Price}. As a result, the 'Price' field will be displayed according to its default template: /templates/[Theme Name]/field_types/input/integer.tpl.

To alter the way a listing field  looks like, e.g., 'Drive Type' field (list type):

{foreach from=$list_values item=list_value}

    <input type="radio" name='{$id}' value='{$list_value.id}' {if $list_value.id == $value}checked{/if} > {$list_value.caption}

{/foreach}

<td colspan="5">{input property=Beds}</td>

<td colspan="5">{input property=Beds template='list_radio.tpl'}</td>

The 'Beds' field will be displayed as on Pic.4.

Pic.4. Alter the Way a Listing Field Looks Like

Note: The above changes to the 'Add Listing' page (the listing input form) will be also displayed on the 'Edit Listing' page.