About this plugin
ACF Media Cluster is an extension for Advance Custom Fields which adds the feature to add multiple media to post/pages. The plugin does come with shortcode or if you know how to write code then you can customize or write your own code and use the data provided by ACF Media Cluster as you wish.
- Visually create your Fields
- Add multiple media and you can also modify title, caption and description to anything
- Assign your fields to multiple edit pages (via custom location rules)
- Easily load data through a simple and friendly API
- Uses the native WordPress custom post type for ease of use and fast processing
- Uses the native WordPress metadata for ease of use and fast processing
Usage
Use the helper function below to pull data from the database. The function will be return an array. The helper function takes in 3 parameters.
acf_media_cluster(string|required $acf_field_name, int $postID, array $options);
Example
Based on the helper function above. Let say we want to pull annual reports from current page.
acf_media_cluster('annual_reports', get_the_ID());
The data that will be return will be an array. Now I can loop over the array and use the data anyway I want.
empty($ap) ){ foreach($ap as $item){ var_dump($item); //Use the data as you wish } }
Options
The 3rd parameter of the acf_media_cluster(string|required $acf_field_name, int $postID, array $options); helper function is options which takes in an array. You can pass the following.
acf_media_cluster('annual_reports', array( 'orderby' => 'post__in', 'order' => 'ASC' ));
org/reference/functions/get_posts/
Shortcode
In the text view of your editor, add the following shortcode where you want the media to appear.
[acf-media-cluster field_name="discussions" container_id="ml-table" container_class="ml-table2" skin="yes"]
The shortcode takes in the following parameters.
string|required $field_name – Which ACF field name should be used
string $container_id – Wrap the output with your custom CSS ID
string $container_class – Wrap the output with your custom CSS class
string $skin – Do you want default CSS styling to apply. yes|no
Issues
Just like any other WordPress plugin, this plugin can also cause issues with other themes and plugins. If you are facing issues making this plugin work on your WordPress site, please do ask for help in the support forum. This way we can help you out and prevent this issue from happening to someone else.
me/
Compatibility
This ACF field type is compatible with:
* ACF 5