Thinkphp編輯器擴充類kindeditor使用方法
一, 使用前的準備。
使用前請確認你已經建立好了一個Thinkphp網站項目。
1,Keditor.class.php和JSON.class.php 是編輯器擴充類檔案,將他們複製到你的網站項目的ThinkPHP\Lib\ORG\Net 檔案夾下。
2,editor檔案夾是kindeditor的核心包。將其複製到你項目的Public檔案夾下(和入口檔案同級的那個Public),並在Public下再建立一個Upload檔案夾,用於存放使用編輯器上傳的圖片。
3,KeditorAction.class.php是編輯器的上傳圖片功能和瀏覽遠程圖片功能,將其複製到你項目的lib\Action 檔案夾下。
二, 對象的調用
在控制器方法中調用對象:
import("ORG.Net.Keditor");$ke=new Keditor();$ke->id="content";//指定textarea的id$keshow=$ke->show();//產生js代碼$this->assign("keshow",$keshow);$this->display();
在方法對應的模版檔案中顯示編輯器:
{$keshow}
上面的是最簡單的調用方法,擴充類還有很多屬性和方法。要想實現更完美的功能,接著往下讀。
三, 對象的屬性
我把屬性分為兩種,一種是kindeditor內建屬性,一種是擴充新增屬性。如果你以前就使用過kindeditor,你應該知道kindeditor自身有id、items、width、height、afterCreate等等30個屬性。這些屬性現在可以用過php直接定義,比如定義id:$ke->id=”content”,定義寬度:$ke->width=”700px”; 我先說對象新增屬性。
對象的新增屬性:
1,jspath:定義kindeditor的核心js檔案,預設值為/Public/editor/kindeditor.js ,如果你的editor檔案夾沒有放在Publib下需要指定此屬性,如$ke->jspath=”/kind/ kindeditor.js”;
2,form:指定提交的表單(from)的id,預設為form1,這個屬性是結合ctrl+enter提交功能使用的,比如有個你的編輯器放在表單id為 “formid”內,要實現ctrl+enter提交formid表單,需要定義$ke->form=”formid” 。 ctrl+enter提交功能還要設定其他屬性,後面再講解。
3,imgid:指定存放圖片地址的隱藏欄位id,預設為img。編輯器每上傳一張圖片,會把圖片地址儲存到該隱藏欄位。在向資料庫添加資料時,可以把此隱藏欄位中的資料也儲存到資料庫欄位中,在刪除資料時候,先讀取資料庫存放的圖片地址,進行刪除。刪除過程只要調用對象的delimg方法即可,此方法後面詳解。這樣就達到刪除內容同時刪除圖片的目的。
內建屬性:
1,items:配置編輯器的工具列,定義方法如
$ke->items=”['source', '|', 'fullscreen', 'undo', 'redo', 'print', 'cut', 'copy', 'paste']”;
我增加了little關鍵詞,可以快速定義一個精簡模型的編輯器,使用方法$ke->items=”little”;
2,afterCreate:設定編輯器建立後執行的回呼函數,定義方法如
$ke->afterCreate=”function(id){
alert(‘成功建立’+id)
}”;
我增加了ctrlenter關鍵詞,可以快速定義ctrl+enter提交表單,使用方法:
$ke->afterCreate=”ctrlenter”;
同時需要定義$ke->form=”formname”, formname換為你編輯器所在的表單id。
3,resizeMode:2或1或0,2時可以拖動改變寬度和高度,1時只能改變高度,0時不能拖動。定義方法如:$ke->resizeMode=1; 注意,數字類型的屬性值不要放在引號中,如$ke->resizeMode=”1”;這麼定義是錯誤的。
4,allowFileManager:true或false,true時顯示瀏覽伺服器圖片功能(點擊上傳圖片按鈕可以看到此功能),定義方法如
$ke-> allowFileManager=ture;
注意,屬性值為布爾值時不要放在引號中。
5,imageUploadJson指定上傳圖片的伺服器端程式,預設值為 /index.php/Keditor/upload
6,fileManagerJson:指定瀏覽遠程圖片的伺服器端程式,
預設值為/index.php/Keditor/filemanager
註:之前你複製過的KeditorAction.class.php就是供上傳圖片和瀏覽遠程圖片使用的。檔案內的upload方法定義了上傳圖片處理過程,檔案內的filemanager方法定義了瀏覽圖片的處理過程。你可以在這兩個方法上加入判斷許可權的代碼,實現只有管理員才能上傳圖片或瀏覽圖片。你也可以不使用預設的KeditorAction.class.php,自己定義上傳處理過程和瀏覽圖片處理過程,則是你需要重新定義imageUploadJson屬性值和fileManagerJson屬性值。 自訂處理過程,後面詳解。
還有其他內建屬性,我就不一一列舉了。大家可以查看kindeditor官方文檔
http://www.kindsoft.net/doc.php?cmd=config
注意,數字類型或布爾類型的屬性值,不要放在引號內。其他屬性值放在引號中,屬性值的格式和kindeditor自身格式一樣。
四 對象的方法。
1,upload,上傳圖片。此方法在編輯器上傳圖片處理過程中使用,使用方法:
import("ORG.Net.Keditor");Keditor::upload('./Public/Upload/','/Public/Upload/',array('gif','jpg','jpeg','png','bmp'),1000000);
upload方法有三個參數,依次是,“上傳圖片目錄”,“圖片顯示地址”,“允許上傳圖片格式”,“允許的圖片大小(單位kb)”
上傳圖片目錄:預設值“./Public/Upload/”(注意Public前面有個“點”符號,是使用的相對位址,不可使用絕對位址),上傳圖片目錄位址是相當於處理檔案的。Thinkphp所有的代碼都是通過入口檔案啟動並執行,所以這個地址其實是相對於入口檔案的。
顯示圖片地址:預設值“/Public/Upload”(一般是絕對位址),假設我們上傳了一張圖片,伺服器端產生的圖片名為 12345.gif。上傳會顯示的圖片地址則為/Public/Upload/12345.gif ,因為我們使用的是絕對位址,所以編輯器發布的內容不管在網站的哪兒,圖片都能正常顯示。
允許上傳的圖片格式:定義一個數組,預設值為array('gif','jpg','jpeg','png','bmp')
允許的圖片大小:預設值為,1000000 ,單位是bk。
2,filemanager,瀏覽伺服器的圖片。此方法在瀏覽圖片處理過程中使用。使用方法:
import("ORG.Net.Keditor");Keditor::filemanager("./Public/Upload/","/Public/Upload/",array('gif','jpg','jpeg', 'png', 'bmp'));
參數依次是:“瀏覽圖片目錄”,“圖片顯示地址”,“允許瀏覽的圖片格式”,和upload方法一樣,瀏覽圖片目錄是相對位址,圖片顯示地址是覺得地址。
3,delimg:刪除通過編輯器上傳的圖片。此方法一般在你刪除資料庫資料時使用。
import("ORG.Net.Keditor");Keditor::delimg($imgfield);//$imgfield 一般是你資料庫存放圖片地址的欄位。
4,show:返回產生的js代碼。此方法一般在顯示編輯器的控制器中使用。
show方法可以使用一個參數定義kindeditor內建屬性。如:
import("ORG.Net.Keditor");$ke=new Keditor();$ke->show(“{id : ”content”,width: ‘700px’;height : ”300px”;imgid : ”img”}”);
不建議用show傳參方式定義kindeditor屬性。show傳參方式不能定義jspath和form兩個新站屬性,也不能使用little和ctrlenter關鍵詞。
http://www.bkjia.com/PHPjc/847864.htmlwww.bkjia.comtruehttp://www.bkjia.com/PHPjc/847864.htmlTechArticleThinkphp編輯器擴充類kindeditor使用方法 一, 使用前的準備。 使用前請確認你已經建立好了一個Thinkphp網站項目。 1,Keditor.class.php和JSON.clas...