398 lines
11 KiB
PHP
398 lines
11 KiB
PHP
<?php
|
|
/**
|
|
* Homepage queries, sidebars, post stream, and pagination.
|
|
*
|
|
* @package AKSRT
|
|
*/
|
|
|
|
defined('ABSPATH') || exit;
|
|
|
|
if (!function_exists('aksrt_homepage_get_latest_query')) {
|
|
/**
|
|
* Homepage main-stream query.
|
|
*/
|
|
function aksrt_homepage_get_latest_query(): WP_Query {
|
|
static $query = null;
|
|
|
|
if ($query instanceof WP_Query) {
|
|
return $query;
|
|
}
|
|
|
|
$query_args = [
|
|
'post_type' => aksrt_homepage_get_post_types(),
|
|
'post_status' => 'publish',
|
|
'posts_per_page' => max(1, (int) get_option('posts_per_page')),
|
|
'paged' => aksrt_homepage_get_current_page(),
|
|
'ignore_sticky_posts' => false,
|
|
'orderby' => 'date',
|
|
'order' => 'DESC',
|
|
'no_found_rows' => false,
|
|
];
|
|
|
|
$exclude_ids = class_exists('\AKSRT\Settings\Settings')
|
|
? \AKSRT\Settings\Settings::home_exclude_post_ids()
|
|
: [];
|
|
if (!empty($exclude_ids)) {
|
|
$query_args['post__not_in'] = $exclude_ids;
|
|
}
|
|
|
|
$exclude_cat_ids = class_exists('\AKSRT\Settings\Settings')
|
|
? \AKSRT\Settings\Settings::home_exclude_category_ids()
|
|
: [];
|
|
if (!empty($exclude_cat_ids)) {
|
|
$query_args['category__not_in'] = $exclude_cat_ids;
|
|
}
|
|
|
|
$query = new WP_Query(aksrt_homepage_apply_sort_args($query_args));
|
|
|
|
return $query;
|
|
}
|
|
}
|
|
|
|
if (!function_exists('aksrt_homepage_get_tab_query')) {
|
|
/**
|
|
* Build a category-tab query.
|
|
*/
|
|
function aksrt_homepage_get_tab_query(int $term_id, string $orderby = 'date'): WP_Query {
|
|
static $queries = [];
|
|
|
|
$cache_key = $term_id . '_' . $orderby;
|
|
if (isset($queries[$cache_key]) && $queries[$cache_key] instanceof WP_Query) {
|
|
return $queries[$cache_key];
|
|
}
|
|
|
|
$term = get_term($term_id);
|
|
$taxonomy = ($term && !is_wp_error($term)) ? (string) $term->taxonomy : 'category';
|
|
if ($taxonomy !== 'category') {
|
|
$taxonomy = 'category';
|
|
}
|
|
|
|
$query_args = [
|
|
'post_type' => aksrt_homepage_get_post_types(),
|
|
'post_status' => 'publish',
|
|
'posts_per_page' => class_exists('\AKSRT\Settings\Settings')
|
|
? \AKSRT\Settings\Settings::homepage_tab_posts_per_page()
|
|
: 6,
|
|
'ignore_sticky_posts' => true,
|
|
'orderby' => 'date',
|
|
'order' => 'DESC',
|
|
'no_found_rows' => true,
|
|
'tax_query' => [
|
|
[
|
|
'taxonomy' => $taxonomy,
|
|
'field' => 'term_id',
|
|
'terms' => [$term_id],
|
|
],
|
|
],
|
|
];
|
|
|
|
$exclude_ids = class_exists('\AKSRT\Settings\Settings')
|
|
? \AKSRT\Settings\Settings::home_exclude_post_ids()
|
|
: [];
|
|
if (!empty($exclude_ids)) {
|
|
$query_args['post__not_in'] = $exclude_ids;
|
|
}
|
|
|
|
$queries[$cache_key] = new WP_Query(
|
|
aksrt_homepage_apply_named_sort_args($query_args, $orderby)
|
|
);
|
|
|
|
return $queries[$cache_key];
|
|
}
|
|
}
|
|
|
|
if (!function_exists('aksrt_homepage_has_active_sidebars')) {
|
|
/**
|
|
* Check whether any sidebar in the given stack is active.
|
|
*
|
|
* @param string[] $sidebar_ids
|
|
*/
|
|
function aksrt_homepage_has_active_sidebars(array $sidebar_ids): bool {
|
|
foreach ($sidebar_ids as $sidebar_id) {
|
|
if (is_active_sidebar($sidebar_id)) {
|
|
return true;
|
|
}
|
|
}
|
|
|
|
return false;
|
|
}
|
|
}
|
|
|
|
if (!function_exists('aksrt_homepage_render_widget_zone')) {
|
|
/**
|
|
* Render a stacked widget zone.
|
|
*
|
|
* @param string[] $sidebar_ids
|
|
* @param string $wrapper_class
|
|
*/
|
|
function aksrt_homepage_render_widget_zone(array $sidebar_ids, string $wrapper_class = ''): void {
|
|
if (!aksrt_homepage_has_active_sidebars($sidebar_ids)) {
|
|
wp_reset_postdata();
|
|
return;
|
|
}
|
|
|
|
echo '<div class="' . esc_attr(trim($wrapper_class)) . '">';
|
|
foreach ($sidebar_ids as $sidebar_id) {
|
|
if (is_active_sidebar($sidebar_id)) {
|
|
dynamic_sidebar($sidebar_id);
|
|
}
|
|
}
|
|
echo '</div>';
|
|
}
|
|
}
|
|
|
|
if (!function_exists('aksrt_homepage_has_sidebar')) {
|
|
/**
|
|
* Whether the fixed homepage should render an aside column.
|
|
*/
|
|
function aksrt_homepage_has_sidebar(): bool {
|
|
$has_widgets = function_exists('aksrt_has_current_sidebar_widgets')
|
|
? aksrt_has_current_sidebar_widgets()
|
|
: aksrt_homepage_has_active_sidebars([
|
|
'all_sidebar_top',
|
|
'home_sidebar',
|
|
'all_sidebar_bottom',
|
|
]);
|
|
if (!$has_widgets) {
|
|
return false;
|
|
}
|
|
|
|
if (function_exists('aksrt_is_show_sidebar')) {
|
|
return aksrt_is_show_sidebar();
|
|
}
|
|
return true;
|
|
}
|
|
}
|
|
|
|
if (!function_exists('aksrt_homepage_render_sidebar')) {
|
|
/**
|
|
* Render the homepage aside column.
|
|
*/
|
|
function aksrt_homepage_render_sidebar(): void {
|
|
if (!aksrt_homepage_has_sidebar()) {
|
|
return;
|
|
}
|
|
|
|
echo '<div class="sidebar aksrt-homepage__aside" role="complementary" aria-label="' . esc_attr__('Homepage Sidebar', 'aksrt') . '">';
|
|
|
|
if (is_active_sidebar('all_sidebar_top')) {
|
|
dynamic_sidebar('all_sidebar_top');
|
|
}
|
|
|
|
if (is_active_sidebar('home_sidebar')) {
|
|
dynamic_sidebar('home_sidebar');
|
|
}
|
|
|
|
if (is_active_sidebar('all_sidebar_bottom')) {
|
|
dynamic_sidebar('all_sidebar_bottom');
|
|
}
|
|
|
|
echo '</div>';
|
|
}
|
|
}
|
|
|
|
if (!function_exists('aksrt_homepage_get_latest_panel_contract')) {
|
|
/**
|
|
* Public-safe latest stream contract shared by homepage pagination/AJAX.
|
|
*
|
|
* @return array{query_context:string,query_vars:string,render_config:string,render_config_array:array<string,mixed>}
|
|
*/
|
|
function aksrt_homepage_get_latest_panel_contract(): array {
|
|
$query = aksrt_homepage_get_latest_query();
|
|
$query_vars = $query instanceof WP_Query ? $query->query_vars : [];
|
|
if (!is_array($query_vars)) {
|
|
$query_vars = [];
|
|
}
|
|
|
|
unset($query_vars['paged'], $query_vars['page']);
|
|
|
|
$render_config = aksrt_resolve_post_list_render_config(['context' => 'home']);
|
|
$render_config['skip_wrapper'] = true;
|
|
|
|
return [
|
|
'query_context' => 'homepage_latest',
|
|
'query_vars' => (string) wp_json_encode($query_vars),
|
|
'render_config' => (string) wp_json_encode($render_config),
|
|
'render_config_array' => $render_config,
|
|
];
|
|
}
|
|
}
|
|
|
|
if (!function_exists('aksrt_homepage_render_pagination')) {
|
|
/**
|
|
* Render pagination for the fixed homepage latest stream.
|
|
*/
|
|
function aksrt_homepage_render_pagination(WP_Query $query): void {
|
|
$max_pages = (int) $query->max_num_pages;
|
|
if ($max_pages < 2) {
|
|
return;
|
|
}
|
|
|
|
$query_page = (int) $query->get('paged');
|
|
$current_page = min(max(1, $query_page > 0 ? $query_page : aksrt_homepage_get_current_page()), $max_pages);
|
|
$pagination_mode = class_exists('\AKSRT\Settings\Settings')
|
|
? \AKSRT\Settings\Settings::get_post_pagination_mode()
|
|
: 'numbered';
|
|
|
|
if ($pagination_mode === 'numbered') {
|
|
$base_url = (string) get_query_var('aksrt_homepage_pagination_base_url');
|
|
$base_args = [
|
|
'format' => '',
|
|
'current' => $current_page,
|
|
'total' => $max_pages,
|
|
'mid_size' => 2,
|
|
'prev_text' => '<span aria-hidden="true">‹</span>',
|
|
'next_text' => '<span aria-hidden="true">›</span>',
|
|
'type' => 'array',
|
|
];
|
|
|
|
if ($base_url !== '') {
|
|
$base_args['base'] = add_query_arg(
|
|
'paged',
|
|
'%#%',
|
|
remove_query_arg(['paged', 'page'], $base_url)
|
|
);
|
|
} else {
|
|
$base_args['base'] = str_replace(999999999, '%#%', esc_url(get_pagenum_link(999999999)));
|
|
}
|
|
|
|
$links = paginate_links($base_args);
|
|
if (!$links || !is_array($links)) {
|
|
return;
|
|
}
|
|
?>
|
|
<nav class="navigation pagination" aria-label="<?php esc_attr_e('Posts', 'aksrt'); ?>">
|
|
<div class="nav-links">
|
|
<?php foreach ($links as $link) : ?>
|
|
<?php echo wp_kses_post($link); ?>
|
|
<?php endforeach; ?>
|
|
</div>
|
|
</nav>
|
|
<?php
|
|
return;
|
|
}
|
|
|
|
$contract = aksrt_homepage_get_latest_panel_contract();
|
|
?>
|
|
<div class="ajax-pagination aksrt-pagination-ajax"
|
|
data-mode="<?php echo esc_attr($pagination_mode); ?>"
|
|
data-next-page="<?php echo esc_attr($current_page + 1); ?>"
|
|
data-max-pages="<?php echo esc_attr($max_pages); ?>"
|
|
data-query-context="<?php echo esc_attr($contract['query_context']); ?>"
|
|
data-query-vars="<?php echo esc_attr($contract['query_vars']); ?>"
|
|
data-render-config="<?php echo esc_attr($contract['render_config']); ?>"
|
|
data-page="<?php echo esc_attr($current_page); ?>"
|
|
data-tab="latest">
|
|
<a href="javascript:;" class="ajax-next aksrt-load-more-btn">
|
|
<?php esc_html_e('加载更多', 'aksrt'); ?>
|
|
</a>
|
|
<div class="aksrt-loading-indicator" style="display:none;" aria-hidden="true">
|
|
<i class="fas fa-spinner fa-spin"></i>
|
|
<span><?php esc_html_e('加载中...', 'aksrt'); ?></span>
|
|
</div>
|
|
</div>
|
|
<?php
|
|
}
|
|
}
|
|
|
|
if (!function_exists('aksrt_get_post_gallery_images')) {
|
|
/**
|
|
* Collect gallery images for homepage mult-thumb cards.
|
|
*
|
|
* @return string[]
|
|
*/
|
|
function aksrt_get_post_gallery_images(int $post_id, int $limit = 4): array {
|
|
static $request_cache = [];
|
|
|
|
$post_id = max(0, $post_id);
|
|
$limit = max(1, min(8, $limit));
|
|
|
|
if ($post_id <= 0) {
|
|
return [];
|
|
}
|
|
|
|
if (isset($request_cache[$post_id]) && is_array($request_cache[$post_id])) {
|
|
return array_slice($request_cache[$post_id], 0, $limit);
|
|
}
|
|
|
|
$modified_gmt = (string) get_post_field('post_modified_gmt', $post_id);
|
|
$transient_key = 'aksrt_home_gallery_' . $post_id . '_' . md5($modified_gmt !== '' ? $modified_gmt : (string) $post_id);
|
|
$cached_images = get_transient($transient_key);
|
|
|
|
if (is_array($cached_images)) {
|
|
$request_cache[$post_id] = $cached_images;
|
|
return array_slice($cached_images, 0, $limit);
|
|
}
|
|
|
|
$images = [];
|
|
$featured_image = has_post_thumbnail($post_id)
|
|
? (string) get_the_post_thumbnail_url($post_id, 'medium_large')
|
|
: '';
|
|
|
|
if ($featured_image !== '') {
|
|
$images[] = esc_url_raw($featured_image);
|
|
}
|
|
|
|
$content = (string) get_post_field('post_content', $post_id, 'raw');
|
|
if ($content !== '') {
|
|
if (preg_match_all('/<img[^>]+src=["\x27]([^"\x27]+)["\x27]/i', $content, $html_matches) && !empty($html_matches[1])) {
|
|
foreach ($html_matches[1] as $raw_url) {
|
|
$images[] = esc_url_raw((string) $raw_url);
|
|
}
|
|
}
|
|
|
|
if (preg_match_all('/"url"\s*:\s*"([^"]+)"/i', $content, $block_matches) && !empty($block_matches[1])) {
|
|
foreach ($block_matches[1] as $raw_url) {
|
|
$images[] = esc_url_raw((string) $raw_url);
|
|
}
|
|
}
|
|
}
|
|
|
|
$images = array_values(array_unique(array_filter($images, static function ($url) {
|
|
return is_string($url) && $url !== '';
|
|
})));
|
|
|
|
set_transient($transient_key, $images, DAY_IN_SECONDS);
|
|
$request_cache[$post_id] = $images;
|
|
|
|
return array_slice($images, 0, $limit);
|
|
}
|
|
}
|
|
|
|
if (!function_exists('aksrt_homepage_render_posts_grid')) {
|
|
/**
|
|
* Render a list block for the fixed homepage.
|
|
*/
|
|
function aksrt_homepage_render_posts_grid(?WP_Query $query = null, bool $with_pagination = false): void {
|
|
$query = $query instanceof WP_Query ? $query : aksrt_homepage_get_latest_query();
|
|
$config = aksrt_resolve_post_list_render_config(['context' => 'home']);
|
|
$config['skip_wrapper'] = true;
|
|
|
|
// Panel already provides posts-row.ajaxpager; avoid nested wrapper.
|
|
aksrt_render_post_list($config, $query, true);
|
|
|
|
if ($with_pagination) {
|
|
aksrt_homepage_render_pagination($query);
|
|
}
|
|
}
|
|
}
|
|
|
|
if (!function_exists('aksrt_homepage_render_section')) {
|
|
/**
|
|
* Render a first-class homepage section (hero / banner).
|
|
*
|
|
* These are fixed homepage sections, not a freeform module canvas bridge.
|
|
*/
|
|
function aksrt_homepage_render_section(string $type): void {
|
|
$type = sanitize_key($type);
|
|
if (!in_array($type, ['hero', 'banner'], true)) {
|
|
return;
|
|
}
|
|
|
|
// Fixed homepage owns these sections directly.
|
|
// Keep the existing hero/banner templates as section implementations,
|
|
// but do not re-wrap them in a freeform module bridge.
|
|
get_template_part('templates/parts/home-modules/module', $type);
|
|
}
|
|
}
|