feat(frontend): illustrated null states and author rewards fallback
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.
This commit is contained in:
1 parent
b1731f7a8d
commit
a0748c08fe
10 files changed
+140
-9
No files matched your search
@@ -0,0 +1,78 @@
|
||||
<?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);
|
||||
}
|
||||
}
|
||||
Reference in new issue
Block a user