UEditor是由百度web前端研發部開發所見即所得富文本web編輯器,具有輕量,可定制,注重用戶體驗等特點,開源基於MIT協議,允許自由使用和修改代碼。
首先從ueEditor官網下載最新版本的包,目前官網上提供了ASP、.NET、PHP、JSP版本的,django版本只有一個第三方個人開發的,但看上出配置起來稍微復雜一點。
這里不介紹uEditor的使用方法,也不過多解釋uEditor的配置方法,官網上都有詳細的文檔和API介紹,下載的Demo中也有常用的方法的示例代碼,這里主要介紹uEditor和django集成需要修改的地方。
這里下載任意一個版本的都可以,因為我們只需要把關於ueEditor前端部分的抽取出來,至於后端服務器的,我們自己開發實現。
其實,uEditord的絕大部分功能在django中都是可用的,只有上傳文件、圖片、視頻、在線圖片、在線文件這一部分和上傳有關系的部分不好用,因為這些功能需要后台處理程序的支持才可以,所以,我們自己要做的,就是用python實現這部分的處理邏輯。
uEditor與后台交互的邏輯:
1.編輯器初始化時,異步請求后台處理頁面,處理程序應該返回一套json格式的配置信息,請求地址攜帶的參數為action=config
2.點擊圖片上傳按鈕,異步請求后台處理頁面,請求地址攜帶參數為action=uploadimage
3.點擊視頻上傳按鈕,異步請求后台處理頁面,請求地址攜帶參數為action=uploadvideo
4.點擊附件上傳按鈕,異步請求后台處理頁面,請求地址攜帶參數為action=uploadfile
5.點擊多圖上傳中的在線圖片選項卡,異步請求后台處理頁面,請求地址攜帶參數為action=listimage
6.點擊附件上傳的在線文件選項卡,異步請求后台處理頁面,請求地址攜帶參數為action=listfile
7.點擊塗鴉按鈕后,異步請求后台處理頁面,請求地址攜帶參數為action=uploadscrawl
我們要實現的就是,根據每次請求的不同參數值,調用不同的方法進行處理,如下圖所示,controller根據參數值,調用對應的處理程序進行處理:
處理邏輯其實很簡單,就是將Request請求中的文件內容讀取並寫入到服務器上,然后構造特定的json返回值。
上傳文件、圖片、視頻時,json格式如下:
{
"url": "20140703491416521462.png",
"state": "SUCCESS",
"error": "null",
"original": "20140703491416521462.png",
"title": "20140703491416521462.png"
}
其中,url是文件在服務器的相對地址,這個地址會和json配置信息中的”xxxUrlPrefix”的值拼在一起,顯示出來。
state是狀態信息,成功的返回信息固定為SUCCESS,異常情況可自己定義。
error:異常信息,正常的話,為null
original:內部文件名,一般和titile相同。
title:文件名稱。
在線文件、在線圖片,json格式如下:
{
"state": "SUCCESS",
"list": [
{
"url": "upload/image/20140627/6353948647502438222009315.png"
},
{
"url": "upload/image/20140627/6353948659383617789875352.png"
},
{
"url": "upload/image/20140701/6353980733328090063690725.png"
},
{
"url": "upload/image/20140701/6353980745691597223366891.png"
},
{
"url": "upload/image/20140701/6353980747586705613811538.png"
},
{
"url": "upload/image/20140701/6353980823509548151892908.png"
}
],
"start": 0,
"size": 20,
"total": 6
}
其中,start,是標志從第幾張圖片開始,個人感覺意義不大。
size:默認顯示多少個文件、圖片。
total:圖片、文件總數量。
list:以數組形式列出圖片、文件的相對地址。
這里,我實現了一個簡單demo,可以實現文件、圖片、視頻的上傳及在線圖片、在線文件的功能。點擊這里下載代碼源碼。
目前支持功能:
基本文字、排版等功能
圖片上傳、文件上傳、視頻上傳功能
在線文件、在線圖片功能
未實現功能:
塗鴉功能
網絡圖片功能
功能已在CentOS下,部署到nginx下,實測,可用。
使用方法: -----
1. 下載這里的完整代碼,直接cd到根目錄,運行
python manage.py runserver 1989
,可直接查看效果演示。
2. 在urls.py中將uEditor所在目錄配置成靜態文件路徑,本demo中為UE
( r'^UE/(?P<path>.*)$','django.views.static.serve', { 'document_root':os.path.dirname(__file__).replace('\\','/')+"/UE"}),
3. 將demo中ueconfig.json文件拷貝到自己項目的根目錄中,並修改其中幾處關鍵位置:
將"imageUrlPrefix": "/upload/images/"修改為自己項目中圖片上傳后保存的位置,demo中是/upload/images/這個目錄 將"scrawlUrlPrefix": "/upload/images/", 修改為自己項目中塗鴉 "snapscreenUrlPrefix": "/upload/images/", 截圖保存位置 "catcherUrlPrefix": "/upload/images/", 網絡圖片保存位置 "videoUrlPrefix": "/upload/vedio/" 視頻文件保存地址 "fileUrlPrefix": "/upload/files/" 附件保存地址 "imageManagerUrlPrefix": "/upload/onlineimages/", 在線圖片所在位置,在線圖片實際就是服務器為用戶提供的可選圖片 "fileManagerUrlPrefix": "/upload/onlinefiles/" 在線附件所在位置,在線附件實際就是服務器為用戶提供的可選附件
4. json文件修改后,要把上面設置的路徑設置為靜態資源目錄,例如demo中全部保存到/upload/的子目錄下,那么在urls.py中配置如下:
( r'^upload/(?P<path>.*)$', 'django.views.static.serve',{ 'document_root': (os.path.dirname(__file__)+"/upload").replace('\\','/') }),
之后,確保子目錄是存在的,為了方便,程序里沒有自動創建目錄的方法,需要手工創建,例如demo中創建了images、vedio、 files、onlinefiles、onlineimages幾個子目錄
5. 將demo中的controller.py文件拷貝到項目中任意位置,其實controller就是一個異步處理的視圖,拷貝完成后,在urls.py中配置相應的路由,demo中放到了根目錄,所以配置如下:
url(r'ueEditorControler','ueEditor_django.controller.handler')
自己的項目中只需要將
ueEditor_django.controller.handler
改為
xxxx.controller.handler
即可
6. 配置工作最后一步,將”ueditor.config.js”文件的
, serverUrl: URL + "/net/controller.ashx"
修改為
, serverUrl: "/ueEditorControler"
即上一步配置的url路由
至此,配置工作完成,剩下的就是到頁面上引用uEditor了,下面是一個簡單的html頁面,可根據uEditor放置位置調整腳本 和樣式的引用路徑
<!DOCTYPE html>
<html lang="en" xmlns="http://www.w3.org/1999/xhtml">
<head>
<link rel="stylesheet" type="text/css" href="/UE/third-party/SyntaxHighlighter/shCoreDefault.css">
<script type="text/javascript" src="/UE/third-party/SyntaxHighlighter/shCore.js"></script>
<script type="text/javascript" charset="utf-8" src="/UE/ueditor.config.js"></script>
<script type="text/javascript" charset="utf-8" src="/UE/ueditor.all.min.js"> </script>
<script type="text/javascript" charset="utf-8" src="/UE/lang/zh-cn/zh-cn.js"></script>
<script type="text/javascript">
var ue = UE.getEditor('editor');
SyntaxHighlighter.all();
</script>
</head>
<body>
<script id="editor" type="text/plain" style="width:auto;height:500px;"></script>
<input type="button" onclick="" value="保存"/>
</body>
</html>
查看源代碼,請到這里

