Files
wordpress-theme-aksrt/src/WidgetSystem/RendererHelpers.php
T
kate522andClaude Opus 5 35bb96e82f refactor: rename the theme brand and every identifier from AKSRT to Jio
Full-project rename. `git grep -i aksrt` is now empty apart from the
DBMigrator 3.3.0 changelog note that documents the rename itself.

Code identifiers
- PHP namespace AKSRT\ -> Jio\ (composer PSR-4 + 378 declarations)
- global constants AKSRT_* -> JIO_* (VERSION/DIR/URI, PAY_TYPE_*, CAPTCHA_*)
- procedural functions, hooks, options, meta keys, table names,
  cookies, query vars, ajax actions and nonces: aksrt_ -> jio_
- text domain aksrt -> jio; Theme Name -> Jio
- JS globals: aksrtData/aksrtAdminData/... -> jioData/jioAdminData/...,
  window.AKSRTCaptcha & friends -> window.JioCaptcha, Aksrt* -> Jio*
- Vue components Aks*.vue -> Jio*.vue (15 files renamed + imports)
- CSS classes/data-attrs/custom properties: aksrt- -> jio-
- REST namespace aksrt/v1 -> jio/v1 (incl. payment gateway callbacks)

Storage layer
- DB tables {prefix}aksrt_* -> {prefix}jio_*; SCHEMA_VERSION 3.2.0 -> 3.3.0
  so dbDelta creates the new names on install
- widget id_base aksrt_widget_* -> jio_widget_*
- uninstall.php drop list rebuilt from the actual migrator tables
  (dropped 3 stale entries, added the 17 missing ones)

Removed
- hardcoded https://api.aksrt.com/version.json default update endpoint;
  get_endpoint() now reads the 「更新端点」 setting and do_check() no-ops
  when it is empty

Files renamed: inc/helpers/aksrt-*.php -> jio-*.php (54),
assets/admin/src/components/form/Aks*.vue -> Jio*.vue (15).
Build artifacts regenerated: assets/css/build, assets/js/runtime,
assets/admin/build.

Verified: audit-psr4-paths errors=0, audit-admin-contracts errors=0
(warnings=56, unchanged baseline), 813/813 widget-system tests,
44/44 phpunit, php -l clean across all PHP.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
2026-11-01 20:05:04 +08:00

71 lines
2.8 KiB
PHP

<?php
namespace Jio\WidgetSystem;
defined('ABSPATH') || exit;
/**
* Small HTML primitives shared by the renderer groups.
*/
final class RendererHelpers {
public static function link(array $link): array {
$url = esc_url((string) ($link['url'] ?? ''));
$text = sanitize_text_field((string) ($link['text'] ?? ''));
$target = ($link['target'] ?? '') === '_blank' ? '_blank' : '';
return ['url' => $url, 'text' => $text, 'target' => $target];
}
public static function link_attrs(array $link): string {
$link = self::link($link);
return $link['target'] === '_blank' ? ' target="_blank" rel="noopener noreferrer"' : '';
}
public static function image(string $url, string $alt = '', string $class = '', string $key = 'lazy_other', string $lazy_src = ''): string {
if ($url === '') {
return '';
}
return '<img' . jio_get_lazy_attr($key, $url, $class, $lazy_src) . ' alt="' . esc_attr($alt) . '">';
}
public static function lines(string $value): array {
$lines = preg_split('/\r\n|\r|\n/', $value) ?: [];
return array_values(array_filter(array_map('trim', $lines), static fn(string $line): bool => $line !== ''));
}
public static function empty_state(string $message): string {
if (function_exists('jio_get_widget_null')) {
return jio_get_widget_null($message);
}
return '<div class="jio-widget__empty" role="status">' . esc_html($message) . '</div>';
}
public static function card_media(array $item, string $class = ''): string {
$title = (string) ($item['title'] ?? '');
$link = self::link((array) ($item['link'] ?? []));
$media = '';
if (!empty($item['image_dark'])) {
$media .= self::image((string) $item['image_dark'], $title, 'jio-media-card__image jio-media-card__image--dark');
}
$media .= self::image((string) ($item['image'] ?? ''), $title, 'jio-media-card__image');
if (!empty($item['video'])) {
$video = esc_url((string) $item['video']);
$video_attr = jio_is_lazy('lazy_other')
? ' class="jio-media-card__video lazyload" src="" data-src="' . $video . '"'
: ' class="jio-media-card__video" src="' . $video . '"';
$media .= '<video' . $video_attr . ' muted loop playsinline preload="metadata"></video>';
}
$body = '<span class="jio-media-card__body"><strong>' . esc_html($title) . '</strong>';
if (!empty($item['description'])) {
$body .= '<small>' . esc_html((string) $item['description']) . '</small>';
}
$body .= '</span>';
$tag = $link['url'] !== '' ? 'a' : 'div';
$attrs = $link['url'] !== '' ? ' href="' . $link['url'] . '"' . self::link_attrs($link) : '';
return '<' . $tag . ' class="jio-media-card ' . esc_attr($class) . '"' . $attrs . '><span class="jio-media-card__media">' . $media . '</span>' . $body . '</' . $tag . '>';
}
public static function ids(string $value): array {
return array_values(array_filter(array_map('absint', preg_split('/\s*,\s*/', $value) ?: [])));
}
}