确认 -> 上传到自建 TinyImg 图床 -> 把 Markdown 插入光标处。
*
* @package TinyImgUploader
* @author BuddyRobot
* @version 2.0.0
* @since 1.3.0
*/
class Plugin implements PluginInterface
{
/** 插件目录名,也是设置项的命名空间 */
const NAME = 'TinyImgUploader';
/** Action 名,对应 /action/tinyimg-uploader */
const ACTION = 'tinyimg-uploader';
/** 允许显式留空的设置项:留空表示「跳过管理员目录校验」 */
const NULLABLE = ['adminDir'];
/** 设置项默认值 */
const DEFAULTS = [
// 占位地址:部署后请改成自己图床的 functions/upload.php 绝对地址
'apiUrl' => 'https://img.example.com/functions/upload.php',
'fieldName' => 'file',
'mode' => 'proxy',
'authMode' => 'token',
'adminUser' => '',
'adminSecret' => '',
'adminDir' => 'upload',
'allowGroup' => 'contributor',
'token' => '',
'extraFields' => '',
'headers' => '',
'maxSize' => '2',
'template' => '',
];
public static function activate()
{
// 侧栏卡片:admin/write-post.php:119 / admin/write-page.php:145
\Typecho\Plugin::factory('admin/write-post.php')->option = __CLASS__ . '::renderOption';
\Typecho\Plugin::factory('admin/write-page.php')->option = __CLASS__ . '::renderOption';
// 弹窗与脚本:页面底部,此时 jQuery 已加载
\Typecho\Plugin::factory('admin/write-post.php')->bottom = __CLASS__ . '::renderFooter';
\Typecho\Plugin::factory('admin/write-page.php')->bottom = __CLASS__ . '::renderFooter';
Helper::addAction(self::ACTION, Action::class);
return _t('图床上传已启用;请在设置里填写图床 functions/upload.php 地址,并填入图床后台「Token 设置」页生成的 API Token,然后点「测试连接」验证');
}
public static function deactivate()
{
Helper::removeAction(self::ACTION);
}
public static function config(Form $form)
{
$apiUrl = new Text(
'apiUrl',
null,
self::DEFAULTS['apiUrl'],
_t('图床上传接口地址'),
_t('TinyImg 2.0 的上传端点:https://你的图床域名/functions/upload.php。默认值是占位地址,必须改成你的实际地址;以 http:// 或 https:// 开头。')
);
$apiUrl->addRule('required', _t('请填写上传接口地址'));
$apiUrl->input->setAttribute('class', 'w-100 text');
$form->addInput($apiUrl);
$authMode = new Radio(
'authMode',
[
'token' => _t('API Token(推荐,TinyImg 2.0 原生支持)'),
'admin' => _t('管理员 Cookie(回退方案,凭证等价于后台密码)'),
'guest' => _t('游客上传(图片进 temp 目录,受每日数量限制)'),
],
self::DEFAULTS['authMode'],
_t('上传到图床的鉴权方式'),
_t('Token 用 X-TinyImg-Token 请求头,由图床后台「Token 设置」页生成,只在服务端出现;Cookie 模式模拟图床后台登录态。详见 README 的鉴权方案对比。')
);
$form->addInput($authMode);
$adminUser = new Text(
'adminUser',
null,
'',
_t('图床管理员账号'),
_t('图床 config.php 里 user 配置项的值,必须与图床完全一致(区分大小写)。')
);
$form->addInput($adminUser);
// 个别 Typecho 构建可能没有 Password 元素,降级成普通输入框以免设置页直接 500
$secretElement = class_exists('Typecho\\Widget\\Helper\\Form\\Element\\Password')
? Password::class
: Text::class;
$adminSecret = new $secretElement(
'adminSecret',
null,
'',
_t('图床管理员密码 / 登录 Cookie 值'),
_t('可填明文密码(插件自动算 md5("tinyimg" + 密码) 作为 Cookie);更推荐用 tools/cookie.php 算出 32 位值后填入,或直接复制图床登录后 Cookie 里的 password 值,避免明文密码存入数据库。')
);
$form->addInput($adminSecret);
$adminDir = new Text(
'adminDir',
null,
self::DEFAULTS['adminDir'],
_t('管理员上传目录名'),
_t('图床 config.php 里 admindir 的值,默认 upload。上传后用它检查是否真的以管理员身份生效;留空则跳过该检查。')
);
$form->addInput($adminDir);
$allowGroup = new Radio(
'allowGroup',
[
'contributor' => _t('贡献者及以上(默认)'),
'administrator' => _t('仅博客管理员可用'),
],
self::DEFAULTS['allowGroup'],
_t('允许使用该插件的博客用户组'),
_t('这是 Typecho 侧的权限,与上面的图床身份无关;两处都设为管理员即实现「仅管理员以管理员身份上传」。')
);
$form->addInput($allowGroup);
$fieldName = new Text(
'fieldName',
null,
self::DEFAULTS['fieldName'],
_t('文件表单字段名'),
_t('TinyImg 2.0 为 file;其它图床可能是 image、smfile 等,按接口文档填写。')
);
$form->addInput($fieldName);
$mode = new Radio(
'mode',
[
'proxy' => _t('服务端代理(推荐,无需图床开放 CORS)'),
'direct' => _t('浏览器直连(需图床返回 CORS 响应头)'),
],
self::DEFAULTS['mode'],
_t('上传方式'),
_t('实测本图床未返回 Access-Control-Allow-Origin,默认必须用服务端代理;Token / Cookie 模式会强制走代理,防止凭证下发到浏览器。')
);
$form->addInput($mode);
$maxSize = new Text(
'maxSize',
null,
self::DEFAULTS['maxSize'],
_t('单张图片上限(MB)'),
_t('TinyImg 2.0 源码里硬编码 file_max_size = 2097152(2 MB),填大于 2 会被图床拒绝。')
);
$maxSize->addRule('required', _t('请填写大小上限'));
$maxSize->addRule('isInteger', _t('请填写整数'));
$form->addInput($maxSize);
$template = new Text(
'template',
null,
self::DEFAULTS['template'],
_t('插入 Markdown 模板'),
_t('可用占位符:%url% 图片地址、%alt% 不含扩展名的文件名、%name% 原文件名。想和极简图床页面完全一致可填 。')
);
$template->input->setAttribute('class', 'w-100 mono');
$form->addInput($template);
$token = new $secretElement(
'token',
null,
'',
_t('图床 API Token'),
_t('在图床后台「Token 设置」页生成或复制,粘贴到此处,两处必须完全一致。Token 模式用 X-TinyImg-Token 请求头在服务端发送,不写入撰写页、不出现在 URL;Cookie / 游客模式下本项留空。')
. self::testButtonHtml()
);
$token->input->setAttribute('class', 'w-100 mono');
$form->addInput($token);
$extraFields = new Textarea(
'extraFields',
null,
'',
_t('附加表单字段(可选)'),
_t('每行一项,格式 key=value,例如 uid=1。用于需要 uid / apiType / folder 等参数的图床。')
);
$form->addInput($extraFields);
$headers = new Textarea(
'headers',
null,
'',
_t('附加请求头(可选,仅代理模式)'),
_t('每行一项,格式 Key: Value。例如需要登录态时填 Cookie: xxxx,或覆盖 Referer。默认已自动带 User-Agent、Referer、X-Requested-With。')
);
$form->addInput($headers);
}
public static function personalConfig(Form $form)
{
}
/**
* 设置页「测试连接」按钮的 HTML(由 config() 放进 Token 字段的说明里)。
*
* 走博客同源的 /action/tinyimg-uploader?do=test,由 PHP 携带 Token 去请求
* 图床的 functions/upload.php?ping=1,因此不受跨域限制、也不会把图床地址
* 或 Token 暴露给撰写文章页。URL 里的 _ 参数是 Typecho 的 CSRF 令牌。
*
* 单独做成 public 方法,便于 tests/render_test.php 直接断言而不必 stub 整套表单类。
*/
public static function testButtonHtml()
{
$testUrl = '';
try {
if (class_exists('\\Widget\\Security')) {
$testUrl = \Widget\Security::alloc()->getIndex('/action/' . self::ACTION . '?do=test');
}
} catch (\Throwable $e) {
$testUrl = '';
}
$jsonUrl = json_encode(
(string) $testUrl,
JSON_UNESCAPED_SLASHES | JSON_HEX_TAG | JSON_HEX_APOS | JSON_HEX_QUOT
);
$html = ''
. ''
. ''
. ''
. ''
. _t('测试会读取上方输入框里的 Token(无需先保存),验证图床是否认这个 Token,并返回图床版本与管理员目录。')
. '';
if ($testUrl === '') {
return $html . '' . _t('无法生成安全令牌,请刷新设置页后重试') . '';
}
$js = <<<'TIJS'
TIJS;
return $html . str_replace('__TEST_URL__', $jsonUrl, $js);
}
/**
* 读取设置,缺失项回落默认值。禁用插件会清空设置,这里做兜底避免出现 500。
* Action 也复用本方法,保证权限校验与转发行为读的是同一份配置。
*/
public static function settings()
{
try {
$saved = Options::alloc()->plugin(self::NAME)->toArray();
} catch (\Typecho\Plugin\Exception $e) {
$saved = [];
}
foreach (self::DEFAULTS as $key => $default) {
$exists = array_key_exists($key, $saved);
// adminDir 允许显式留空(表示跳过目录校验)
$nullableEmpty = $exists && $saved[$key] === '' && in_array($key, self::NULLABLE, true);
if (!$exists || ($saved[$key] === '' && !$nullableEmpty)) {
$saved[$key] = $default;
}
}
return $saved;
}
/**
* 「仅博客管理员可用」时,非管理员连侧栏卡片都不显示。
* Action 里仍会再做一次权限校验,这里是纯粹的界面收敛。
*/
private static function canUse(array $cfg)
{
if ($cfg['allowGroup'] !== 'administrator' || !class_exists('\\Widget\\User')) {
return true;
}
$user = \Widget\User::alloc();
return (bool) ($user->hasLogin() && $user->pass('administrator', true));
}
/**
* option 钩子:右侧「选项」标签页内的上传卡片。
*/
public static function renderOption($content)
{
$cfg = self::settings();
if (!self::canUse($cfg)) {
return;
}
$limit = htmlspecialchars((string) $cfg['maxSize'], ENT_QUOTES, 'UTF-8');
echo ' ' . _t('选图并确认后上传到自建图床,自动把 Markdown 插入光标处;也可拖入图片或在弹窗内 Ctrl+V 粘贴。单张不超过 ')
. $limit . ' MB。 '
. _t('当前站点未开启 Markdown,插入的图片语法可能不会被解析。') . ' ' . _t('图床身份:') . '' . $identity . '';
if ($missing) {
echo ' ' . $hint . '';
}
echo ' '
. _t('插件设置里的「图床上传接口地址」仍是占位值,请先改成你的实际地址,并用「测试连接」验证。')
. '