Skip to main content

Listing

[babe-listing]

Displays a list of booking items (tours, apartments, services, etc.) with dynamic filters. Commonly used for catalogs or selections like "Popular Tours" or "Recently Added Items". Example

 

img

Parameters​

All parameters are optional

Main options

  • title="Title of the listing" - text that appears at the top of the listing
  • per_page="3" - number of booking items that are displayed per page. If not specified, the setting is taken from the taxonomy archive settings in BA Settings → General admin menu
  • pagination="0|1" - possible values: 0 (default) or 1; whether (1) or not (0) to add a pager to the bottom of the list
  • date_from="", date_to="" - show only those objects that have available dates in the specified range. Must be specified in the d/m/Y or m/d/Y format according to the Date format setting in BA Settings → General admin menu
  • with_sorting_option="0|1" - possible values: 0 (default) or 1; whether to display a drop-down sorting list
  • category_ids="1,2,3" - IDs of booking categories
  • term_ids="1,2,3" - IDs of custom taxonomy terms
  • ids="1,2,3" - IDs of booking object posts
  • filter_taxonomies="1,2,3" - IDs of taxonomies that should be included in the dynamic filter
  • not_scheduled="0|1" - display not scheduled booking items only
  • group_results_by_date="0|1" - possible values: 0 (default) or 1; whether (1) or not (0) to group search results by availability calendar dates. Typically used when sorting by availability date (av_date_from)
  • without_av_check="0|1" - possible values: 0 (default) or 1; whether (1) or not (0) to skip booking item availability check
  • post_author="1" - show only booking items from the author with this ID

Sort options

  • sort - sort by one of the following criteria:
    • price_from - by price (default)
    • rating - by rate
    • post_title - by booking item post title
    • av_date_from - by the nearest available date
    • post_date - by post creation date
    • post_modified - by post modified date
    • menu_order - by "sort order" option of the post
  • sortby
    • ASC — ascending (default)
    • DESC — descending

Style options

  • view="grid|full" - style of the booking item preview blocks: grid (default) or full (list)
  • bg_img_id="", bg_img_url="" - set a background image for a listing section by specifying an image ID or URL from the site media library
  • fa_icon="" - Font Awesome icon class to display an icon in the section header next to title
  • classes="" - comma separated additional classes to add to the shortcode html
tip

More about shortcodes in the WordPress codex