User Tools

Site Tools


Sidebar

startup_tutorial_and_checklist:feature_configuration:field_configuration:standard_fields:address_fields

Address Fields

These fields contain address data for a listing.

The specific address fields are:

  • address
  • city (when not included as a level in the region data)
  • zip/postal code

Highlights:

  • The data for these fields is automatically pulled from the seller's registration data when they first place a listing
  • The seller can override any of these values within any individual listing if you use the fields
  • The same address data in these fields is automatically placed in the mapping field when a listing placement process is started.
  • The city field can be included as a level in the region field configuration.
  • If city field is overridden by a region level the blank city field will not appear.
  • If city field is used and not overridden by a region level the city field will be a text box for the seller to fill in.

The values in these fields along with the country and state field of the region configuration are duplicated within the mapping location field when a seller begins a listing placement process. Of course all field data can be overridden by the seller for any individual listing within the place a listing process.

Where Do You Manage Address Fields

Use On The Site

The controls found to turn on/off the use of these fields are found within the following admin tool:

LISTING SETUP > FIELDS TO USE

shown in the following screen shot within the "main settings" tab of the above admin tool:

If the city field is overridden by a region level it will be grayed and labeled as such in the above admin tool.

Display Within Specific Features

You control their display within client-side features using the field display configurations within the same admin tool above. You can control their display within:

  • category browsing feature
  • all modules that display listings like newest, featured and hottest listing modules
  • all featured pic modules
  • and within certain addons that display listing data

Look to the following screenshot and the corresponding tabs within it for more:

Display Within Listing Details Page

There is no admin tool to force display of these fields within the listing display page. That is the full details page you see when you click on a listing to view it. To place these fields for display within your listing details page you would place the following placement tags where you want them to appear in the details templates used on that page. The default design templates these would display in are the two following templates. One template is used when displaying the details of a classified and the other the details of an auction:

/main_page/listing_classified.tpl
/main_page/listing_auction.tpl

You can of course create your own templates but whichever you use the following placement tags would be placed within that template to display this address data:

{$address_label}
{listing field='address_data'}
{$city_label}
{listing field='city_data'}
{$zip_label}
{listing field='zip_data'}

Even if you are using the country and state fields in the region feature you can still use the following tags to display that data where it would be relevant to display with address data:

{$state_label}
{listing field='state_data'}
{$country_label}
{listing field='country_data'}
startup_tutorial_and_checklist/feature_configuration/field_configuration/standard_fields/address_fields.txt · Last modified: 2016/10/06 15:14 by geojames