wordpress-theme-aksrt/templates/parts/user-shared-helpers.php

<?php
/**
 * 用户页面共享辅助函数
 *
 * 分页渲染和空状态卡片，供本人中心和公开主页共用。
 *
 * @package Jio
 */

defined('ABSPATH') || exit;

if (!function_exists('jio_render_profile_pagination')) {
    /**
     * 渲染分页
     *
     * @param int    $total_pages 总页数
     * @param int    $current     当前页
     * @param string $param       URL 参数名
     */
    function jio_render_profile_pagination($total_pages, $current, $param, $base_url = '') {
        if ($total_pages <= 1) {
            return;
        }
        $base = $base_url !== '' ? $base_url : remove_query_arg($param);
        $base = remove_query_arg($param, $base);
        $base = add_query_arg($param, '%#%', $base);
        $links = paginate_links([
            'base'      => $base,
            'format'    => '',
            'current'   => $current,
            'total'     => $total_pages,
            'prev_text' => '<span aria-hidden="true">&lsaquo;</span><span class="screen-reader-text">' . esc_html__('上一页', 'jio') . '</span>',
            'next_text' => '<span aria-hidden="true">&rsaquo;</span><span class="screen-reader-text">' . esc_html__('下一页', 'jio') . '</span>',
            'mid_size'  => 1,
            'end_size'  => 1,
        ]);
        if ($links) {
            echo '<nav class="profile-pagination" aria-label="' . esc_attr__('分页', 'jio') . '">' . $links . '</nav>'; // phpcs:ignore
        }
    }
}

if (!function_exists('jio_render_asset_pagination')) {
	/**
	 * Render user asset pagination without URL state.
	 */
	function jio_render_asset_pagination(int $total_pages, int $current, string $asset): void {
		if ($total_pages <= 1) {
			return;
		}

		$current = max(1, min($total_pages, $current));
		$pages = array_values(array_unique(array_filter([
			1,
			$current - 1,
			$current,
			$current + 1,
			$total_pages,
		], static fn(int $page): bool => $page >= 1 && $page <= $total_pages)));
		sort($pages);

		echo '<nav class="profile-pagination" aria-label="' . esc_attr__('分页', 'jio') . '">';
		if ($current > 1) {
			echo '<button type="button" class="page-numbers prev" data-jio-asset-page="' . (int) ($current - 1) . '" data-jio-asset-key="' . esc_attr($asset) . '"><span aria-hidden="true">&lsaquo;</span><span class="screen-reader-text">' . esc_html__('上一页', 'jio') . '</span></button>';
		}
		$previous = 0;
		foreach ($pages as $page) {
			if ($previous > 0 && $page > $previous + 1) {
				echo '<span class="page-numbers dots">&hellip;</span>';
			}
			if ($page === $current) {
				echo '<span class="page-numbers current" aria-current="page">' . (int) $page . '</span>';
			} else {
				echo '<button type="button" class="page-numbers" data-jio-asset-page="' . (int) $page . '" data-jio-asset-key="' . esc_attr($asset) . '">' . (int) $page . '</button>';
			}
			$previous = $page;
		}
		if ($current < $total_pages) {
			echo '<button type="button" class="page-numbers next" data-jio-asset-page="' . (int) ($current + 1) . '" data-jio-asset-key="' . esc_attr($asset) . '"><span aria-hidden="true">&rsaquo;</span><span class="screen-reader-text">' . esc_html__('下一页', 'jio') . '</span></button>';
		}
		echo '</nav>';
	}
}

if (!function_exists('jio_render_profile_empty')) {
    /**
     * 渲染空状态卡片
     */
    function jio_render_profile_empty($icon_svg, $title, $desc = '', $cta_url = '', $cta_label = '') {
        echo '<div class="profile-empty">';
        echo '<div class="profile-empty__icon" aria-hidden="true">' . $icon_svg . '</div>'; // phpcs:ignore
        echo '<h4 class="profile-empty__title">' . esc_html($title) . '</h4>';
        if ($desc) {
            echo '<p class="profile-empty__desc">' . esc_html($desc) . '</p>';
        }
        if ($cta_url && $cta_label) {
            echo '<a class="btn-primary btn-sm profile-empty__cta" href="' . esc_url($cta_url) . '">' . esc_html($cta_label) . '</a>';
        }
        echo '</div>';
    }
}