在WordPress主題開發中,有多種常用的模板文件,它們負責控制網站不同部分的顯示內容和布局,以下是一些常見的模板文件:

1.index.php

這是WordPress主題的核心模板文件。當沒有其他更具體的模板文件匹配當前頁面時,WordPress就會使用index.php來顯示內容。它通常用于顯示博客的主頁,展示文章列表等。例如,一個簡單的index.php文件可能包含以下代碼:

<?php get_header(); ?>
<div id="content">
    <?php if (have_posts()) : ?>
        <?php while (have_posts()) : the_post(); ?>
            <div class="post">
                <h2><?php the_title(); ?></h2>
                <div class="entry">
                    <?php the_excerpt(); ?>
                </div>
            </div>
        <?php endwhile; ?>
    <?php else : ?>
        <p><?php _e('Sorry, no posts matched your criteria.'); ?></p>
    <?php endif; ?>
</div>
<?php get_sidebar(); ?>
<?php get_footer(); ?>

2.header.php

用于定義網站的頭部區域,通常包含網站的標題、導航菜單、logo等內容。例如:

<!DOCTYPE html>
<html <?php language_attributes(); ?>>
<head>
    <meta charset="<?php bloginfo('charset'); ?>">
    <meta name="viewport" content="width=device-width, initial-scale=1">
    <title><?php wp_title('|', true, 'right'); ?></title>
    <?php wp_head(); ?>
</head>
<body <?php body_class(); ?>>
<div id="header">
    <h1><?php bloginfo('name'); ?></h1>
    <div id="nav">
        <?php wp_nav_menu(array('theme_location' => 'primary')); ?>
    </div>
</div>

3.footer.php

定義網站的底部區域,通常包含版權信息、底部菜單等內容。例如:

<div id="footer">
    <p>&copy; <?php echo date('Y'); ?> <?php bloginfo('name'); ?>. All rights reserved.</p>
    <div id="footer-nav">
        <?php wp_nav_menu(array('theme_location' => 'footer')); ?>
    </div>
</div>
<?php wp_footer(); ?>
</body>
</html>

4.sidebar.php

用于定義側邊欄的內容,通常包含小工具(widgets)等。例如:

<div id="sidebar">
    <?php if (is_active_sidebar('sidebar-1')) : ?>
        <?php dynamic_sidebar('sidebar-1'); ?>
    <?php endif; ?>
</div>

5.single.php

用于顯示單篇文章的完整內容。例如:

<?php get_header(); ?>
<div id="content">
    <?php if (have_posts()) : ?>
        <?php while (have_posts()) : the_post(); ?>
            <div class="post">
                <h2><?php the_title(); ?></h2>
                <div class="entry">
                    <?php the_content(); ?>
                </div>
            </div>
        <?php endwhile; ?>
    <?php else : ?>
        <p><?php _e('Sorry, no posts matched your criteria.'); ?></p>
    <?php endif; ?>
</div>
<?php get_sidebar(); ?>
<?php get_footer(); ?>

6.page.php

用于顯示單個頁面的內容,比如“關于我們”“聯系我們”等頁面。例如:

<?php get_header(); ?>
<div id="content">
    <?php if (have_posts()) : ?>
        <?php while (have_posts()) : the_post(); ?>
            <div class="page">
                <h2><?php the_title(); ?></h2>
                <div class="entry">
                    <?php the_content(); ?>
                </div>
            </div>
        <?php endwhile; ?>
    <?php else : ?>
        <p><?php _e('Sorry, no posts matched your criteria.'); ?></p>
    <?php endif; ?>
</div>
<?php get_sidebar(); ?>
<?php get_footer(); ?>

7.archive.php

用于顯示文章歸檔頁面,比如分類歸檔、標簽歸檔、日期歸檔等。例如:

<?php get_header(); ?>
<div id="content">
    <?php if (have_posts()) : ?>
        <?php while (have_posts()) : the_post(); ?>
            <div class="page">
                <h2><?php the_title(); ?></h2>
                <div class="entry">
                    <?php the_content(); ?>
                </div>
            </div>
        <?php endwhile; ?>
    <?php else : ?>
        <p><?php _e('Sorry, no posts matched your criteria.'); ?></p>
    <?php endif; ?>
</div>
<?php get_sidebar(); ?>
<?php get_footer(); ?>

8.category.php

用于顯示特定分類的歸檔頁面。如果存在category.php文件,WordPress會優先使用它來顯示分類歸檔頁面,而不是使用archive.php。例如:

<?php get_header(); ?>
<div id="content">
    <h1><?php single_cat_title(); ?></h1>
    <?php if (have_posts()) : ?>
        <?php while (have_posts()) : the_post(); ?>
            <div class="post">
                <h2><?php the_title(); ?></h2>
                <div class="entry">
                    <?php the_excerpt(); ?>
                </div>
            </div>
        <?php endwhile; ?>
    <?php else : ?>
        <p><?php _e('Sorry, no posts matched your criteria.'); ?></p>
    <?php endif; ?>
</div>
<?php get_sidebar(); ?>
<?php get_footer(); ?>

9.tag.php

用于顯示特定標簽的歸檔頁面。如果存在tag.php文件,WordPress會優先使用它來顯示標簽歸檔頁面,而不是使用archive.php。例如:

<?php get_header(); ?>
<div id="content">
    <h1><?php single_tag_title(); ?></h1>
    <?php if (have_posts()) : ?>
        <?php while (have_posts()) : the_post(); ?>
            <div class="post">
                <h2><?php the_title(); ?></h2>
                <div class="entry">
                    <?php the_excerpt(); ?>
                </div>
            </div>
        <?php endwhile; ?>
    <?php else : ?>
        <p><?php _e('Sorry, no posts matched your criteria.'); ?></p>
    <?php endif; ?>
</div>
<?php get_sidebar(); ?>
<?php get_footer(); ?>

10.search.php

用于顯示搜索結果頁面。例如:

<?php get_header(); ?>
<div id="content">
    <h1>Search Results</h1>
    <?php if (have_posts()) : ?>
        <?php while (have_posts()) : the_post(); ?>
            <div class="post">
                <h2><?php the_title(); ?></h2>
                <div class="entry">
                    <?php the_excerpt(); ?>
                </div>
            </div>
        <?php endwhile; ?>
    <?php else : ?>
        <p><?php _e('Sorry, no posts matched your criteria.'); ?></p>
    <?php endif; ?>
</div>
<?php get_sidebar(); ?>
<?php get_footer(); ?>

11.404.php

用于顯示404錯誤頁面,當用戶訪問不存在的頁面時會顯示該頁面。例如:

<?php get_header(); ?>
<div id="content">
    <h1>404 Not Found</h1>
    <p>Sorry, the page you are looking for does not exist.</p>
</div>
<?php get_footer(); ?>

12.comments.php

用于顯示文章或頁面的評論區域。例如:

<?php if (post_password_required()) {
    return;
} ?>
<div id="comments" class="comments-area">
    <?php if (have_comments()) : ?>
        <h2 class="comments-title">
            <?php
            printf(_n('One thought on “%2$s”', '%1$s thoughts on “%2$s”', get_comments_number(), 'textdomain'), number_format_i18n(get_comments_number()), '<span>' . get_the_title() . '</span>');
            ?>
        </h2>
        <ol class="comment-list">
            <?php
            wp_list_comments(array(
                'callback' => 'custom_comment_callback',
                'style' => 'ol',
                'short_ping' => true,
            ));
            ?>
        </ol>
        <?php
        the_comments_pagination(array(
            'prev_text' => '<span class="screen-reader-text">' . __('Previous', 'textdomain') . '</span>',
            'next_text' => '<span class="screen-reader-text">' . __('Next', 'textdomain') . '</span>',
        ));
        ?>
    <?php endif; ?>
    <?php
    if (!comments_open() && get_comments_number() && post_type_supports(get_post_type(), 'comments')) :
        ?>
        <p class="no-comments"><?php _e('Comments are closed.', 'textdomain'); ?></p>
    <?php
    endif;
    comment_form();
    ?>
</div>

這些模板文件相互配合,共同構成了WordPress主題的完整結構。通過合理地編寫和使用這些模板文件,可以實現豐富多樣的網站布局和功能。