{"id":174929,"date":"2023-09-20T18:45:36","date_gmt":"2023-09-20T18:45:36","guid":{"rendered":"https:\/\/wordpress.org\/plugins\/acf-my-media-cluster\/"},"modified":"2026-01-07T17:10:22","modified_gmt":"2026-01-07T17:10:22","slug":"acf-my-media-cluster","status":"publish","type":"plugin","link":"https:\/\/ary.wordpress.org\/plugins\/acf-my-media-cluster\/","author":7925588,"comment_status":"closed","ping_status":"closed","template":"","meta":{"_crdt_document":"","version":"1.2.12","stable_tag":"1.2.12","tested":"6.9.4","requires":"3.6.0","requires_php":"","requires_plugins":null,"header_name":"ACF My Media Cluster","header_author":"Nikki Blight","header_description":"An extension for the Advanced Custom Fields plugin, which adds the ability to create groups of media files for download on a page\/post\/custom post type. Based on an add-on created by Navneil Naicker and Download Attachments by dFactory.","assets_banners_color":"8a6658","last_updated":"2026-01-07 17:10:22","external_support_url":"","external_repository_url":"","donate_link":"","header_plugin_uri":"","header_author_uri":"http:\/\/nlb-creations.com","rating":0,"author_block_rating":0,"active_installs":0,"downloads":2218,"num_ratings":0,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","changelog"],"tags":{"1.2.10":{"tag":"1.2.10","author":"kionae","date":"2024-08-08 16:35:37"},"1.2.11":{"tag":"1.2.11","author":"kionae","date":"2025-07-15 13:58:49"},"1.2.12":{"tag":"1.2.12","author":"kionae","date":"2026-01-07 17:10:22"},"1.2.9":{"tag":"1.2.9","author":"kionae","date":"2023-09-25 18:43:10"}},"upgrade_notice":[],"ratings":[],"assets_icons":{"icon-256x256.png":{"filename":"icon-256x256.png","revision":2969412,"resolution":"256x256","location":"assets","locale":""}},"assets_banners":{"banner-772x250.png":{"filename":"banner-772x250.png","revision":2969412,"resolution":"772x250","location":"assets","locale":""}},"assets_blueprints":{},"all_blocks":[],"tagged_versions":["1.2.10","1.2.11","1.2.12","1.2.9"],"block_files":[],"assets_screenshots":[],"screenshots":[],"jetpack_post_was_ever_published":false},"plugin_section":[],"plugin_tags":[2211,9054,131721,84,1764],"plugin_category":[50,59],"plugin_contributors":[81681],"plugin_business_model":[],"class_list":["post-174929","plugin","type-plugin","status-publish","hentry","plugin_tags-acf","plugin_tags-documents","plugin_tags-download-files","plugin_tags-media","plugin_tags-pdf","plugin_category-media","plugin_category-utilities-and-tools","plugin_contributors-kionae","plugin_committers-kionae"],"banners":{"banner":"https:\/\/ps.w.org\/acf-my-media-cluster\/assets\/banner-772x250.png?rev=2969412","banner_2x":false,"banner_rtl":false,"banner_2x_rtl":false},"icons":{"svg":false,"icon":"https:\/\/ps.w.org\/acf-my-media-cluster\/assets\/icon-256x256.png?rev=2969412","icon_2x":"https:\/\/ps.w.org\/acf-my-media-cluster\/assets\/icon-256x256.png?rev=2969412","generated":false},"screenshots":[],"raw_content":"<!--section=description-->\n<p>ACF My Media Cluster is an extension for Advance Custom Fields which adds the feature to create groups of media files for download on a page\/post\/custom post type. The plugin does come with both a simple to use shortcode and a helper function if you wish to customize your output.\n* Visually create your Fields in the ACF interface.\n* Assign your fields to post types\n* Easily load data through a simple and friendly helper function, or just use the shortcode.\n* Uses the native WordPress custom post type for ease of use and fast processing\n* Uses the native WordPress metadata for ease of use and fast processing\n* Add multiple media files to your posts, pages, and custom post types. You can also modify title, caption and description from this interface.<\/p>\n\n<h4>Usage<\/h4>\n\n<p>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.<\/p>\n\n<pre><code>acf_media_cluster(string|required $acf_field_name, int $postID, array $options);\n<\/code><\/pre>\n\n<h4>Example<\/h4>\n\n<p>Based on the helper function above. Let say we want to pull annual reports from current page.<\/p>\n\n<pre><code>acf_media_cluster('annual_reports', get_the_ID());\n<\/code><\/pre>\n\n<p>The data that will be return will be an array. You can then loop over the array and use the data anyway you want.<\/p>\n\n<pre><code>$ap = acf_media_cluster('annual_reports', get_the_ID());\nif( !empty($ap) ){\n    foreach($ap as $item){\n        var_dump($item); \/\/Use the data as you wish\n    }\n}\n<\/code><\/pre>\n\n<h4>Options<\/h4>\n\n<p>The 3rd parameter of the <code>acf_media_cluster(string|required $acf_field_name, int $postID, array $options);<\/code> helper function is options which takes in an array. You can pass the following:<\/p>\n\n<pre><code>acf_media_cluster('annual_reports', get_the_ID(), array(\n    'orderby' =&gt; 'post__in',\n    'order' =&gt; 'ASC'\n));\n<\/code><\/pre>\n\n<p>For acceptable values for order and orderby, please refer to <a href=\"https:\/\/developer.wordpress.org\/reference\/functions\/get_posts\/\">https:\/\/developer.wordpress.org\/reference\/functions\/get_posts\/<\/a><\/p>\n\n<h4>Shortcode<\/h4>\n\n<p>In your editor, add the following shortcode where you want the media to appear.<\/p>\n\n<pre><code>[acf-media-cluster field_name=\"my_media_field\"]\n<\/code><\/pre>\n\n<p>The shortcode accepts the following parameters.<\/p>\n\n<p>string|required $field_name - Which ACF field name should be used\nstring $container_id - Wrap the output with your custom CSS ID name\nstring $container_class - Wrap the output with your custom CSS class name\nstring $skin - Do you want default CSS styling to apply? yes|no\nstring $format - html format for the output. table|list\nstring $title - a title wrapped in an container tag.  Leave blank for no tag.\nstring $title_container - html tag to wrap the title in, with no brackets. \"h3\" is default.\nstring $show_meta - Do you want to display file metadata (size, downloads, date)? yes|no<\/p>\n\n<h4>Compatibility<\/h4>\n\n<p>This ACF field type is compatible with:\n* ACF 6\n* ACF 5<\/p>\n\n<p>This ACF field is compatible with the iThemes Security plugin, but you must uncheck the option for \"Disable PHP in plugins\" under PHP Execution in System Tweaks.<\/p>\n\n<h4>Credits<\/h4>\n\n<p>This plugin is based on ACF Media Cluster by Navneil Naicker. (<a href=\"https:\/\/wordpress.org\/plugins\/acf-media-cluster\/\">https:\/\/wordpress.org\/plugins\/acf-media-cluster\/<\/a>)<\/p>\n\n<p>It also takes some inspiration from the Download Attachments plugin by dfactory, which sadly no longer exists.<\/p>\n\n<!--section=installation-->\n<ol>\n<li>Copy the <code>acf-media-cluster<\/code> folder into your <code>wp-content\/plugins<\/code> folder<\/li>\n<li>Activate the ACF My Media Cluster plugin via the plugins admin page<\/li>\n<li>Create a new field via ACF and select the Media Cluster type<\/li>\n<li>Read the description above for usage instructions<\/li>\n<\/ol>\n\n<!--section=changelog-->\n<h4>1.2.12<\/h4>\n\n<ul>\n<li>Fixed PHP deprecation issues.<\/li>\n<li>Checking WP 6.9 compatibility<\/li>\n<\/ul>\n\n<h4>1.2.11<\/h4>\n\n<ul>\n<li>Fixed a PHP deprecation issue.<\/li>\n<\/ul>\n\n<h4>1.2.10<\/h4>\n\n<ul>\n<li>Fixed a javascript issue that prevented the user from updating the selected file before saving in some circumstances.<\/li>\n<li>Fixed a javascript issue that appended the name of a file to existing text instead of overwriting when updating the selected file in some circumstances.<\/li>\n<li>Now dynamically selecting the plugin version number from file headers instead of hardcoding it.<\/li>\n<\/ul>\n\n<h4>1.2.9<\/h4>\n\n<ul>\n<li>Additional security and sanitization of data.<\/li>\n<\/ul>\n\n<h4>1.2.8<\/h4>\n\n<ul>\n<li>Additional security and sanitization of data.<\/li>\n<\/ul>\n\n<h4>1.2.7<\/h4>\n\n<ul>\n<li>Additional security and sanitization of data.<\/li>\n<\/ul>\n\n<h4>1.2.6<\/h4>\n\n<ul>\n<li>Additional security and sanitization of data.<\/li>\n<li>Changes to the way files are referenced<\/li>\n<li>Fixed an output bug in the shortcode's list option<\/li>\n<\/ul>\n\n<h4>1.2.5<\/h4>\n\n<ul>\n<li>Additional security and sanitization of data.<\/li>\n<li>Fixed a PHP warning on the field creation page.<\/li>\n<\/ul>\n\n<p>= 1.2.4=\n* Added better security and sanitization of data\n* Removed the download.php file to eliminate external calls to that script\n* Moved inline javascript to the acf-media-cluster.js file<\/p>\n\n<h4>1.2.3<\/h4>\n\n<ul>\n<li>Re-added backwards compatibility with ACF version 5, and cleaned things up to prepare for future ACF updates.<\/li>\n<li>Added more documentation to codebase.<\/li>\n<li>Rebranded for public release.<\/li>\n<\/ul>\n\n<h4>1.2.2<\/h4>\n\n<ul>\n<li>Finally fixed the issue with the button clicks requiring a perfectly still mouse due to the sorting function.<\/li>\n<li>Fixed the model edit box on files added to the list but not yet saved.<\/li>\n<\/ul>\n\n<h4>1.2.1<\/h4>\n\n<ul>\n<li>Fixed issue with clusters not rendering more than 5 media links in the backend<\/li>\n<\/ul>\n\n<h4>1.2.0<\/h4>\n\n<ul>\n<li>Made custom field settings compatible with ACF 6.x<\/li>\n<\/ul>\n\n<h4>1.1.4<\/h4>\n\n<ul>\n<li>Added ability to change the wrapper tag for the file list title.<\/li>\n<\/ul>\n\n<h4>1.1.3<\/h4>\n\n<ul>\n<li>Added image alts to download link icons for accessibility<\/li>\n<\/ul>\n\n<h4>1.1.2<\/h4>\n\n<ul>\n<li>Added aria-label and role attributes to download links for accessibility<\/li>\n<\/ul>\n\n<h4>1.1.1<\/h4>\n\n<ul>\n<li>Fixed a jQuery conflict with ACF's date picker field type<\/li>\n<\/ul>\n\n<h4>1.1.0<\/h4>\n\n<ul>\n<li>Fixed primary data retrieval function<\/li>\n<li>Fixed shortcode output<\/li>\n<li>Added ability to reorder files<\/li>\n<li>Title field now updates in backend via jQuery on edit<\/li>\n<li>Added filetype icons<\/li>\n<li>Added download count<\/li>\n<li>Added format and content options to the shortcode<\/li>\n<li>Added meta info on the file to the post edit page<\/li>\n<\/ul>\n\n<h4>1.0.0<\/h4>\n\n<ul>\n<li>Initial Release.<\/li>\n<\/ul>","raw_excerpt":"ACF My Media Cluster is an extension for the Advance Custom Fields plugin, which adds the ability to create groups of media files for download on a pa &hellip;","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/ary.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/174929","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/ary.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/ary.wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/ary.wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=174929"}],"author":[{"embeddable":true,"href":"https:\/\/ary.wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/kionae"}],"wp:attachment":[{"href":"https:\/\/ary.wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=174929"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/ary.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=174929"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/ary.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=174929"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/ary.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=174929"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/ary.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=174929"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/ary.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=174929"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}