本文详解如何在 astra 主题「custom layouts」中，通过 php 条件判断，仅当特色图像存在非空标题（caption）时，在页眉右上角安全渲染自定义图标（如 `uil-camera`）与标题文本的组合内容。
在 WordPress + Astra 主题中，利用 Custom Layouts 添加动态页眉元素时，一个常见需求是：仅当当前文章/页面设置了特色图像标题（Caption）时，才在页眉右上角显示带图标的说明文字（例如相机图标 + “Photo by XXX”）。但直接使用 the_post_thumbnail_caption() 会导致内容重复输出或 HTML 结构错乱——因为该函数默认直接输出（echo），而非返回字符串。
✅ 正确做法是改用 get_the_post_thumbnail_caption() —— 它返回纯字符串，便于条件判断和灵活拼接：
? 关键要点说明：
传媒公司模板(RTCMS)1.0
下载
传媒企业网站系统使用热腾CMS(RTCMS),根据网站板块定制的栏目，如果修改栏目，需要修改模板相应的标签。站点内容均可在后台网站基本设置中添加。全站可生成HTML，安装默认动态浏览。并可以独立设置SEO标题、关键字、描述信息。源码包中带有少量测试数据，安装时可选择演示安装或全新安装。如果全新安装，后台内容充实后，首页才能完全显示出来。（全新安装后可以删除演示数据用到的图片，目录在https://
- get_the_post_thumbnail_caption() 替代 the_post_thumbnail_caption()：前者返回值可赋给变量，后者直接输出且无法捕获，易导致图标与文字错位或重复渲染；
- esc_html() 而非 esc_url()：标题是普通文本（非 URL），应使用 esc_html() 防 XSS，确保安全输出；
- trim() 包裹判断：避免因用户仅输入空格导致 !empty($caption) 误判为真；
- 添加 aria-hidden="true"：提升可访问性，明确告知屏幕阅读器该图标仅为装饰；
- z-index: 10：确保图标文字层叠于其他页眉元素之上，防止被遮挡；
- CDN 引入建议：将 标签移至主题 header.php 或通过 wp_enqueue_style() 在 functions.php 中注册加载，避免多次重复引入。
⚠️ 注意事项：
- 此代码需添加到 Astra Custom Layout 的「PHP Code」区块中（启用「Execute PHP」选项）；
- 若在首页或存档页等无单篇文章上下文的页面使用，请先确认 $post 全局对象已正确设置，必要时添加 global $post; 和 setup_postdata($post);；
- 图标字体加载建议使用子主题或 wp_enqueue_style() 方式，以兼容缓存与性能优化（CDN 可能受地区或 CSP 策略限制）。
最终效果：仅当编辑器中为特色图像填写了有效标题时，页眉右上角才会精准显示「? Photo by Jane Doe」样式内容，干净、可控、符合 WordPress 最佳实践。
