本教程详细介绍了如何修改wordpress网站的归档页面标题，特别是移除默认的“archive:”或“archives:”前缀。通过利用`get_the_archive_title`过滤器，您可以根据不同的归档类型（如分类、标签、自定义文章类型）灵活定制标题，提升用户体验和网站专业度。文章提供了具体代码示例及扩展用法，并强调了使用子主题的重要性。
在WordPress中，归档页（Archive Page）用于展示特定分类、标签、作者或自定义文章类型的文章列表。默认情况下，这些页面的标题通常会包含一个前缀，例如“Archive: Category Name”、“Archives: Post Type Name”等。对于许多网站，尤其是那些使用自定义文章类型来构建特定内容模块的网站，这种默认标题可能显得冗余或不符合品牌风格。例如，当您希望将一个自定义文章类型归档页的标题显示为“我的产品列表”而不是“Archives: Products”时，就需要进行自定义修改。
理解WordPress归档页标题的默认行为
WordPress通过 get_the_archive_title() 函数来生成归档页的标题。这个函数会根据当前的查询类型（例如，是分类归档、标签归档还是自定义文章类型归档）自动添加相应的文本和前缀。例如，对于名为“新闻”的分类归档页，默认标题可能是“Archive: 新闻”。
为什么需要修改归档页标题
修改归档页标题的需求主要源于以下几点：
-
优化用户体验：更简洁、更具描述性的标题能让用户更好地理解页面内容。
-
品牌一致性：移除默认前缀，使标题与网站整体风格保持一致。
-
自定义文章类型集成：当使用自定义文章类型时，默认的“Archives:”前缀可能不适用于您的特定内容展示。
-
SEO考虑：虽然标题标签（）是SEO的关键，但页面内部的H1标题也对用户体验和内容结构有影响。
不奏效的方法解析
在尝试修改WordPress标题时，一些开发者可能会尝试修改 wp_head 动作或移除 _wp_render_title_tag 函数。例如：
remove_action('wp_head', '_wp_render_title_tag');这种方法通常是无效的，因为它控制的是整个HTML
标签的渲染方式，而不是 <title> 标签内部的文本内容，也不是页面主体中由 the_archive_title() 或 get_the_archive_title() 输出的H1标题内容。要修改归档页的标题文本，我们需要使用更精确的过滤器。<h3>核心解决方案：使用 get_the_archive_title 过滤器</h3>
<p>WordPress提供了一个名为 get_the_archive_title 的过滤器，允许开发者在归档页标题被输出之前对其进行修改。这是修改归档页标题最推荐和最有效的方法。</p>
<p>以下是一个示例代码，它将移除分类归档页标题中的“Archive:”前缀，只显示分类名称：</p><pre class="brush:php;toolbar:false;">/**
* 修改WordPress归档页标题，移除分类归档的“Archive:”前缀。
*
* @param string $title 原始归档页标题。
* @return string 修改后的归档页标题。
*/
function change_archive_page_title( $title ) {
// 判断当前是否为分类归档页
if ( is_category() ) {
// 获取当前分类的标题，第二个参数设为false表示不直接输出，而是返回
$title = single_cat_title( '', false );
}
return $title;
}
// 将自定义函数挂载到 'get_the_archive_title' 过滤器上
add_filter( 'get_the_archive_title', 'change_archive_page_title' );</pre><p>将这段代码添加到您的<strong>子主题</strong>的 functions.<a style="color:#f60; text-decoration:underline;" title="php" href="https://www.php.cn/zt/15714.html" target="_blank">php</a> 文件中即可生效。</p><div class="aritcle_card flexRow">
<div class="artcardd flexRow">
<a class="aritcle_card_img" href="/xiazai/code/10767" title="启昌企业网站管理系统1.3"><img
src="https://img.php.cn/upload/webcode/000/000/005/176364720792979.jpg" alt="启昌企业网站管理系统1.3"></a>
<div class="aritcle_card_info flexColumn">
<a href="/xiazai/code/10767" title="启昌企业网站管理系统1.3">启昌企业网站管理系统1.3</a>
<p>注意：请将此程序放在网站根目录下运行。若没有IIS，请直接运行根目录下的 测试.exe 进行本地测试。 基本功能表基本设置：后台可修改联系方式,网站信息。管 理 员：可新增管理员。自定义导航：新增修改导航菜单、菜单排序等。单页管理：单页面新增关键词和描述等。新闻增加：新闻可设置标题、新闻分类、添加内容等。新闻管理：可分类查看新闻、修改新闻、删除新闻等。产品管理：产品增加二级分类，产品略缩图、产品</p>
</div>
<a href="/xiazai/code/10767" title="启昌企业网站管理系统1.3" class="aritcle_card_btn flexRow flexcenter"><b></b><span>下载</span> </a>
</div>
</div>
<h4>代码详解：</h4>
<ul>
<li>
<strong>change_archive_page_title( $title ) 函数</strong>：<ul>
<li>这是我们自定义的函数，它接收一个参数 $title，这个参数就是WordPress默认生成的归档页标题字符串。</li>
<li>if ( is_category() )：这是一个条件判断标签，用于检测当前页面是否为分类归档页。只有当页面是分类归档时，我们才执行标题修改逻辑。</li>
<li>$title = single_cat_title( '', false );：single_cat_title() 函数用于获取当前分类的标题。<ul>
<li>第一个参数 '' 表示不添加任何前缀或后缀。</li>
<li>第二个参数 false 至关重要，它告诉WordPress不要直接将标题输出到<a style="color:#f60; text-decoration:underline;" title="浏览器" href="https://www.php.cn/zt/16180.html" target="_blank">浏览器</a>，而是将其作为返回值。这样我们就可以将获取到的分类标题赋值给 $title 变量。</li>
</ul>
</li>
</ul>
</li>
<li>
<strong>add_filter( 'get_the_archive_title', 'change_archive_page_title' );</strong>：<ul><li>这是WordPress的过滤器钩子，它将我们的 change_archive_page_title 函数注册到 get_the_archive_title 过滤器上。这意味着每当WordPress尝试获取归档页标题时，都会先经过我们的函数处理。</li></ul>
</li>
</ul>
<h3>扩展与自定义</h3>
<p>上述代码只针对分类归档页。根据您的具体需求，可以进一步扩展此功能，以适应不同的归档类型或实现更复杂的标题逻辑。</p>
<h4>1. 移除所有“Archive:”或“Archives:”前缀</h4>
<p>如果您希望为所有类型的归档页（包括分类、标签、自定义文章类型等）移除默认前缀，可以使用<a style="color:#f60; text-decoration:underline;" title="正则表达式" href="https://www.php.cn/zt/15947.html" target="_blank">正则表达式</a>来匹配并替换标题：</p><pre class="brush:php;toolbar:false;">/**
* 移除所有归档页标题中的“Archive:”或“Archives:”前缀。
*
* @param string $title 原始归档页标题。
* @return string 修改后的归档页标题。
*/
function remove_all_archive_prefixes( $title ) {
// 匹配并移除“Archive: ”或“Archives: ”前缀
$title = preg_replace( '/^Archive:\s*/', '', $title );
$title = preg_replace( '/^Archives:\s*/', '', $title );
// 某些主题或插件可能还会添加“Category: ”或“Tag: ”等前缀，也可以一并移除
$title = preg_replace( '/^Category:\s*/', '', $title );
$title = preg_replace( '/^Tag:\s*/', '', $title );
// 匹配并移除“Taxonomy: ”前缀（针对自定义分类法）
$title = preg_replace( '/^Taxonomy:\s*/', '', $title );
return $title;
}
add_filter( 'get_the_archive_title', 'remove_all_archive_prefixes' );</pre><p>这段代码会更通用，它直接操作 $title 字符串，通过正则表达式移除各种可能的前缀。</p>
<h4>2. 针对自定义文章类型 (CPT) 归档页</h4>
<p>如果您想为特定的自定义文章类型归档页设置标题，可以使用 is_post_type_archive() 和 post_type_archive_title()：</p><pre class="brush:php;toolbar:false;">/**
* 修改特定自定义文章类型归档页的标题。
*
* @param string $title 原始归档页标题。
* @return string 修改后的归档页标题。
*/
function change_custom_post_type_archive_title( $title ) {
// 替换 'your_custom_post_type' 为您的自定义文章类型名称
if ( is_post_type_archive( 'product' ) ) {
// 获取自定义文章类型归档的标题，不带前缀
$title = post_type_archive_title( '', false );
// 或者完全自定义为固定文本
// $title = '我们的产品列表';
} elseif ( is_post_type_archive( 'event' ) ) {
$title = '最新活动';
}
return $title;
}
add_filter( 'get_the_archive_title', 'change_custom_post_type_archive_title' );</pre><h4>3. 完全自定义标题或返回空字符串</h4>
<p>在某些情况下，您可能希望归档页的标题完全自定义，或者干脆不显示标题（返回空字符串）。</p><pre class="brush:php;toolbar:false;">/**
* 完全自定义归档页标题或使其为空。
*
* @param string $title 原始归档页标题。
* @return string 修改后的归档页标题。
*/
function full_custom_archive_title( $title ) {
if ( is_category( 'news' ) ) {
$title = '最新新闻报道'; // 特定分类的自定义标题
} elseif ( is_post_type_archive( 'portfolio' ) ) {
$title = '我的作品集'; // 特定自定义文章类型的自定义标题
} elseif ( is_archive() ) { // 对于所有其他归档页，移除所有标题
$title = ''; // 返回空字符串，不显示任何标题
}
return $title;
}
add_filter( 'get_the_archive_title', 'full_custom_archive_title' );</pre><h3>注意事项</h3>
<ol>
<li>
<strong>使用子主题 (Child Theme)</strong>：将所有自定义代码放入您当前主题的子主题的 functions.php 文件中。这可以确保在主题更新时您的修改不会丢失。</li>
<li>
<strong>条件判断的精确性</strong>：根据您的需求，精确使用WordPress的条件判断标签，如 is_category()、is_tag()、is_tax()、is_post_type_archive() 或更通用的 is_archive()。避免使用过于宽泛的条件，以免影响到不希望修改的页面。</li>
<li>
<strong>代码冲突</strong>：在添加代码前，请确保您的代码不会与其他插件或主题功能产生冲突。如果遇到问题，可以尝试暂时禁用其他插件进行排查。</li>
<li>
<strong>SEO影响</strong>：虽然本教程修改的是页面内部的H1标题，但通常 <title> 标签（浏览器标签页显示的标题）也是由 get_the_archive_title() 的结果生成的。一个清晰、准确的页面标题对SEO是有益的，因此请确保您的自定义标题能够准确反映页面内容。
总结
通过灵活运用 get_the_archive_title 过滤器，您可以完全掌控WordPress归档页的标题显示方式。无论是移除冗余的前缀，还是为特定页面设置独特的标题，这个过滤器都提供了强大的定制能力。遵循本教程的指导和注意事项，您将能够轻松地优化您的WordPress网站的归档页标题，从而提升用户体验和网站的专业度。
