05 媒体、图片与文件

整理特色图、图片尺寸、附件信息、Alt 文本、上传限制和 SVG 支持场景。

05 媒体、图片与文件

本页关键词

post thumbnails add_image_size wp_get_attachment_image upload_mimes alt

学习目标

代码使用提醒

本页代码适合用于学习和研究。复制到正式网站前,请先备份,并优先在测试环境验证。

涉及用户输入、后台保存、接口请求、删除操作和邮件发送时,要同时考虑权限、nonce、sanitize、validate 和 escape。

1. 启用特色图和自定义图片尺寸

基础
<?php function mysite_image_setup() { add_theme_support( 'post-thumbnails' ); add_image_size( 'hero-banner', 1600, 700, true ); add_image_size( 'product-card', 600, 420, true ); } add_action( 'after_setup_theme', 'mysite_image_setup' );
新增图片尺寸后,旧图通常需要重新生成缩略图。

2. 输出特色图并添加 class

基础
<?php if ( has_post_thumbnail() ) { the_post_thumbnail( 'product-card', array( 'class' => 'product-card__image', 'loading' => 'lazy', ) ); }
the_post_thumbnail 可以传尺寸和属性数组。

3. 用 wp_get_attachment_image 输出图片

实用
<?php $image_id = get_post_thumbnail_id(); if ( $image_id ) { echo wp_get_attachment_image( $image_id, 'hero-banner', false, array( 'class' => 'hero__image' ) ); }
wp_get_attachment_image 会生成更完整的图片 HTML。

4. 获取图片 Alt 文本

SEO
<?php $image_id = get_post_thumbnail_id(); $alt = get_post_meta( $image_id, '_wp_attachment_image_alt', true ); echo '<img src="' . esc_url( get_the_post_thumbnail_url( null, 'large' ) ) . '" alt="' . esc_attr( $alt ) . '">';
Alt 文本输出在属性中,要用 esc_attr。

5. 限制上传文件大小提示

后台
<?php function mysite_upload_size_notice() { $screen = get_current_screen(); if ( 'upload' === $screen->id ) { echo '<div class="notice notice-info"><p>建议上传前压缩图片,避免超过 300KB。</p></div>'; } } add_action( 'admin_notices', 'mysite_upload_size_notice' );
可以在媒体库后台给维护人员加提示。

6. 允许上传 SVG 示例

安全
<?php function mysite_allow_svg_uploads( $mimes ) { if ( current_user_can( 'manage_options' ) ) { $mimes['svg'] = 'image/svg+xml'; } return $mimes; } add_filter( 'upload_mimes', 'mysite_allow_svg_uploads' );
SVG 可能包含脚本风险,真实项目建议配合 SVG 清理库或专用插件。

7. 作者归档与博客详情页:自定义头像和简介

实用
<?php // 兼容作者归档页和普通文章详情页 $author_id = 0; if ( is_author() ) { $author_id = get_queried_object_id(); } elseif ( is_singular( 'post' ) ) { $author_id = (int) get_post_field( 'post_author', get_queried_object_id() ); } // 获取作者信息 $author_name = $author_id ? get_the_author_meta( 'display_name', $author_id ) : ''; $author_bio = $author_id ? get_the_author_meta( 'description', $author_id ) : ''; // 作者头像映射(请按实际网站修改) $author_avatars = [ 8 => '/wp-content/uploads/2024/06/kelin.webp', 12 => '/wp-content/uploads/2024/06/galen.webp', ]; ?> <?php if ( $author_id ) : ?> <div class="author-profile__avatar"> <img class="author-avatar" src="<?php echo esc_url( home_url( $author_avatars[ $author_id ] ?? '/wp-content/uploads/2024/06/avatar-au.webp' ) ); ?>" alt="<?php echo esc_attr( $author_name ); ?>" width="110" height="110" loading="eager" decoding="async"> </div> <?php endif; ?> <?php if ( $author_bio ) : ?> <p class="author-profile__bio"> <?php echo esc_html( $author_bio ); ?> </p> <?php endif; ?>
适用于 author.php 和普通文章的 single.php。根据页面类型获取作者 ID;头像与简介分别独立判断,只有有效作者 ID 时才生成头像 URL。请根据实际站点修改头像映射及路径,并上传对应图片;未指定时使用默认头像。简介为空时不输出段落。若头像不在首屏,可将 eager 改为 lazy。此代码是独立模板片段,不要执行整个分类 PHP 文件。简介的 CSS 类名为 author-profile__bio,使用时检查现有样式。

本页总结

媒体相关代码重点是图片尺寸、输出方式、Alt 文本和上传安全。图片处理好,SEO、性能和维护都会更稳定。