• view_type: "grid", "list", "map" (display layout)
  • pagination_type: "pagination", "carousel" (navigation method)
  • filter_layout: "top", "sidebar" (filter position)
  • sort_by: "date-desc", "date-asc", "views-desc", "rating-desc", "review-count", "title-asc", "title-desc", "price-asc", "price-desc", "rand"
  • display_listings: "", "featured" (show all or only featured)
  • rating: "1", "2", "3", "4", "5" (minimum rating filter)
  • per_page: number (items per page, default: 6)
  • custom_directory: comma-separated directory slugs (e.g., "restaurants,hotels")
  • categories: comma-separated category slugs (e.g., "italian,chinese")
  • locations: comma-separated location slugs (e.g., "new-york,chicago")
  • tags: comma-separated tag slugs (e.g., "popular,trending")
  • grid_columns: number (1-12, grid columns for grid view, default: 3)
  • list_columns: number (1-12, columns for list view, default: 2)
  • grid_columns_gap: CSS value (gap between grid items, e.g., "15px")
  • list_columns_gap: CSS value (gap between list items, e.g., "15px")
  • post__not_in: comma-separated post IDs to exclude (e.g., "12,45,67")
  • directory_dropdown: number (2-20, show dropdown after this many directories, default: 5)
  • uniq_id: unique identifier for multiple instances (auto-generated if empty)
  • carousel_settings: JSON string (see Carousel Settings Examples below)
  • Boolean switches: "true", "false" for: filter_show, ajax_filter, top_bar_show, reset_filter, sort_by_show, view_bar_show, has_map_view
  • Note: Leave custom_directory empty to show all directories, or specify directory slugs to filter
  • Note: Tags parameter accepts both slugs and IDs (will be converted automatically)
  • Note: Categories and locations now use shared taxonomies across all directories

  • tax_type: "categories", "locations" (type of taxonomy to display)
  • pagination_type: "pagination", "carousel" (navigation method)
  • order: "ASC", "DESC" (sorting direction, default: "DESC")
  • orderby: "name", "slug", "term_id", "term_order", "count" (sorting criteria, default: "count")
  • per_page: number (items per page, default: 10)
  • custom_directory: comma-separated directory slugs (e.g., "restaurants,hotels")
  • terms: JSON string keyed by taxonomy (e.g., '{"adqs_category":"italian,chinese"}'). Slugs are sanitised automatically.
  • Example (single category): terms='{"adqs_category":"restaurants"}'
  • Example (multiple locations): terms='{"adqs_location":"new-york,los-angeles"}'
  • column_basis: CSS value (flex-basis for grid items, e.g., "25%")
  • column_gap: CSS value (gap between grid items, e.g., "20px")
  • directory_dropdown: number (2-20, show dropdown after this many directories, default: 5)
  • uniq_id: unique identifier for multiple instances (auto-generated if empty)
  • carousel_settings: JSON string (see Carousel Settings Examples below)
  • Boolean switches: "true", "false" for: ajax_filter, top_bar_show, search_bar_show
  • Note: When custom_directory is specified, only terms from those directories will be shown
  • Note: The terms parameter allows filtering to specific taxonomy terms only

  • search_page_url: URL to redirect search results (e.g., "/all-listings", "/search-results")
  • custom_directory: comma-separated directory slugs (e.g., "restaurants,hotels")
  • directory_dropdown: number (2-20, show dropdown after this many directories, default: 6)
  • new_tab: "true", "false" (open search results in new tab, default: "true")
  • display_categories: "true", "false" (show/hide the Categories dropdown, default: "true")
  • display_locations: "true", "false" (show/hide the Locations dropdown, default: "true")
  • Note: If search_page_url is empty, the All Listings page set in plugin settings will be used
  • Example URLs: "/all-listings", "/search", "https://yoursite.com/search-results"

  • per_page: number (1-100, agents per page, default: 8)
  • ajax_filter: "true", "false" (enable/disable AJAX filtering, auto-detected from settings)
  • nav_bar_show: "true", "false" (show/hide navigation bar with pagination, default: "true")
  • search_bar_show: "true", "false" (show/hide search bar for filtering agents, default: "true")
  • sort_by_show: "true", "false" (show/hide sort by dropdown, default: "true")
  • reset_filter: "true", "false" (show/hide reset filter button, default: "true")
  • directory_dropdown: number (2-20, show dropdown after this many directories, default: 4)
  • Note: Agents are automatically filtered by directory type if multiple directories exist
  • Sorting: Agents can be sorted by name, date, and other criteria via sort_by_show dropdown

  • arrows: true/false (show navigation arrows)
  • dots: true/false (show dot indicators)
  • autoplay: true/false (auto-advance slides)
  • autoplay_speed: number in milliseconds (3000 = 3 seconds)
  • animation_speed: number in milliseconds (300 = 0.3 seconds)
  • pause_on_hover: true/false (pause autoplay on hover)
  • center_mode: true/false (center current slide)
  • center_padding: "50px" (padding for center mode)
  • rows: number (multiple rows, default: 1)
  • fade: true/false (fade transition instead of slide)
  • focusonselect: true/false (focus on click)
  • vertical: true/false (vertical sliding)
  • rtl: true/false (right-to-left direction)
  • infinite: true/false (infinite loop)
  • display_columns: number (items to show)
  • scroll_columns: number (items to scroll at once)
  • tablet_width: number (tablet breakpoint in px, default: 750)
  • tablet_display_columns: number (items on tablet)
  • tablet_scroll_columns: number (scroll count on tablet)
  • mobile_width: number (mobile breakpoint in px, default: 480)
  • mobile_display_columns: number (items on mobile)
  • mobile_scroll_columns: number (scroll count on mobile)
  • Note: carousel_settings must be a valid JSON string
  • Usage: Only works when pagination_type="carousel"
  • Example: carousel_settings='{"arrows":true,"dots":false,"autoplay":true}'