已创建WordPress用户分类法，如何查询并在指定页面展示用户网格

1. 先确认核心参数 #

首先要明确你创建的用户分类法的slug（即注册时指定的$taxonomy值），以及目标分类“Artists”的slug——这两个参数是后续查询的关键，务必对应准确。

2. 选择页面实现方式 #

方式一：自定义页面模板（推荐，适配主题风格）

复制当前主题的page.php文件，重命名为page-artist.php（WordPress会自动匹配slug为artist的页面），之后修改模板内容，加入用户查询和网格渲染代码。

方式二：短代码（灵活，无需修改模板）

在主题的functions.php中注册一个短代码，之后直接在“Artist”页面编辑器里插入短代码即可调用。

3. 核心用户查询代码 #

用WP_User_Query筛选出属于“Artists”分类的用户，示例代码如下（记得替换注释里的实际slug）：

// 构建查询参数
$artist_args = array(
    'tax_query' => array(
        array(
            'taxonomy' => 'your_user_taxonomy_slug', // 替换成你的用户分类法slug
            'field'    => 'slug',
            'terms'    => 'artists', // 替换成"Artists"分类的slug
        ),
    ),
    'orderby'   => 'display_name',
    'order'     => 'ASC',
);

// 执行查询
$artist_query = new WP_User_Query( $artist_args );

4. 渲染网格布局 #

遍历查询结果，输出用户卡片，同时用CSS实现网格排版：

PHP循环渲染（放在模板或短代码里）

if ( ! empty( $artist_query->results ) ) {
    echo '<div class="artist-grid">';
    foreach ( $artist_query->results as $artist ) {
        // 获取用户头像、名称、简介等信息
        $avatar = get_avatar( $artist->ID, 120, '', '', array( 'class' => 'artist-avatar' ) );
        $name = esc_html( $artist->display_name );
        $bio = esc_html( $artist->description );
        
        // 输出卡片
        echo <<<HTML
        <div class="artist-card">
            $avatar
            <h3>$name</h3>
            <p>$bio</p>
            <!-- 可添加自定义字段，比如社交媒体链接：<?= get_user_meta($artist->ID, 'social_link', true) ?> -->
        </div>
HTML;
    }
    echo '</div>';
} else {
    echo '<p>暂无艺术家信息</p>';
}

CSS网格样式（放在主题自定义CSS或style.css里）

.artist-grid {
    display: grid;
    grid-template-columns: repeat(auto-fill, minmax(260px, 1fr));
    gap: 2rem;
    padding: 3rem 0;
}

.artist-card {
    border: 1px solid #e5e5e5;
    border-radius: 8px;
    padding: 1.5rem;
    text-align: center;
    transition: box-shadow 0.2s ease;
}

.artist-card:hover {
    box-shadow: 0 4px 12px rgba(0,0,0,0.05);
}

.artist-avatar {
    border-radius: 50%;
    margin-bottom: 1rem;
    width: 120px;
    height: 120px;
    object-fit: cover;
}

5. 进阶优化建议 #

• 分页支持：如果艺术家数量较多，给$artist_args添加'paged' => get_query_var('paged')参数，再用paginate_links()生成分页导航。
• 性能优化：用wp_cache_set和wp_cache_get缓存用户查询结果，减少数据库请求次数。
• 自定义字段扩展：若需要展示艺术家的作品链接、联系方式等内容，可通过get_user_meta()获取对应字段并渲染。

内容的提问来源于stack exchange，提问作者svess