首頁
編程語言
C語言|JAVA編程
Python編程
網頁編程
ASP編程|PHP編程
JSP編程
數據庫
MYSQL數據庫|SqlServer數據庫
Oracle數據庫|DB2數據庫
您现在的位置: 程式碼之家 >> 編程語言 >  >> 網頁程式設計 >> PHP 程式設計 >> PHP 相關知識

WordPress 整合 CKEditor + CKFinder 完整配置教程

     編輯:PHP 相關知識

WordPress 編輯器升級:CKEditor + CKFinder 圖片上傳完整部署

預設 WordPress 編輯器功能有限,整合 CKEditor 4 與 CKFinder 可獲得專業級富文本編輯與圖片管理體驗。本文記錄從安裝到配置的完整流程。

安裝步驟

  1. 後台搜尋安裝:外掛搜尋 "CKEditor for WordPress" 安裝啟用
  2. 部署 CKFinder:
    • 下載 CKFinder PHP 版,解壓至網站根目錄 `/ckfinder/`
    • 重命名 `ckfinder_config.php` → `config.php` 覆蓋原檔
    • 刪除 `_samples`、`userfiles` 兩個示例資料夾
  3. 啟用整合:WP 後台左側選單 → CKEditor → Upload Options → 勾選 "Enable CKFinder"

關鍵配置檔 (config.php) 重點

<?php
// 必須設為 true 才允許上傳
$config['authentication'] = function() {
    return isset($_SESSION['user_id']) && current_user_can('upload_files');
};

// 上傳目錄與 URL
$config['backends'][] = [
    'name'         => 'default',
    'adapter'      => 'local',
    'baseUrl'      => '/wp-content/uploads/ckfinder/',
    'root'         => '/var/www/html/wp-content/uploads/ckfinder/', // 絕對路徑
    'chmodFiles'   => 0644,
    'chmodFolders' => 0755,
    'filesystemEncoding' => 'UTF-8',
];

// 圖片處理:縮圖、水印等
$config['images'] = [
    'maxWidth'  => 1920,
    'maxHeight' => 1080,
    'quality'   => 85,
    'sizes'     => [
        'small'  => [320, 240],
        'medium' => [640, 480],
        'large'  => [1280, 960],
    ],
];

權限與安全注意事項

  • 上傳目錄需 Web 服務器寫入權限:`chown -R www-data:www-data /path/to/ckfinder/userfiles`
  • 配置 `.htaccess` 禁止直接執行 PHP:SetHandler default-handler
  • 限制允許上傳副檔名:`$config['allowedExtensions'] = ['jpg','jpeg','png','gif','pdf','doc'];`
  • 定期掃描上傳目錄清理惡意檔案

常見問題排查

  1. 上一篇文章:
  2. 下一篇文章:
Copyright © 程式碼之家 All Rights Reserved
現象可能原因解決方案
上傳按鈕無反應CKFinder 路徑錯誤檢查 `baseUrl`、`root` 絕對路徑是否正確
圖片上傳後不顯示跨域或 URL 重寫問題確認 `baseUrl` 可公開訪問、Nginx/Apache 靜態檔案規則
認證失敗Session 未共享確保 CKFinder 能讀取 WP Session,或改用 JWT 驗證