bdListings

The bdListings snippet can be used to present search results, a generic listing overview and more.

Snippet Properties¶

General Properties¶

Filtering Properties¶

Tip: by default each of these are accepted as URL properties (or POST values) so they are great to offer as filtering options to your site visitor.

Templating Chunks¶

tplOuter¶

Wraps around all the individual items.

Default:

[[+wrapper]]

Accepted properties:

• wrapper: all individual items contained in their tplRow chunk, separated by the rowSeparator separator.
• total: the total amount of items in the result set.

tplRow¶

Used to output a single listing.

Default:

<div>
    <h2>
        [[+redirect_url:notempty=`<a href="[[+redirect_url]]">[[+title]]</a>`:default=`[[+title]]`]]
    </h2>
    [[+images:notempty=`<p>[[+primaryimage:notempty=`<img src="[[+primaryimage:phpthumbof=`w=300&h=200`]]" alt="[[+title]]" /><br />`]] [[+images]]</p>`]]
    <p>In [[+city]] - [[+neighborhood]] - [[+companyname]] - <a href="[[+redirect_url]]">[[+companyname]]</a></p>
    [[+description:notempty=`<p>[[+description:nl2br]]</p>`]]
    [[+googlemap_url:notempty=`<a href="[[+googlemap_url]]" title="View on Google Maps"><img src="[[+googlemap_static]]" alt="Google Maps"></a>`]]
</div>

There's a lot of placeholders you can use there, and some properties have a direct influence on their value. Especially think of the redirect_url (which is influenced by &redirectResource) and the googlemap_static placeholder which is a link generated based on the staticMap* properties (see further below).

Placeholders:

• title
• description
• keywords
• price
• pricegroup / pricegroup_id (id)
• pricegroup_display
• category / category_id (id)
• category_name
• category_description
• subcategory / subcategory_id (id)
• subcategory_name
• subcategory_description
• target / target_id (id)
• target_name
• createdon (use with strtotime and date output modifiers)
• publisheduntil (use with strtotime and date output modifiers)
• active (1/0)
• featured (1/0)
• extended (1/0)
• companyname
• contactinfo
• address
• phone
• email
• neighborhood
• zip
• city
• country
• website
• latitude
• longitude
• clicks
• views
• googlemap_static: url to a static google map image (based on your map snippet properties, see further below). Empty if no lat/long is set.
• googlemap_url: url to maps.google.com/maps?q=LATITUDE,LONGITUDE. Empty if no lat/long is set.
• redirect_url: url to the &redirectResource resource with the "lid" property and the listing ID as its value, used to redirect to the website set for the listing while tracking clicks. Empty if no website is set.
• images: filled with individual images templated with the tplImage chunk, separated by the imageSeparator property.
• primaryimage: if you have an image marked as primary, this will have the link (so not the tplImage tpl) to the image. If you don't have an image marked as primary it will attempt to use the first image.
• primaryimagepath: path to the image set in primaryimage.

tplImage (lower L then upper i)¶

Used to wrap around images inside a listing. (not used for the primaryimage property in the tplRow chunk)

Default:

<img src="[[+image:phpthumbof=`w=150&h=150&zc=1`]]" alt="[[+caption]]" />

Placeholders:

• image
• imagepath
• caption
• sortorder
• listing (id)
• primary (1|0)

Static Map Properties¶

In the tplRow chunk there's a googlemap_static placeholder. That's a simple image showing a map with the listing centered with a marker. The following properties influence its behavior, and I would suggest reading up on the Google Maps Static API if you are looking for more in-depth explanation of what goes on behind the scenes.

Examples¶

Last 5 listings, simple list format:

<h3>Lastest 5 Ads</h3>
<ul id="latest_ads">
[[!bdListings? &sort=`{"createdon":"DESC"}`  &tplRow=`bdl.listings.list` &limit=`5`]]
</ul>

bdl.listings.list chunk, pointing to resource 14 (search results page which has an uncached bdListings call on it and accepts URL parameters) with the listing ID as filter, meaning it will only show the one listing.

<li>
  <a href="[[~14? &listings=`[[+id]]`]]" title="[[+title]]">[[+title]]</a>
</li>