如何为WordPress默认图库功能添加自定义选项并在代码中调用

完全可以实现，借助WordPress原生的媒体字段钩子和短代码过滤器即可完成自定义字段添加、存储、查询全流程，无需依赖第三方插件。

1. 给图库设置界面添加自定义字段 #

使用attachment_fields_to_edit过滤器可以给媒体库/图库设置界面添加任意类型的自定义字段，以下是同时添加复选框、下拉选择字段的示例：

// 给图库设置添加自定义字段
add_filter('attachment_fields_to_edit', 'custom_gallery_add_fields', 10, 2);
function custom_gallery_add_fields($form_fields, $post) {
    // 复选框字段：是否为精选图库图片
    $form_fields['is_gallery_featured'] = array(
        'label' => '设为精选展示',
        'input' => 'html',
        'html' => '<input type="checkbox" name="attachments['.$post->ID.'][is_gallery_featured]" id="attachments-'.$post->ID.'-is_gallery_featured" value="1" '.checked(get_post_meta($post->ID, '_is_gallery_featured', true), 1, false).' />',
        'helps' => '勾选后该图会在图库精选区域优先展示'
    );
    
    // 下拉选择字段：图片展示风格
    $form_fields['gallery_display_style'] = array(
        'label' => '展示风格',
        'input' => 'html',
        'html' => '
        <select name="attachments['.$post->ID.'][gallery_display_style]" id="attachments-'.$post->ID.'-gallery_display_style">
            <option value="default" '.selected(get_post_meta($post->ID, '_gallery_display_style', true), 'default', false).'>默认样式</option>
            <option value="rounded" '.selected(get_post_meta($post->ID, '_gallery_display_style', true), 'rounded', false).'>圆角样式</option>
            <option value="shadow" '.selected(get_post_meta($post->ID, '_gallery_display_style', true), 'shadow', false).'>阴影样式</option>
            <option value="blur_hover" '.selected(get_post_meta($post->ID, '_gallery_display_style', true), 'blur_hover', false).'>Hover模糊效果</option>
        </select>',
        'helps' => '选择该图片在图库中的展示样式'
    );
    return $form_fields;
}

2. 保存自定义字段的提交值 #

使用attachment_fields_to_save过滤器处理字段的存储逻辑：

// 保存图库自定义字段值
add_filter('attachment_fields_to_save', 'custom_gallery_save_fields', 10, 2);
function custom_gallery_save_fields($post, $attachment) {
    // 保存复选框值
    if (isset($attachment['is_gallery_featured'])) {
        update_post_meta($post['ID'], '_is_gallery_featured', 1);
    } else {
        delete_post_meta($post['ID'], '_is_gallery_featured');
    }
    // 保存下拉选择值
    if (isset($attachment['gallery_display_style'])) {
        update_post_meta($post['ID'], '_gallery_display_style', sanitize_text_field($attachment['gallery_display_style']));
    }
    return $post;
}

3. 调用自定义参数查询图库 #

你可以选择重写默认的图库短代码输出，也可以在自定义模板中直接查询符合条件的图片：

方法A：重写默认图库短代码（全局生效） #

// 自定义图库短代码输出，应用自定义查询参数
add_filter('post_gallery', 'custom_gallery_render', 10, 3);
function custom_gallery_render($output, $attr, $instance) {
    // 构造查询参数，支持自定义筛选条件
    $args = array(
        'post_type' => 'attachment',
        'post__in' => explode(',', $attr['ids']),
        'posts_per_page' => -1,
        'orderby' => 'post__in',
        // 自定义筛选：仅查询勾选了「设为精选展示」的图片
        'meta_query' => array(
            array(
                'key' => '_is_gallery_featured',
                'value' => 1,
                'compare' => '='
            )
        )
    );
    $gallery_images = get_posts($args);
    if (empty($gallery_images)) return '';
    
    // 构建自定义输出结构
    $output = '<div class="custom-gallery">';
    foreach ($gallery_images as $img) {
        // 获取自定义的展示风格参数
        $style = get_post_meta($img->ID, '_gallery_display_style', true) ?: 'default';
        $img_url = wp_get_attachment_url($img->ID);
        $img_alt = get_post_meta($img->ID, '_wp_attachment_image_alt', true);
        $output .= '<div class="gallery-item gallery-style-'.esc_attr($style).'">';
        $output .= '<img src="'.esc_url($img_url).'" alt="'.esc_attr($img_alt).'">';
        $output .= '</div>';
    }
    $output .= '</div>';
    return $output;
}

方法B：自定义模板中直接查询 #

如果不需要修改全局图库输出，直接在需要的位置传入meta参数查询即可：

$custom_gallery_args = array(
    'post_type' => 'attachment',
    'post_status' => 'inherit',
    'posts_per_page' => 10,
    // 按自定义字段筛选
    'meta_query' => array(
        'relation' => 'AND',
        array(
            'key' => '_is_gallery_featured',
            'value' => 1
        ),
        array(
            'key' => '_gallery_display_style',
            'value' => 'rounded'
        )
    )
);
$custom_gallery = new WP_Query($custom_gallery_args);

注意：以上代码可直接添加到当前主题的functions.php文件，或独立的自定义功能插件中使用，修改前建议先备份站点代码。

内容的提问来源于stack exchange，提问作者Viewer