Sidebar

startup_tutorial_and_checklist:usability_configuration:features_within_listing_details_page:placement_tags

Placement Tags Within Listing Details Template

Each listing will have many bits of information needed to display that are unique to that listing. You also want to control the display of those elements in an appealing and organized way. So within the system we create one template to control the look and organization of the listing display page using html and css. Once we have a design we like there then needs to be a way to place the listing's data within that design where we want that data to appear. For that we use placement tags for each individual piece of data. By placing those tags within the listing details template you are able to make that bit of information display where you want in that design. Those placement tags are essentially "place holders" where specific data for an individual listing will be placed within that template for display of that listing.

Below is an example of a way we we may want to display our listing title in our html/css design contained within our template:

<div><h1>this is the title for my listing</h1></div> 

But as we've said above we need a way to display the current listings title within that position where the html designer/design wants that title to display. So within the above code we need a simple tag as a placeholder for the title. So to tell the software to place the title where we want it to appear in the html we use a placement tag like:

{$title}

And when we place that into the html where we want the title to appear we get the following:

<div><h1>{$title}</h1></div> 

So first you get a look that you want through the creation of an html/css based template. Once you have the look you want you simply place the data tags where you want that data to appear in that template/design.

Within the software the listing display page is a single "page" in the system. On that one page you are able to set the template used on that page and then within that template control the look/feel of all listing details page. Within the default template set design we use the following templates to control the look of classifieds and auctions on the client side:

/main_page/listing_classifieds.tpl
/main_page/listing_auction.tpl

And within those templates html we place the placement tags (the title above is one example) to place any individual listings data within that design. Within that template we need to be able to place all the possible data a listing can have. That requires many placement tags and there is one tag for most individual pieces of data that can be attached/within a listing. Since there is a lot of distinctive data that can be placed within a listing there are a lot of distinctive tags that can be used. There's enough that we created a page in the admin tool to show all of them. You'll find them on the bottom of this page in the admin tool:

PAGES MANAGEMENT > BROWSING LISTINGS > LISTING DISPLAY PAGE

On that page in the admin tool you'll find the full list of possible placement tags as well as an indication if that tags is currently found in either of the listing details template assigned to the listing details page.

startup_tutorial_and_checklist/usability_configuration/features_within_listing_details_page/placement_tags.txt · Last modified: 2015/08/12 17:51 by geojames