Horizontal Listings

[seymourjames +]

This kind of comes up from time to time on the forum and I am also asked regularly. I take the liberty of publishing it here. The full functionality available through this module is as follows. So many combinations are available.

Examples of using the horizontal listings plugin as used the on home page to produce listings in a horizontal row.


{css_listings_horizontal type="featured" number="5" category="2"} - 5 featured adverts from category number 2

{css_categories_list number="5"} - 5 random adverts from all categories

{css_listings_horizontal number=3 type="featured" category=$categoryid} - 3 featured adverts from the current category when variable available (usefully placed on browse page).

category: accepts integer, i.e. category="1", limits results to a specific category id
number: total number of listings, i.e. number="12", limits a specific number of results
owner: accepts integer, i.e. owner="2", limits results to a specific owner
show_price: display the price, yes by default, accepts "Y" or "N", i.e. show_price="Y"
type: kind of listing you want, featured and newest by default, accepts:

random: random listings, i.e. type="random"
new: new listings, i.e. type="new"
featured_new: new featured listings, i.e. type="featured_new"
featured_top: top featured listings, i.e. type="featured_top"
top: top listings, i.e. type="top"
anything else defaults to random featured listings

lfilter: filter results by location filter module, i.e. lfilter="on"

list: retrieve an unordered list vs image type display
class: assign a class for the unordered list (requires list to be requested)
truncate: defaults to off, set to true if you wish to truncate the title
truncate_start: defaults to 0, starting position if truncate requested
truncate_end: defaults to 50, ending position if truncate requested
truncate_suffix: no default, if a string such as '...' is passed as this variable, after the end position this will be appended to the title.
truncate_encoding: defaults to system encoding, 'UTF-8'
image_width: defaults to 100px, sets the thumbnail width to desired size (px)
image_height: defaults to 86px, sets the thumbnail height to desired size (px)

CSS Categories List Plugin Parameters:

number: defaults to 5, number of popular categories to consider, limits number of results
show_count: defaults to 'Y', displays the number of listing hits per that specific category
show_percent: defaults to 'N', displays the percent of total hits per that specific category
class: defaults to 'sidebar_nav', can override the unordered list css class.