* @license MIT License
* @version 2020.09.21
*/
function getrobots()
{
$site_url = parse_url(site_url());
$path = (!empty($site_url['path'])) ? $site_url['path'] : '';
$robots = "User-agent: *\n\n";
$robots .= "Disallow: $path/wp-admin/\n";
$robots .= "Disallow: $path/wp-includes/\n";
$robots .= "Disallow: $path/wp-content/plugins/\n";
$robots .= "Disallow: $path/wp-content/themes/\n";
return $robots;
}
/**
* 图片字段的默认值(后台预填用)。
*
* ── 为什么不直接调 yang_image_default() ──────────────────────
* 本文件由 optionsframework_init() 在 init 钩子上 require,
* 而 yang_image_default() 来自 inc/theme-option-defaults.php。
* 正常时序下后者先加载,但**加载顺序被打乱时**(子主题、外部脚本
* 直接 include 本文件、插件在更早的钩子里触发本函数),
* 直接调用就会 Fatal —— 后台整个白屏,比"少一个预填值"严重得多。
*
* 这里先用 function_exists() 探一下,缺了就返回空串:
* 后台退化成没有预填默认值,但页面能打开、能保存、能干活。
* 降级必须降到"还能用",不能降到"打不开"。
*/
if (!function_exists('yang_options_default_img')) {
function yang_options_default_img($id)
{
return function_exists('yang_image_default')
? yang_image_default($id)
: '';
}
}
/**
* 哀悼相关辅助函数的安全访问
*
* 同样的道理:yang_mourning_presets() / yang_mourning_status_text() /
* yang_mourning_extra_raw() 都在 inc/theme-mourning.php 里,由
* functions.php 按顺序 require。只要有人(子主题、迁移脚本、别的插件)
* 在 theme-mourning.php 之前触发了 kratos_options(),这里就会 Fatal,
* 整个后台白屏,且报错指向本文件,很难联想到是加载顺序问题。
*
* 降级策略:缺函数时按"没有纪念日 / 没有状态说明"降级 ——
* 后台那几个控件会变空,但页面能打开、能保存、能继续用。
*/
if (!function_exists('yang_opt_mourning_presets')) {
function yang_opt_mourning_presets()
{
return function_exists('yang_mourning_presets')
? yang_mourning_presets()
: array();
}
}
if (!function_exists('yang_opt_mourning_status')) {
function yang_opt_mourning_status()
{
return function_exists('yang_mourning_status_text')
? yang_mourning_status_text()
: '';
}
}
if (!function_exists('yang_opt_mourning_extra_raw')) {
function yang_opt_mourning_extra_raw()
{
return function_exists('yang_mourning_extra_raw')
? yang_mourning_extra_raw()
: '';
}
}
/**
* 今年清明的月日,给后台说明文字用(如「4 月 5 日」)
*
* 换算不出来(超出年份表范围)时返回一句明确的说明,
* **不要**退化成「4 月 4 日」—— 那正是用户要求删掉的近似值。
*/
if (!function_exists('yang_opt_qingming_label')) {
function yang_opt_qingming_label()
{
if (!function_exists('yang_qingming_md')) {
return __('换算不可用', 'kratos');
}
$md = yang_qingming_md();
if ($md === null) {
return sprintf(
__('今年(%s 年)超出可换算范围,清明不会自动生效', 'kratos'),
current_time('Y')
);
}
list($mo, $da) = explode('-', $md);
return sprintf(__('%d 月 %d 日', 'kratos'), (int) $mo, (int) $da);
}
}
/**
* 自定义 CSS 的默认值(来自 inc/theme-custom-code.php)
*
* 同样是加载顺序问题:这个函数在 theme-custom-code.php 里,
* 而 kratos_options() 可能被更早触发。缺了就返回空串,
* 后台的「自定义 CSS」框是空的,但能打开、能填、能保存。
*
* 3.2.29 起该默认值恒为空:原来的那批规则(段落缩进、h2 蓝条、列表缩进)
* 已并入主题公共样式 assets/css/site.css,配置项只留给站长做临时覆盖。
*/
if (!function_exists('yang_opt_default_custom_css')) {
function yang_opt_default_custom_css()
{
return function_exists('yang_default_custom_css')
? yang_default_custom_css()
: '';
}
}
function kratos_options()
{
$sitename = get_bloginfo('name');
$imagepath = ASSET_PATH . '/assets/img/options/';
$seorobots = 'robots.txt';
$seoreading = '' . __('设置-阅读-对搜索引擎的可见性', 'kratos') . '';
$top_array = array(
'banner' => __( '图片导航', 'kratos' ),
'color' => __( '颜色导航', 'kratos' ),
);
$options = array();
/* ══════════════════════════════════════════════════════════
* 一、全站配置 —— 影响每一个页面的东西
* ══════════════════════════════════════════════════════════ */
$options[] = array(
'name' => __('全站配置', 'kratos'),
'type' => 'heading',
);
$options[] = array(
'name' => __('图片 Logo', 'kratos'),
'desc' => __('不选择图片则显示文字标题', 'kratos'),
'id' => 'g_logo',
'type' => 'upload',
/* 有意不设 std:这里空着时显示站点名称文字,比塞一张通用占位
logo 好看。其它图片字段见 inc/theme-option-defaults.php。 */
);
$options[] = array(
'name' => __('Favicon 图片', 'kratos'),
'desc' => __('浏览器收藏夹和地址栏中显示的图标。留空则自动使用主题自带的默认图标,不会出现空白。', 'kratos'),
'id' => 'g_icon',
/* 有意不写 std。
*
* std 里存的是**绝对 URL**,一旦用户保存表单就会被写进数据库。
* 数据库里躺着一个写死的主题目录地址是隐患:主题目录改名、
* 换 CDN、或站点迁移域名之后,那条记录就指向不存在的文件,
* 页面上是破图,而用户在后台看到的仍是"已设置",很难自己发现。
*
* 所以默认值一律由运行时提供(yang_option_image()),库里保持空。
* 这样默认图地址永远由当前请求现算,改目录也不用改数据。
*/
'type' => 'upload',
);
$options[] = array(
'name' => __('背景颜色', 'kratos'),
'desc' => __('全站页面的背景颜色,需填写十六进制颜色码', 'kratos'),
'id' => 'g_background',
'std' => '#f5f5f5',
'type' => 'color',
);
$options[] = array(
'name' => __('Chrome 导航栏颜色', 'kratos'),
'desc' => __('Chrome 移动端浏览器地址栏的颜色', 'kratos'),
'id' => 'g_chrome',
'std' => '#282a2c',
'type' => 'color',
);
$options[] = array(
'name' => __('404 页面图片', 'kratos'),
'desc' => __('访客打开不存在的地址时显示的配图', 'kratos'),
'id' => 'g_404',
'std' => yang_options_default_img('g_404'),
'type' => 'upload',
);
$options[] = array(
'name' => __('前台管理员导航', 'kratos'),
'desc' => __('登录管理员后,页面顶部显示 WordPress 管理工具条', 'kratos'),
'std' => '1',
'id' => 'g_adminbar',
'type' => 'checkbox',
);
$options[] = array(
'name' => __('CSS 动画库', 'kratos'),
'desc' => __('开启 animate.css 效果。会增加一个约 60KB 的样式文件,不需要就别开。', 'kratos'),
'std' => '0',
'id' => 'g_animate',
'type' => 'checkbox',
);
$options[] = array(
'name' => __('Gravatar 加速', 'kratos'),
'desc' => __('把评论头像的请求转发到国内可访问的镜像,改善加载速度。若开启了下面的「自动头像」,未上传头像的访客不再需要这张图。', 'kratos'),
'std' => '0',
'id' => 'g_gravatar',
'type' => 'checkbox',
);
$options[] = array(
'name' => __('禁止生成缩略图', 'kratos'),
'desc' => __('上传图片时不再额外生成多种尺寸的副本,节省磁盘空间', 'kratos'),
'id' => 'g_removeimgsize',
'std' => '0',
'type' => 'checkbox',
);
$options[] = array(
'name' => __('Gutenberg 编辑器', 'kratos'),
'desc' => __('开启 WordPress 区块编辑器。关闭则使用经典编辑器。', 'kratos'),
'std' => '0',
'id' => 'g_gutenberg',
'type' => 'checkbox',
);
/* ══════════════════════════════════════════════════════════
* 二、自动头像 —— 独立一块
*
* 3.2.36 里这两项原本塞在「全站配置」内部(Gravatar 加速之后)。
* 上线后发现**根本找不到**:它排在第 9 位,纵坐标 1058px,而
* 浏览器视口才 1000px 高 —— 前 8 项(其中「404 页面图片」一项
* 就占 301px)把它顶到首屏之外,不往下滚看不见。左侧标签栏也没
* 有「头像」字样,光扫标签栏同样摸不着。
*
* 所以提成独立标签页:标签栏直接能看见,进去第一项就是开关。
* 这也更贴合原始需求「最上面的一个复选框,勾完之后出现下面这些
* 列表」——独立成页后,这个「上面/下面」的关系才真的成立。
*
* ── 为什么开关与风格拆成两个字段 ──────────────────────────
* 若用一个字段直接存风格名(留空=关闭),用户「主动关闭」和
* 「还没选过风格」在库里会变成同一种状态(都空),以后想恢复
* 默认值时分不清该填什么。两个字段各管一件事更清楚。
*
* ⚠️ std 只在后台预填和「恢复默认」时起作用,运行时 kratos_option()
* 完全不看它。所以运行时默认值必须同步给一份:
* 开关默认关('0'),风格默认 lorelei(见 yang_avatar_style())。
* ══════════════════════════════════════════════════════════ */
$options[] = array(
'name' => __('自动头像', 'kratos'),
'type' => 'heading',
);
$options[] = array(
'name' => __('启用自动头像', 'kratos'),
'desc' => __('访客没注册、也没上传头像时,按他的邮箱生成一张头像。全程本地生成,不请求任何外部服务,同一个邮箱永远得到同一张。若访客已经上传过真实头像,不受影响。', 'kratos'),
'std' => '0',
'id' => 'a_auto_enable',
'type' => 'checkbox',
);
/* ⚠️ 这个开关必须排在「头像风格」**之前**。
风格列表是 18 张带缩略图的卡片,实测高约 2100px;
排在它后面的控件实际落到 y≈2327px,而设置页视口约 1000px
—— 用户不滚三屏根本看不到。3.2.36 就是栽在「塞在长列表末尾」
这个坑里,别再犯。 */
$options[] = array(
'name' => __('注册用户保留原头像', 'kratos'),
'desc' => __('建议开启。开启后只给「邮箱在用户表里查不到」的匿名访客生成头像;本站注册用户一律用他自己的头像,不会被替换。
关掉则所有 Gravatar 头像都会被换掉 —— 站内作者、管理员也会变成卡通脸。
说明:注册用户若自己也没上传过头像,Gravatar 上就是一张默认灰人像。要分辨这种情况必须向 gravatar.com 发请求,而本功能坚持不访问任何外部服务,所以这类用户会保持灰人像,不会自动生成。', 'kratos'),
'std' => '1',
'id' => 'a_auto_keep_member',
'type' => 'checkbox',
'requires' => 'a_auto_enable',
);
$options[] = array(
'name' => __('头像风格', 'kratos'),
'desc' => __('勾选上面的「启用自动头像」后,这里才会出现风格列表。所有风格都可自由使用与商用,且不要求署名。点一下即时预览,保存后生效。', 'kratos'),
'std' => 'lorelei',
'id' => 'a_auto_style',
'type' => 'avatar_style',
/* 只有开关打开时才显示这个控件;关着的时候看不到它,
避免用户在关闭状态下改了风格却不知道为什么没生效。 */
'requires' => 'a_auto_enable',
);
/* ══════════════════════════════════════════════════════════
* 三、顶部导航 —— 页头那一条
* ══════════════════════════════════════════════════════════ */
$options[] = array(
'name' => __('顶部导航', 'kratos'),
'type' => 'heading',
);
$options[] = array(
'name' => __( '顶部样式', 'kratos' ),
'desc' => __('请选择顶部样式(图片导航或颜色导航)', 'kratos'),
'id' => 'top_select',
'std' => 'banner',
'type' => 'select',
'options' => $top_array
);
$options[] = array(
'name' => __('图片导航背景', 'kratos'),
'desc' => __('顶部样式选「图片导航」时使用。留空则自动使用主题自带的默认图片。', 'kratos'),
'id' => 'top_img',
'std' => yang_options_default_img('top_img'),
'class' => 'hidden',
'type' => 'upload',
);
$options[] = array(
'name' => __('颜色导航背景', 'kratos'),
'desc' => __('顶部样式选「颜色导航」时使用', 'kratos'),
'id' => 'top_color',
'std' => '#24292e',
'class' => 'hidden',
'type' => 'color',
);
$options[] = array(
'name' => __('副标题', 'kratos'),
'desc' => __('显示在站点标题旁边的一句短话', 'kratos'),
'id' => 'top_title',
'std' => 'Kratos',
'class' => 'hidden',
'type' => 'text',
);
$options[] = array(
'name' => __('标题描述', 'kratos'),
'std' => __('一款专注于用户阅读体验的响应式博客主题', 'kratos'),
'id' => 'top_describe',
'class' => 'hidden',
'type' => 'text',
);
/* ══════════════════════════════════════════════════════════
* 四、首页配置 —— 只管首页列表长什么样
* ══════════════════════════════════════════════════════════ */
$options[] = array(
'name' => __('首页配置', 'kratos'),
'type' => 'heading',
);
$options[] = array(
'name' => __('特色图片', 'kratos'),
'desc' => __('在首页文章列表的每篇标题上方显示一张配图', 'kratos'),
'std' => '1',
'id' => 'g_thumbnail',
'type' => 'checkbox',
);
$options[] = array(
'name' => __('默认特色图', 'kratos'),
'desc' => __('文章既没有正文图片、也没有设置特色图时,用这张顶上。留空则自动使用主题自带的默认图片。', 'kratos'),
'id' => 'g_postthumbnail',
'class' => 'hidden',
'std' => yang_options_default_img('g_postthumbnail'),
'type' => 'upload',
);
$options[] = array(
'name' => __('无内容图片', 'kratos'),
'desc' => __('搜索不到结果、或分类下还没有文章时显示的插画。留空则自动使用主题自带的默认图片。', 'kratos'),
'id' => 'g_nothing',
'std' => yang_options_default_img('g_nothing'),
'type' => 'upload',
);
/* ══════════════════════════════════════════════════════════
* 五、文章配置 —— 打开单篇文章才看得到的东西
* ══════════════════════════════════════════════════════════ */
$options[] = array(
'name' => __('文章配置', 'kratos'),
'type' => 'heading',
);
$options[] = array(
'name' => __('页面布局', 'kratos'),
'desc' => __('文章页面是否显示侧边栏。仅在文章详情页生效。', 'kratos'),
'id' => "g_article_widgets",
'std' => "two_side",
'type' => "images",
'options' => array(
'one_side' => $imagepath . 'col-12.png',
'two_side' => $imagepath . 'col-8.png')
);
$options[] = array(
'name' => __('文章打赏', 'kratos'),
'desc' => __('在文章底部显示打赏按钮,点开是收款二维码', 'kratos'),
'id' => 'g_donate',
'type' => 'checkbox',
);
$options[] = array(
'name' => __('支付宝收款码', 'kratos'),
'desc' => __('留空则自动使用主题自带的默认图片。', 'kratos'),
'id' => 'g_donate_alipay',
'std' => yang_options_default_img('g_donate_alipay'),
'type' => 'upload',
'class' => 'hidden',
);
$options[] = array(
'name' => __('微信收款码', 'kratos'),
'desc' => __('留空则自动使用主题自带的默认图片。', 'kratos'),
'id' => 'g_donate_wechat',
'std' => yang_options_default_img('g_donate_wechat'),
'type' => 'upload',
'class' => 'hidden',
);
/* ══════════════════════════════════════════════════════════
* 六、自动目录 —— 把长文切成能跳的章节
*
* 与「文章配置」分开成独立标签页,是刻意的:目录的选项有六项,
* 塞进文章配置里会把「页面布局 / 打赏」这些一眼要看到的东西挤下去。
*
* ⚠️ 这里的 std 必须与 inc/theme-toc.php 的 yang_toc_defaults() 一致。
* 前者只服务「后台预填」和「恢复默认」,运行时一律走
* kratos_option($id, 默认值) —— 两处不一致会出现
* 「页面照 A 渲染、后台框里显示 B」的错位,而且极难发现。
* ══════════════════════════════════════════════════════════ */
$options[] = array(
'name' => __('自动目录', 'kratos'),
'type' => 'heading',
);
/* ── 分组标题:正文里的那一份 ──────────────────────────────
*
* 用 info 类型而不是 heading:heading 会另起一个标签页
* (framework 里 `case "heading"` 会 $counter++ 并新建
* #options-group-N),info 只渲染成一行
** ——
写 会被静默剥掉,页面上只剩裸文字。所以这里用 强调。 */
__('变黑白时,页面顶部会出现一条提示,点进去是一个说明页面(彩色),讲清楚为什么变黑白、哪几天会变。
这里可以改那个页面的路径。留空默认 memory,即 %s
注意:不要和已有文章或页面的路径重名。', 'kratos'),
esc_url(home_url('/memory/'))
),
'id' => 'g_rip_page_slug',
'std' => 'memory',
'type' => 'text',
);
$options[] = array(
'desc' => yang_opt_mourning_status(),
'type' => 'info',
);
/* ══════════════════════════════════════════════════════════
* 十、收录与统计 —— 给搜索引擎看的
* ══════════════════════════════════════════════════════════ */
$options[] = array(
'name' => __('收录与统计', 'kratos'),
'type' => 'heading',
);
$options[] = array(
'name' => __('分享图片', 'kratos'),
'desc' => __('搜索引擎或者社交工具分享首页时抓取的图片。留空则自动使用主题自带的默认图片。', 'kratos'),
'id' => 'seo_shareimg',
'std' => yang_options_default_img('seo_shareimg'),
'type' => 'upload',
);
$options[] = array(
'name' => __('关键词', 'kratos'),
'desc' => __('每个关键词之间需要用「英文逗号」分割', 'kratos'),
'id' => 'seo_keywords',
'type' => 'text',
);
$options[] = array(
'name' => __('站点描述', 'kratos'),
'id' => 'seo_description',
'type' => 'textarea',
);
$options[] = array(
'name' => __('统计代码', 'kratos'),
'desc' => __('填在页脚的统计脚本(如站点访问量统计)。注意:输入 HTML/JS 代码时请注意辨别代码安全!', 'kratos'),
'id' => 'seo_statistical',
'type' => 'textarea',
);
$options[] = array(
'name' => __('robots.txt 内容', 'kratos'),
'desc' => __('- 需要 ', 'kratos') . $seoreading . __(' 是开启的状态,下面的配置才会生效', 'kratos'),
'type' => 'info',
);
$options[] = array(
'desc' => __('- 如果网站根目录下已经有 robots.txt 文件,下面的配置不会生效', 'kratos'),
'type' => 'info',
);
$options[] = array(
'desc' => __('- 点击 ', 'kratos') . $seorobots . __(' 查看配置是否生效,如果网站开启了 CDN,可能需要刷新缓存才会生效', 'kratos'),
'type' => 'info',
);
$options[] = array(
'id' => 'seo_robots',
'std' => getrobots(),
'type' => 'textarea',
);
/* ══════════════════════════════════════════════════════════
* 十一、邮件通知 —— SMTP 与评论提醒
* ══════════════════════════════════════════════════════════ */
$options[] = array(
'name' => __('邮件通知', 'kratos'),
'type' => 'heading',
);
$options[] = array(
'name' => __('SMTP 服务', 'kratos'),
'desc' => __('用第三方邮箱发信。不开启时走服务器本地发信,很多主机上会被判定为垃圾邮件。', 'kratos'),
'id' => 'm_smtp',
'type' => 'checkbox',
);
$options[] = array(
'name' => __('邮件服务器', 'kratos'),
'desc' => __('填写发件服务器地址', 'kratos'),
'id' => 'm_host',
'class' => 'hidden',
'type' => 'text',
);
$options[] = array(
'name' => __('服务器端口', 'kratos'),
'desc' => __('填写发件服务器端口', 'kratos'),
'id' => 'm_port',
'class' => 'hidden',
'type' => 'text',
);
$options[] = array(
'name' => __('授权方式', 'kratos'),
'desc' => __('填写登录鉴权的方式,ssl 或 tls', 'kratos'),
'id' => 'm_sec',
'class' => 'hidden',
'type' => 'text',
);
$options[] = array(
'name' => __('邮箱帐号', 'kratos'),
'desc' => __('填写邮箱账号', 'kratos'),
'id' => 'm_username',
'class' => 'hidden',
'type' => 'text',
);
$options[] = array(
'name' => __('邮箱密码', 'kratos'),
'desc' => __('填写邮箱密码或授权码', 'kratos'),
'id' => 'm_passwd',
'class' => 'hidden',
'type' => 'password',
);
$options[] = array(
'id' => 'm_sendmail',
'class' => 'hidden',
'type' => 'sendmail',
);
/* ── 评论提醒的开关 ──────────────────────────────────────
*
* ⚠️ 这三个开关原先**只有代码在读取、后台没有界面**:
* `m_comment_notify` —— 有人回复时通知被回复者
* `m_comment_approved_notify` —— 评论通过审核时通知评论者
* `m_keep_core_notify` —— 保留 WordPress 自带的作者通知
* 也就是说用户无法关掉它们,只能改代码。
* 静态契约检查(`_static_315.php`)会报「模板读取的选项都有界面」失败,
* 那一项正是靠这个抓出来的。
*
* 默认值取 true 与代码里的 `kratos_option('m_comment_notify', true)` 一致:
* 评论提醒默认开着(这是博客的基本礼貌),想关的人自己能关。
*/
$options[] = array(
'name' => __('有人回复时发邮件通知', 'kratos'),
'desc' => __('评论收到回复时,给被回复的人发一封提醒。需要先在下面配好发信方式,否则发不出去。', 'kratos'),
'id' => 'm_comment_notify',
'std' => true,
'type' => 'checkbox',
);
$options[] = array(
'name' => __('评论通过审核时通知评论者', 'kratos'),
'desc' => __('评论从「待审核」变为「已通过」时,告诉评论者他的评论已显示。适合开了先审后发的站点。', 'kratos'),
'id' => 'm_comment_approved_notify',
'std' => true,
'type' => 'checkbox',
);
$options[] = array(
'name' => __('保留 WordPress 自带的作者通知', 'kratos'),
'desc' => __('主题在装了评论插件时会关掉 WordPress 自带的「有新评论通知站长」,避免和插件重复发信。只有当插件在场时勾这一项才有意义;插件不在场时主题一定会保留自带通知,不会让你收不到信。', 'kratos'),
'id' => 'm_keep_core_notify',
'std' => false,
'type' => 'checkbox',
);
/* ══════════════════════════════════════════════════════════
* 十二、CDN 加速 —— 一个开关 + 两个名单
*
* 3.2.34 原设计是「地址留空即关闭」,没有开关。本版(3.2.35)
* 按用户要求补了三件事:
* ① 「启用 CDN 加速」复选框,作为总开关
* ② 白名单预填 13 类静态资源后缀(用户可改)
* ③ 黑名单预填安全相关后缀(用户可改)
*
* ── 预制内容为什么放在输入框里而不是硬编码 ──────────────────
* 用户明确选了这条路:「预制的这些就放在白名单的输入框里,
* 这样用户就可以直接修改;修改完之后,我们再把它保存下来,
* 按照用户修改的来执行。」
*
* 所以预制内容写在 std 里 —— 它只服务两件事:
* · 后台首次渲染时预填
* · 点「恢复默认」时还原成这份内容
* 一旦用户保存过,库里就有明确的值,运行时读的是库里的值,
* 主题**不会**再去覆盖用户改过的内容。
*
* 匹配逻辑(写进说明里,让用户看得到):
* 开关没勾 → 整个功能关闭,两套名单都不参与
* 先看黑名单 → 命中就保持原地址
* 黑名单没命中 → 再看白名单
* 黑名单优先级高于白名单
* ══════════════════════════════════════════════════════════ */
$options[] = array(
'name' => __('CDN 加速', 'kratos'),
'type' => 'heading',
);
/*
* 开关必须是本段的第一个控件。
*
* std 用 yang_cdn_enable_default()(地址非空 ⇒ 默认勾选),
* 目的是**老站点升级不丢加速**:3.2.34 的站点只要填过地址就
* 一直在加速,升级后若默认不勾,它会静默失去加速,而用户不会
* 去查一个从没动过的复选框。
*/
$options[] = array(
'name' => __('启用 CDN 加速', 'kratos'),
'desc' => __('勾选后功能才生效。没勾时,下面填什么都不产生作用,前台与不装这个功能完全一致。'
. '
勾了但 CDN 地址留空是不允许的:点保存会被拦下来并提示必须填地址。', 'kratos'),
'id' => 'cdn_enable',
'std' => function_exists('yang_cdn_enable_default') ? yang_cdn_enable_default() : false,
'type' => 'checkbox',
);
$options[] = array(
'name' => __('CDN 地址', 'kratos'),
'desc' => __('资源的加速前缀,例如 https://cdn.example.com。可以不带协议(自动按 https 补全)。'
. '勾选了上面的开关,这一项就必须填。', 'kratos'),
'id' => 'cdn_url',
'std' => '',
'type' => 'text',
'placeholder' => 'https://cdn.example.com',
);
/*
* 白名单的 std 就是预制清单。
*
* ⚠️ std 在运行时**完全不生效**(kratos_option 只查库),所以
* 这里只负责「后台预填」与「恢复默认」。运行时若库里没有这个键,
* 由 yang_cdn_defaults() 提供同一份内容 —— 两处必须一致,
* 否则会出现"后台显示 13 项、运行时按 0 项算"的错位。
*/
$options[] = array(
'name' => __('白名单', 'kratos'),
'desc' => __('命中这些规则的文件才走 CDN。一行一条,# 或 ; 开头的行是注释。'
. '
这里已经预填了 13 类常用静态资源,你可以直接改、加、删,保存后按你改的执行。'
. '
⚠️ 把它全部删空 = 所有静态文件都走 CDN(不只是下面这 13 类)。'
. '不想让字体、图标字体之类的走 CDN,就把 * 换成具体后缀。', 'kratos'),
'id' => 'cdn_include',
'std' => function_exists('yang_cdn_preset_text') ? yang_cdn_preset_text(yang_cdn_preset_include()) : '',
'type' => 'code',
'settings' => array('rows' => 10),
);
$options[] = array(
'name' => __('白名单写法', 'kratos'),
'desc' => __('按路径匹配(正则规则除外,它对完整地址匹配)。下面每种写法都可以直接抄:', 'kratos')
. '
* —— 全部静态文件'
. '
jpg 或 .jpg 或 *.jpg —— 扩展名'
. '
jpg,png,webp 或 .jpg .png —— 一串扩展名,命中任一'
. '
/wp-content/uploads/ —— 以这个路径开头(以斜杠开头、不含星号)'
. '
*/uploads/* —— 通配符,* 可以跨斜杠'
. '
uploads —— 路径里含这几个字(子串)'
. '
~\/20\d\d\/~ —— 正则,对完整地址匹配'
. '
扩展到字体也很常见:加一行 .woff2 .woff .ttf .eot .otf 即可。',
'type' => 'info',
);
$options[] = array(
'name' => __('黑名单', 'kratos'),
'desc' => __('命中的文件即使符合白名单也不走 CDN,保持原地址。一行一条,写法与白名单完全相同。'
. '黑名单优先于白名单:两边都命中时按黑名单处理。'
. '
这里已经预填了安全相关的后缀(.php .env .sql .bak .log 等)—— '
. '它们一旦被推到第三方 CDN 节点上,等于把配置、数据库备份、错误日志公开了。'
. '建议保留这行,即使白名单写的是 *。', 'kratos'),
'id' => 'cdn_exclude',
'std' => function_exists('yang_cdn_preset_text') ? yang_cdn_preset_text(yang_cdn_preset_exclude()) : '',
'type' => 'code',
'settings' => array('rows' => 10),
);
$options[] = array(
'name' => __('这些地址永远不走 CDN', 'kratos'),
'desc' => __('下面这些不受两套名单影响,是硬性排除 —— 把它们改到 CDN 会让站点直接坏掉,所以不给开关:'
. '
· 以斜杠结尾的地址(页面、栏目页、导航链接):改了会让访客跳去 CDN 域名,全站 404'
. '
· 页面与动态后缀:php、html、htm、asp 等'
. '
· 没有后缀的地址:通常是接口、短链、伪静态页'
. '
· 后台与接口路径:wp-admin、wp-login.php、wp-json、wp-cron.php、xmlrpc.php、/feed/'
. '
· 非本站域名:外链图片、别人家的 CDN'
. '
· 非 http(s) 协议:data:、mailto:、tel:、javascript:', 'kratos'),
'type' => 'info',
);
$options[] = array(
'name' => __('后台与接口里不改写', 'kratos'),
'desc' => __('为了不影响编辑与调试,下面这些地方保持原地址:后台页面、REST 接口、AJAX 请求、feed 订阅、WP-Cron、定制器预览、命令行。只有访客看到的前台页面才改写。', 'kratos'),
'type' => 'info',
);
/* ══════════════════════════════════════════════════════════
* 十二、图片灯箱 —— 正文图片点击在当前页放大
*
* 放在 CDN 之后:灯箱里加载的原图地址会被 CDN 一起改写,
* 两者是相关的,放近一点方便对照着调。
*
* ⚠️ 这里的 std 必须与 inc/theme-lightbox.php 的运行时默认值一致
* (yang_lightbox_active() / yang_lightbox_theme())。
* `std` 只服务「后台预填」和「恢复默认」,**运行时完全不读**;
* 两处不一致会出现「后台看着勾上了、前台却没生效」。
* ══════════════════════════════════════════════════════════ */
$options[] = array(
'name' => __('图片灯箱', 'kratos'),
'type' => 'heading',
);
$options[] = array(
'name' => __('启用图片灯箱', 'kratos'),
'desc' => __('点击正文里的图片,在当前页面覆盖展示原图,不再跳新标签页。'
. '一篇文章有多张图时可以左右切换,也支持键盘方向键。'
. '
说明:这些图在正文里通常是缩略图,点开后加载的是原图;'
. '若开启了 CDN 加速,原图地址同样走 CDN。'
. '
关掉则完全退回原有行为(点击在新标签页打开图片)。', 'kratos'),
'std' => '1',
'id' => 'a_lightbox_enable',
'type' => 'checkbox',
);
/* 遮罩配色的两个单选项
*
* 用户先要「黑底也行、不黑也行」,看了两套演示后明确选了**白色**,
* 所以 std 从 dark 改成 light。深色仍然保留:看照片时它更合适
* (周围全黑对颜色判断干扰最小),换站/换内容时可能需要。
* 说明文字里写清各自适合什么图,避免用户反复切换试错。 */
$options[] = array(
'name' => __('遮罩配色', 'kratos'),
'desc' => __('白色(默认)适合以截图、文档、白底图为主的内容,'
. '不会让白底图的边缘发灰。'
. '
深色适合看照片:周围全黑时对图里颜色的判断更准。', 'kratos'),
'std' => 'light',
'id' => 'a_lightbox_theme',
'type' => 'radio',
'options' => array(
'light' => __('白色遮罩(浅底,看截图与文档)', 'kratos'),
'dark' => __('深色遮罩(黑底,看照片)', 'kratos'),
),
/* 只有灯箱开着时才有意义;关着的时候藏起来,
避免用户改了配色却不知道为什么没变化。 */
'requires' => 'a_lightbox_enable',
);
/* 遮罩不透明度
*
* 用户要求「不一定要把内容全盖住一点都看不见,只突出这张照片就行,
* 透明度 80% 左右」。做成可调而不是写死 80:
* · 各人屏幕亮度不同,80 在别人站上可能偏透或偏实;
* · 以后想临时更实一点(确认底下文字)或更透一点,
* 改一个数字就行,不用等主题更新。
*
* ⚠️ 用 select 而不是文本输入:文本输入让用户自己敲数字,
* 敲出 0 或 300 都是灾难(0 = 完全看不见遮罩,300 = 非法值)。
* 给固定的几档,每个档都验证过可读性。 */
$options[] = array(
'name' => __('遮罩不透明度', 'kratos'),
'desc' => __('数值越小,底下正文透出来越多 —— 能看出自己还停在哪一页,'
. '但正文也越容易干扰看图的注意力。'
. '
80%(默认)是「隐约可见、照片仍是主角」的平衡点。'
. '低于 70% 时请在深色图片较多的页面上确认一下底部文字是否还看得清。'
. '
说明:这里改的是遮罩底色的透明度,'
. '照片本身不会被弄淡。', 'kratos'),
'std' => '80',
'id' => 'a_lightbox_opacity',
'type' => 'select',
'options' => array(
'100' => __('100% —— 完全盖住(不透)', 'kratos'),
'95' => __('95% —— 几乎不透明', 'kratos'),
'90' => __('90% —— 很实', 'kratos'),
'85' => __('85%', 'kratos'),
'80' => __('80% —— 默认,隐约可见', 'kratos'),
'75' => __('75%', 'kratos'),
'70' => __('70% —— 能明显看到底下', 'kratos'),
'60' => __('60% —— 偏透', 'kratos'),
'50' => __('50% —— 最透(下限)', 'kratos'),
),
'requires' => 'a_lightbox_enable',
);
/* ══════════════════════════════════════════════════════════
* 十二·五、代码高亮
*
* 自研替换(highlight.js 自托管),不再依赖 Enlighter / Prism 插件。
*
* ⚠️ 这里的 std 必须与 inc/theme-highlight.php 的运行时默认值一致
* (yang_hl_enabled() / yang_hl_js_config())。
* `std` 只服务「后台预填」和「恢复默认」,**运行时完全不读**;
* 两处不一致会出现「后台看着勾上了、前台却没生效」。
* ══════════════════════════════════════════════════════════ */
$options[] = array(
'name' => __('代码高亮', 'kratos'),
'type' => 'heading',
);
$options[] = array(
'name' => __('启用代码高亮', 'kratos'),
'desc' => __('接管文章与评论里的所有代码块:配色、语言标签、复制按钮、行号。'
. '
关掉则退回插件高亮(若插件也没开,代码块就是纯文本)。', 'kratos'),
'std' => '1',
'id' => 'a_highlight_enable',
'type' => 'checkbox',
);
/* 配色:20 套 = 10 浅 + 10 深
*
* 深色组不是装饰。两个实际用途:
* ① 技术文章里把代码块做成深色,能压住浅色的正文,突出代码本身;
* ② 一篇文章并列给 Python / Java 两种实现时,配色差异帮读者分清段落。
* 站内实测有 19 篇文章含 ≥2 种语言、38 处相邻代码块语言不同 —— 确有场景。
*
* 只加载选中的那一套:20 套全加载约 50KB,没必要,
* 而且多套同时在场时会互相压制,切换时容易"看起来没变"。 */
$yang_hl_opts = array();
if (function_exists('yang_hl_themes')) {
foreach (yang_hl_themes() as $k => $v) {
$yang_hl_opts[$k] = $v[1] === 'dark'
? sprintf(__('%s(深色)', 'kratos'), $v[0])
: sprintf(__('%s(浅色)', 'kratos'), $v[0]);
}
}
$options[] = array(
'name' => __('代码配色', 'kratos'),
'desc' => __('共 20 套,10 套浅色 + 10 套深色。'
. '
浅色与站点底色接近,整体更统一;'
. '深色能压住浅色正文、让代码更突出,技术文章里常用。'
. '
说明:深色配色会连带代码块的顶栏与底色一起变深,'
. '不会出现"浅色页面上印浅色字"。', 'kratos'),
'std' => 'github',
'id' => 'a_highlight_theme',
'type' => 'select',
'options' => $yang_hl_opts,
'requires' => 'a_highlight_enable',
);
/* 配色预览:紧跟在配色下拉框后面
*
* 为什么需要:20 套配色只有名字(GitHub / Monokai / Night Owl…),
* 光看名字不知道长什么样。原来的流程是
* 选一个 → 保存 → 去前台刷新 → 不满意 → 回来再选,
* 来回几次就放弃、最后一直用默认那套。
*
* 这里放一张**真代码块卡片**,切换下拉框立刻换色,不用保存。
* 用的是前台同一份 CSS(配色 min.css + highlight.css),不另写一套 ——
* 另写一套会导致预览和前台不一致,比没有预览更误导人。 */
if (function_exists('yang_hl_admin_preview_html')) {
$options[] = array(
'name' => '',
'desc' => yang_hl_admin_preview_html(),
'type' => 'info',
'class' => 'yang-hl-preview-wrap',
);
}
$options[] = array(
'name' => __('显示行号', 'kratos'),
'desc' => __('默认关闭。'
. '
行号画在代码左侧的独立区域里,不会进入复制内容 ——'
. '复制出去的永远是干净的代码,可以直接粘到编辑器里跑。'
. '
说明:如果是要逐行对比两段代码,建议复制到编辑器里用'
. '它自带的行号或对比功能,那样更准确。', 'kratos'),
'std' => '0',
'id' => 'a_highlight_line_numbers',
'type' => 'checkbox',
'requires' => 'a_highlight_enable',
);
$options[] = array(
'name' => __('显示复制按钮', 'kratos'),
'desc' => __('默认开启。代码块右上角一个「复制」,点一下把纯代码放进剪贴板。'
. '
桌面端鼠标移到代码块上才显形(不占视觉),'
. '触屏设备上常驻可见。', 'kratos'),
'std' => '1',
'id' => 'a_highlight_copy_button',
'type' => 'checkbox',
'requires' => 'a_highlight_enable',
);
/* 自动识别必须做成选项,不能强行开着
*
* 站内实测:18 个 ≥4 行、作者没标语言的代码块,用 highlightAuto 只对了 4 个
* (22%)。典型错误:Java 被认成 Kotlin 或 C#、shell 输出被认成 Swift、
* 配置文件被认成 Go/Ruby、140 行 LaTeX 被认成 Ruby。
* 所以它默认开着当兜底(老文章大量没标语言,不开就全是白板),
* 但必须让用户能关掉 —— 否则等于把 78% 的错误结果当成事实贴在页面上。
* 识别出来的标签会画成虚线边框 + 斜体,与作者手标的实线区分开。 */
$options[] = array(
'name' => __('自动识别代码语言', 'kratos'),
'desc' => __('默认开启。对没写语言标记的代码块自动判断语言并上色;'
. '作者标了语言的块永远按标记来,不受影响。'
. '
识别结果会画成虚线边框 + 斜体,提醒读者这是猜的、可能不准。'
. '
为什么要做成开关:自动识别并不总对 —— 已用站内代码实测,'
. '像 Java 可能被认成 Kotlin/C#、命令行输出可能被认成 Swift。'
. '如果你发现某些代码块颜色明显不对,可以关掉它,全部按纯文本显示。', 'kratos'),
'std' => '1',
'id' => 'a_highlight_autodetect',
'type' => 'checkbox',
'requires' => 'a_highlight_enable',
);
/* ══════════════════════════════════════════════════════════
* 十三、写作增强 —— 发布时自动生成别名/标签/分类/摘要
*
* 四个引擎各自独立开关,互不依赖。分工是按「能不能纯本地做」
* 划的,不是按功能好坏:
* · 分类、摘要 → 纯本地(分类 90% 准确率、摘要 4ms)
* · 标签 → 本地优先,外部可选(Top8 召回 49.2%,见下方说明)
* · 别名 → 必须外部(纯 PHP 做不出中译英)
*
* 用户明确要求「能不用外部就不用,为了安全着想」,所以默认状态是:
* 四个开关**全关**,需要用户主动打开 —— 新装主题不该偷偷往文章里写东西。
* ══════════════════════════════════════════════════════════ */
$options[] = array(
'name' => __('写作增强', 'kratos'),
'type' => 'heading',
);
$options[] = array(
'name' => __('总开关说明', 'kratos'),
'desc' => __('下面的功能全部只在「文章第一次发布」那一下生效,'
. '并且只填空白、绝不覆盖已有内容。'
. '
已发布的旧文章完全不动 —— 再次编辑保存也不会改任何字段。'
. '
这样设计是因为别名就是 URL:一旦被改,旧链接全部 404。', 'kratos'),
'type' => 'info',
);
/* ── ① 摘要 ────────────────────────────────────────────────
* 放第一个:最安全、最便宜、纯本地、离线可用。
* 站点现在 967 篇文章**没有一篇有摘要**,这一项立刻有收益。 */
$options[] = array(
'name' => __('自动生成摘要', 'kratos'),
'desc' => __('发布时从正文里抽取 150 字左右的摘要,写入「摘要」字段。'
. '纯本地计算,不联网,耗时约 4 毫秒。'
. '
只有摘要为空时才写;你自己写过的摘要不会被改动。', 'kratos'),
'std' => '0',
'id' => 'w_on_excerpt',
'type' => 'checkbox',
);
/* ── ② 分类 ────────────────────────────────────────────────
* 同样纯本地。只在新文章还挂在「默认分类」上时才出手。 */
$options[] = array(
'name' => __('自动选择分类', 'kratos'),
'desc' => __('发布时按标签与已发布文章的历史共现关系,推荐最接近的一个分类。'
. '纯本地计算,不联网。'
. '
只对仍挂在「默认分类」的新文章生效;你已经选过分类的不动。'
. '
线上实测准确率约 90%(前三名命中 99%)。', 'kratos'),
'std' => '0',
'id' => 'w_on_category',
'type' => 'checkbox',
);
/* ── ③ 标签 ────────────────────────────────────────────────
* 本地引擎:703 个已有标签当词典,最大匹配 + TF-IDF 排序。
* 外部引擎:本地匹配不到新词时,由服务商提关键词 —— 这是唯一
* 能"发现新词"的路(服务器没有任何中文分词扩展)。 */
$options[] = array(
'name' => __('自动生成标签', 'kratos'),
'desc' => __('发布时自动打标签。优先从你已有的标签里挑'
. '(实测:Top8 能命中人工标签的 49.2%,'
. '只算字面出现在正文里的人工标签则 59.0%),'
. '匹配不到才考虑新增。'
. '
你自己手工打的标签不会被删除,只会追加。', 'kratos'),
'std' => '0',
'id' => 'w_on_tag',
'type' => 'checkbox',
);
$options[] = array(
'name' => __('每篇最多新增几个标签', 'kratos'),
'desc' => __('只限制新建的标签数量;匹配到已有标签不受此限制。'
. '
设为 0 表示只从已有标签里挑,永不新建。'
. '
为什么要限制:站内 703 个标签里已有 338 个只用过 1 次,'
. '放开新建会让标签库迅速变成几千个长尾词。', 'kratos'),
'std' => '3',
'id' => 'w_tag_new_limit',
'type' => 'text',
);
/* ── ④ 别名 ────────────────────────────────────────────────
* 唯一必须联网的一项。放最后:万一接口超时,前面三项已经落库。 */
$options[] = array(
'name' => __('自动生成英文别名', 'kratos'),
'desc' => __('发布时把中文标题翻译成英文,作为 URL 别名(slug)。'
. '这一项必须联网调用翻译服务 —— 纯 PHP 做不出中译英,'
. '拼音方案(xin-xi-jiao-lu…)又长又不可读,所以没有本地引擎。'
. '
只有别名为空、或仍是 %e4%bf%a1 这种乱码时才写;'
. '你手工填过的别名绝不动。'
. '
翻译失败(超时、限额用尽)时安静跳过,不影响发布。', 'kratos'),
'std' => '0',
'id' => 'w_on_slug',
'type' => 'checkbox',
);
/* ── 翻译服务商 ────────────────────────────────────────────
* 只用服务器实测可达的三家。Google 翻译返回 000、LibreTranslate 超时,
* 已排除 —— 列出来只会让用户白填密钥。 */
$providers = function_exists('yang_writing_providers') ? yang_writing_providers() : array();
$prov_sel = array();
foreach ($providers as $k => $v) {
$prov_sel[$k] = $v['label'];
}
/* ── 首帧显隐:在服务端就把它算对 ──────────────────────────
*
* 不这么做的后果:进设置页时四个密钥框**全部先显示**,等
* options-custom.js 跑到 yq_toggle_writing_slug_fields() 才被藏起来 ——
* 每次进页面、每次保存后重载,都闪一下。
*
* inc/theme-avatar.php 那边踩过同一个坑,结论一样:
* 「首帧的显隐由 PHP 打 class 上(不闪),JS 只管‘点了之后’。」
*
* ⚠️ 这里读的是**当前已保存值**,不是 std。用户没保存过时
* kratos_option 会给回传的默认值,正好也是表单上显示的值,一致。 */
$yang_prov_now = (string) kratos_option('w_provider', 'mymemory');
if (!isset($prov_sel[$yang_prov_now])) {
/* 库里的值不在清单里(配置被改坏 / 服务商下架)时,按第一项算,
与 select 实际会选中的那项保持一致 —— 否则首帧和 JS 修正后不一样。
🔴 别用 key($prov_sel) 取「第一项」:那读的是数组**内部指针**,
而指针位置取决于前面有没有跑过 foreach / reset,属于隐式状态。
PHP 7 起 foreach 按值遍历不动指针,所以现在恰好对;但这是巧合,
不是保证 —— 中间插一句 reset() 或改成按引用遍历就会变。
线上硬基线是 PHP 7.4,用 array_key_first()(7.3+)才是显式的。 */
$yang_first = function_exists('array_key_first') ? array_key_first($prov_sel) : null;
if ($yang_first === null && !empty($prov_sel)) {
$yang_keys = array_keys($prov_sel);
$yang_first = $yang_keys[0];
}
$yang_prov_now = (string) $yang_first;
}
$yang_on_slug = function_exists('yang_writing_on') ? yang_writing_on('w_on_slug') : false;
/* 生成某个字段的 class。$key 为 null 表示「不按服务商分组、只看总开关」。 */
$yang_prov_class = function ($key = null) use ($yang_on_slug, $yang_prov_now) {
if ($key === null) {
return $yang_on_slug ? '' : 'yq-cond-hide';
}
$cls = 'yang-prov yang-prov-' . $key;
if (!$yang_on_slug || $key !== $yang_prov_now) {
$cls .= ' yq-cond-hide';
}
return $cls;
};
$options[] = array(
'name' => __('翻译服务商', 'kratos'),
'desc' => __('别名生成用的翻译服务。MyMemory 无需密钥,开箱可用,'
. '但它是国外服务、有每日字符限额;被限流时换成百度即可。'
. '
选定之后,下方只出现这一家的账号输入框 —— 用不上的不会摆在那里碍事。', 'kratos'),
'std' => 'mymemory',
'id' => 'w_provider',
'type' => 'select',
'options' => $prov_sel,
'class' => $yang_prov_class(),
);
/* ── 按服务商分组的账号字段 ────────────────────────────────
*
* 需求(3.2.58):选了谁才显示谁的输入框,别把四家的密钥框全摆着。
*
* 实现要点 —— `class` 里那两个勾子不是装饰,是**唯一的分组声明处**:
* yang-prov 「我说哪家就显示哪家」的成员标记
* yang-prov- 属于哪一家,key 必须与 yang_writing_providers() 一致
*
* 为什么把分组写在 PHP 而不是 JS 里写死一张映射表:
* 服务商清单本来就只有 theme-writing.php 一份(yang_writing_providers())。
* 若 JS 里再抄一份 {baidu:[...], youdao:[...]},将来加一家就得改两处,
* 而且两边不一致时**不会报错**,只会表现成「新服务商的框永远不出现」。
* 现在 JS 只做一件事:读元素上的 class,和下拉框当前值比对。
*
* ⚠️ 框架确实会把这里的 class 拼到包裹 div 上(见
* class-options-interface.php:70 的 `$class .= ' ' . $value['class']`),
* 所以 text/password 会得到 `section section-text yang-prov ...`。
*
* ⚠️ info 类型走的是另一条分支(:272),它拼出来的 class 是
* `section section-info yang-prov ...` —— 注意它**也有 .section 类**。
* 本文件下面那段 CSS 注释里写的「info 不生成 .section 包裹层」只对
* `id="section-xxx"` 这个 id 成立,class 是有的。别再被那句话误导。
*/
/* MyMemory:无需任何账号,说明只有一句。 */
$options[] = array(
'name' => __('服务商账号填写说明', 'kratos'),
'id' => 'w_provider_help_mymemory',
'desc' => __('MyMemory 不用填任何东西,选它就已经可用。'
. '
它是免费公共服务,每日有字符限额;某天开始报错、别名生成不出来,'
. '多半是限额用完了 —— 换百度即可。', 'kratos'),
'type' => 'info',
'class' => $yang_prov_class('mymemory'),
);
$options[] = array(
'name' => __('百度翻译 · 账号怎么拿', 'kratos'),
'id' => 'w_provider_help_baidu',
'desc' => __('访问 fanyi-api.baidu.com '
. '→ 注册登录 → 进入「管理控制台」→ 在「开发者信息」里可看到 APPID 与 密钥。'
. '
免费版每月 5 万字符,对个人博客够用。', 'kratos'),
'type' => 'info',
'class' => $yang_prov_class('baidu'),
);
$options[] = array(
'name' => __('百度 APPID', 'kratos'),
'desc' => __('在百度控制台的「开发者信息」里,形如 20240xxx 的一串数字。', 'kratos'),
'id' => 'w_baidu_appid',
'type' => 'text',
'class' => $yang_prov_class('baidu'),
);
/* 密钥字段的特殊处理(只对这两项生效)。
*
* 框架的 password 类型会把**真实值**写进 HTML 的 value 属性,页面上看着
* 是圆点,F12 一看就是明文(主题里的 SMTP 密码现在就是这样,那是既有
* 问题,不在本次范围)。这个新功能没有照抄一遍的理由。
*
* 做法:submit 前先用 '' 覆盖掉 std,页面上永远不出现真实密钥;
* 真实值存进独立选项 yang_writing_secrets(见 theme-writing.php 的
* yang_writing_capture_secret)。已有值时在下方提示末 4 位,
* 留空提交 = 不修改。 */
$yang_baidu_hint = function_exists('yang_writing_secret_hint') ? yang_writing_secret_hint('w_baidu_key') : '';
$yang_youdao_hint = function_exists('yang_writing_secret_hint') ? yang_writing_secret_hint('w_youdao_key') : '';
$options[] = array(
'name' => __('百度密钥', 'kratos'),
'desc' => __('留空表示不修改已保存的密钥。', 'kratos')
. ($yang_baidu_hint !== '' ? '
当前已保存:' . esc_html($yang_baidu_hint) . '' : ''),
'id' => 'w_baidu_key',
'type' => 'password',
'std' => '',
'class' => $yang_prov_class('baidu'),
);
$options[] = array(
'name' => __('有道翻译 · 账号怎么拿', 'kratos'),
'id' => 'w_provider_help_youdao',
'desc' => __('访问 ai.youdao.com '
. '→ 注册登录 → 「创建应用」选「文本翻译」→ 在「应用管理」里可看到 应用 ID 与 应用密钥。', 'kratos'),
'type' => 'info',
'class' => $yang_prov_class('youdao'),
);
$options[] = array(
'name' => __('有道应用 ID', 'kratos'),
'desc' => __('在「应用管理」里查。', 'kratos'),
'id' => 'w_youdao_appid',
'type' => 'text',
'class' => $yang_prov_class('youdao'),
);
$options[] = array(
'name' => __('有道应用密钥', 'kratos'),
'desc' => __('留空表示不修改已保存的密钥。', 'kratos')
. ($yang_youdao_hint !== '' ? '
当前已保存:' . esc_html($yang_youdao_hint) . '' : ''),
'id' => 'w_youdao_key',
'type' => 'password',
'std' => '',
'class' => $yang_prov_class('youdao'),
);
/* 超时对所有服务商通用,所以只跟第一层(w_on_slug)走,不分服务商分组。 */
$options[] = array(
'name' => __('接口超时(秒)', 'kratos'),
'desc' => __('调用翻译接口的最长等待时间,建议 8 秒。'
. '设太大时接口挂了会拖慢发布;设太小则容易误判超时。', 'kratos'),
'std' => '8',
'id' => 'w_timeout',
'type' => 'text',
'class' => $yang_prov_class(),
);
/* ══════════════════════════════════════════════════════════
* 十四、自定义代码 —— 兜底用,放最后
*
* 3.2.29 起这两项默认都为空:站点自己的通用样式
* (段落缩进、h2 蓝条、列表缩进)已并入 assets/css/site.css,
* 跟着主题走、升级不丢,也不再需要在这里重复一份。
* ══════════════════════════════════════════════════════════ */
$options[] = array(
'name' => __('自定义代码', 'kratos'),
'type' => 'heading',
);
$options[] = array(
'name' => __('自定义 CSS', 'kratos'),
'desc' => __('附加样式,排在主题公共样式之后加载,用于临时覆盖。站点通用样式已并入主题的 assets/css/site.css,这里留空即可。保存后立即生效,随主题升级保留。', 'kratos'),
'id' => 'g_custom_css',
'std' => yang_opt_default_custom_css(),
'type' => 'code',
'settings' => array('rows' => 14),
);
$options[] = array(
'name' => __('自定义 JS', 'kratos'),
'desc' => __('附加脚本,在页面底部加载,不需要写 <script> 标签。', 'kratos'),
'id' => 'g_custom_js',
'std' => '',
'type' => 'code',
'settings' => array('rows' => 14),
);
return $options;
}