本教程详细阐述了在WordPress自定义分类法中，如何正确地获取并显示Advanced Custom Fields (ACF) 图片字段的URL，以解决标签src属性为空的问题。文章将深入分析常见错误，并提供使用get_field()和the_field()两种方法的正确实现代码，帮助开发者构建健壮的自定义短代码来展示分类法术语关联的图片。
引言：WordPress自定义分类法与ACF图片字段的集成
在WordPress开发中，为自定义分类法（Custom Taxonomy）的术语（Term）添加额外信息，尤其是图片，是一个常见的需求。Advanced Custom Fields (ACF) 插件为实现这一目标提供了极大的便利。例如，您可能希望为每个产品矿物分类（minerals）术语添加一个代表性图片，并在产品详情页上展示这些图片及其链接。然而，在实际操作中，开发者常会遇到一个问题：尽管看似已经成功获取了图片URL，但生成的标签src属性却显示为空，导致图片无法加载。
理解问题：src属性为空的根源
问题的核心在于WordPress和PHP中变量的输出机制。当我们使用get_field(‘field_name’, $object_id)这样的ACF函数时，它会返回字段的值，而不是直接将其输出到HTML中。原始代码中的标签构建方式如下：
@@##@@" />
这里的问题在于php $term_image ?>。这段PHP代码仅仅是声明或处理了$term_image变量，但并没有将其内容打印（echo）出来。因此，当HTML被渲染时，src属性接收到的不是变量的值，而是一个空字符串，或者PHP标签内部的空白字符，最终表现为<img src="%E3%80%82
%E6%AD%A4%E5%A4%96%EF%BC%8C%E5%8E%9F%E5%A7%8B%E4%BB%A3%E7%A0%81%E4%B8%AD%E8%8E%B7%E5%8F%96%24term_id%E7%9A%84%E6%96%B9%E5%BC%8F%24queried_object%20=%20get_queried_object();%20%24term_id%20=%20%24queried_object->term_id;%E5%9C%A8%E5%BE%AA%E7%8E%AF%E4%B8%AD%E4%B9%9F%E5%AD%98%E5%9C%A8%E6%BD%9C%E5%9C%A8%E7%9A%84%E8%AF%AF%E7%94%A8%E3%80%82get_queried_object()%E9%80%9A%E5%B8%B8%E8%BF%94%E5%9B%9E%E5%BD%93%E5%89%8D%E4%B8%BB%E6%9F%A5%E8%AF%A2%E7%9A%84%E5%AF%B9%E8%B1%A1%EF%BC%88%E4%BE%8B%E5%A6%82%EF%BC%8C%E5%A6%82%E6%9E%9C%E6%98%AF%E4%BA%A7%E5%93%81%E9%A1%B5%E9%9D%A2%EF%BC%8C%E5%AE%83%E8%BF%94%E5%9B%9E%E7%9A%84%E6%98%AF%E4%BA%A7%E5%93%81%E5%AF%B9%E8%B1%A1%EF%BC%89%EF%BC%8C%E8%80%8C%E4%B8%8D%E6%98%AF%E5%BD%93%E5%89%8D%E5%BE%AA%E7%8E%AF%E4%B8%AD%E7%9A%84%E5%88%86%E7%B1%BB%E6%B3%95%E6%9C%AF%E8%AF%AD%E5%AF%B9%E8%B1%A1%E3%80%82%E5%9C%A8%E5%BE%AA%E7%8E%AF%E9%81%8D%E5%8E%86get_the_terms()%E8%BF%94%E5%9B%9E%E7%9A%84%E6%9C%AF%E8%AF%AD%E6%97%B6%EF%BC%8C%E6%AF%8F%E4%B8%AA%24term%E5%AF%B9%E8%B1%A1%E6%9C%AC%E8%BA%AB%E5%B0%B1%E6%98%AF%E6%AD%A3%E7%A1%AE%E7%9A%84%E4%B8%8A%E4%B8%8B%E6%96%87%E3%80%82
%E6%AD%A3%E7%A1%AE%E5%AE%9E%E7%8E%B0%EF%BC%9A%E8%BE%93%E5%87%BAACF%E5%9B%BE%E7%89%87URL
%E8%A6%81%E6%AD%A3%E7%A1%AE%E6%98%BE%E7%A4%BAACF%E5%9B%BE%E7%89%87%E5%AD%97%E6%AE%B5%E7%9A%84URL%EF%BC%8C%E6%88%91%E4%BB%AC%E9%9C%80%E8%A6%81%E7%A1%AE%E4%BF%9D%E5%B0%86get_field()%E8%BF%94%E5%9B%9E%E7%9A%84%E5%80%BC%E6%98%BE%E5%BC%8F%E5%9C%B0%E8%BE%93%E5%87%BA%E5%88%B0HTML%E4%B8%AD%E3%80%82%E6%9C%89%E4%B8%A4%E7%A7%8D%E4%B8%BB%E8%A6%81%E7%9A%84%E6%96%B9%E6%B3%95%E5%8F%AF%E4%BB%A5%E5%AE%9E%E7%8E%B0%E8%BF%99%E4%B8%80%E7%82%B9%EF%BC%9A
%E4%BD%BF%E7%94%A8%20echo%20get_field()%EF%BC%9A%0A%E8%BF%99%E6%98%AF%E6%9C%80%E7%9B%B4%E6%8E%A5%E7%9A%84%E6%96%B9%E6%B3%95%E3%80%82get_field()%E8%BF%94%E5%9B%9E%E5%9B%BE%E7%89%87URL%EF%BC%8C%E7%84%B6%E5%90%8E%E6%88%91%E4%BB%AC%E4%BD%BF%E7%94%A8PHP%E7%9A%84echo%E8%AF%AD%E5%8F%A5%E5%B0%86%E5%85%B6%E6%89%93%E5%8D%B0%E5%87%BA%E6%9D%A5%E3%80%82
';}?>
%E6%B3%A8%E6%84%8F%EF%BC%9A%20%E5%BC%BA%E7%83%88%E5%BB%BA%E8%AE%AE%E4%BD%BF%E7%94%A8esc_url()%E5%AF%B9URL%E8%BF%9B%E8%A1%8C%E8%BD%AC%E4%B9%89%EF%BC%8C%E4%BB%A5%E9%98%B2%E6%AD%A2XSS%E6%94%BB%E5%87%BB%E3%80%82
%E4%BD%BF%E7%94%A8%20the_field()%EF%BC%9A%0AACF%E6%8F%90%E4%BE%9B%E4%BA%86%E4%B8%80%E4%B8%AA%E4%BE%BF%E6%8D%B7%E5%87%BD%E6%95%B0the_field()%EF%BC%8C%E5%AE%83%E7%9B%B4%E6%8E%A5%E8%BE%93%E5%87%BA%E5%AD%97%E6%AE%B5%E7%9A%84%E5%80%BC%EF%BC%8C%E7%9C%81%E5%8E%BB%E4%BA%86%E6%89%8B%E5%8A%A8echo%E7%9A%84%E6%AD%A5%E9%AA%A4%E3%80%82
@@##@@" alt="name); ?>" />
%E8%BF%99%E7%A7%8D%E6%96%B9%E6%B3%95%E6%9B%B4%E4%B8%BA%E7%AE%80%E6%B4%81%EF%BC%8C%E4%BD%86%E9%9C%80%E8%A6%81%E6%B3%A8%E6%84%8Fthe_field()%E6%B2%A1%E6%9C%89%E8%BF%94%E5%9B%9E%E5%80%BC%E7%9A%84%E7%89%B9%E6%80%A7%EF%BC%8C%E5%A6%82%E6%9E%9C%E9%9C%80%E8%A6%81%E5%AF%B9%E5%AD%97%E6%AE%B5%E5%80%BC%E8%BF%9B%E8%A1%8C%E8%BF%9B%E4%B8%80%E6%AD%A5%E5%A4%84%E7%90%86%EF%BC%88%E5%A6%82%E6%8B%BC%E6%8E%A5%E3%80%81%E6%9D%A1%E4%BB%B6%E5%88%A4%E6%96%AD%EF%BC%89%EF%BC%8C%E5%88%99%E5%BA%94%E4%BD%BF%E7%94%A8get_field()%E3%80%82
%E5%AE%8C%E6%95%B4%E7%A4%BA%E4%BE%8B%EF%BC%9A%E6%9E%84%E5%BB%BA%E4%B8%80%E4%B8%AA%E5%81%A5%E5%A3%AE%E7%9A%84%E8%87%AA%E5%AE%9A%E4%B9%89%E7%9F%AD%E4%BB%A3%E7%A0%81
%E4%BB%A5%E4%B8%8B%E6%98%AF%E4%B8%80%E4%B8%AA%E4%BC%98%E5%8C%96%E5%90%8E%E7%9A%84%E8%87%AA%E5%AE%9A%E4%B9%89%E7%9F%AD%E4%BB%A3%E7%A0%81%E7%A4%BA%E4%BE%8B%EF%BC%8C%E5%AE%83%E7%BB%93%E5%90%88%E4%BA%86%E4%B8%8A%E8%BF%B0%E6%AD%A3%E7%A1%AE%E8%BE%93%E5%87%BA%E6%96%B9%E6%B3%95%E5%92%8C%E6%9B%B4%E5%81%A5%E5%A3%AE%E7%9A%84%E9%80%BB%E8%BE%91%EF%BC%8C%E7%94%A8%E4%BA%8E%E5%9C%A8%E4%BA%A7%E5%93%81%E9%A1%B5%E9%9D%A2%E6%98%BE%E7%A4%BA%E5%85%B3%E8%81%94%E7%9A%84%E8%87%AA%E5%AE%9A%E4%B9%89%E5%88%86%E7%B1%BB%E6%B3%95%E6%9C%AF%E8%AF%AD%E5%9B%BE%E7%89%87%E5%92%8C%E9%93%BE%E6%8E%A5%EF%BC%9A
get_id(); // 获取当前产品ID $output = ''; $taxonomy_name = 'minerals'; // 定义自定义分类法名称 $acf_image_field = 'mineral_image'; // 定义ACF图片字段名称 // 获取产品关联的分类法术语 $terms = get_the_terms( $product_id, $taxonomy_name ); if ( $terms && ! is_wp_error( $terms ) ) { $output .= ''; foreach ( $terms as $term ) { $term_name = $term->name; $term_slug = $term->slug; $term_link = get_term_link( $term, $taxonomy_name ); // 获取术语链接 // 获取ACF图片URL，使用 $term 作为上下文 $term_image_url = get_field( $acf_image_field, $term ); $output .= ''; if ( $term_image_url ) { // 使用 get_field 并 echo 输出，同时进行URL转义 $output .= ''; $output .= '@@##@@'; $output .= ''; } // 链接到分类法术语归档页 $output .= '' . esc_html($term_name) . ''; $output .= ''; } $output .= ''; } return $output;}// 注册短代码add_shortcode('short_minerals', 'display_product_minerals_shortcode');?>
%E4%BB%A3%E7%A0%81%E8%A7%A3%E6%9E%90%EF%BC%9A
global%20%24product;:%20%E5%9C%A8WooCommerce%E4%BA%A7%E5%93%81%E9%A1%B5%E9%9D%A2%E4%B8%AD%EF%BC%8C%E9%80%9A%E8%BF%87global%20%24product;%E5%8F%AF%E4%BB%A5%E8%AE%BF%E9%97%AE%E5%BD%93%E5%89%8D%E4%BA%A7%E5%93%81%E5%AF%B9%E8%B1%A1%E3%80%82get_the_terms(%20%24product_id,%20%24taxonomy_name%20):%20%E6%AD%A3%E7%A1%AE%E8%8E%B7%E5%8F%96%E6%8C%87%E5%AE%9A%E4%BA%A7%E5%93%81ID%E5%85%B3%E8%81%94%E7%9A%84%E5%88%86%E7%B1%BB%E6%B3%95%E6%9C%AF%E8%AF%AD%E3%80%82get_field(%20%24acf_image_field,%20%24term%20):%20%E5%9C%A8%E5%BE%AA%E7%8E%AF%E4%B8%AD%EF%BC%8C%E5%B0%86%E5%BD%93%E5%89%8D%24term%E5%AF%B9%E8%B1%A1%E4%BD%9C%E4%B8%BA%E7%AC%AC%E4%BA%8C%E4%B8%AA%E5%8F%82%E6%95%B0%E4%BC%A0%E9%80%92%E7%BB%99get_field()%EF%BC%8C%E7%A1%AE%E4%BF%9D%E8%8E%B7%E5%8F%96%E7%9A%84%E6%98%AF%E5%BD%93%E5%89%8D%E6%9C%AF%E8%AF%AD%E7%9A%84ACF%E5%AD%97%E6%AE%B5%E5%80%BC%E3%80%82esc_url()%20%E5%92%8C%20esc_attr()%20/%20esc_html(): 对所有输出的URL、属性和内容进行安全转义，这是WordPress开发中的最佳实践，能有效防止安全漏洞。
get_term_link( $term, $taxonomy_name ): 获取分类法术语的正确链接。
最佳实践与注意事项
理解get_field()与the_field()的区别：
get_field()：返回字段值。您需要使用echo来显示它，这使得您可以在输出前对值进行处理、判断或存储。the_field()：直接输出字段值。它更简洁，但如果您需要对值进行进一步操作，则不适用。
正确的上下文传递：当获取ACF字段时，第二个参数（$post_id, $term_id, $user_id或相应的对象）至关重要。确保您传递的是正确上下文的ID或对象。在分类法术语循环中，直接使用$term对象是最佳实践。
安全转义：始终使用WordPress提供的转义函数（如esc_url(), esc_attr(), esc_html()）来处理所有输出到HTML的内容。这是防止跨站脚本（XSS）攻击的关键。
空值检查：在尝试使用ACF字段值之前，务必检查它是否存在或是否为空。例如，if ( $term_image_url ) { … }可以避免在没有图片时输出空的标签。
错误处理：get_the_terms()等函数可能会返回WP_Error对象。在处理结果前，检查! is_wp_error( $terms )可以提高代码的健壮性。
总结
正确在WordPress自定义分类法中显示ACF图片字段，关键在于理解PHP的输出机制以及ACF函数的正确用法。通过显式地echo get_field()返回的URL，或者直接使用the_field()，并确保将正确的上下文（如$term对象）传递给ACF函数，您可以避免标签src属性为空的问题。结合安全转义和空值检查等最佳实践，您的代码将更加健壮和安全。
以上就是WordPress自定义分类法中ACF图片字段的正确显示教程的详细内容，更多请关注php中文网其它相关文章！
版权声明：本文内容由互联网用户自发贡献，该文观点仅代表作者本人。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。
如发现本站有涉嫌抄袭侵权/违法违规的内容， 请发送邮件至 chuangxiangniao@163.com 举报，一经查实，本站将立刻删除。
发布者：程序猿，转转请注明出处：https://www.chuangxiangniao.com/p/1273809.html
微信扫一扫 
支付宝扫一扫 
