Files
wordpress-theme-aksrt/inc/helpers/aksrt-null.php
T
kate522 9375b1c30c refactor(assets): vendor 资产迁入标准目录并全仓去除 zibll 标识
- assets/vendor 全量迁移: fontawesome5→assets/fontawesome5, css→assets/css,
  js→assets/js/runtime(避开 14 个同名自有文件), img 合并去重→assets/img,
  fonts→assets/fonts; 删除 assets/vendor
- libs 五个与 widgets/third-party 字节相同的库不重复入库, loader paths 改指向
- 运行时切换: _win.uri=assets 根, loader baseUrl=/js/runtime, enlighter 注入
  路径同步; PHP 7 个引用文件切换并改名 $zibll_*→$runtime_*
- 去品牌: Qinver 头注释/品牌 console.log/演示链接清除, 默认文案中性化
- 功能标识符改名: zib__→aksrt__, zib_ajax→aksrt_ajax, window.zib→
  window.aksrtLegacy, zibllblock/*→aksrtblock/*, .zib-widget→.aksrt-panel,
  .zib-slider→.aksrt-slider, zib_menu_options meta 键等
- 自有 CSS 改名: legacy-utilities/compat-vars/footer shell
- admin SPA 重建; 契约测试同步(路径/断言/文件更名)
- 例外保留: tests/visual 对照环境与 fixtures 前缀(外部 Zibll 产品引用)

验证: php -l 133 个改动文件通过; runtime 86 个 JS node --check 通过;
契约测试 68/70(2 个失败经 stash 对照确认为存量问题)
2026-08-22 16:16:30 +08:00

79 lines
2.5 KiB
PHP

<?php
/**
* Illustrated empty / null state helpers (legacy parity).
*
* @package AKSRT
*/
defined('ABSPATH') || exit;
if (!function_exists('aksrt_null_image_url')) {
/**
* Prefer theme null illustration; fall back to placeholder.
*/
function aksrt_null_image_url(string $file = 'null.svg'): string {
$file = sanitize_file_name($file);
if ($file === '') {
$file = 'null.svg';
}
$candidates = [
'/assets/img/' . $file,
'/img/' . $file,
'/assets/img/placeholder.svg',
];
foreach ($candidates as $rel) {
$path = get_template_directory() . $rel;
if (is_readable($path)) {
return get_template_directory_uri() . $rel;
}
}
return get_template_directory_uri() . '/assets/img/placeholder.svg';
}
}
if (!function_exists('aksrt_get_null')) {
/**
* legacy-like empty illustration block.
*
* @param string|null $text Caption (null → 暂无内容).
* @param int|string $margin Vertical padding / top margin.
* @param string $img Image file under assets/img.
* @param string $class Extra class on wrapper.
* @param int $width Image max width.
* @param int $height Optional fixed height.
*/
function aksrt_get_null($text = null, $margin = 60, string $img = 'null.svg', string $class = '', int $width = 280, int $height = 0): string {
if (null === $text) {
$text = __('暂无内容', 'aksrt');
}
$margin = is_numeric($margin) ? (string) $margin : '60';
$caption = $text !== ''
? '<p style="margin-top:' . esc_attr($margin) . 'px;" class="em09 muted-3-color separator">' . esc_html((string) $text) . '</p>'
: '';
if ($height > 0) {
$style = $width > 0 ? 'max-width:' . (int) $width . 'px;' : '';
$style .= 'height:' . (int) $height . 'px;';
} else {
$style = $width > 0 ? 'width:' . (int) $width . 'px;' : '';
}
$style .= 'opacity:.7;';
$src = aksrt_null_image_url($img);
return '<div class="text-center aksrt-null ' . esc_attr($class) . '" style="padding:' . esc_attr($margin) . 'px 0;">'
. '<img class="no-imgbox aksrt-null__img" style="' . esc_attr($style) . '" src="' . esc_url($src) . '" alt="" decoding="async">'
. $caption
. '</div>';
}
}
if (!function_exists('aksrt_get_widget_null')) {
/**
* Compact null for sidebar widgets.
*/
function aksrt_get_widget_null(string $text = '', int $margin = 24, int $width = 140): string {
if ($text === '') {
$text = __('暂无内容', 'aksrt');
}
return aksrt_get_null($text, $margin, 'null.svg', 'widget-empty aksrt-null--widget', $width);
}
}