- 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}'