本文介绍如何通过 the_content 钩子，在文章正文渲染完成后，自动追加该文章所有已上传的附件图片 URL，适用于主题开发或内容增强场景。
本文介绍如何通过 `the_content` 钩子，在文章正文渲染完成后，自动追加该文章所有已上传的附件图片 url，适用于主题开发或内容增强场景。
在 WordPress 主题开发中，有时需要在文章正文（即 the_content() 输出的内容）之后统一展示所有与该文章关联的附件图片——例如用于图集预览、资源下载索引或 SEO 友好型媒体列表。实现这一需求的关键在于安全、精准地拦截并扩展 the_content 过滤器，而非直接修改模板逻辑。
以下是一个健壮、可复用的解决方案：
<?php add_filter('the_content', 'append_attached_images_to_content', 10, 1);
function append_attached_images_to_content($content) {
// 仅在单篇文章主循环中执行（避免影响首页摘要、搜索结果、REST API 等）
if (is_singular('post') && in_the_loop() && is_main_query()) {
$post_id = get_the_ID();
$attached_images = get_attached_media('image', $post_id);
if (!empty($attached_images)) {
$content .= '<div class="attached-images-list"><h4>相关图片附件</h4>
- ';
foreach ($attached_images as $img) {
$url = wp_get_attachment_url($img->ID);
$alt = get_post_meta($img->ID, '_wp_attachment_image_alt', true) ?: $img->post_title;
$content .= sprintf('
- %s ', esc_url($url), esc_html($alt)); } $content .= '
✅ 关键说明：
- 使用
10作为优先级（默认值），确保兼容其他插件过滤器；若需更早/晚执行，可调整该数值； -
is_singular('post')明确限定作用域为普通文章（可按需改为'page'或自定义类型）； -
in_the_loop() && is_main_query()是双重保险，防止在侧边栏、小工具或 WP_Query 子查询中误触发； - 使用
esc_url()和esc_html()强制转义输出，保障 XSS 安全； - 建议将 HTML 封装为语义化结构（如
<div class="attached-images-list">），便于 CSS 样式控制与无障碍访问。<p>⚠️ <strong>注意事项：</strong> </p> <ul> <li>此方法仅处理「已插入媒体库且关联到当前文章」的图片（即通过后台“添加媒体”上传并绑定到该文章 ID 的附件），不包含纯外链图片或未关联的媒体； </li> <li>若文章含大量图片，建议配合懒加载或分页优化前端性能； </li> <li>如需输出缩略图而非原始 URL，可改用 <code>wp_get_attachment_image()并传入尺寸参数。
通过该方案，你无需改动任何模板文件，即可全局、一致地在每篇符合条件的文章末尾呈现结构清晰、安全可靠的附件图片列表。
