kate522
a0748c08fe
Add aksrt_get_null / widget null helpers with null.svg, use them in sidebar widgets, comments empty, and related posts; when PM is off show post rewards entry on the single author bar.
79 lines
2.5 KiB
PHP
79 lines
2.5 KiB
PHP
<?php
|
|
/**
|
|
* Illustrated empty / null state helpers (Zibll zib_get_null 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')) {
|
|
/**
|
|
* Zibll-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="" loading="lazy" 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);
|
|
}
|
|
}
|