<?php if ( have_posts() ) : ?>
  <ul class="post-list">
    <?php while ( have_posts() ) : the_post(); ?>
      <li><a href="<?php the_permalink(); ?>"><?php the_title(); ?></a></li>
    <?php endwhile; ?>
  </ul>
<?php else : ?>
  <p>暂无文章</p>
<?php endif; ?>

<?php while ( have_posts() ) : the_post(); ?>
  <article id="post-<?php the_ID(); ?>" <?php post_class(); ?>>
    <h2><?php the_title(); ?></h2>
  </article>
<?php endwhile; ?>

<?php
$args = array(
    'post_type'      => 'post',
    'posts_per_page' => 5,
    'category_name'  => 'news',
);
$query = new WP_Query( $args );
if ( $query->have_posts() ) :
    while ( $query->have_posts() ) : $query->the_post();
        ?><h3><a href="<?php the_permalink(); ?>"><?php the_title(); ?></a></h3><?php
    endwhile;
    wp_reset_postdata();
endif;
?>

<?php
$posts = get_posts( array(
    'numberposts' => 5,
    'category'    => 3,
    'post_status' => 'publish',
) );
foreach ( $posts as $post ) :
    setup_postdata( $post );
    ?><li><a href="<?php the_permalink(); ?>"><?php the_title(); ?></a></li><?php
endforeach;
wp_reset_postdata();
?>

<?php
// 修改主查询（不推荐，优先用 pre_get_posts）
query_posts( 'cat=5&posts_per_page=3' );
while ( have_posts() ) : the_post();
    ?><h3><?php the_title(); ?></h3><?php
endwhile;
wp_reset_query();
?>

<?php
$q = new WP_Query( array( 'post_type' => 'product' ) );
while ( $q->have_posts() ) : $q->the_post();
    ?><p><?php the_title(); ?></p><?php
endwhile;
wp_reset_postdata(); // 恢复全局 $post 为主查询数据
?>

<?php
query_posts( 'cat=2' );
while ( have_posts() ) : the_post();
    ?><h4><?php the_title(); ?></h4><?php
endwhile;
wp_reset_query(); // 与 query_posts() 配对使用
?>

<?php
$posts = get_posts( array( 'numberposts' => 3 ) );
foreach ( $posts as $post ) :
    setup_postdata( $post ); // 使模板标签在循环外正常工作
    ?><a href="<?php the_permalink(); ?>"><?php the_title(); ?></a><?php
endforeach;
wp_reset_postdata();
?>

<h1 class="entry-title"><?php the_title(); ?></h1>

<!-- 在链接中使用，带属性 -->
<a href="<?php the_permalink(); ?>" title="<?php the_title_attribute(); ?>">
  <?php the_title(); ?>
</a>

<?php
// 获取标题字符串，用于拼接或传参
$title = get_the_title(); // 当前文章
$other = get_the_title( 42 ); // 指定文章 ID

echo '<meta property="og:title" content="' . esc_attr( $title ) . '">';
?>

<article>
  <?php
  the_content(
    '<a class="read-more" href="' . esc_url( get_permalink() ) . '">继续阅读</a>'
  );
  ?>
</article>

<div class="card">
  <h3><?php the_title(); ?></h3>
  <p class="excerpt"><?php the_excerpt(); ?></p>
  <a href="<?php the_permalink(); ?>">阅读全文</a>
</div>

<?php
$excerpt = get_the_excerpt();
// 截取前 80 个字符作摘要
echo '<p>' . esc_html( mb_substr( $excerpt, 0, 80 ) ) . '...</p>';
?>

<!-- 文章卡片链接 -->
<a href="<?php the_permalink(); ?>" class="post-link">
  <?php the_title(); ?>
</a>

<!-- 缩略图包裹链接 -->
<a href="<?php the_permalink(); ?>">
  <?php the_post_thumbnail( 'medium' ); ?>
</a>

<?php
// 获取指定 ID 文章的永久链接
$url = get_permalink( 123 );
echo '<a href="' . esc_url( $url ) . '">查看详情</a>';

// 用于 Open Graph
echo '<meta property="og:url" content="' . esc_url( get_permalink() ) . '">';
?>

<time class="entry-date" datetime="<?php echo get_the_date('c'); ?>">
  <?php the_date( 'Y年m月d日' ); ?>
</time>

<?php
$date = get_the_date( 'Y-m-d' );
echo '<span class="date">发布于 ' . esc_html( $date ) . '</span>';
?>

<!-- 显示发布时间 -->
<span>发布时间：<?php the_time( 'H:i' ); ?></span>

<!-- 完整日期+时间 -->
<time><?php the_time( 'Y-m-d H:i:s' ); ?></time>

<p class="updated">
  最后更新：<?php the_modified_date( 'Y年m月d日' ); ?>
</p>

<!-- 用于文章 ID 锚点 / DOM 操作 -->
<article id="post-<?php the_ID(); ?>" <?php post_class(); ?>>
  <h2><?php the_title(); ?></h2>
</article>

<p class="byline">
  作者：<a href="<?php echo esc_url( get_author_posts_url( get_the_author_meta('ID') ) ); ?>">
    <?php the_author(); ?>
  </a>
</p>

<?php
$author_id = get_the_author_meta( 'ID' );
$name      = get_the_author_meta( 'display_name' );
$bio       = get_the_author_meta( 'description' );
$avatar    = get_avatar( $author_id, 64 );
echo $avatar . '<strong>' . esc_html( $name ) . '</strong>';
echo '<p>' . esc_html( $bio ) . '</p>';
?>

<a href="<?php comments_link(); ?>">
  <?php comments_number( '0 条评论', '1 条评论', '% 条评论' ); ?>
</a>

<?php
// 获取单个自定义字段
$price = get_post_meta( get_the_ID(), 'product_price', true );
if ( $price ) {
    echo '<span class="price">¥' . esc_html( $price ) . '</span>';
}

// 获取多值字段（数组）
$images = get_post_meta( get_the_ID(), 'gallery_images', false );
foreach ( $images as $img_id ) {
    echo wp_get_attachment_image( $img_id, 'thumbnail' );
}
?>

<?php
$type = get_post_type();
if ( 'product' === $type ) {
    echo '<span class="badge">商品</span>';
} elseif ( 'post' === $type ) {
    echo '<span class="badge">文章</span>';
}
?>

<!-- 自动输出 post-N, category-X, format-X 等 class -->
<article <?php post_class( 'card my-article' ); ?>>
  <h2><?php the_title(); ?></h2>
</article>

<div class="post-cats">
  分类：<?php the_category( ' / ' ); ?>
</div>

<?php
$cats = get_the_category();
if ( $cats ) {
    $first = $cats[0];
    echo '<a href="' . esc_url( get_category_link( $first->term_id ) ) . '">'
       . esc_html( $first->name ) . '</a>';
}
?>

<?php
$cats = get_categories( array(
    'parent'  => 0,       // 只取顶级分类
    'orderby' => 'name',
    'order'   => 'ASC',
    'hide_empty' => false,
) );
echo '<ul class="cat-list">';
foreach ( $cats as $cat ) {
    echo '<li><a href="' . esc_url( get_category_link( $cat->term_id ) ) . '">'
       . esc_html( $cat->name ) . ' (' . $cat->count . ')</a></li>';
}
echo '</ul>';
?>

<div class="post-tags">
  <?php the_tags( '标签：', ' · ', '' ); ?>
</div>

<?php
$tags = get_the_tags();
if ( $tags ) {
    echo '<ul class="tags">';
    foreach ( $tags as $tag ) {
        echo '<li><a href="' . esc_url( get_tag_link( $tag->term_id ) ) . '">#'
           . esc_html( $tag->name ) . '</a></li>';
    }
    echo '</ul>';
}
?>

<?php
// 获取自定义分类法的所有项
$brands = get_terms( array(
    'taxonomy'   => 'brand',
    'hide_empty' => false,
    'orderby'    => 'count',
    'order'      => 'DESC',
) );
if ( ! is_wp_error( $brands ) ) {
    foreach ( $brands as $brand ) {
        echo '<option value="' . esc_attr( $brand->slug ) . '">'
           . esc_html( $brand->name ) . '</option>';
    }
}
?>

<?php
// 在侧边栏输出分类列表
wp_list_categories( array(
    'title_li'   => '文章分类',
    'orderby'    => 'name',
    'show_count' => true,
    'depth'      => 2,
) );
?>

<?php
// 分类页才显示分类描述
if ( is_category() ) {
    $cat  = get_queried_object();
    $desc = category_description( $cat->term_id );
    if ( $desc ) echo '<div class="cat-desc">' . $desc . '</div>';
}
?>

<?php
// 当前文章属于"精选"分类才显示角标
if ( in_category( 'featured' ) ) {
    echo '<span class="badge-featured">精选</span>';
}
?>

<?php if ( is_user_logged_in() ) : ?>
  <a href="<?php echo esc_url( admin_url() ); ?>">后台管理</a>
  <a href="<?php echo esc_url( wp_logout_url( home_url() ) ); ?>">退出登录</a>
<?php else : ?>
  <a href="<?php echo esc_url( wp_login_url() ); ?>">登录</a>
<?php endif; ?>

<?php
$user = wp_get_current_user();
if ( $user->ID ) {
    echo '<p>欢迎，' . esc_html( $user->display_name ) . '！</p>';
    echo '<p>邮箱：' . esc_html( $user->user_email ) . '</p>';
}
?>

<?php
$user_id = get_current_user_id();
if ( $user_id ) {
    // 获取该用户的自定义字段
    $vip = get_user_meta( $user_id, 'is_vip', true );
    echo $vip ? '<span class="vip-badge">VIP</span>' : '';
}
?>

<?php
// 仅管理员可见的编辑入口
if ( current_user_can( 'edit_posts' ) ) {
    echo '<a href="' . esc_url( get_edit_post_link() ) . '">编辑文章</a>';
}
?>

<div class="author-card">
  <?php echo get_avatar( get_the_author_meta( 'ID' ), 80, '', get_the_author() ); ?>
  <span><?php the_author(); ?></span>
</div>

<nav class="user-nav">
  <?php
  // 已登录显示「退出」，未登录显示「登录」
  wp_loginout( home_url(), true );
  ?>
</nav>

<!-- 单篇文章页：显示大尺寸特色图 -->
<?php if ( has_post_thumbnail() ) : ?>
  <figure class="post-cover">
    <?php the_post_thumbnail( 'large', array( 'class' => 'cover-img', 'loading' => 'lazy' ) ); ?>
  </figure>
<?php endif; ?>

<?php
$thumb = get_the_post_thumbnail_url( get_the_ID(), 'medium' );
if ( $thumb ) {
    echo '<div class="card-bg" style="background-image:url(' . esc_url($thumb) . ')"></div>';
}
// 用于 Open Graph
echo '<meta property="og:image" content="' . esc_url( get_the_post_thumbnail_url( get_the_ID(), 'full' ) ) . '">';
?>

<?php if ( has_post_thumbnail() ) : ?>
  <a href="<?php the_permalink(); ?>">
    <?php the_post_thumbnail( 'thumbnail' ); ?>
  </a>
<?php else : ?>
  <img src="<?php echo esc_url( get_template_directory_uri() . '/img/default.jpg' ); ?>" alt="">
<?php endif; ?>

<?php
// 在图集循环中输出响应式图片
$image_ids = array( 101, 102, 103 );
foreach ( $image_ids as $id ) {
    echo wp_get_attachment_image( $id, 'medium', false, array( 'class' => 'gallery-img', 'loading' => 'lazy' ) );
}
?>

<?php
$attachment_id = 56;
$file_url      = wp_get_attachment_url( $attachment_id );
echo '<a href="' . esc_url( $file_url ) . '" download>下载文件</a>';
?>

<?php
// 在 functions.php 中注册自定义尺寸
add_theme_support( 'post-thumbnails' );
add_image_size( 'hero-banner', 1440, 600, true );  // 裁剪
add_image_size( 'card-thumb',  400,  300, false ); // 等比缩放

// 模板中使用
the_post_thumbnail( 'hero-banner' );
?>

<!-- 在模板中引用主题资源 -->
<img src="<?php echo esc_url( get_template_directory_uri() . '/images/logo.png' ); ?>" alt="Logo">

<link rel="stylesheet" href="<?php echo esc_url( get_template_directory_uri() . '/css/custom.css' ); ?>">

<?php
// 子主题中引用子主题自己的资源（父主题用 get_template_directory_uri）
$icon_url = get_stylesheet_directory_uri() . '/icons/star.svg';
echo '<img src="' . esc_url( $icon_url ) . '" alt="star">';
?>

<!-- 网站首页链接 -->
<a href="<?php echo esc_url( home_url( '/' ) ); ?>">
  <img src="logo.png" alt="首页">
</a>

<?php
// 登录后跳回首页
wp_login_url( home_url() );
?>

<?php
// 构造绝对路径 URL（常用于 AJAX 接口或 REST API）
$api = site_url( '/wp-json/wp/v2/posts' );
echo '<script>var API_BASE = "' . esc_js( $api ) . '";</script>';
?>

<?php
// 带权限判断的后台链接
if ( current_user_can( 'manage_options' ) ) {
    echo '<a href="' . esc_url( admin_url( 'options-general.php' ) ) . '">网站设置</a>';
}
// ajax-admin URL（前端 AJAX 请求用）
$ajax_url = admin_url( 'admin-ajax.php' );
?>

<?php
// 引用 wp-includes 目录内的脚本（通常无需直接用）
$js = includes_url( 'js/tinymce/tinymce.min.js' );
echo '<script src="' . esc_url( $js ) . '"></script>';
?>

<?php
// 在插件内引用自身资源
function my_plugin_assets() {
    wp_enqueue_script(
        'my-plugin-js',
        plugins_url( 'js/main.js', __FILE__ ),
        array('jquery'),
        '1.0.0',
        true
    );
}
add_action( 'wp_enqueue_scripts', 'my_plugin_assets' );
?>

<!-- 页面标题和描述 -->
<title><?php echo esc_html( get_bloginfo( 'name' ) ); ?> &ndash; <?php bloginfo( 'description' ); ?></title>
<meta name="description" content="<?php echo esc_attr( get_bloginfo( 'description' ) ); ?>">

<?php
// 首页显示大 Banner，其他页显示普通头图
if ( is_front_page() ) {
    get_template_part( 'template-parts/hero-banner' );
} else {
    get_template_part( 'template-parts/page-header' );
}
?>

<?php
// 单文章页才加载评论
if ( is_single() ) {
    comments_template();
}
// 判断特定文章
if ( is_single( array( 12, 'hello-world' ) ) ) {
    echo '<div class="special-banner">特别专题</div>';
}
?>

<?php
// 关于页面特殊布局
if ( is_page( 'about' ) ) {
    get_template_part( 'template-parts/team-section' );
}
// 联系页面隐藏侧边栏
if ( is_page( array( 'contact', 'about' ) ) ) {
    $sidebar = false;
}
?>

<?php
// 归档页显示归档标题
if ( is_archive() ) {
    echo '<h1>' . esc_html( get_the_archive_title() ) . '</h1>';
    $desc = get_the_archive_description();
    if ( $desc ) echo '<div class="archive-desc">' . $desc . '</div>';
}
?>

<?php if ( is_search() ) : ?>
  <h1>搜索 “<?php echo esc_html( get_search_query() ); ?>” 的结果</h1>
  <p>共找到 <?php echo $wp_query->found_posts; ?> 篇相关文章</p>
<?php endif; ?>

<!-- 在搜索框中回显关键词 -->
<form role="search" method="get" action="<?php echo esc_url( home_url( '/' ) ); ?>">
  <input type="search" name="s"
         value="<?php echo esc_attr( get_search_query() ); ?>"
         placeholder="搜索...">
  <button type="submit">搜索</button>
</form>

<!-- 必须放在 </head> 之前，WordPress 核心、插件在此注入 CSS/JS/meta -->
<head>
  <meta charset="<?php bloginfo( 'charset' ); ?>">
  <meta name="viewport" content="width=device-width, initial-scale=1">
  <?php wp_head(); ?>
</head>

<!-- 必须放在 </body> 之前，WordPress 在此注入 JS 文件 -->
<footer>
  <p>&copy; <?php echo date('Y'); ?> <?php bloginfo('name'); ?></p>
</footer>
<?php wp_footer(); ?>
</body></html>

<?php
// functions.php 中正确加载脚本
function mytheme_scripts() {
    wp_enqueue_script(
        'my-slider',                          // 句柄
        get_template_directory_uri() . '/js/slider.js',
        array( 'jquery' ),                    // 依赖
        '2.1.0',                              // 版本
        true                                  // 放在 footer
    );
    // 传递变量给 JS
    wp_localize_script( 'my-slider', 'sliderConfig', array(
        'autoplay' => true,
        'speed'    => 500,
    ) );
}
add_action( 'wp_enqueue_scripts', 'mytheme_scripts' );
?>

<?php
function mytheme_styles() {
    // 主样式（自动读取 style.css 版本号）
    wp_enqueue_style(
        'mytheme-style',
        get_stylesheet_uri(),
        array(),
        wp_get_theme()->get('Version')
    );
    // 额外样式
    wp_enqueue_style(
        'google-fonts',
        'https://fonts.googleapis.com/css2?family=Noto+Sans+SC&display=swap',
        array(),
        null
    );
}
add_action( 'wp_enqueue_scripts', 'mytheme_styles' );
?>

<?php
// 在文章内容后追加版权声明
function add_copyright( $content ) {
    if ( is_single() && in_the_loop() ) {
        $content .= '<p class="copyright">版权归本站所有，转载请注明出处。</p>';
    }
    return $content;
}
add_filter( 'the_content', 'add_copyright' );

// 注册侧边栏
add_action( 'widgets_init', function() {
    register_sidebar( array( 'name' => '主侧边栏', 'id' => 'sidebar-1' ) );
} );
?>

<?php
// 修改摘要长度
add_filter( 'excerpt_length', function( $length ) {
    return 30; // 30 个字
} );

// 修改「阅读更多」文字
add_filter( 'excerpt_more', function() {
    return '… <a href="' . esc_url( get_permalink() ) . '">阅读全文</a>';
} );
?>

<?php
// 注册短代码 [my_button text="点击" color="blue" url="#"]
function my_button_shortcode( $atts ) {
    $a = shortcode_atts( array(
        'text'  => '按钮',
        'color' => 'primary',
        'url'   => '#',
    ), $atts, 'my_button' );

    return '<a href="' . esc_url( $a['url'] ) . '" class="btn btn-' . esc_attr($a['color']) . '">'
         . esc_html( $a['text'] ) . '</a>';
}
add_shortcode( 'my_button', 'my_button_shortcode' );
?>

<?php
// 在 PHP 中主动解析短代码（如在 Widget、自定义字段中）
$content = get_post_meta( get_the_ID(), 'custom_html', true );
echo do_shortcode( $content );

// 在侧边栏 Widget 文本中启用短代码
add_filter( 'widget_text', 'do_shortcode' );
?>

<?php
$title = get_the_title();          // 可能含 HTML 特殊字符
$url   = get_the_permalink();
$alt   = get_post_meta( get_the_ID(), 'img_alt', true );

// esc_html：输出为纯文本（转义 < > & 等）
echo '<h2>' . esc_html( $title ) . '</h2>';

// esc_url：清理 URL，防止 javascript: 等危险协议
echo '<a href="' . esc_url( $url ) . '">';

// esc_attr：用于 HTML 属性值（双引号内）
echo '<img src="cover.jpg" alt="' . esc_attr( $alt ) . '">';
?>