WordPress从入门到精通

<?php
// 数据库配置
define('DB_NAME', 'wordpress');
define('DB_USER', 'wpuser');
define('DB_PASSWORD', 'YourStrongPassword123!');
define('DB_HOST', 'localhost');
define('DB_CHARSET', 'utf8mb4');
define('DB_COLLATE', 'utf8mb4_unicode_ci');

// 直接粘贴官方生成的密钥
// 访问 https://api.wordpress.org/secret-key/1.1/salt/ 生成

// WordPress 表前缀
$table_prefix = 'wp_';

// 调试模式（生产环境设为 false）
define('WP_DEBUG', false);
define('WP_DEBUG_LOG', false);
define('WP_DEBUG_DISPLAY', false);

// 内存限制
define('WP_MEMORY_LIMIT', '256M');
define('WP_MAX_MEMORY_LIMIT', '512M');

// 文件编辑器（生产环境禁用）
define('DISALLOW_FILE_EDIT', true);

// 自动更新
define('WP_AUTO_UPDATE_CORE', 'minor');

// 文件系统方法
define('FS_METHOD', 'direct');

if ( ! defined( 'ABSPATH' ) ) {
    define( 'ABSPATH', __DIR__ . '/' );
}
require_once ABSPATH . 'wp-settings.php';

<?php
// 加载父主题样式
function child_theme_styles() {
    wp_enqueue_style('parent-style', get_template_directory_uri() . '/style.css');
    wp_enqueue_style('child-style', get_stylesheet_uri(), array('parent-style'), wp_get_theme()->get('Version'));
}
add_action('wp_enqueue_scripts', 'child_theme_styles');

<?php
/**
 * My Theme Functions
 */

// 主题支持
function my_theme_setup() {
    // 支持标题标签
    add_theme_support('title-tag');

    // 支持特色图片
    add_theme_support('post-thumbnails');

    // 支持自定义 Logo
    add_theme_support('custom-logo', array(
        'height'      => 100,
        'width'       => 300,
        'flex-height' => true,
        'flex-width'  => true,
    ));

    // 支持 HTML5 标签
    add_theme_support('html5', array(
        'search-form', 'comment-form', 'comment-list',
        'gallery', 'caption', 'style', 'script',
    ));

    // 注册导航菜单
    register_nav_menus(array(
        'primary'   => __('Primary Menu', 'my-theme'),
        'footer'    => __('Footer Menu', 'my-theme'),
        'sidebar'   => __('Sidebar Menu', 'my-theme'),
    ));

    // 自定义图片尺寸
    add_image_size('featured-large', 1200, 630, true);
    add_image_size('card-thumb', 400, 300, true);
}
add_action('after_setup_theme', 'my_theme_setup');

// 注册侧边栏
function my_theme_widgets_init() {
    register_sidebar(array(
        'name'          => __('Main Sidebar', 'my-theme'),
        'id'            => 'main-sidebar',
        'description'   => __('Add widgets here', 'my-theme'),
        'before_widget' => '<section id="%1$s" class="widget %2$s">',
        'after_widget'  => '</section>',
        'before_title'  => '<h3 class="widget-title">',
        'after_title'   => '</h3>',
    ));

    register_sidebar(array(
        'name'          => __('Footer Widgets', 'my-theme'),
        'id'            => 'footer-widgets',
        'before_widget' => '<div class="footer-widget %2$s">',
        'after_widget'  => '</div>',
        'before_title'  => '<h4 class="footer-widget-title">',
        'after_title'   => '</h4>',
    ));
}
add_action('widgets_init', 'my_theme_widgets_init');

// 加载样式和脚本
function my_theme_scripts() {
    wp_enqueue_style('my-theme-style', get_stylesheet_uri(), array(), wp_get_theme()->get('Version'));
    wp_enqueue_style('my-theme-main', get_template_directory_uri() . '/assets/css/main.css', array(), '1.0.0');
    wp_enqueue_script('my-theme-main', get_template_directory_uri() . '/assets/js/main.js', array(), '1.0.0', true);

    // 添加自定义属性到 WordPress 生成的 JS（如 AJAX nonce）
    wp_localize_script('my-theme-main', 'myThemeData', array(
        'ajaxUrl' => admin_url('admin-ajax.php'),
        'nonce'   => wp_create_nonce('my_theme_nonce'),
    ));
}
add_action('wp_enqueue_scripts', 'my_theme_scripts');

// 自定义摘要长度
function my_theme_excerpt_length($length) {
    return 30;
}
add_filter('excerpt_length', 'my_theme_excerpt_length');

// 自定义摘要后缀
function my_theme_excerpt_more($more) {
    return '...';
}
add_filter('excerpt_more', 'my_theme_excerpt_more');

<!DOCTYPE html>
<html <?php language_attributes(); ?>>
<head>
    <meta charset="<?php bloginfo('charset'); ?>">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <?php wp_head(); ?>
</head>
<body <?php body_class(); ?>>
<?php wp_body_open(); ?>

<header class="site-header">
    <div class="container">
        <div class="site-branding">
            <?php
            if (has_custom_logo()) {
                the_custom_logo();
            } else {
                echo '<h1 class="site-title"><a href="' . esc_url(home_url('/')) . '">' . get_bloginfo('name') . '</a></h1>';
            }
            ?>
        </div>

        <nav class="main-navigation">
            <?php
            wp_nav_menu(array(
                'theme_location' => 'primary',
                'container'      => false,
                'menu_class'     => 'nav-menu',
            ));
            ?>
        </nav>
    </div>
</header>

<main class="site-main">

</main>

<footer class="site-footer">
    <div class="container">
        <?php
        if (is_active_sidebar('footer-widgets')) {
            dynamic_sidebar('footer-widgets');
        }
        ?>

        <nav class="footer-navigation">
            <?php
            wp_nav_menu(array(
                'theme_location' => 'footer',
                'container'      => false,
                'menu_class'     => 'footer-menu',
            ));
            ?>
        </nav>

        <p class="copyright">
            &copy; <?php echo date('Y'); ?> <?php bloginfo('name'); ?>.
            <?php _e('All rights reserved.', 'my-theme'); ?>
        </p>
    </div>
</footer>

<?php wp_footer(); ?>
</body>
</html>

<?php get_header(); ?>

<div class="container">
    <?php if (have_posts()) : ?>
        <div class="posts-grid">
            <?php while (have_posts()) : the_post(); ?>
                <article id="post-<?php the_ID(); ?>" <?php post_class('post-card'); ?>>
                    <?php if (has_post_thumbnail()) : ?>
                        <a href="<?php the_permalink(); ?>" class="post-thumbnail">
                            <?php the_post_thumbnail('card-thumb'); ?>
                        </a>
                    <?php endif; ?>

                    <div class="post-content">
                        <h2 class="post-title">
                            <a href="<?php the_permalink(); ?>"><?php the_title(); ?></a>
                        </h2>

                        <div class="post-meta">
                            <span class="post-date"><?php echo get_the_date(); ?></span>
                            <span class="post-author"><?php the_author(); ?></span>
                            <span class="post-category"><?php the_category(', '); ?></span>
                        </div>

                        <div class="post-excerpt">
                            <?php the_excerpt(); ?>
                        </div>

                        <a href="<?php the_permalink(); ?>" class="read-more">
                            <?php _e('Read More', 'my-theme'); ?> →
                        </a>
                    </div>
                </article>
            <?php endwhile; ?>
        </div>

        <?php the_posts_pagination(array(
            'mid_size'  => 2,
            'prev_text' => __('← Previous', 'my-theme'),
            'next_text' => __('Next →', 'my-theme'),
        )); ?>

    <?php else : ?>
        <p><?php _e('No posts found.', 'my-theme'); ?></p>
    <?php endif; ?>
</div>

<?php get_footer(); ?>

<?php get_header(); ?>

<div class="container">
    <?php while (have_posts()) : the_post(); ?>
        <article id="post-<?php the_ID(); ?>" <?php post_class('single-post'); ?>>
            <header class="entry-header">
                <h1 class="entry-title"><?php the_title(); ?></h1>
                <div class="post-meta">
                    <span><?php echo get_the_date(); ?></span>
                    <span><?php the_author(); ?></span>
                    <?php the_category(', '); ?>
                </div>
            </header>

            <?php if (has_post_thumbnail()) : ?>
                <div class="post-thumbnail">
                    <?php the_post_thumbnail('featured-large'); ?>
                </div>
            <?php endif; ?>

            <div class="entry-content">
                <?php the_content(); ?>
                <?php wp_link_pages(); ?>
            </div>

            <footer class="entry-footer">
                <div class="tags"><?php the_tags('', ', ', ''); ?></div>
            </footer>

            <?php
            // 上一篇/下一篇
            the_post_navigation(array(
                'prev_text' => '<span class="nav-subtitle">' . __('Previous:', 'my-theme') . '</span> <span class="nav-title">%title</span>',
                'next_text' => '<span class="nav-subtitle">' . __('Next:', 'my-theme') . '</span> <span class="nav-title">%title</span>',
            ));
            ?>

            <?php comments_template(); ?>
        </article>
    <?php endwhile; ?>
</div>

<?php get_footer(); ?>

<?php get_header(); ?>

<div class="container error-404">
    <h1>404</h1>
    <h2><?php _e('Page Not Found', 'my-theme'); ?></h2>
    <p><?php _e('The page you are looking for does not exist.', 'my-theme'); ?></p>

    <?php get_search_form(); ?>

    <a href="<?php echo esc_url(home_url('/')); ?>" class="btn">
        <?php _e('Back to Home', 'my-theme'); ?>
    </a>
</div>

<?php get_footer(); ?>

// 文章
the_ID();                         // 文章 ID
the_title();                      // 标题
the_content();                    // 正文
the_excerpt();                    // 摘要
the_permalink();                  // 文章链接
the_author();                     // 作者
the_date();                       // 发布日期
the_category(', ');               // 分类
the_tags('', ', ', '');           // 标签
the_post_thumbnail('medium');     // 特色图片
the_comments_number();            // 评论数
edit_post_link('Edit');           // 编辑链接

// 查询
have_posts();                     // 是否有文章
the_post();                       // 移到下一篇文章

// 条件标签
is_home()                         // 是否首页
is_front_page()                   // 是否静态首页
is_single()                       // 是否单篇文章
is_page()                         // 是否页面
is_archive()                      // 是否归档
is_category()                     // 是否分类页
is_tag()                          // 是否标签页
is_search()                       // 是否搜索页
is_404()                          // 是否 404
is_user_logged_in()               // 是否已登录
is_admin()                        // 是否后台
is_singular('post')               // 是否单篇特定类型

// 站点信息
bloginfo('name');                 // 站点名称
bloginfo('description');          // 站点描述
bloginfo('url');                  // 站点 URL
home_url('/');                    // 首页 URL
site_url('/');                    // 站点 URL
admin_url('/');                   // 后台 URL
get_template_directory_uri();     // 主题 URL
get_stylesheet_directory_uri();   // 子主题 URL
get_template_directory();         // 主题路径

// 自定义字段
get_post_meta($post_id, 'key', true);
the_meta();                       // 输出所有自定义字段

// 菜单
wp_nav_menu(array('theme_location' => 'primary'));

// 小工具
dynamic_sidebar('sidebar-id');
is_active_sidebar('sidebar-id');