fbpx

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.

View Documentation

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

  1. Navigate to the ‘Add New’ in the plugins dashboard
  2. Navigate to the ‘Upload’ area
  3. Select ajax-load-more-for-acf.zip from your computer
  4. Click ‘Install Now’
  5. Activate the plugin in the Plugin dashboard

Using FTP

  1. Download ajax-load-more-acf.zip.
  2. Extract the ajax-load-more-for-acf directory to your computer.
  3. Upload the ajax-load-more-for-acf directory to the /wp-content/plugins/ directory.
  4. Ensure Ajax Load More is installed prior to activating the plugin.
  5. Activate the plugin in the WP plugin dashboard.

FAQ

What version of Ajax Load More is required?

You must have v3.0+ of Ajax Load More installed.

How do I use this extension?

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).

What field types of Advanced Custom Fields are supported?

Gallery, Flexible Content, Repeater and Relationship fields are currently supported.

How do I infinite scroll Repeater fields with Ajax Load More

Create an [ajax_load_more] shortcode and set acf_field_type="repeater".

How do I infinite scroll Relationship fields with Ajax Load More

Create an [ajax_load_more] shortcode and set acf_field_type="relationship".

How do I infinite scroll Gallery fields with Ajax Load More

Create an [ajax_load_more] shortcode and set acf_field_type="gallery".

How do I infinite scroll Flexible Content fields with Ajax Load More

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.

Keep up to date with all things ACF!

Subscribe to our newsletter or follow @awesomeacf on Twitter!