Typecho 插件開發教程（三）：配置面板實現與表單元素保存機制

Typecho 插件開發教程（三）：配置面板實現與表單元素保存機制

上節建立裸插件，本節實現 activate()/deactivate() 返回友好提示，並通過 config() 方法構建後台配置面板，保存百度站長 API 接口調用地址。

1. 完善激活/禁用提示

public static function activate() {
    return '插件安裝成功，請進入設置填寫准入密鑰';
}
public static function deactivate() {
    return '插件卸載成功';
}

返回字符串將在後台操作彈窗顯示。

2. 配置面板構建

public static function config(Typecho_Widget_Helper_Form $form) {
    // 保存接口調用地址
    $element = new Typecho_Widget_Helper_Form_Element_Text(
        'api',           // name: 表單字段名，對應數據庫 option 鍵
        null,            // options: 下拉選項（文本框無需）
        null,            // value: 默認值
        _t('接口調用地址'), // label: 顯示標題
        '請登錄百度站長平台獲取' // description: 說明文字
    );
    $form->addInput($element);
}

3. 表單元素構造函數參數詳解

public function __construct(
    $name = null,        // 表單輸入項名稱（鍵）
    array $options = null, // 選擇項（select/radio/checkbox 用）
    $value = null,       // 默認值
    $label = null,       // 顯示標題
    $description = null  // 描述說明
)

4. 常用表單元素類型

5. 關鍵注意事項

• 修改 name 需重啟插件：啟用時表單結構持久化到數據庫，修改 name 後必須禁用再啟用才生效。
• Typecho_Widget_Helper_Form_Element_Fake 為佔位元素，無實際輸入，一般不直接使用。
• 高級用法（驗證、聯動、條件顯示）可參考 var/Widget/Plugins/Edit.php。

配置面板實現極簡：實例化元素 → $form->addInput()，Typecho 自動處理保存、讀取、CSRF 防護、權限校驗。