Documentation
Online documentation for Ajax Load More
Shortcode 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 35 unique parameters to choose from, creating your own Ajax Load More query is never more than a few minutes away!
All core shortcode 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_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 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 |
exclude | 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' |
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 |
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 the loading of posts on scroll. Default = null |
transition | Choose a loading transition (fade/masonry/none). Default = 'fade' |
transition_speed | The speed of the loading transition in milliseconds. Default = '250' |
transition_container | Display the Ajax Load More (.alm-reveal) loading container. (true/false) Default = 'true' |
transition_container_classes | Add custom classes to the .alm-reveal loading container. Default = null |
masonry_selector | The target classname of each masonry item. Default = null |
masonry_animation | Select a loading transition 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 |
container_type | Override the global Container Type that was set on ALM Settings page. Default = null |
css_classes | Add custom CSS classes to the Ajax Load More container. Default = null |
nested | Is this a nested Ajax Load More instance? Default = false |
Example Shortcode[ajax_load_more post_type="post, portfolio" repeater="default" posts_per_page="5" transition="fade" button_label="Older Posts"]