fix(homepage): unify runtime rendering contract
This commit is contained in:
@@ -25,6 +25,9 @@ require_once AKSRT_DIR . '/inc/helpers/comments/form-parts.php';
|
||||
require_once AKSRT_DIR . '/inc/helpers/comments/item.php';
|
||||
require_once AKSRT_DIR . '/inc/helpers/aksrt-flow.php';
|
||||
require_once AKSRT_DIR . '/inc/helpers/aksrt-homepage.php';
|
||||
require_once AKSRT_DIR . '/inc/helpers/homepage/content.php';
|
||||
require_once AKSRT_DIR . '/inc/helpers/homepage/header-components.php';
|
||||
require_once AKSRT_DIR . '/inc/helpers/homepage/layout.php';
|
||||
require_once AKSRT_DIR . '/inc/helpers/aksrt-single-components.php';
|
||||
require_once AKSRT_DIR . '/inc/helpers/aksrt-single.php';
|
||||
require_once AKSRT_DIR . '/inc/helpers/aksrt-yiyan.php';
|
||||
|
||||
@@ -392,765 +392,3 @@ if (!function_exists('aksrt_homepage_render_sortbar')) {
|
||||
<?php
|
||||
}
|
||||
}
|
||||
|
||||
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 (!in_array($taxonomy, ['category', 'topics'], true)) {
|
||||
$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 {
|
||||
if (function_exists('aksrt_is_show_sidebar')) {
|
||||
return aksrt_is_show_sidebar();
|
||||
}
|
||||
return aksrt_homepage_has_active_sidebars([
|
||||
'all_sidebar_top',
|
||||
'home_sidebar',
|
||||
'all_sidebar_bottom',
|
||||
'sidebar-blog',
|
||||
]);
|
||||
}
|
||||
}
|
||||
|
||||
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');
|
||||
} elseif (is_active_sidebar('sidebar-blog')) {
|
||||
dynamic_sidebar('sidebar-blog');
|
||||
}
|
||||
|
||||
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 = function_exists('aksrt_resolve_post_list_render_config')
|
||||
? aksrt_resolve_post_list_render_config(['context' => 'home'])
|
||||
: [
|
||||
'mode' => 'list',
|
||||
'context' => 'home',
|
||||
];
|
||||
|
||||
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_post_card')) {
|
||||
/**
|
||||
* Render a homepage post card inline.
|
||||
*/
|
||||
function aksrt_homepage_render_post_card(): void {
|
||||
if (!function_exists('aksrt_render_post')) {
|
||||
return;
|
||||
}
|
||||
|
||||
$config = function_exists('aksrt_resolve_post_list_render_config')
|
||||
? aksrt_resolve_post_list_render_config(['context' => 'home'])
|
||||
: [
|
||||
'mode' => 'list',
|
||||
'context' => 'home',
|
||||
];
|
||||
|
||||
echo aksrt_render_post($config); // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped
|
||||
}
|
||||
}
|
||||
|
||||
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 = function_exists('aksrt_resolve_post_list_render_config')
|
||||
? aksrt_resolve_post_list_render_config(['context' => 'home'])
|
||||
: [
|
||||
'mode' => 'list',
|
||||
'context' => 'home',
|
||||
];
|
||||
$config['skip_wrapper'] = true;
|
||||
$view = (($config['mode'] ?? 'list') === 'card') ? 'card' : 'list';
|
||||
|
||||
if (function_exists('aksrt_render_post_list')) {
|
||||
// Panel already provides posts-row.ajaxpager; avoid nested wrapper.
|
||||
aksrt_render_post_list($query, $config, true);
|
||||
} else {
|
||||
if (!$query->have_posts()) {
|
||||
echo '<div class="no-results"><p>' . esc_html__('暂无文章', 'aksrt') . '</p></div>';
|
||||
} else {
|
||||
echo '<div class="posts-row aksrt-homepage__posts" data-view="' . esc_attr($view) . '">';
|
||||
while ($query->have_posts()) {
|
||||
$query->the_post();
|
||||
aksrt_homepage_render_post_card();
|
||||
}
|
||||
echo '</div>';
|
||||
}
|
||||
wp_reset_postdata();
|
||||
}
|
||||
|
||||
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);
|
||||
}
|
||||
}
|
||||
|
||||
if (!function_exists('aksrt_header_components_page_type_keys')) {
|
||||
/**
|
||||
* Allowed page-type keys for header multi-function (zibll CFS_Module::page_type).
|
||||
*
|
||||
* @return list<string>
|
||||
*/
|
||||
function aksrt_header_components_page_type_keys(): array {
|
||||
return [
|
||||
'home',
|
||||
'topics',
|
||||
'category',
|
||||
'tag',
|
||||
'author',
|
||||
'single',
|
||||
'search',
|
||||
'forum_home',
|
||||
'forum_plate',
|
||||
'forum_post',
|
||||
'page',
|
||||
];
|
||||
}
|
||||
}
|
||||
|
||||
if (!function_exists('aksrt_header_slide_excluded_page_templates')) {
|
||||
/**
|
||||
* Page templates excluded from the generic "page" type (zibll parity).
|
||||
*
|
||||
* @return list<string>
|
||||
*/
|
||||
function aksrt_header_slide_excluded_page_templates(): array {
|
||||
return [
|
||||
'templates/pages/page-sign.php',
|
||||
'templates/pages/page-login.php',
|
||||
'templates/pages/page-register.php',
|
||||
'templates/pages/page-reset-password.php',
|
||||
'templates/pages/page-bind-account.php',
|
||||
'templates/pages/page-verify-email.php',
|
||||
'templates/pages/page-download.php',
|
||||
'templates/pages/page-download-file.php',
|
||||
'templates/pages/page-forums.php',
|
||||
];
|
||||
}
|
||||
}
|
||||
|
||||
if (!function_exists('aksrt_header_slide_match_page_type')) {
|
||||
/**
|
||||
* Whether the current main query matches a header-slider page-type key.
|
||||
*
|
||||
* Mirrors zibll zib_header_slide_is_show() matching rules.
|
||||
*/
|
||||
function aksrt_header_slide_match_page_type(string $type): bool {
|
||||
global $wp_query;
|
||||
|
||||
$type = sanitize_key($type);
|
||||
if ($type === '' || !($wp_query instanceof WP_Query)) {
|
||||
return false;
|
||||
}
|
||||
|
||||
$raw_post_type = $wp_query->get('post_type');
|
||||
if (is_array($raw_post_type)) {
|
||||
$post_type = (string) reset($raw_post_type);
|
||||
} else {
|
||||
$post_type = (string) $raw_post_type;
|
||||
}
|
||||
|
||||
// Special keys that are not plain is_{$type} flags.
|
||||
if ($type === 'topics') {
|
||||
return is_tax('topics');
|
||||
}
|
||||
|
||||
if ($type === 'forum_home') {
|
||||
return is_page_template('templates/pages/page-forums.php');
|
||||
}
|
||||
|
||||
if ($type === 'forum_plate') {
|
||||
return is_singular('aksrt_forum_plate') || $post_type === 'aksrt_forum_plate';
|
||||
}
|
||||
|
||||
if ($type === 'forum_post') {
|
||||
return is_singular('aksrt_forum_topic') || $post_type === 'aksrt_forum_topic';
|
||||
}
|
||||
|
||||
// Generic WP_Query is_* flags (home/category/tag/author/single/search/page).
|
||||
$query_flag = 'is_' . $type;
|
||||
if (empty($wp_query->{$query_flag})) {
|
||||
return false;
|
||||
}
|
||||
|
||||
if ($type === 'single') {
|
||||
// Only ordinary posts; CPTs use dedicated keys.
|
||||
return $post_type === '' || $post_type === 'post';
|
||||
}
|
||||
|
||||
if ($type === 'page') {
|
||||
foreach (aksrt_header_slide_excluded_page_templates() as $template) {
|
||||
if (is_page_template($template)) {
|
||||
return false;
|
||||
}
|
||||
}
|
||||
return true;
|
||||
}
|
||||
|
||||
return true;
|
||||
}
|
||||
}
|
||||
|
||||
if (!function_exists('aksrt_header_slide_is_show')) {
|
||||
/**
|
||||
* Whether the header multi-function slider should render (zibll header-slider contract).
|
||||
*
|
||||
* Master switch: non-empty header_components_show_on + current page-type match.
|
||||
* Device rule: header_components_device_visibility (only_pc / only_sm).
|
||||
*/
|
||||
function aksrt_header_slide_is_show(): bool {
|
||||
global $wp_query;
|
||||
|
||||
if (is_admin() || !($wp_query instanceof WP_Query)) {
|
||||
return false;
|
||||
}
|
||||
|
||||
// Not on paginated views (zibll: query_vars['paged'] non-empty).
|
||||
$paged = (int) $wp_query->get('paged');
|
||||
if ($paged > 1) {
|
||||
return false;
|
||||
}
|
||||
if (function_exists('aksrt_homepage_get_current_page') && aksrt_homepage_get_current_page() > 1) {
|
||||
return false;
|
||||
}
|
||||
|
||||
$settings = class_exists('\AKSRT\Settings\Settings')
|
||||
? \AKSRT\Settings\Settings::get_header_components_settings()
|
||||
: [];
|
||||
$show_on = isset($settings['show_on_pages']) ? (array) $settings['show_on_pages'] : [];
|
||||
$allowed = array_values(array_intersect(
|
||||
array_map('sanitize_key', $show_on),
|
||||
aksrt_header_components_page_type_keys()
|
||||
));
|
||||
|
||||
// Empty selection = feature off (zibll header_slider_show).
|
||||
if ($allowed === []) {
|
||||
return false;
|
||||
}
|
||||
|
||||
// Device visibility (zibll header_slider_show_type).
|
||||
$show_type = (string) ($settings['show_type'] ?? '');
|
||||
if ($show_type === 'only_pc' && wp_is_mobile()) {
|
||||
return false;
|
||||
}
|
||||
if ($show_type === 'only_sm' && !wp_is_mobile()) {
|
||||
return false;
|
||||
}
|
||||
|
||||
foreach ($allowed as $type) {
|
||||
if (aksrt_header_slide_match_page_type($type)) {
|
||||
return true;
|
||||
}
|
||||
}
|
||||
|
||||
return false;
|
||||
}
|
||||
}
|
||||
|
||||
if (!function_exists('aksrt_header_slide')) {
|
||||
/**
|
||||
* Render header slider after the site header (outside main).
|
||||
*/
|
||||
function aksrt_header_slide(): void {
|
||||
if (!aksrt_header_slide_is_show()) {
|
||||
return;
|
||||
}
|
||||
|
||||
// Reuse existing hero partial as the slider implementation.
|
||||
get_template_part('templates/parts/home-modules/module', 'hero');
|
||||
}
|
||||
}
|
||||
|
||||
if (!function_exists('aksrt_homepage_render_layout')) {
|
||||
/**
|
||||
* Render the fixed homepage layout (Zibll latest-first content stream).
|
||||
*
|
||||
* Order (zibll-aligned):
|
||||
* fluid top → main.container → top content → banner → tabs/list → bottom content → sidebar
|
||||
* → fluid bottom. Hero/header-slider is rendered from header.php, not here.
|
||||
*/
|
||||
function aksrt_homepage_render_layout(): void {
|
||||
$current_page = aksrt_homepage_get_current_page();
|
||||
$show_tabs = $current_page === 1;
|
||||
$tab_configs = $show_tabs ? aksrt_homepage_get_tab_configs() : [];
|
||||
$latest_contract = aksrt_homepage_get_latest_panel_contract();
|
||||
$has_sidebar = aksrt_homepage_has_sidebar();
|
||||
$banner_on = $show_tabs && aksrt_homepage_module_banner_enabled();
|
||||
$main_list_enabled = !class_exists('\AKSRT\Settings\Settings') || \AKSRT\Settings\Settings::home_posts_list_enabled();
|
||||
$list_title = class_exists('\AKSRT\Settings\Settings')
|
||||
? \AKSRT\Settings\Settings::home_list_title()
|
||||
: __('最新发布', 'aksrt');
|
||||
|
||||
// Fluid zones live outside <main>, once only (removed from header.php).
|
||||
aksrt_homepage_render_widget_zone(
|
||||
['all_top_fluid', 'home_top_fluid'],
|
||||
'fluid-widget-wrap aksrt-homepage__fluid-zone aksrt-homepage__fluid-zone--top'
|
||||
);
|
||||
?>
|
||||
<main id="main-content" role="main" class="container site-main aksrt-homepage" tabindex="-1">
|
||||
<div class="content-wrap aksrt-homepage__shell">
|
||||
<div class="content-layout aksrt-homepage__content-layout aksrt-homepage__primary">
|
||||
<?php
|
||||
aksrt_homepage_render_widget_zone(
|
||||
['home_top_content'],
|
||||
'aksrt-homepage__content-zone aksrt-homepage__content-zone--top'
|
||||
);
|
||||
|
||||
if ($banner_on && function_exists('aksrt_homepage_render_section')) {
|
||||
aksrt_homepage_render_section('banner');
|
||||
}
|
||||
?>
|
||||
|
||||
<?php if ($main_list_enabled) : ?>
|
||||
<section class="aksrt-homepage__stream home-tab-content" aria-label="<?php esc_attr_e('Homepage Content', 'aksrt'); ?>">
|
||||
<?php if ($show_tabs && !empty($tab_configs)) : ?>
|
||||
<div class="index-tab affix-header-sm relative home-tab-nav-box aksrt-homepage__tabs mb10" data-sticky-tabs="<?php echo aksrt_homepage_sticky_tabs_enabled() ? 'true' : 'false'; ?>" offset-top="-8">
|
||||
<ul class="list-inline scroll-x no-scrollbar aksrt-homepage__tab-list" role="tablist" data-aksrt-home-tabs style="width:100%;">
|
||||
<li class="aksrt-homepage__tab-item is-active" role="presentation">
|
||||
<button type="button" class="aksrt-homepage__tab-button" role="tab" aria-selected="true" data-home-tab-target="latest">
|
||||
<?php echo esc_html($list_title !== '' ? $list_title : __('最新发布', 'aksrt')); ?>
|
||||
</button>
|
||||
</li>
|
||||
<?php foreach ($tab_configs as $tab_cfg) : ?>
|
||||
<li class="aksrt-homepage__tab-item" role="presentation">
|
||||
<button
|
||||
type="button"
|
||||
class="aksrt-homepage__tab-button"
|
||||
role="tab"
|
||||
aria-selected="false"
|
||||
data-home-tab-target="term-<?php echo (int) $tab_cfg['term_id']; ?>"
|
||||
data-tab-orderby="<?php echo esc_attr($tab_cfg['orderby']); ?>"
|
||||
>
|
||||
<?php echo esc_html($tab_cfg['title']); ?>
|
||||
</button>
|
||||
</li>
|
||||
<?php endforeach; ?>
|
||||
</ul>
|
||||
<?php if (function_exists('aksrt_render_admin_quick_link')) { aksrt_render_admin_quick_link('page-display/homepage', __('首页设置', 'aksrt'), 'aksrt-admin-quicklink aksrt-homepage__admin-link'); } ?>
|
||||
</div>
|
||||
<?php elseif ($current_page > 1) : ?>
|
||||
<div class="box-body notop nobottom aksrt-homepage__titlebox">
|
||||
<div class="title-theme">
|
||||
<?php echo esc_html($list_title !== '' ? $list_title : __('最新发布', 'aksrt')); ?>
|
||||
<small class="aksrt-homepage__page-indicator ml10">
|
||||
<?php echo esc_html(sprintf(__('第 %d 页', 'aksrt'), $current_page)); ?>
|
||||
</small>
|
||||
</div>
|
||||
</div>
|
||||
<?php elseif ($list_title !== '') : ?>
|
||||
<div class="box-body notop nobottom aksrt-homepage__titlebox">
|
||||
<div class="title-theme"><?php echo esc_html($list_title); ?></div>
|
||||
</div>
|
||||
<?php endif; ?>
|
||||
|
||||
<?php aksrt_homepage_render_sortbar(); ?>
|
||||
|
||||
<div class="aksrt-homepage__panels tab-content">
|
||||
<div class="aksrt-homepage__panel posts-row ajaxpager tab-pane is-active show" role="tabpanel" data-home-tab-panel="latest" id="index-tab-main">
|
||||
<div
|
||||
class="aksrt-homepage__panel-contract"
|
||||
data-query-context="<?php echo esc_attr($latest_contract['query_context']); ?>"
|
||||
data-query-vars="<?php echo esc_attr($latest_contract['query_vars']); ?>"
|
||||
data-render-config="<?php echo esc_attr($latest_contract['render_config']); ?>"
|
||||
data-page="1"
|
||||
data-tab="latest"
|
||||
></div>
|
||||
<?php aksrt_homepage_render_posts_grid(aksrt_homepage_get_latest_query(), true); ?>
|
||||
</div>
|
||||
|
||||
<?php if ($show_tabs && !empty($tab_configs)) : ?>
|
||||
<?php foreach ($tab_configs as $tab_cfg) : ?>
|
||||
<div
|
||||
class="aksrt-homepage__panel posts-row ajaxpager tab-pane"
|
||||
role="tabpanel"
|
||||
data-home-tab-panel="term-<?php echo (int) $tab_cfg['term_id']; ?>"
|
||||
data-tab-orderby="<?php echo esc_attr($tab_cfg['orderby']); ?>"
|
||||
hidden
|
||||
></div>
|
||||
<?php endforeach; ?>
|
||||
<?php endif; ?>
|
||||
</div>
|
||||
</section>
|
||||
<?php else : ?>
|
||||
<section class="aksrt-homepage__stream home-tab-content aksrt-homepage__stream--disabled" aria-label="<?php esc_attr_e('Homepage Content', 'aksrt'); ?>">
|
||||
<div class="no-results box-body">
|
||||
<p><?php esc_html_e('首页主列表已关闭。', 'aksrt'); ?></p>
|
||||
<?php if (current_user_can('manage_options') && function_exists('aksrt_render_admin_quick_link')) : ?>
|
||||
<?php aksrt_render_admin_quick_link('page-display/homepage', __('打开首页设置并启用主列表', 'aksrt'), 'aksrt-admin-quicklink'); ?>
|
||||
<?php endif; ?>
|
||||
</div>
|
||||
</section>
|
||||
<?php endif; ?>
|
||||
|
||||
<?php
|
||||
aksrt_homepage_render_widget_zone(
|
||||
['home_bottom_content'],
|
||||
'aksrt-homepage__content-zone aksrt-homepage__content-zone--bottom'
|
||||
);
|
||||
?>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<?php aksrt_homepage_render_sidebar(); ?>
|
||||
</main>
|
||||
<?php
|
||||
aksrt_homepage_render_widget_zone(
|
||||
['home_bottom_fluid', 'all_bottom_fluid'],
|
||||
'fluid-widget-wrap aksrt-homepage__fluid-zone aksrt-homepage__fluid-zone--bottom'
|
||||
);
|
||||
}
|
||||
}
|
||||
|
||||
if (!function_exists('aksrt_render_fixed_homepage')) {
|
||||
/**
|
||||
* Render the new fixed homepage layout.
|
||||
*/
|
||||
function aksrt_render_fixed_homepage(): bool {
|
||||
if (!aksrt_is_fixed_homepage_request()) {
|
||||
return false;
|
||||
}
|
||||
|
||||
get_header();
|
||||
aksrt_homepage_render_layout();
|
||||
get_footer();
|
||||
|
||||
return true;
|
||||
}
|
||||
}
|
||||
|
||||
@@ -0,0 +1,438 @@
|
||||
<?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 (!in_array($taxonomy, ['category', 'topics'], true)) {
|
||||
$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 {
|
||||
if (function_exists('aksrt_is_show_sidebar')) {
|
||||
return aksrt_is_show_sidebar();
|
||||
}
|
||||
return aksrt_homepage_has_active_sidebars([
|
||||
'all_sidebar_top',
|
||||
'home_sidebar',
|
||||
'all_sidebar_bottom',
|
||||
'sidebar-blog',
|
||||
]);
|
||||
}
|
||||
}
|
||||
|
||||
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');
|
||||
} elseif (is_active_sidebar('sidebar-blog')) {
|
||||
dynamic_sidebar('sidebar-blog');
|
||||
}
|
||||
|
||||
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 = function_exists('aksrt_resolve_post_list_render_config')
|
||||
? aksrt_resolve_post_list_render_config(['context' => 'home'])
|
||||
: [
|
||||
'mode' => 'list',
|
||||
'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_post_card')) {
|
||||
/**
|
||||
* Render a homepage post card inline.
|
||||
*/
|
||||
function aksrt_homepage_render_post_card(): void {
|
||||
if (!function_exists('aksrt_render_post')) {
|
||||
return;
|
||||
}
|
||||
|
||||
$config = function_exists('aksrt_resolve_post_list_render_config')
|
||||
? aksrt_resolve_post_list_render_config(['context' => 'home'])
|
||||
: [
|
||||
'mode' => 'list',
|
||||
'context' => 'home',
|
||||
];
|
||||
|
||||
echo aksrt_render_post($config); // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped
|
||||
}
|
||||
}
|
||||
|
||||
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 = function_exists('aksrt_resolve_post_list_render_config')
|
||||
? aksrt_resolve_post_list_render_config(['context' => 'home'])
|
||||
: [
|
||||
'mode' => 'list',
|
||||
'context' => 'home',
|
||||
];
|
||||
$config['skip_wrapper'] = true;
|
||||
$view = (($config['mode'] ?? 'list') === 'card') ? 'card' : 'list';
|
||||
|
||||
if (function_exists('aksrt_render_post_list')) {
|
||||
// Panel already provides posts-row.ajaxpager; avoid nested wrapper.
|
||||
aksrt_render_post_list($query, $config, true);
|
||||
} else {
|
||||
if (!$query->have_posts()) {
|
||||
echo '<div class="no-results"><p>' . esc_html__('暂无文章', 'aksrt') . '</p></div>';
|
||||
} else {
|
||||
echo '<div class="posts-row aksrt-homepage__posts" data-view="' . esc_attr($view) . '">';
|
||||
while ($query->have_posts()) {
|
||||
$query->the_post();
|
||||
aksrt_homepage_render_post_card();
|
||||
}
|
||||
echo '</div>';
|
||||
}
|
||||
wp_reset_postdata();
|
||||
}
|
||||
|
||||
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);
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,184 @@
|
||||
<?php
|
||||
/**
|
||||
* Homepage header component visibility and rendering.
|
||||
*
|
||||
* @package AKSRT
|
||||
*/
|
||||
|
||||
defined('ABSPATH') || exit;
|
||||
|
||||
if (!function_exists('aksrt_header_components_page_type_keys')) {
|
||||
/**
|
||||
* Allowed page-type keys for header multi-function (zibll CFS_Module::page_type).
|
||||
*
|
||||
* @return list<string>
|
||||
*/
|
||||
function aksrt_header_components_page_type_keys(): array {
|
||||
return [
|
||||
'home',
|
||||
'topics',
|
||||
'category',
|
||||
'tag',
|
||||
'author',
|
||||
'single',
|
||||
'search',
|
||||
'forum_home',
|
||||
'forum_plate',
|
||||
'forum_post',
|
||||
'page',
|
||||
];
|
||||
}
|
||||
}
|
||||
|
||||
if (!function_exists('aksrt_header_slide_excluded_page_templates')) {
|
||||
/**
|
||||
* Page templates excluded from the generic "page" type (zibll parity).
|
||||
*
|
||||
* @return list<string>
|
||||
*/
|
||||
function aksrt_header_slide_excluded_page_templates(): array {
|
||||
return [
|
||||
'templates/pages/page-sign.php',
|
||||
'templates/pages/page-login.php',
|
||||
'templates/pages/page-register.php',
|
||||
'templates/pages/page-reset-password.php',
|
||||
'templates/pages/page-bind-account.php',
|
||||
'templates/pages/page-verify-email.php',
|
||||
'templates/pages/page-download.php',
|
||||
'templates/pages/page-download-file.php',
|
||||
'templates/pages/page-forums.php',
|
||||
];
|
||||
}
|
||||
}
|
||||
|
||||
if (!function_exists('aksrt_header_slide_match_page_type')) {
|
||||
/**
|
||||
* Whether the current main query matches a header-slider page-type key.
|
||||
*
|
||||
* Mirrors zibll zib_header_slide_is_show() matching rules.
|
||||
*/
|
||||
function aksrt_header_slide_match_page_type(string $type): bool {
|
||||
global $wp_query;
|
||||
|
||||
$type = sanitize_key($type);
|
||||
if ($type === '' || !($wp_query instanceof WP_Query)) {
|
||||
return false;
|
||||
}
|
||||
|
||||
$raw_post_type = $wp_query->get('post_type');
|
||||
if (is_array($raw_post_type)) {
|
||||
$post_type = (string) reset($raw_post_type);
|
||||
} else {
|
||||
$post_type = (string) $raw_post_type;
|
||||
}
|
||||
|
||||
// Special keys that are not plain is_{$type} flags.
|
||||
if ($type === 'topics') {
|
||||
return is_tax('topics');
|
||||
}
|
||||
|
||||
if ($type === 'forum_home') {
|
||||
return is_page_template('templates/pages/page-forums.php');
|
||||
}
|
||||
|
||||
if ($type === 'forum_plate') {
|
||||
return is_singular('aksrt_forum_plate') || $post_type === 'aksrt_forum_plate';
|
||||
}
|
||||
|
||||
if ($type === 'forum_post') {
|
||||
return is_singular('aksrt_forum_topic') || $post_type === 'aksrt_forum_topic';
|
||||
}
|
||||
|
||||
// Generic WP_Query is_* flags (home/category/tag/author/single/search/page).
|
||||
$query_flag = 'is_' . $type;
|
||||
if (empty($wp_query->{$query_flag})) {
|
||||
return false;
|
||||
}
|
||||
|
||||
if ($type === 'single') {
|
||||
// Only ordinary posts; CPTs use dedicated keys.
|
||||
return $post_type === '' || $post_type === 'post';
|
||||
}
|
||||
|
||||
if ($type === 'page') {
|
||||
foreach (aksrt_header_slide_excluded_page_templates() as $template) {
|
||||
if (is_page_template($template)) {
|
||||
return false;
|
||||
}
|
||||
}
|
||||
return true;
|
||||
}
|
||||
|
||||
return true;
|
||||
}
|
||||
}
|
||||
|
||||
if (!function_exists('aksrt_header_slide_is_show')) {
|
||||
/**
|
||||
* Whether the header multi-function slider should render (zibll header-slider contract).
|
||||
*
|
||||
* Master switch: non-empty header_components_show_on + current page-type match.
|
||||
* Device rule: header_components_device_visibility (only_pc / only_sm).
|
||||
*/
|
||||
function aksrt_header_slide_is_show(): bool {
|
||||
global $wp_query;
|
||||
|
||||
if (is_admin() || !($wp_query instanceof WP_Query)) {
|
||||
return false;
|
||||
}
|
||||
|
||||
// Not on paginated views (zibll: query_vars['paged'] non-empty).
|
||||
$paged = (int) $wp_query->get('paged');
|
||||
if ($paged > 1) {
|
||||
return false;
|
||||
}
|
||||
if (function_exists('aksrt_homepage_get_current_page') && aksrt_homepage_get_current_page() > 1) {
|
||||
return false;
|
||||
}
|
||||
|
||||
$settings = class_exists('\AKSRT\Settings\Settings')
|
||||
? \AKSRT\Settings\Settings::get_header_components_settings()
|
||||
: [];
|
||||
$show_on = isset($settings['show_on_pages']) ? (array) $settings['show_on_pages'] : [];
|
||||
$allowed = array_values(array_intersect(
|
||||
array_map('sanitize_key', $show_on),
|
||||
aksrt_header_components_page_type_keys()
|
||||
));
|
||||
|
||||
// Empty selection = feature off (zibll header_slider_show).
|
||||
if ($allowed === []) {
|
||||
return false;
|
||||
}
|
||||
|
||||
// Device visibility (zibll header_slider_show_type).
|
||||
$show_type = (string) ($settings['show_type'] ?? '');
|
||||
if ($show_type === 'only_pc' && wp_is_mobile()) {
|
||||
return false;
|
||||
}
|
||||
if ($show_type === 'only_sm' && !wp_is_mobile()) {
|
||||
return false;
|
||||
}
|
||||
|
||||
foreach ($allowed as $type) {
|
||||
if (aksrt_header_slide_match_page_type($type)) {
|
||||
return true;
|
||||
}
|
||||
}
|
||||
|
||||
return false;
|
||||
}
|
||||
}
|
||||
|
||||
if (!function_exists('aksrt_header_slide')) {
|
||||
/**
|
||||
* Render header slider after the site header (outside main).
|
||||
*/
|
||||
function aksrt_header_slide(): void {
|
||||
if (!aksrt_header_slide_is_show()) {
|
||||
return;
|
||||
}
|
||||
|
||||
// Reuse existing hero partial as the slider implementation.
|
||||
get_template_part('templates/parts/home-modules/module', 'hero');
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,166 @@
|
||||
<?php
|
||||
/**
|
||||
* Fixed homepage layout renderer.
|
||||
*
|
||||
* @package AKSRT
|
||||
*/
|
||||
|
||||
defined('ABSPATH') || exit;
|
||||
|
||||
if (!function_exists('aksrt_homepage_render_layout')) {
|
||||
/**
|
||||
* Render the fixed homepage layout (Zibll latest-first content stream).
|
||||
*
|
||||
* Order (zibll-aligned):
|
||||
* fluid top → main.container → top content → banner → tabs/list → bottom content → sidebar
|
||||
* → fluid bottom. Hero/header-slider is rendered from header.php, not here.
|
||||
*/
|
||||
function aksrt_homepage_render_layout(): void {
|
||||
$current_page = aksrt_homepage_get_current_page();
|
||||
$show_tabs = $current_page === 1;
|
||||
$tab_configs = $show_tabs ? aksrt_homepage_get_tab_configs() : [];
|
||||
$latest_contract = aksrt_homepage_get_latest_panel_contract();
|
||||
$view_mode = (($latest_contract['render_config_array']['mode'] ?? 'list') === 'card') ? 'card' : 'list';
|
||||
$banner_on = $show_tabs && aksrt_homepage_module_banner_enabled();
|
||||
$main_list_enabled = !class_exists('\AKSRT\Settings\Settings') || \AKSRT\Settings\Settings::home_posts_list_enabled();
|
||||
$list_title = class_exists('\AKSRT\Settings\Settings')
|
||||
? \AKSRT\Settings\Settings::home_list_title()
|
||||
: __('最新发布', 'aksrt');
|
||||
|
||||
// Fluid zones live outside <main>, once only (removed from header.php).
|
||||
aksrt_homepage_render_widget_zone(
|
||||
['all_top_fluid', 'home_top_fluid'],
|
||||
'fluid-widget-wrap aksrt-homepage__fluid-zone aksrt-homepage__fluid-zone--top'
|
||||
);
|
||||
?>
|
||||
<main id="main-content" role="main" class="container site-main aksrt-homepage" tabindex="-1">
|
||||
<div class="content-wrap aksrt-homepage__shell">
|
||||
<div class="content-layout aksrt-homepage__content-layout aksrt-homepage__primary">
|
||||
<?php
|
||||
aksrt_homepage_render_widget_zone(
|
||||
['home_top_content'],
|
||||
'aksrt-homepage__content-zone aksrt-homepage__content-zone--top'
|
||||
);
|
||||
|
||||
if ($banner_on && function_exists('aksrt_homepage_render_section')) {
|
||||
aksrt_homepage_render_section('banner');
|
||||
}
|
||||
?>
|
||||
|
||||
<?php if ($main_list_enabled) : ?>
|
||||
<section class="aksrt-homepage__stream home-tab-content" aria-label="<?php esc_attr_e('Homepage Content', 'aksrt'); ?>">
|
||||
<?php if ($show_tabs && !empty($tab_configs)) : ?>
|
||||
<div class="index-tab affix-header-sm relative home-tab-nav-box aksrt-homepage__tabs mb10" data-sticky-tabs="<?php echo aksrt_homepage_sticky_tabs_enabled() ? 'true' : 'false'; ?>" offset-top="-8">
|
||||
<ul class="list-inline scroll-x no-scrollbar aksrt-homepage__tab-list" role="tablist" data-aksrt-home-tabs style="width:100%;">
|
||||
<li class="aksrt-homepage__tab-item is-active" role="presentation">
|
||||
<button type="button" class="aksrt-homepage__tab-button" role="tab" aria-selected="true" data-home-tab-target="latest">
|
||||
<?php echo esc_html($list_title !== '' ? $list_title : __('最新发布', 'aksrt')); ?>
|
||||
</button>
|
||||
</li>
|
||||
<?php foreach ($tab_configs as $tab_cfg) : ?>
|
||||
<li class="aksrt-homepage__tab-item" role="presentation">
|
||||
<button
|
||||
type="button"
|
||||
class="aksrt-homepage__tab-button"
|
||||
role="tab"
|
||||
aria-selected="false"
|
||||
data-home-tab-target="term-<?php echo (int) $tab_cfg['term_id']; ?>"
|
||||
data-tab-orderby="<?php echo esc_attr($tab_cfg['orderby']); ?>"
|
||||
>
|
||||
<?php echo esc_html($tab_cfg['title']); ?>
|
||||
</button>
|
||||
</li>
|
||||
<?php endforeach; ?>
|
||||
</ul>
|
||||
<?php if (function_exists('aksrt_render_admin_quick_link')) { aksrt_render_admin_quick_link('page-display/homepage', __('首页设置', 'aksrt'), 'aksrt-admin-quicklink aksrt-homepage__admin-link'); } ?>
|
||||
</div>
|
||||
<?php elseif ($current_page > 1) : ?>
|
||||
<div class="box-body notop nobottom aksrt-homepage__titlebox">
|
||||
<div class="title-theme">
|
||||
<?php echo esc_html($list_title !== '' ? $list_title : __('最新发布', 'aksrt')); ?>
|
||||
<small class="aksrt-homepage__page-indicator ml10">
|
||||
<?php echo esc_html(sprintf(__('第 %d 页', 'aksrt'), $current_page)); ?>
|
||||
</small>
|
||||
</div>
|
||||
</div>
|
||||
<?php elseif ($list_title !== '') : ?>
|
||||
<div class="box-body notop nobottom aksrt-homepage__titlebox">
|
||||
<div class="title-theme"><?php echo esc_html($list_title); ?></div>
|
||||
</div>
|
||||
<?php endif; ?>
|
||||
|
||||
<?php aksrt_homepage_render_sortbar(); ?>
|
||||
|
||||
<div class="aksrt-homepage__panels tab-content">
|
||||
<div class="aksrt-homepage__panel aksrt-homepage__posts posts-row post-grid post-grid--home ajaxpager tab-pane is-active show" role="tabpanel" data-home-tab-panel="latest" data-view="<?php echo esc_attr($view_mode); ?>" id="index-tab-main">
|
||||
<div
|
||||
class="aksrt-homepage__panel-contract"
|
||||
data-query-context="<?php echo esc_attr($latest_contract['query_context']); ?>"
|
||||
data-query-vars="<?php echo esc_attr($latest_contract['query_vars']); ?>"
|
||||
data-render-config="<?php echo esc_attr($latest_contract['render_config']); ?>"
|
||||
data-page="1"
|
||||
data-tab="latest"
|
||||
></div>
|
||||
<?php aksrt_homepage_render_posts_grid(aksrt_homepage_get_latest_query(), true); ?>
|
||||
</div>
|
||||
|
||||
<?php if ($show_tabs && !empty($tab_configs)) : ?>
|
||||
<?php foreach ($tab_configs as $tab_cfg) : ?>
|
||||
<div
|
||||
class="aksrt-homepage__panel aksrt-homepage__posts posts-row post-grid post-grid--home ajaxpager tab-pane"
|
||||
data-view="<?php echo esc_attr($view_mode); ?>"
|
||||
role="tabpanel"
|
||||
data-home-tab-panel="term-<?php echo (int) $tab_cfg['term_id']; ?>"
|
||||
data-tab-orderby="<?php echo esc_attr($tab_cfg['orderby']); ?>"
|
||||
hidden
|
||||
></div>
|
||||
<?php endforeach; ?>
|
||||
<?php endif; ?>
|
||||
</div>
|
||||
</section>
|
||||
<?php else : ?>
|
||||
<section class="aksrt-homepage__stream home-tab-content aksrt-homepage__stream--disabled" aria-label="<?php esc_attr_e('Homepage Content', 'aksrt'); ?>">
|
||||
<div class="no-results box-body">
|
||||
<p><?php esc_html_e('首页主列表已关闭。', 'aksrt'); ?></p>
|
||||
<?php if (current_user_can('manage_options') && function_exists('aksrt_render_admin_quick_link')) : ?>
|
||||
<?php aksrt_render_admin_quick_link('page-display/homepage', __('打开首页设置并启用主列表', 'aksrt'), 'aksrt-admin-quicklink'); ?>
|
||||
<?php endif; ?>
|
||||
</div>
|
||||
</section>
|
||||
<?php endif; ?>
|
||||
|
||||
<?php
|
||||
aksrt_homepage_render_widget_zone(
|
||||
['home_bottom_content'],
|
||||
'aksrt-homepage__content-zone aksrt-homepage__content-zone--bottom'
|
||||
);
|
||||
?>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<?php aksrt_homepage_render_sidebar(); ?>
|
||||
</main>
|
||||
<?php
|
||||
aksrt_homepage_render_widget_zone(
|
||||
['home_bottom_fluid', 'all_bottom_fluid'],
|
||||
'fluid-widget-wrap aksrt-homepage__fluid-zone aksrt-homepage__fluid-zone--bottom'
|
||||
);
|
||||
}
|
||||
}
|
||||
|
||||
if (!function_exists('aksrt_render_fixed_homepage')) {
|
||||
/**
|
||||
* Render the new fixed homepage layout.
|
||||
*/
|
||||
function aksrt_render_fixed_homepage(): bool {
|
||||
if (!aksrt_is_fixed_homepage_request()) {
|
||||
return false;
|
||||
}
|
||||
|
||||
get_header();
|
||||
aksrt_homepage_render_layout();
|
||||
get_footer();
|
||||
|
||||
return true;
|
||||
}
|
||||
}
|
||||
Reference in New Issue
Block a user