內容簡介
ACF Photo Gallery Field 是 Advanced Custom Field (ACF) 的輕量級擴充外掛，可在任何文章或頁面新增相簿欄位，支援多張圖片上傳與管理，並提供簡潔的 API 供前端呼叫顯示。
【主要功能】
• 透過視覺化介面建立自訂欄位
• 批次上傳多張圖片並編輯標題、說明與連結
• 透過自訂位置規則指派欄位至多個編輯頁面
• 提供簡潔易用的 PHP API 讀取圖片資料
• 採用 WordPress 原生自訂文章類型與中繼資料
• 同時支援傳統編輯器與 Gutenberg 編輯器及 RESTful API
外掛標籤
開發者團隊
📦 歷史版本下載
原文外掛簡介
Important Notice for New Users of ACF Photo Gallery Field
If you are installing the ACF Photo Gallery Field for the first time on your WordPress website, we’d like to inform you that this plugin will no longer be maintained as of October 2024. As an alternative, we have launched a new and improved plugin called ACF Galerie 4.
We encourage you to check out ACF Galerie 4 for enhanced features and ongoing support. ACF Galerie 4 includes a built-in migration tool that seamlessly transfers data from ACF Photo Gallery Field or ACF Gallery Pro to ACF Galerie 4. Learn more.
Thanks
A lightweight extension of Advanced Custom Field (ACF) that adds Photo Gallery field to any post/pages on your WordPress website.
Visually create your Fields
Add multiple photos and you can also modify title, caption and link 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
Supports WordPress classic and Gutenberg editor
RESTFul API
Donation
Navneil Naicker is the sole developer working on this free WordPress Plugin in his leisure time. He would like to integrate it with premium plugins like Elementor Pro and Advanced Custom Fields Pro. Please donate to support Navneil in continuing further development of this plugin. Click on the link “https://www.buymeacoffee.com/navzme” to donate.
Usage
acf_photo_gallery is a helper function that takes in ACF_FIELD_NAME and POST_ID will query the database and compile the images for you. The output of this function will be an array.
acf_photo_gallery(ACF_FIELD_NAME, POST_ID);
Example
The following example is using Twitter Bootstrap framework to layout. You can use any framework of your choice.
ID);
//Check if return array has anything in it
if( count($images) ):
//Cool, we got some data so now let's loop over it
foreach($images as $image):
$id = $image['id']; // The attachment id of the media
$title = $image['title']; //The title
$caption= $image['caption']; //The caption
$full_image_url= $image['full_image_url']; //Full size image url
$full_image_url = acf_photo_gallery_resize_image($full_image_url, 262, 160); //Resized size to 262px width by 160px height image url
$thumbnail_image_url= $image['thumbnail_image_url']; //Get the thumbnail size image url 150px by 150px
$url= $image['url']; //Goto any link when clicked
$target= $image['target']; //Open normal or new tab
$alt = get_field('photo_gallery_alt', $id); //Get the alt which is a extra field (See below how to add extra fields)
$class = get_field('photo_gallery_class', $id); //Get the class which is a extra field (See below how to add extra fields)
?>
Add Extra Fields
To add extra fields add the following to your themes functions.php file.
//Create extra fields called Altnative Text and Status
function my_extra_gallery_fields( $args, $attachment_id, $acf_key ){
$args['alt'] = array(
'type' => 'text',
'label' => 'Altnative Text',
'name' => 'alt',
'value' => get_field($field . '_alt', $attachment_id)
);
$args['status'] = array(
'type' => 'select',
'label' => 'Status',
'name' => 'status',
'value' => array(
array(
'1' => 'Active',
'2' => 'Inactive'
),
get_field($field . '_status', $attachment_id)
)
);
return $args;
}
add_filter( 'acf_photo_gallery_image_fields', 'my_extra_gallery_fields', 10, 3 );
Supported field types:
* text, date, color, datetime-local, email, number, tel, time, url, week, range, checkbox, radio, textarea, select
How to get values of extra fields
You can use ACF helper function get_field
get_field('photo_gallery_alt', $id);
get_field('photo_gallery_class', $id);
Pull caption from attachment caption field
By default the caption is being pulled from description field. Add the following filter to your function.php to pull the caption from attachment caption field.
add_filter( 'acf_photo_gallery_caption_from_attachment', '__return_true' );
REST API
Send HTTP Request to URL to get JSON response of all posts
http://{domain}/wp-json/wp/v2/{POST_TYPE}/
Send HTTP Request to URL to get JSON response of specific post
http://{domain}/wp-json/wp/v2/{POST_TYPE}/{POST_ID}/
When you receive the response, see the ACF item which contains ACF photo gallery name and array of images.
Installation and basic usage tutorial
ACF Photo Gallery Field on WordPress Custom Post Type tutorial
How to use Elementor dynamic tags with ACF Photo Gallery Field plugin tutorial
Compatibility
This ACF field type is compatible with: ACF 4, 5 and 6
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. If you want to talk to me directly, you can contact me via my website http://www.navz.me/
