feat: rewrite schema-driven widget system
This commit is contained in:
@@ -0,0 +1,196 @@
|
||||
<?php
|
||||
|
||||
namespace AKSRT\WidgetSystem\Renderers;
|
||||
|
||||
use AKSRT\WidgetSystem\RendererHelpers;
|
||||
|
||||
defined('ABSPATH') || exit;
|
||||
|
||||
/** Render the 17 general and decorative widgets. */
|
||||
final class GeneralRenderer {
|
||||
public static function render(string $slug, array $instance, array $context = []): string {
|
||||
$method = 'render_' . $slug;
|
||||
return is_callable([self::class, $method]) ? (string) self::$method($instance, $context) : '';
|
||||
}
|
||||
|
||||
private static function render_search(array $i): string {
|
||||
$action = esc_url(home_url('/'));
|
||||
$placeholder = esc_attr((string) $i['placeholder']);
|
||||
$style = sanitize_html_class((string) $i['search_style']);
|
||||
return '<form class="aksrt-widget-search aksrt-widget-search--' . $style . '" role="search" method="get" action="' . $action . '"><label><span class="screen-reader-text">' . esc_html__('搜索：', 'aksrt') . '</span><input type="search" name="s" placeholder="' . $placeholder . '" autocomplete="off"></label><button type="submit" aria-label="' . esc_attr__('搜索', 'aksrt') . '"><i class="fas fa-search" aria-hidden="true"></i><span>' . esc_html__('搜索', 'aksrt') . '</span></button></form>';
|
||||
}
|
||||
|
||||
private static function render_posts_toc(array $i): string {
|
||||
if (!is_singular('post')) {
|
||||
return '';
|
||||
}
|
||||
return '<nav class="aksrt-widget-toc' . (!empty($i['collapsed']) ? ' is-collapsed' : '') . '" data-min-headings="' . (int) $i['min_headings'] . '" data-scroll-offset="' . (int) $i['offset'] . '" aria-label="' . esc_attr__('文章目录', 'aksrt') . '"><button class="aksrt-widget-toc__toggle" type="button" aria-expanded="' . (empty($i['collapsed']) ? 'true' : 'false') . '"><span>' . esc_html__('文章目录', 'aksrt') . '</span><i class="fas fa-chevron-down" aria-hidden="true"></i></button><ol class="aksrt-widget-toc__list"></ol><p class="aksrt-widget-toc__empty">' . esc_html__('正在生成目录…', 'aksrt') . '</p></nav>';
|
||||
}
|
||||
|
||||
private static function render_quote(array $i): string {
|
||||
$quotes = RendererHelpers::lines((string) $i['quotes']);
|
||||
$text = $quotes ? $quotes[array_rand($quotes)] : __('保持好奇，持续创造。', 'aksrt');
|
||||
return '<figure class="aksrt-widget-quote" data-source="' . esc_attr((string) $i['source']) . '" data-interval="' . (int) $i['interval'] . '"><i class="fas fa-quote-left" aria-hidden="true"></i><blockquote>' . esc_html($text) . '</blockquote><button type="button" aria-label="' . esc_attr__('换一句', 'aksrt') . '"><i class="fas fa-sync-alt" aria-hidden="true"></i></button></figure>';
|
||||
}
|
||||
|
||||
private static function render_icon_cards(array $i): string {
|
||||
return self::icon_cards((array) $i['cards'], false, (int) $i['pc_row'], (int) $i['m_row']);
|
||||
}
|
||||
|
||||
private static function render_icon_cover_cards(array $i): string {
|
||||
return self::icon_cards((array) $i['cards'], true, (int) $i['pc_row'], (int) $i['m_row']);
|
||||
}
|
||||
|
||||
private static function icon_cards(array $cards, bool $cover, int $pc, int $mobile): string {
|
||||
$html = '<div class="aksrt-widget-grid aksrt-widget-icon-cards' . ($cover ? ' aksrt-widget-icon-cards--cover' : '') . '" style="--aksrt-cols:' . $pc . ';--aksrt-cols-m:' . $mobile . '">';
|
||||
foreach ($cards as $card) {
|
||||
if (!is_array($card)) {
|
||||
continue;
|
||||
}
|
||||
$args = ['icon' => $card['icon'] ?? '', 'customize_icon' => $card['custom_icon'] ?? '', 'icon_image' => $card['custom_icon'] ?? '', 'icon_color' => $card['color'] ?? '', 'icon_class' => $card['color'] ?? '', 'title' => $card['title'] ?? '', 'desc' => $card['description'] ?? '', 'link' => $card['link'] ?? []];
|
||||
if ($cover && function_exists('aksrt_icon_cover_card')) {
|
||||
$html .= aksrt_icon_cover_card($args);
|
||||
} elseif (!$cover && function_exists('aksrt_icon_card')) {
|
||||
$html .= aksrt_icon_card($args);
|
||||
} else {
|
||||
$link = RendererHelpers::link((array) ($card['link'] ?? []));
|
||||
$tag = $link['url'] ? 'a' : 'div';
|
||||
$html .= '<' . $tag . ' class="aksrt-widget-icon-card ' . esc_attr((string) ($card['color'] ?? '')) . '"' . ($link['url'] ? ' href="' . $link['url'] . '"' . RendererHelpers::link_attrs($link) : '') . '><i class="' . esc_attr((string) ($card['icon'] ?? 'fa fa-star')) . '" aria-hidden="true"></i><span><strong>' . esc_html((string) ($card['title'] ?? '')) . '</strong><small>' . esc_html((string) ($card['description'] ?? '')) . '</small></span></' . $tag . '>';
|
||||
}
|
||||
}
|
||||
return $html . '</div>';
|
||||
}
|
||||
|
||||
private static function render_video(array $i): string {
|
||||
$url = esc_url((string) $i['url']);
|
||||
if ($url === '') {
|
||||
return RendererHelpers::empty_state(__('请配置视频地址', 'aksrt'));
|
||||
}
|
||||
$ratio = (string) $i['ratio'];
|
||||
return '<div class="aksrt-widget-video aksrt-widget-video--' . esc_attr(str_replace(':', '-', $ratio)) . '" data-video-url="' . $url . '" data-video-poster="' . esc_url((string) $i['poster']) . '" data-autoplay="' . (!empty($i['autoplay']) ? '1' : '0') . '" data-muted="' . (!empty($i['muted']) ? '1' : '0') . '"><video controls playsinline preload="metadata"' . (!empty($i['autoplay']) ? ' autoplay' : '') . (!empty($i['muted']) ? ' muted' : '') . (!empty($i['poster']) ? ' poster="' . esc_url((string) $i['poster']) . '"' : '') . '><source src="' . $url . '"></video><p class="aksrt-widget-media-error" hidden>' . esc_html__('视频加载失败，请稍后重试。', 'aksrt') . '</p></div>';
|
||||
}
|
||||
|
||||
private static function render_embed(array $i): string {
|
||||
if (empty($i['url'])) {
|
||||
return RendererHelpers::empty_state(__('请配置嵌入地址', 'aksrt'));
|
||||
}
|
||||
return '<div class="aksrt-widget-embed" style="--aksrt-embed-ratio:' . esc_attr((string) (float) $i['ratio']) . '%"><iframe src="' . esc_url((string) $i['url']) . '" loading="lazy" referrerpolicy="strict-origin-when-cross-origin"' . (!empty($i['allow_fullscreen']) ? ' allowfullscreen' : '') . ' title="' . esc_attr__('嵌入内容', 'aksrt') . '"></iframe></div>';
|
||||
}
|
||||
|
||||
private static function render_media_cards(array $i): string {
|
||||
return self::media_grid((array) $i['cards']);
|
||||
}
|
||||
|
||||
private static function media_grid(array $items, string $class = ''): string {
|
||||
$html = '<div class="aksrt-widget-grid aksrt-widget-media-cards ' . esc_attr($class) . '">';
|
||||
foreach ($items as $item) {
|
||||
if (is_array($item)) {
|
||||
$html .= RendererHelpers::card_media($item);
|
||||
}
|
||||
}
|
||||
return $html . '</div>';
|
||||
}
|
||||
|
||||
private static function render_partners(array $i): string {
|
||||
$items = '';
|
||||
foreach ((array) $i['items'] as $item) {
|
||||
if (is_array($item)) {
|
||||
$items .= RendererHelpers::card_media($item, 'aksrt-partner');
|
||||
}
|
||||
}
|
||||
return '<div class="aksrt-widget-partners" style="--aksrt-partner-rows:' . (int) $i['rows_pc'] . ';--aksrt-partner-rows-m:' . (int) $i['rows_mobile'] . ';--aksrt-partner-speed:' . (int) $i['speed'] . 's"><div class="aksrt-widget-partners__track">' . $items . $items . '</div></div>';
|
||||
}
|
||||
|
||||
private static function render_combo_info(array $i): string {
|
||||
$html = '<div class="aksrt-widget-grid aksrt-widget-combo">';
|
||||
foreach ((array) $i['items'] as $item) {
|
||||
if (!is_array($item)) {
|
||||
continue;
|
||||
}
|
||||
$tags = '';
|
||||
foreach (preg_split('/\s*[,，]\s*/', (string) ($item['tags'] ?? '')) ?: [] as $tag) {
|
||||
if ($tag !== '') {
|
||||
$tags .= '<span>' . esc_html($tag) . '</span>';
|
||||
}
|
||||
}
|
||||
$html .= '<article class="aksrt-combo-card">' . RendererHelpers::card_media($item) . ($tags ? '<div class="aksrt-combo-card__tags">' . $tags . '</div>' : '') . '</article>';
|
||||
}
|
||||
return $html . '</div>';
|
||||
}
|
||||
|
||||
private static function render_text_title(array $i): string {
|
||||
return '<div class="aksrt-widget-text-title is-' . esc_attr((string) $i['alignment']) . '"><h2>' . nl2br(esc_html((string) $i['heading'])) . '</h2><p>' . nl2br(esc_html((string) $i['description'])) . '</p></div>';
|
||||
}
|
||||
|
||||
private static function render_buttons(array $i): string {
|
||||
$html = '<div class="aksrt-widget-buttons is-' . esc_attr((string) $i['alignment']) . '" style="--aksrt-button-gap:' . (float) $i['gap'] . 'px">';
|
||||
foreach ((array) $i['buttons'] as $button) {
|
||||
$link = RendererHelpers::link((array) ($button['link'] ?? []));
|
||||
if ($link['url'] === '') {
|
||||
continue;
|
||||
}
|
||||
$html .= '<a class="aksrt-widget-button ' . esc_attr((string) ($button['color'] ?? 'jb-blue')) . '" href="' . $link['url'] . '"' . RendererHelpers::link_attrs($link) . '>' . (!empty($button['icon']) ? '<i class="' . esc_attr((string) $button['icon']) . '" aria-hidden="true"></i>' : '') . '<span>' . esc_html((string) ($button['text'] ?? $link['text'])) . '</span></a>';
|
||||
}
|
||||
return $html . '</div>';
|
||||
}
|
||||
|
||||
private static function render_layout_gap(array $i): string {
|
||||
return '<div class="aksrt-widget-gap" aria-hidden="true" style="--aksrt-gap:' . (float) $i['pc_gap'] . 'px;--aksrt-gap-m:' . (float) $i['m_gap'] . 'px"></div>';
|
||||
}
|
||||
|
||||
private static function render_tag_cloud(array $i): string {
|
||||
$args = ['taxonomy' => (string) $i['taxonomy'], 'number' => (int) $i['number'], 'hide_empty' => true];
|
||||
if ($i['orderby'] !== 'rand') {
|
||||
$args['orderby'] = (string) $i['orderby'];
|
||||
$args['order'] = 'DESC';
|
||||
}
|
||||
$terms = get_terms($args);
|
||||
if (is_wp_error($terms) || !$terms) {
|
||||
return RendererHelpers::empty_state(__('暂无标签', 'aksrt'));
|
||||
}
|
||||
if ($i['orderby'] === 'rand') {
|
||||
shuffle($terms);
|
||||
}
|
||||
$html = '<div class="aksrt-widget-tag-cloud">';
|
||||
foreach (array_slice($terms, 0, (int) $i['number']) as $term) {
|
||||
$url = get_term_link($term);
|
||||
if (!is_wp_error($url)) {
|
||||
$html .= '<a href="' . esc_url($url) . '">' . esc_html($term->name) . (!empty($i['show_count']) ? '<small>' . (int) $term->count . '</small>' : '') . '</a>';
|
||||
}
|
||||
}
|
||||
return $html . '</div>';
|
||||
}
|
||||
|
||||
private static function render_recent_comments(array $i): string {
|
||||
$comments = get_comments(['status' => 'approve', 'number' => (int) $i['count'], 'user__not_in' => RendererHelpers::ids((string) $i['exclude_users']), 'post__not_in' => RendererHelpers::ids((string) $i['exclude_posts'])]);
|
||||
if (!$comments) {
|
||||
return RendererHelpers::empty_state(__('暂无评论', 'aksrt'));
|
||||
}
|
||||
$html = '<ul class="aksrt-widget-comments">';
|
||||
foreach ($comments as $comment) {
|
||||
$html .= '<li><a class="aksrt-widget-comments__avatar" href="' . esc_url(get_comment_link($comment)) . '">' . (function_exists('aksrt_get_avatar_html') ? aksrt_get_avatar_html($comment, 48) : get_avatar($comment, 48)) . '</a><div><strong>' . esc_html(get_comment_author($comment)) . '</strong><p>' . esc_html(wp_trim_words(wp_strip_all_tags((string) $comment->comment_content), 18)) . '</p>' . (!empty($i['show_source']) ? '<a class="aksrt-widget-comments__source" href="' . esc_url(get_comment_link($comment)) . '">' . esc_html(get_the_title((int) $comment->comment_post_ID)) . '</a>' : '') . '</div></li>';
|
||||
}
|
||||
return $html . '</ul>';
|
||||
}
|
||||
|
||||
private static function render_links(array $i): string {
|
||||
$html = '<div class="aksrt-widget-links aksrt-widget-links--' . esc_attr((string) $i['style']) . '">';
|
||||
foreach (array_slice((array) $i['links'], 0, (int) $i['limit']) as $item) {
|
||||
$link = RendererHelpers::link((array) ($item['link'] ?? []));
|
||||
if ($link['url']) {
|
||||
$html .= '<a href="' . $link['url'] . '"' . RendererHelpers::link_attrs($link) . '><strong>' . esc_html((string) ($item['title'] ?? $link['text'])) . '</strong><small>' . esc_html((string) ($item['description'] ?? '')) . '</small></a>';
|
||||
}
|
||||
}
|
||||
return $html . '</div>';
|
||||
}
|
||||
|
||||
private static function render_notice(array $i): string {
|
||||
$slides = '';
|
||||
foreach ((array) $i['items'] as $item) {
|
||||
$link = RendererHelpers::link((array) ($item['link'] ?? []));
|
||||
$content = '<strong>' . esc_html((string) ($item['title'] ?? '')) . '</strong><span>' . esc_html((string) ($item['description'] ?? '')) . '</span>';
|
||||
$slides .= '<div class="swiper-slide">' . ($link['url'] ? '<a href="' . $link['url'] . '"' . RendererHelpers::link_attrs($link) . '>' . $content . '</a>' : $content) . '</div>';
|
||||
}
|
||||
return '<div class="aksrt-widget-notice"><i class="fas fa-bullhorn" aria-hidden="true"></i><div class="swiper aksrt-widget-swiper" data-aksrt-swiper="notice" data-interval="' . ((int) $i['interval'] * 1000) . '"><div class="swiper-wrapper">' . $slides . '</div></div></div>';
|
||||
}
|
||||
}
|
||||
Reference in New Issue
Block a user