承接前兩節,本文詳細講解 Typecho 插件如何通過 Typecho_Widget_Helper_Form 體系實現配置頁面的自動生成、數據持久化與讀取,以「百度站長平台鏈接提交插件」為例演示完整流程。
public static function activate() {
// 可在這裡創建表、寫入默認配置等初始化操作
return '插件安裝成功,請進入設置填寫准入密鑰';
}
public static function deactivate() {
// 可選:清理數據、移除定時任務等
return '插件卸載成功';
}
返回字符串將在後台顯示為綠色/紅色提示條,提升用戶體驗。
config() 方法)public static function config(Typecho_Widget_Helper_Form $form) {
// 文本輸入框:API 調用地址
$api = new Typecho_Widget_Helper_Form_Element_Text(
'api', // name:存儲鍵名
null, // options:下拉選項(文本框為 null)
null, // value:默認值
_t('接口調用地址'), // label:顯示標題
'請登錄百度站長平台獲取' // description:幫助文本
);
$form->addInput($api);
// 更多表單類型示例:
// 下拉選擇:Typecho_Widget_Helper_Form_Element_Select
// 複選框:Typecho_Widget_Helper_Form_Element_Checkbox
// 隱藏域:Typecho_Widget_Helper_Form_Element_Hidden
// 密碼框:Typecho_Widget_Helper_Form_Element_Password
// 單選組:Typecho_Widget_Helper_Form_Element_Radio
}
| 參數 | 名稱 | 說明 |
|---|---|---|
$name | 表單項名稱 | 對應數據庫 options 表 name 字段,唯一標識 |
$options | 選項數組 | Select/Checkbox/Radio 使用,格式 ['value'=>'Label'] |
$value | 默認值 | 未保存配置時顯示的初始值 |
$label | 顯示標題 | 後台配置頁左側標籤文本 |
$description | 描述/幫助 | 標籤下方灰色小字提示 |
插件啟用後,配置自動持久化到 typecho_options 表(name=plugin:插件名:api)。在其他掛點(如 action_contents_post_edit)中讀取:
$options = Typecho_Widget::widget('Widget_Options');
$apiUrl = $options->plugin('BaiduSubmit')->api; // 插件名對應目錄名
if ($apiUrl) {
// 調用百度推送 API
}
$name 需重啟插件:配置已持久化,改名後舊鍵值仍留在數據庫,新鍵值為空。需禁用再啟用插件重置。Typecho_Widget_Helper_Form_Element_Fake:僅作佔位/分組標題,不產生輸入控件,不保存數據。Typecho_Widget_Helper_Form_Element 重寫 validate() 實現自定義校驗(如 URL 格式、API 連通性測試)。plugin:插件名:site_id:key)。_t() 支援多語言。Element_Password 並啟用 HTTPS 後台。掌握 Form 組件體系,即可快速構建專業級插件配置界面,專注業務邏輯而非 HTML 拼接。