DocumentationOnline documentation for Ajax Load More
Parameters
Ajax Load More accepts a variety of query and styling parameters that are passed to WordPress via shortcode.
With the custom Shortcode Builder and over 40 unique parameters to choose from, creating your own Ajax Load More query is never more than a few minutes away!
Core Ajax Load More parameters are listed below:
| id | A unique ID for the Ajax Load More instance. Default = null |
|---|---|
| repeater | Select from a list of customizable repeaters (add-on available). Default = 'default' |
| post_type | Comma separated list of post types to query. Default = 'post' |
| sticky_posts | Preserve sticky post ordering in Ajax listing. Default = false |
| post_format | Query by post format. Default = null |
| category | A comma separated list of categories to include by slug. Default = null |
| category__and | A comma separated list of categories to include by ID. Default = null |
| category__not_in | A comma separated list of categories to exclude by ID. Default = null |
| tag | A comma separated list of tags to include by slug. Default = null |
| tag__and | A comma separated list of tags to include by ID. Default = null |
| tag__not_in | A comma separated list of tags to exclude by ID. Default = null |
| taxonomy | Query by custom taxonomy name. Default = null |
| taxonomy_terms | Comma separated list of custom taxonomy terms(slug) to query. Default = null |
| taxonomy_operator | Operator to compare taxonomy terms against (IN/NOT IN). Default = 'IN' |
| taxonomy_include_children | Whether or not to include children in the query results for hierarchical taxonomies. (true/false). Default = true |
| taxonomy_relation | The logical relationship between each taxonomy when there is more than one. (AND/OR). Default = 'AND' |
| day | Day of the week. Default = null |
| month | Month of the year. Default = null |
| year | Year of post. Default = 'IN' |
| meta_key | Custom field key(name). Default = null |
| meta_value | Custom field value. Default = null |
| meta_compare | Operator to compare meta_key and meta_value against (IN/NOT IN/=/!=/>/>=/</<=). Default = 'IN' |
| meta_type | Custom field type. Default = 'CHAR' |
| meta_relation | Used with multiple custom field entries (AND/OR). Default = 'AND' |
| author | A comma separated list of authors by id. Default = null |
| search | Query search term ('s'). Default = null |
| custom_args | A semicolon separated list of key:value pair arguments. e.g. tag_slug__and:design,development; event_display:upcoming. Default = null |
| post__in | Comma separated list of post ID's to include in query.Default = null |
| post__not_in | Comma separated list of post ID's to exclude from query.Default = null |
| order | Order posts ASC(ascending) or DESC(descending) order. Default = 'DESC' |
| orderby | Order posts by date, title, name, menu order, author, post ID or comment count. Default = 'date' |
| sort_key | The custom field key to use for sorting results by custom field value. Default = null |
| offset | Offset the initial query (number).Default = '0' |
| posts_per_page | Number of posts to load with each request.Default = '5' |
| scroll | Load more posts as the user scrolls the page (true/false)Default = 'true' |
| scroll_distance | The distance from the bottom of the screen to trigger the loading of posts while scrolling. Default = '150' |
| scroll_container | Constrain Ajax Load More infinite scrolling to a parent container. Default = null |
| scroll_direction | Set the direction Ajax Load More should scroll to load posts. Default = vertical |
| max_pages | Maximum number of pages to load while scrolling (only activated if scroll = true). Default = '0' |
| pause_override | Allow scrolling to override the Pause parameter and trigger loading on scroll. Default = null |
| transition | Select a loading transition. (fade/masonry/none) Default = 'fade' |
| transition_delay | Stagger the transition display of each post incrementally. Default = '0' |
| masonry_selector | The target classname of each masonry item. Default = null |
| masonry_animation | Select a loading animation type for Masonry items. (default/zoom-out/slide-up/slide-down/none)Default = default |
| masonry_horizontalorder | Lays out items to maintain left-to-right order. (true/false)Default = true |
| pause | Do not load posts until user clicks load posts button (true/false) Default = 'false' |
| progress_bar | Display progress bar indicator at the top of the window while loading Ajax content. (true/false) Default = 'false' |
| progress_bar_color | Enter the hex color of the progress bar. Default = 'ed7070' |
| images_loaded | Wait for all images to load before displaying ajax loaded content. (true/false) Default = 'false' |
| destroy_after | Remove ajax load more functionality after 'n' number of pages have been loaded. Default = null |
| button_label | The label text for Load more button. Default = 'Older Posts' |
| button_loading_label | Update the text of the Load More button while content is loading. Default = null |
| button_done_label | Update the text of the Load More button when no content remains to be loaded. Default = null |
| loading_style | Select an Ajax loading style - you can choose between a Button or Infinite Scroll. Default = null |
| container_type | Override the global Container Type that was set on ALM Settings page. Default = null |
| css_classes | Add CSS classes to the Ajax Load More content container. Default = null |
| wrapper_classes | Add CSS classes to the upper-most Ajax Load More wrapper. Default = null |
| nested | Is this a nested Ajax Load More instance? Default = false |
| no_results_text | Add text/html to be displayed when no results are returned in the Ajax Load More query. Default = null |
| placeholder | Display a placeholder image while Ajax content is being loaded. Default = null |
| lazy_images | Provides a fix for images not loading when an image lazy load plugin is hooked and images are not rendering. Default = 'false' |
| vars | A semicolon separated list of key:value pair arguments used to pass variables to a Repeater Template or core filter hooks. e.g. date:Jan 2, 2020; author:Jenn Smith. Default = null |
| archive | Automatically pull content on archive pages. Supported on taxonomy, category, tag, date (year, month, day) and author archives. Default = 'false' |
| woocommerce | Display WooCommerce products. (View Post) Default = 'false' |
| elementor | Enables compatibility with Elementor and is to be used in conjunction with the Single Posts add-on only. (true/false) Default = 'false' |
Example Shortcode[ajax_load_more post_type="post, portfolio" repeater="default" posts_per_page="5" button_label="Older Posts"]