wordpress 404.php

WordPress 404.php 基础概念

404.php 是 WordPress 中的一个自定义错误页面模板文件，用于处理网站上的 404 错误。当用户访问一个不存在的页面时，WordPress 会自动加载 404.php 文件，并显示一个友好的错误信息页面。

类型

默认 404 页面：WordPress 默认提供的 404 页面。
自定义 404 页面：通过编辑 404.php 文件或使用插件创建的自定义 404 页面。

应用场景

网站改版：在网站改版期间，旧的页面可能不再存在，自定义 404 页面可以引导用户访问新的页面。
内容删除：当某些内容被删除时，自定义 404 页面可以提供替代内容或导航选项。
新站上线：新站上线初期，可能会有很多不存在的页面，自定义 404 页面可以提升用户体验。

常见问题及解决方法

问题：为什么我的自定义 404 页面没有显示？

原因：

404.php 文件不存在或路径错误。
主题的 functions.php 文件中禁用了自定义 404 页面。
服务器配置问题，导致 WordPress 无法正确加载 404.php 文件。

解决方法：

确保 404.php 文件存在于主题目录中，并且路径正确。
检查主题的 functions.php 文件，确保没有禁用自定义 404 页面的代码。
检查服务器配置，确保 WordPress 能够正确加载 404.php 文件。

示例代码

<?php
/**
 * The template for displaying 404 pages (not found)
 *
 * @package WordPress
 * @subpackage Twenty_Twenty_One
 * @since Twenty Twenty-One 1.0
 */

get_header();
?>

<main id="site-content" role="main">

    <section class="error-404 not-found">
        <header class="entry-header">
            <h1 class="entry-title"><?php esc_html_e( 'Oops! That page can&rsquo;t be found.', 'twentytwentyone' ); ?></h1>
        </header><!-- .entry-header -->

        <div class="entry-content">
            <p><?php esc_html_e( 'It looks like nothing was found at this location. Maybe try a search?', 'twentytwentyone' ); ?></p>

            <?php get_search_form(); ?>

            <?php the_widget( 'WP_Widget_Recent_Posts' ); ?>

            <div class="widget widget_categories">
                <h2 class="widget-title"><?php esc_html_e( 'Most Used Categories', 'twentytwentyone' ); ?></h2>
                <ul>
                <?php
                    wp_list_categories(
                        array(
                            'orderby'    => 'count',
                            'order'      => 'DESC',
                            'show_count' => 1,
                            'title_li'   => '',
                            'number'     => 10,
                        )
                    );
                ?>
                </ul>
            </div><!-- .widget -->

            <?php
                /* translators: %1$s: smiley */
                $archive_content = '<p>' . sprintf( esc_html__( 'Try looking in the monthly archives. %1$s', 'twentytwentyone' ), convert_smilies( ':)' ) ) . '</p>';
                the_widget( 'WP_Widget_Archives', 'dropdown=1', "after_title=</h2>$archive_content" );
            ?>

            <?php the_widget( 'WP_Widget_Tag_Cloud' ); ?>

        </div><!-- .page-content -->
    </section><!-- .error-404 -->

</main><!-- #site-content -->

<?php get_footer(); ?>