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,使用时检查现有样式。