kate522/wordpress-theme-aksrt
1
0 Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

feat(widgets): simplify locations and paid sidebar

Browse Source 
Remove deprecated widget locations and widgets, standardize sidebar labels, and render a compact paid-post purchase card in the article sidebar.
This commit is contained in:
kate522 committed 2026-08-14 01:49:50 +08:00
1 parent 51d2ab3aa7
commit bd7d3046a5
43 files changed
+294 -3581
Download Patch File Download Diff File Expand all files Collapse all files

No files matched your search

inc/bootstrap.php
+1 -1
View File
@@ -41,7 +41,7 @@ require_once AKSRT_DIR . '/inc/helpers/aksrt-forum.php';
require_once AKSRT_DIR . '/inc/helpers/aksrt-slider.php';
require_once AKSRT_DIR . '/inc/helpers/aksrt-vip.php';
require_once AKSRT_DIR . '/inc/helpers/aksrt-auth-ui.php';
require_once AKSRT_DIR . '/inc/helpers/aksrt-i18n-switch.php';
require_once AKSRT_DIR . '/inc/helpers/aksrt-i18n-header.php';
require_once AKSRT_DIR . '/inc/helpers/aksrt-posts-renderer.php';
require_once AKSRT_DIR . '/inc/helpers/aksrt-resource.php';
require_once AKSRT_DIR . '/inc/helpers/aksrt-pay.php';
inc/helpers/aksrt-i18n-header.php
+58
View File
@@ -0,0 +1,58 @@
<?php
/**
* Header and mobile navigation language controls.
*
* @package AKSRT
*/
defined('ABSPATH') || exit;
/**
* Header language dropdown (zibll zib_get_translate_language_btn).
* Uses SPA i18n_available_langs when i18n enabled and position includes header.
*
* @param string $class Extra classes.
*/
function aksrt_get_translate_language_btn(string $class = ''): string {
if (!class_exists('\AKSRT\Settings\Settings')) {
return '';
}
$cfg = \AKSRT\Settings\Settings::get_i18n_config();
if (empty($cfg['enabled'])) {
return '';
}
$pos = (string) ($cfg['switcherPosition'] ?? 'footer');
if (!in_array($pos, ['header', 'both'], true)) {
return '';
}
$raw = (string) ($cfg['availableLangs'] ?? '');
$buttons = [];
foreach (preg_split('/\r\n|\r|\n/', $raw) as $line) {
$line = trim($line);
if ($line === '' || strpos($line, '|') === false) {
continue;
}
[$code, $label] = array_map('trim', explode('|', $line, 2));
if ($code === '' || $label === '') {
continue;
}
$buttons[] = ['language' => $code, 'text' => $label];
}
if (!$buttons) {
return '';
}
$buttons_html = '';
foreach ($buttons as $button) {
$buttons_html .= '<li><a href="javascript:;" class="translate-button translate-ignore flex ac" data-language="'
. esc_attr($button['language']) . '">' . esc_html($button['text']) . '</a></li>';
}
$is_mobile = wp_is_mobile();
$dropdown = '<ul class="dropdown-menu hover-show-con">' . $buttons_html . '</ul>';
$hover = !$is_mobile ? ' hover-show' : '';
$toggle = !$is_mobile ? '' : ' data-toggle="dropdown"';
return '<div class="dropdown language-dropdown ' . esc_attr($class) . $hover . '">'
. '<a href="javascript:;" class="toggle-radius"' . $toggle . ' title="' . esc_attr__('切换语言', 'aksrt') . '">'
. '<i class="fas fa-language" aria-hidden="true"></i></a>' . $dropdown . '</div>';
}
inc/helpers/aksrt-i18n-switch.php
-202
View File
@@ -1,202 +0,0 @@
<?php
/**
* AKSRT i18n Switch — 多语言切换辅助函数
*
* 支持 Polylang、WPML 或 WordPress 内置语言切换。
*
* @package AKSRT
*/
defined('ABSPATH') || exit;
/**
* 获取可用语言列表
*
* @return array<array{code: string, name: string, url: string, flag: string, active: bool}>
*/
function aksrt_get_available_languages(): array {
$languages = [];
// Polylang
if (function_exists('pll_the_languages')) {
$pll_langs = pll_the_languages(['raw' => 1]);
if (is_array($pll_langs)) {
foreach ($pll_langs as $lang) {
$languages[] = [
'code' => $lang['slug'] ?? '',
'name' => $lang['name'] ?? '',
'url' => $lang['url'] ?? '#',
'flag' => $lang['flag'] ?? '',
'active' => !empty($lang['current_lang']),
];
}
}
return $languages;
}
// WPML
if (defined('ICL_LANGUAGE_CODE') && function_exists('icl_get_languages')) {
$wpml_langs = icl_get_languages('skip_missing=0');
if (is_array($wpml_langs)) {
foreach ($wpml_langs as $lang) {
$languages[] = [
'code' => $lang['language_code'] ?? '',
'name' => $lang['native_name'] ?? '',
'url' => $lang['url'] ?? '#',
'flag' => $lang['country_flag_url'] ?? '',
'active' => !empty($lang['active']),
];
}
}
return $languages;
}
// WordPress 内置：通过 filter 提供语言列表
$filtered = apply_filters('aksrt_available_languages', []);
if (is_array($filtered) && !empty($filtered)) {
return $filtered;
}
return [];
}
/**
* 检查是否有多语言插件可用
*/
function aksrt_has_multilingual(): bool {
if (function_exists('pll_the_languages')) return true;
if (defined('ICL_LANGUAGE_CODE')) return true;
if (!empty(apply_filters('aksrt_available_languages', []))) return true;
return false;
}
/**
* 获取当前语言代码
*/
function aksrt_get_current_language(): string {
if (function_exists('pll_current_language')) {
return pll_current_language('slug');
}
if (defined('ICL_LANGUAGE_CODE')) {
return ICL_LANGUAGE_CODE;
}
return get_locale();
}
/**
* 渲染语言切换器 HTML
*
* @param string $style dropdown | inline | flags
* @return string
*/
function aksrt_render_language_switcher(string $style = 'dropdown'): string {
$languages = aksrt_get_available_languages();
if (count($languages) < 2) return '';
$current = aksrt_get_current_language();
if ($style === 'flags') {
$html = '<div class="aksrt-lang-switch aksrt-lang-switch--flags">';
foreach ($languages as $lang) {
$active_class = $lang['active'] ? ' is-active' : '';
$html .= '<a href="' . esc_url($lang['url']) . '" class="aksrt-lang-switch__flag' . esc_attr($active_class) . '" title="' . esc_attr($lang['name']) . '">';
if ($lang['flag']) {
$html .= '<img src="' . esc_url($lang['flag']) . '" alt="' . esc_attr($lang['code']) . '" width="20" height="14">';
} else {
$html .= '<span>' . esc_html(strtoupper($lang['code'])) . '</span>';
}
$html .= '</a>';
}
$html .= '</div>';
return $html;
}
// dropdown style
$html = '<div class="aksrt-lang-switch">';
$html .= '<button type="button" class="aksrt-lang-switch__toggle" aria-haspopup="true" aria-expanded="false">';
// 当前语言
foreach ($languages as $lang) {
if ($lang['active'] || $lang['code'] === $current) {
if ($lang['flag']) {
$html .= '<img src="' . esc_url($lang['flag']) . '" alt="" width="18" height="12"> ';
}
$html .= '<span>' . esc_html($lang['name']) . '</span>';
break;
}
}
$html .= ' <i class="fas fa-chevron-down" style="font-size:10px;margin-left:4px;"></i>';
$html .= '</button>';
$html .= '<ul class="aksrt-lang-switch__dropdown" role="menu">';
foreach ($languages as $lang) {
$active_class = $lang['active'] ? ' is-active' : '';
$html .= '<li role="menuitem">';
$html .= '<a href="' . esc_url($lang['url']) . '" class="aksrt-lang-switch__item' . esc_attr($active_class) . '">';
if ($lang['flag']) {
$html .= '<img src="' . esc_url($lang['flag']) . '" alt="" width="18" height="12"> ';
}
$html .= esc_html($lang['name']);
$html .= '</a>';
$html .= '</li>';
}
$html .= '</ul>';
$html .= '</div>';
return $html;
}
/**
* Header language dropdown (zibll zib_get_translate_language_btn).
* Uses SPA i18n_available_langs when i18n enabled and position includes header.
*
* @param string $class Extra classes.
*/
function aksrt_get_translate_language_btn(string $class = ''): string {
if (!class_exists('\AKSRT\Settings\Settings')) {
return '';
}
$cfg = \AKSRT\Settings\Settings::get_i18n_config();
if (empty($cfg['enabled'])) {
return '';
}
$pos = (string) ($cfg['switcherPosition'] ?? 'footer');
if (!in_array($pos, ['header', 'both'], true)) {
return '';
}
$raw = (string) ($cfg['availableLangs'] ?? '');
$buttons = [];
foreach (preg_split('/
|␍|
/', $raw) as $line) {
$line = trim($line);
if ($line === '' || strpos($line, '|') === false) {
continue;
}
[$code, $label] = array_map('trim', explode('|', $line, 2));
if ($code === '' || $label === '') {
continue;
}
$buttons[] = ['language' => $code, 'text' => $label];
}
if (!$buttons) {
return '';
}
$buttons_html = '';
foreach ($buttons as $button) {
$buttons_html .= '<li><a href="javascript:;" class="translate-button translate-ignore flex ac" data-language="'
. esc_attr($button['language']) . '">' . esc_html($button['text']) . '</a></li>';
}
$is_mobile = wp_is_mobile();
$dropdown = '<ul class="dropdown-menu hover-show-con">' . $buttons_html . '</ul>';
$hover = !$is_mobile ? ' hover-show' : '';
$toggle = !$is_mobile ? '' : ' data-toggle="dropdown"';
return '<div class="dropdown language-dropdown ' . esc_attr($class) . $hover . '">'
. '<a href="javascript:;" class="toggle-radius"' . $toggle . ' title="' . esc_attr__('切换语言', 'aksrt') . '">'
. '<i class="fas fa-language" aria-hidden="true"></i></a>' . $dropdown . '</div>';
}
inc/helpers/aksrt-single.php
+10 -3
View File
@@ -100,9 +100,16 @@ if (!function_exists('aksrt_single_build_context')) :
$show_pay_box = false;
}
$show_aside = function_exists('aksrt_is_show_sidebar')
? aksrt_is_show_sidebar()
: false;
$layout = function_exists('aksrt_get_post_show_layout')
? aksrt_get_post_show_layout($post_id)
: '';
$has_article_widgets = is_active_sidebar('all_sidebar_top')
|| is_active_sidebar('sidebar-article')
|| is_active_sidebar('all_sidebar_bottom');
$show_aside = !wp_is_mobile()
&& get_post_type($post_id) === 'post'
&& $layout !== 'no_sidebar'
&& $has_article_widgets;
return [
'post_id' => $post_id,
inc/helpers/aksrt-template-tags.php
+22 -1
View File
@@ -50,7 +50,7 @@ function aksrt_resolve_sidebar_id(): string {
return 'home_sidebar';
}
return 'sidebar-blog';
return 'home_sidebar';
}
endif;
@@ -206,6 +206,27 @@ if (!function_exists('aksrt_get_site_layout')):
* Zibll site-layout mode: 1=no sidebar, 2=right, 3=left.
*/
function aksrt_get_site_layout(): int {
if (is_single()) {
$post_id = (int) get_queried_object_id();
$layout = aksrt_get_post_show_layout($post_id);
$has_article_widgets = is_active_sidebar('all_sidebar_top')
|| is_active_sidebar('sidebar-article')
|| is_active_sidebar('all_sidebar_bottom');
if (get_post_type($post_id) !== 'post' || wp_is_mobile() || $layout === 'no_sidebar' || !$has_article_widgets) {
return 1;
}
if ($layout === 'sidebar_left') {
return 3;
}
if ($layout === 'sidebar_right') {
return 2;
}
$cfg = aksrt_get_sidebar_config_safe();
return ($cfg['position'] ?? 'right') === 'left' ? 3 : 2;
}
if (!aksrt_is_show_sidebar()) {
return 1;
}
inc/helpers/homepage/content.php
-3
View File
@@ -153,7 +153,6 @@ if (!function_exists('aksrt_homepage_has_sidebar')) {
'all_sidebar_top',
'home_sidebar',
'all_sidebar_bottom',
'sidebar-blog',
]);
}
}
@@ -175,8 +174,6 @@ if (!function_exists('aksrt_homepage_render_sidebar')) {
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')) {
inc/modules/widgets-register.php
+24 -125
View File
@@ -19,11 +19,11 @@ function aksrt_unregister_default_widgets(): void {
unregister_widget('WP_Widget_Pages');
unregister_widget('WP_Widget_Search');
unregister_widget('WP_Widget_Calendar');
unregister_widget('WP_Nav_Menu_Widget');
}
add_action('widgets_init', 'aksrt_unregister_default_widgets', 1);
function aksrt_register_widgets() {
register_widget('\AKSRT\Widgets\AboutWidget');
register_widget('\AKSRT\Widgets\CategoriesWidget');
register_widget('\AKSRT\Widgets\TagCloudWidget');
register_widget('\AKSRT\Widgets\HotPostsWidget');
@@ -56,43 +56,28 @@ function aksrt_register_widgets() {
// 视频播放器
register_widget('\AKSRT\Widgets\WidgetVideoPlayer');
// 语言切换器
register_widget('\AKSRT\Widgets\WidgetLangSwitch');
// 一言轮播
register_widget('\AKSRT\Widgets\WidgetYiyan');
// 文章目录树（zibll posts_navs）
register_widget('\AKSRT\Widgets\WidgetPostsNavs');
// 幻灯片
register_widget('\AKSRT\Widgets\WidgetSlider');
// 幻灯片
register_widget('\AKSRT\Widgets\WidgetSlider');
// zibll more widgets batch
register_widget('\AKSRT\Widgets\WidgetPartnersScroll');
register_widget('\AKSRT\Widgets\WidgetIframe');
register_widget('\AKSRT\Widgets\WidgetComboInfo');
register_widget('\AKSRT\Widgets\WidgetTextTitle');
register_widget('\AKSRT\Widgets\WidgetUserLists');
register_widget('\AKSRT\Widgets\WidgetPricingPlans');
register_widget('\AKSRT\Widgets\WidgetFaq');
register_widget('\AKSRT\Widgets\WidgetStats');
register_widget('\AKSRT\Widgets\WidgetReviews');
register_widget('\AKSRT\Widgets\WidgetHighlights');
register_widget('\AKSRT\Widgets\WidgetFeatureIntro');
register_widget('\AKSRT\Widgets\WidgetTermCards');
register_widget('\AKSRT\Widgets\WidgetPaidPosts');
register_widget('\AKSRT\Widgets\WidgetPostPayBox');
register_widget('\AKSRT\Widgets\WidgetAuthorCard');
register_widget('\AKSRT\Widgets\WidgetOnelinePosts');
register_widget('\AKSRT\Widgets\WidgetTiltCases');
register_widget('\AKSRT\Widgets\WidgetMainPosts');
register_widget('\AKSRT\Widgets\WidgetTermAggregation');
register_widget('\AKSRT\Widgets\WidgetIconCoverCards');
register_widget('\AKSRT\Widgets\WidgetBookmarkLinks');
aksrt_maybe_repair_sidebar_blog_widgets();
// 其余通用小工具
register_widget('\AKSRT\Widgets\WidgetIframe');
register_widget('\AKSRT\Widgets\WidgetComboInfo');
register_widget('\AKSRT\Widgets\WidgetTextTitle');
register_widget('\AKSRT\Widgets\WidgetUserLists');
register_widget('\AKSRT\Widgets\WidgetFaq');
register_widget('\AKSRT\Widgets\WidgetHighlights');
register_widget('\AKSRT\Widgets\WidgetTermCards');
register_widget('\AKSRT\Widgets\WidgetPostPayBox');
register_widget('\AKSRT\Widgets\WidgetAuthorCard');
register_widget('\AKSRT\Widgets\WidgetOnelinePosts');
register_widget('\AKSRT\Widgets\WidgetTiltCases');
register_widget('\AKSRT\Widgets\WidgetMainPosts');
register_widget('\AKSRT\Widgets\WidgetTermAggregation');
register_widget('\AKSRT\Widgets\WidgetIconCoverCards');
register_widget('\AKSRT\Widgets\WidgetBookmarkLinks');
}
add_action('widgets_init', 'aksrt_register_widgets');
@@ -105,7 +90,6 @@ if (!function_exists('aksrt_widget_sidebar_area_ids')) {
function aksrt_widget_sidebar_area_ids(): array {
return [
'home_sidebar',
'sidebar-blog',
'sidebar-article',
'all_sidebar_top',
'all_sidebar_bottom',
@@ -192,7 +176,6 @@ if (!function_exists('aksrt_widget_allowed_sidebars')) {
*/
function aksrt_widget_allowed_sidebars(string $widget_base_id): array {
$sidebar_only = [
'aksrt_about',
'aksrt_categories',
'aksrt_tag_cloud',
'aksrt_hot_posts',
@@ -221,6 +204,10 @@ if (!function_exists('aksrt_widget_allowed_sidebars')) {
)));
}
if ($widget_base_id === 'aksrt_post_pay_box') {
return ['sidebar-article'];
}
return [];
}
}
@@ -280,7 +267,7 @@ if (!function_exists('aksrt_widget_render_location_help')) {
*/
function aksrt_widget_render_location_help(string $scope): void {
$messages = [
'sidebar' => __('仅限侧栏区域：首页侧栏、博客侧栏、文章侧栏、全站侧栏、分类/标签/搜索侧栏。', 'aksrt'),
'sidebar' => __('仅限侧栏区域：首页侧栏、文章页侧边栏、全站侧栏、分类/标签/搜索侧栏。', 'aksrt'),
'homepage' => __('仅限首页挂载区域：首页顶部/底部全宽、首页内容上方/下方。', 'aksrt'),
'hybrid' => __('支持侧栏、首页和归档页挂载区域。', 'aksrt'),
'archive' => __('仅限归档页挂载区域：分类页、标签页、搜索页的顶部/底部/侧栏。', 'aksrt'),
@@ -412,92 +399,6 @@ if (!function_exists('aksrt_filter_widget_sidebar_assignments')) {
}
add_filter('pre_update_option_sidebars_widgets', 'aksrt_filter_widget_sidebar_assignments', 10, 2);
/**
* Ensure widget instance config exists.
*/
function aksrt_ensure_widget_instance(string $option_name, int $number, array $defaults): void {
$instances = get_option($option_name, []);
if (!is_array($instances)) {
$instances = [];
}
if (!isset($instances['_multiwidget'])) {
$instances['_multiwidget'] = 1;
}
if (empty($instances[$number]) || !is_array($instances[$number])) {
$instances[$number] = $defaults;
update_option($option_name, $instances);
}
}
/**
* Repair the sidebar-blog structure and seed default sidebar widgets on first install.
*/
function aksrt_maybe_repair_sidebar_blog_widgets(): void {
$sidebars = get_option('sidebars_widgets', []);
$seeded = (bool) get_option('aksrt_sidebar_blog_seeded', false);
if (!is_array($sidebars)) {
$sidebars = [];
}
$current = $sidebars['sidebar-blog'] ?? null;
$needs_repair = false;
$normalized = [];
if (is_array($current)) {
foreach ($current as $item) {
if (is_array($item)) {
$needs_repair = true;
}
if (is_string($item) && $item !== '') {
$normalized[] = $item;
}
}
}
if ($needs_repair) {
$sidebars['sidebar-blog'] = array_values($normalized);
update_option('sidebars_widgets', $sidebars);
update_option('aksrt_sidebar_blog_seeded', true);
return;
}
if ($current !== null) {
if (!$seeded) {
update_option('aksrt_sidebar_blog_seeded', true);
}
return;
}
if ($seeded) {
return;
}
aksrt_ensure_widget_instance('widget_aksrt_about', 2, [
'title' => '',
]);
aksrt_ensure_widget_instance('widget_aksrt_categories', 2, [
'title' => __('分类目录', 'aksrt'),
'count' => 8,
]);
aksrt_ensure_widget_instance('widget_aksrt_tag_cloud', 2, [
'title' => __('标签云', 'aksrt'),
'count' => 15,
]);
$sidebars['sidebar-blog'] = [
'aksrt_about-2',
'aksrt_categories-2',
'aksrt_tag_cloud-2',
];
update_option('sidebars_widgets', $sidebars);
update_option('aksrt_sidebar_blog_seeded', true);
}
/**
* Register a block editor collection for AKSRT widgets.
*/
@@ -527,7 +428,6 @@ add_action('enqueue_block_editor_assets', function () {
*/
add_filter('block_type_metadata', function ($metadata) {
$aksrt_widgets = [
'aksrt_about',
'aksrt_categories',
'aksrt_tag_cloud',
];
@@ -544,7 +444,6 @@ add_filter('block_type_metadata', function ($metadata) {
*/
add_action('in_widget_form', function (WP_Widget $widget): void {
$map = [
'aksrt_about' => 'sidebar',
'aksrt_categories' => 'sidebar',
'aksrt_tag_cloud' => 'sidebar',
'aksrt_hot_posts' => 'sidebar',