WordPress自定义文章类型查询与集成教程

// loop-post.php 示例片段
$the_query = isset( $args['template_args']['the_query'] ) ? $args['template_args']['the_query'] : '';
// ...
if ($the_query && $the_query->have_posts()) {
    // ... 循环显示文章 ...
}

<?php
// 定义查询参数
$custom_query_args = array(  
    'post_type'      => 'properties', // 指定要查询的自定义文章类型，例如 'properties'
    'post_status'    => 'publish',    // 只获取已发布的文章
    'posts_per_page' => 8,            // 每页显示8篇文章
    'orderby'        => 'title',      // 按标题排序
    'order'          => 'ASC',        // 升序排列
    // 更多参数可以根据需求添加，例如：
    // 'category_name'  => 'featured', // 按分类名称查询
    // 'tag'            => 'new-arrival', // 按标签查询
    // 'author'         => 1,          // 查询特定作者的文章
    // 'tax_query'      => array( ... ), // 复杂的分类法查询
    // 'meta_query'     => array( ... ), // 复杂的自定义字段查询
);

// 实例化 WP_Query 对象
$custom_the_query = new WP_Query( $custom_query_args ); 

// 以下是循环示例，展示如何使用这个查询对象
if ( $custom_the_query->have_posts() ) :
    while ( $custom_the_query->have_posts() ) : $custom_the_query->the_post(); 
        // 在这里可以调用模板片段或直接输出内容
        echo '<h3>' . get_the_title() . '</h3>';
        the_excerpt();
        // ... 其他内容，如缩略图、链接等
    endwhile;
    // 恢复全局文章数据，非常重要
    wp_reset_postdata(); 
else :
    echo '<p>没有找到任何属性。</p>';
endif;
?>

<?php
// 在调用 loop-post.php 之前构建自定义查询
$custom_query_args = array(  
    'post_type'      => 'properties', // 使用你的自定义文章类型
    'post_status'    => 'publish',
    'posts_per_page' => 10,
    'orderby'        => 'date',
    'order'          => 'DESC',
);
$custom_the_query = new WP_Query( $custom_query_args ); 

// 构建传递给 uwp_get_template 的参数
$template_args = array(
    'template_args' => array(
        'the_query' => $custom_the_query, // 将你的自定义查询对象传递进去
        'title'     => '最新属性',         // 更新标题
    ),
);

// 调用模板，此时 loop-post.php 将使用你的自定义查询
uwp_get_template('loop-post.php', $template_args);

// 务必在自定义查询之后调用 wp_reset_postdata()
wp_reset_postdata();
?>

<?php
if ( ! defined( 'ABSPATH' ) ) {
    exit; // Exit if accessed directly
}

// 原始代码：从 $args 获取 $the_query
// $the_query = isset( $args['template_args']['the_query'] ) ? $args['template_args']['the_query'] : '';

// 替换为你的自定义查询
$custom_query_args = array(  
    'post_type'      => 'properties', // 指定自定义文章类型
    'post_status'    => 'publish',
    'posts_per_page' => 8,
    'orderby'        => 'title',
    'order'          => 'ASC',
);
$the_query = new WP_Query( $custom_query_args ); // 直接在这里实例化你的查询

$title = isset( $args['template_args']['title'] ) ? $args['template_args']['title'] : '属性列表'; // 可以自定义标题
?>
<h3><?php echo $title; ?></h3>
<div class="uwp-profile-item-block">
    <?php
    // The Loop
    if ($the_query && $the_query->have_posts()) {
        echo '<ul class="uwp-profile-item-ul">';
        while ($the_query->have_posts()) {
            $the_query->the_post();
            uwp_get_template('posts-post.php', $args); // posts-post.php 将使用当前文章数据
        }
        echo '</ul>';

        /* Restore original Post Data */
        wp_reset_postdata();
    } else {
        // no posts found
        echo "<p>".sprintf( __( "No %s found.", 'userswp' ), $title )."</p>";
    }
    do_action('uwp_profile_pagination', $the_query->max_num_pages);
    ?>
</div>

<?php
// 1. 定义自定义查询参数
$property_query_args = array(  
    'post_type'      => 'properties', // 你的自定义文章类型
    'post_status'    => 'publish',
    'posts_per_page' => 5,            // 每页显示5个属性
    'orderby'        => 'date',       // 按发布日期排序
    'order'          => 'DESC',       // 最新发布的在前
);

// 2. 实例化 WP_Query 对象
$property_query = new WP_Query( $property_query_args ); 

// 3. 开始循环
if ( $property_query->have_posts() ) :
    echo '<ul class="uwp-profile-item-ul">';
    while ( $property_query->have_posts() ) : $property_query->the_post(); 
        // 模拟 posts-post.php 的内容输出
        // 这里可以根据 posts-post.php 的逻辑，直接输出HTML
        // 或者如果 uwp_get_template 可以被调用，则继续调用

        // 假设直接输出HTML，类似 posts-post.php 的结构
        ?>
        <li class="uwp-profile-item-li uwp-profile-item-clearfix">
            <div class="uwp_generic_thumb_wrap">
                <a class="uwp-profile-item-img" href="<?php echo esc_url_raw( get_the_permalink() ); ?>">
                    <?php
                    if ( has_post_thumbnail() ) {
                        $thumb_url = get_the_post_thumbnail_url( get_the_ID(), array( 80, 80 ) );
                    } else {
                        // 替换为你的默认缩略图URI
                        $thumb_url = 'https://via.placeholder.com/80'; 
                    }
                    ?>
                    <img class="uwp-profile-item-alignleft uwp-profile-item-thumb"
                         src="<?php echo esc_url_raw( $thumb_url ); ?>" alt="<?php echo esc_attr( get_the_title() ); ?>">
                </a>
            </div>

            <h3 class="uwp-profile-item-title">
                <a href="<?php echo esc_url_raw( get_the_permalink() ); ?>"><?php echo get_the_title(); ?></a>
            </h3>
            <time class="uwp-profile-item-time published" datetime="<?php echo get_the_time( 'c' ); ?>">
                <?php echo get_the_date(); ?>
            </time>
            <div class="uwp-profile-item-summary">
                <?php
                // do_action( 'uwp_before_profile_summary', get_the_ID(), $post->post_author, $post->post_type );
                $excerpt = strip_shortcodes( wp_trim_words( get_the_excerpt(), 15, '...' ) );
                echo esc_html( $excerpt ); // 使用 esc_html 而非 esc_attr
                // do_action( 'uwp_after_profile_summary', get_the_ID(), $post->post_author, $post->post_type );
                ?>
            </div>
        </li>
        <?php
    endwhile;
    echo '</ul>';

    // 4. 恢复全局文章数据，非常重要
    wp_reset_postdata(); 
else :
    echo '<p>目前没有可用的属性信息。</p>';
endif;
?>