The following information is sourced from WordPress.org and was last synced on Thursday 26th of December 2024 am31 05:52:07 AM.
Description
Ajax Load More for Advanced Custom Fields provides additional functionality for infinite scrolling Flexible Content, Gallery, Repeater and Relationship field data with Ajax Load More.
Easily access Repeater, Gallery, Flexible Content and Relationship custom field data from a page or post and return the results to Ajax Load More for infinite scrolling.
Supported Field Types
The following ACF Field Types are supported:
- Gallery – The gallery field provides a simple and intuitive interface for managing a collection of images.
- Flexible Content – The flexible content field acts as a blank canvas to which you can add an unlimited number of layouts with full control over the order.
- Relationship – The Relationship field creates a very attractive version of the post object field. With a Relationship field, you can select from pages + posts + custom post types.
- Repeater – The repeater field allows you to create a set of sub fields which can be repeated again and again whilst editing content.
Shortcode Parameters
The following Ajax Load More shortcode parameters are available when the Advanced Custom Fields extension is activated.
- acf – Enable compatibility with Advanced Custom Fields. (true/false)
- acf_post_id – The ID of the current page/post. Default = $post->ID
- acf_field_type – The type of ACF field. (gallery/flexible/relationship/repeater)
- acf_field_name – The name of the ACF field.
- acf_parent_field_name – Access sub field data up to the three levels deep.
- acf_row_index – Access sub field data in a Repeater or Flexible Content field by row index.
Example Shortcode
[ajax_load_more repeater="default" acf="true" acf_field_type="repeater" acf_field_name="{your_field_name}"]
Installation
Uploading in WordPress Dashboard
- Navigate to the ‘Add New’ in the plugins dashboard
- Navigate to the ‘Upload’ area
- Select
ajax-load-more-for-acf.zip
from your computer - Click ‘Install Now’
- Activate the plugin in the Plugin dashboard
Using FTP
- Download
ajax-load-more-acf.zip
. - Extract the
ajax-load-more-for-acf
directory to your computer. - Upload the
ajax-load-more-for-acf
directory to the/wp-content/plugins/
directory. - Ensure Ajax Load More is installed prior to activating the plugin.
- Activate the plugin in the WP plugin dashboard.
FAQ
You must have v3.0+ of Ajax Load More installed.
Once installed, visit the Ajax Load More Shortcode Builder and build a custom shortcode specifying the ACF field type (acf_field_type) and field name (acf_field_name).
Gallery, Flexible Content, Repeater and Relationship fields are currently supported.
Create an [ajax_load_more] shortcode and set acf_field_type="repeater"
.
Create an [ajax_load_more] shortcode and set acf_field_type="relationship"
.
Create an [ajax_load_more] shortcode and set acf_field_type="gallery"
.
Create an [ajax_load_more] shortcode and set acf_field_type="flexible"
.
Changelog
1.3.3 – November 11, 2024
- UPDATE: Readme, contributors, WordPress tested version
1.3.2 – June 11, 2023
- NEW: Added support for accessing sub field data in Repeater or Flexible Content field types by row index.
- UPDATE: Updated to add compatibility with Cache Add-on 2.0 and Ajax Load More 6.0.
- FIX: Fixed issue with broken Paging add-on and ACF extension.
1.3.1 – December 30, 2022
- FIX: Fixed issue with undefined
$page
variable when using Repeater field. - FIX: Fixed issue with
$alm_item
variable being off in preloaded queries. - UPDATE: Code cleanup and organization.
1.3.0.1 – March 6, 2020
- FIX – Fix for issue with Relationship field type show PHP warning message about undefined variable.
1.3.0 – October 22, 2019
- UPGRADE NOTICE – Users updating to the latest ACF extension must also update core Ajax Load More to 5.1.6 to get sub_field support.
- NEW – Added support for infinite scrolling nested sub fields (
acf_parent_field_name
). Up to 3 levels of nesting is supported. - UPDATE – Removed legacy API endpoint.
1.2.0 – May 6, 2019
- UPGRADE NOTICE – This update requires Ajax Load More 5.1+.
- NEW – ACF extension now uses the WordPress REST API for Ajax queries. This change can be reverted in ALM Settings.
1.1.2 – September 19, 2018
- FIX – Fixed cache creation issue with Cache add-on and Repeater and Flexible Content fields.
- FIX – Fixed issue with
offset
parameter not working in preloaded Ajax Load More query. - FIX – Fixed PHP warning message about undefined variable.
1.1.1 – October 5, 2017
- NEW – Adding new
alm_get_acf_gallery_theme_repeater
function for integration between Theme Repeaters (add-on) and the Gallery Field Type.
1.1 – May 22, 2017
- NOTICE – Requires Ajax Load More 3.0.1+
- NEW – Added support for Gallery field type.
- NEW – Added support for Flexible Content field type.
1.0 – May 4, 2017
- Initial Release.