确认 -> 上传到自建 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' => '![%alt%](%url%)', ]; 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% 原文件名。想和极简图床页面完全一致可填 ![](%url%)。') ); $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 '
'; echo ''; echo '

'; echo '

' . _t('选图并确认后上传到自建图床,自动把 Markdown 插入光标处;也可拖入图片或在弹窗内 Ctrl+V 粘贴。单张不超过 ') . $limit . ' MB。

'; if (!Options::alloc()->markdown) { echo '

' . _t('当前站点未开启 Markdown,插入的图片语法可能不会被解析。') . '

'; } $mode = $cfg['authMode']; $identity = $mode === 'token' ? _t('API Token') : ($mode === 'admin' ? _t('管理员 Cookie') : _t('游客')); $missing = ($mode === 'token' && $cfg['token'] === '') || ($mode === 'admin' && ($cfg['adminUser'] === '' || $cfg['adminSecret'] === '')); $hint = $mode === 'token' ? _t('(未填写 API Token,上传会被拒绝;请到图床后台「Token 设置」页生成后填入插件设置)') : _t('(未填写管理员账号或密码/Cookie,上传会被拒绝)'); echo '

' . _t('图床身份:') . '' . $identity . ''; if ($missing) { echo ' ' . $hint . ''; } echo '

'; // 默认接口地址是占位符,没改过就上传必然失败,这里提前拦住并给出明确指引 if (strpos($cfg['apiUrl'], 'img.example.com') !== false) { echo '

' . _t('插件设置里的「图床上传接口地址」仍是占位值,请先改成你的实际地址,并用「测试连接」验证。') . '

'; } echo '

'; echo '
'; } /** * bottom 钩子:弹窗 DOM、样式、交互脚本。 */ public static function renderFooter($content) { $cfg = self::settings(); $actionUrl = \Widget\Security::alloc()->getIndex('/action/' . self::ACTION); // Token / Cookie 模式携带服务端凭证,绝不允许把请求切到浏览器直连 $mode = ($cfg['mode'] === 'direct' && $cfg['authMode'] === 'guest') ? 'direct' : 'proxy'; $jsCfg = [ 'mode' => $mode, 'template' => (string) $cfg['template'], 'maxSize' => max(1, (int) $cfg['maxSize']), 'actionUrl' => $actionUrl, ]; // 直连模式必须把接口信息下发到浏览器;代理模式下 token 只留在服务端。 if ($jsCfg['mode'] === 'direct') { $jsCfg['apiUrl'] = (string) $cfg['apiUrl']; $jsCfg['fieldName'] = (string) $cfg['fieldName']; $jsCfg['token'] = (string) $cfg['token']; $jsCfg['extra'] = Util::parsePairs($cfg['extraFields'], '='); } $flags = JSON_UNESCAPED_SLASHES | JSON_UNESCAPED_UNICODE | JSON_HEX_TAG | JSON_HEX_AMP | JSON_HEX_APOS | JSON_HEX_QUOT; echo ''; echo <<<'IUCSS' IUCSS; echo <<<'IUHTML'
IUHTML; echo <<<'IUJS' IUJS; } }