動(dòng)易sitefactory系統(tǒng)插件開發(fā)說明

1、插件開發(fā)說明目錄 TOC o 1-5 h z HYPERLINK l bookmark0 o Current Document 插件開發(fā)環(huán)境說明 2 HYPERLINK l bookmark4 o Current Document 插件開發(fā)過程簡(jiǎn)述 5插件安裝卸載配置說明 7Install 節(jié)為插件安裝步驟 8 HYPERLINK l bookmark8 o Current Document 可用操作詳細(xì)說明： 8 HYPERLINK l bookmark10 o Current Document Load （加載插件操作） 可以分為： 8 HYPERLINK l bookmark12 o C

2、urrent Document File （文件操作） 8 HYPERLINK l bookmark14 o Current Document Database （數(shù)據(jù)庫操作） 9 HYPERLINK l bookmark16 o Current Document Menu （菜單操作） 10 HYPERLINK l bookmark18 o Current Document Uninstall 節(jié)點(diǎn)， 10 HYPERLINK l bookmark20 o Current Document Upgrade 節(jié)點(diǎn) 11 HYPERLINK l bookmark22 o Current Docu

3、ment 插件接口說明 11插件實(shí)例 HelloWorld 13 HYPERLINK l bookmark24 o Current Document 系統(tǒng)擴(kuò)展點(diǎn)說明 13插件開發(fā)環(huán)境說明1、使用 VS2010/2008 新建一個(gè)空的 WebApplicationSolution ExplorerH3 Xal si*左 Solution WebApplicationl 1 projectj Q WebApplicati o-nl圈 Properti es/ References.2、 把動(dòng)易程序放在項(xiàng)目根目錄下，并點(diǎn)擊顯示所有文件.；App_Erow5er&.：App_Lata.；.；App_E

4、row5er&.：App_Lata.；Ap p_G I ob a Iu rces.：App.Tlnernes:bin:Comment匯Commo-n_i Comm&nTemplate；ConfiqSolution Ejcplo-rer導(dǎo)|岬丨*|J3 SolutioKWebApplication 1 (1 proj ect j W&bApplicationl 國(guó) Properties jjj R&feren ce&:AdminClientEinAPIDLL3、 把 bin 目錄改名為 DLL 目錄APIDLL3、 把 bin 目錄改名為 DLL 目錄Solution Ejcplo-rerTBl

5、 Sl|J3 Solution WebApplicatio-nl 1 projectj WebApplieatianl 國(guó) PropertiesReferen ces.i Admin”.i App_Browsers：App Data.i App_GlobalResources: App_Th ernes:ClientEini Comm-ent；Comm-onCommo-nT em plateConfi gControls4、把DLL目錄的所有DLL添加引用到項(xiàng)目中。SHF燉石期沖h PcwirEtny.9十!口ry.EiqA_dlLWW17 皈DLL Art阿KB. RoeEwy.Sieadc

6、ifyiHliSapdiJDLIVWl? 3lLTOLL EH：Lj4H9 kbs PowarEiny.Gvirlnry.RI壬iMrcupdlJDIWL? iL7口 LL立碎卻KBj. Roe*Ei5.Sifac1cify.BISikHiflidll2DLIW17 31LTOLL 立H：G9 KB* F*ci-irEiny.yiAriDry.BIJurwydlJDLi7 SL7DLL Art37 KB,* Povi-irEinY.SiivJriDrY.Hl.TflrrlKflijdlimqwu slt LL 宜H：m KHj. Roe*EM.SiJciC!fy.BliUpg*Brikpdll

7、2DLW17 ML?OLL EH：232 KB 仙1irEjny.5十irlHryRlJLHrMarugiiHI2DLU17 iL7DLL Art&7 KBj. Rwe*ESifac1cifYiBli7aieidlJDLIVWl? SLTOLL 立H：4KB* PowarEinv.GvirlnryBI.WiHI20Lti7 SL7口 l宜碎9 KBj. Rowe*EM.Eieacici!ry.BliWafkxil2DLW17 ML?OLL EH：14KEIj. Roe*E.Siedoi.DaxFdl2DLIW17 31LTOLL彌32 KEI,? PcwirEtny.9十!口rylMSIMHV

8、W SL7DLL AML4d KB* Pc-weEwy.E-i-adcify.MMtlidlJDLIVWl? 3lLTOLL EH：IZ2 KBn owarEiny.GvirlnryMISBmr&iLdlJDIWL? iL7口 LL立碎2jOJ KBj. R(Me*E.Sifac1cify.W#bSif.dl2DLIW17 31LTOLL 立H：3.731 KBFftirEiny.ilrmjp.AftiirYKfljLQnimQrdlF*owwEjny.&flrjrcup.!A-.Trjm.MrlUa_.MMW1?蟲訂jmWL?如 7口 LL如 口 LI宜碎12 KB27 kBj. Roe*E

9、iTempMeErtfl!rtexll2DLW17 ML?OLL EH：LSKEI-, iJb4mAhJjKaVnuilEEiDrLDaiiJI2DLU17 逓DLL Art呦KBj.加BmWebiOaaVu&SMficiriihJDLIVWl?泗OLL 立H：L.4B3 KB” m ibmAAhv1niionilaiKFixll口 l宜碎42 KBJDLl?泗OLL立浮倔KBLJKi-RiLtrdTeiaJd L 還Jj-vnErk iLl18, lESbirijC1 Shu-jEijlilULB Ewsic Eap. illBrssBfTrsidcss kbir界寸”rRihriry” 皿

10、 iLl/ i EmrfL ErKLieil Enrjri aslilS：i CajiwuLt IlLii 0Ufc：t.畝3”由于項(xiàng)目比較多，可能這個(gè)操作需要比較久的時(shí)間。經(jīng)過上面四步，插件開發(fā)環(huán)境就搭建好了。當(dāng)然這里的開發(fā)環(huán)境不是唯一的標(biāo)準(zhǔn)，如果你對(duì) 熟悉，可以以其他形式開發(fā)。具體實(shí)現(xiàn)效果可以參考插件DEMO工程。插件開發(fā)過程簡(jiǎn)述1、我們把新增功能所需要的新增文件包含到項(xiàng)目中Solution Ejtpl&rerBI SIA Ij 議 WebAppli匚mtioni:=ai Propertie-s Referencesi J Ad min.；Analytics丫 API.；App_Erows

11、er&.j App_Data；App G lob a I Resources Hinn!|.i App_Th ernesD bin:BLL層BLL:BLL層C ClientBin.；CommentP j Common.:CoimmonTem p latei _j Config.；Controlsi J Da I Fa doryi J Datsbse.i DLLJ、$ Editor數(shù)據(jù)層i IAA IDal 2、配置好相關(guān)配置文件J L_J Configj AjaxHand丨已config j APLconfigj AP,UC.conf g j AppS-eltin g t.confi gj A

12、u th 已 ntiuaijon,configj Au toCrea te. confi gL j CodeSnippstPaneLcontfigj CommonMailS-erver.co-nfg j Conn ection St ring s. configCon sum er Ext ersio nO-bj ect. coritfi g L j CreateCo-l I ecti onW o rk. confi gAppS etti n g s-. co nfi gSource Control ExploreAppS etti n g s-. co nfi gSource Control

13、 Exploreversion 1. 0 &n.codirLntf-S? 和-包含自定文應(yīng)用程障設(shè)貴。E appSetting3)add key=aPoierEasy; Def aultUp 1 oadSuff ins value jpg g：if jpEg png. 1add key=，vVersion valuer3. 6. 0. C )| 和數(shù)據(jù)連接字符串，即可正常運(yùn)行程序。（在此之前先把數(shù)據(jù)庫建立好，數(shù)據(jù)庫腳本為：SQLServerSchema2005.sql-架構(gòu)，SQLServerData2005.sql-默認(rèn)數(shù)據(jù)，也要注意數(shù)據(jù)庫版本。）-&F7JmptCut3PDelOpenOp

14、-en With.二 I View Code 闔Vi ew DesignerView MarkupView Compo-nent DesignerView Code Gen FileSet As Start 日已In du de In Project電 Copy X Del ete-&F7JmptCut3PDelOpenOp-en With.二 I View Code 闔Vi ew DesignerView MarkupView Compo-nent DesignerView Code Gen FileSet As Start 日已In du de In Project電 Copy X Del

15、 eteRenarrie當(dāng) Prope-rtiesd 口 adFilessicProxy.sspitAlt-h Enterrtegory.aspx. J De-fault.aspK1 faviccjn.iccrBrowse- With.Shift+F7Ctrl+XCtrl+CbSarvi ces3、 插件開發(fā)完畢后的打包插件開發(fā)完成后，打包程序，先把程序發(fā)布出來，然后保留新增功能文件。并根據(jù)安裝 配置需要分別打包。具體可以參考插件 DEMO 中的打包方式。容稱:-f Plugin.config訶 Tieba.Installdll這 TieBa.zip插件信息配置文件統(tǒng)一為：Plugin.con

16、figPlugin.confg 模板：Hello WorldPluginUr卜 HYPERLINK v/PluginUr%e5%8d%9c v/PluginUr卜Hello World JannocklnstallStep Action=Load Description-檢查環(huán)境InstallStep Action=File Description復(fù)制插件文件ActionType=sqlActionType=sql(Database Type=txtInstallStep Action=Load Description-加載插件 InstallStep Action=Menu Descript

17、ion設(shè)置菜單Install 節(jié)為插件安裝步驟其中 InstallStep 為一步。這里可以同時(shí)處理同一類操作的集合。 InstallStep 可用操作有 Action 為 ：Load （加載插件操作）File （文件操作）Database （數(shù)據(jù)庫操作）Menu （菜單操作）Description 為操作說明可用操作詳細(xì)說明：Load （加載插件操作） 可以分為：Type 為：check 類 直接執(zhí)行插件類，一般用于環(huán)境檢查操作，也可用于其他操作 同時(shí)必須要有參數(shù)FilePath 以“/”開頭即為網(wǎng)站根目錄，否則是當(dāng)前插件目錄 NameSpace 插件命名空間service 類 服務(wù)類插件，

18、系統(tǒng)啟動(dòng)時(shí)加載。同時(shí)必須有參數(shù)FilePath 以“/”開頭即為網(wǎng)站根目錄，否則是當(dāng)前插件目錄 NameSpace 插件命名空間File （文件操作）Type 為：zip 文件解壓必須參數(shù)OriginPath 源文件路徑 以“/”開頭即為網(wǎng)站根目錄，否則是當(dāng)前插件目錄 TargetPath 目標(biāo)路徑 以“/”開頭即為網(wǎng)站根目錄，否則是當(dāng)前插件目錄Description 為操作說明copy 文件復(fù)制必須參數(shù)OriginPath 源文件路徑 以“/”開頭即為網(wǎng)站根目錄，否則是當(dāng)前插件目錄 TargetPath 目標(biāo)路徑 以“/”開頭即為網(wǎng)站根目錄，否則是當(dāng)前插件目錄 Description 為操作

19、說明edit 文件編輯必須參數(shù)FilePath 源文件路徑 以“/”開頭即為網(wǎng)站根目錄，否則是當(dāng)前插件目錄 ActionType 操作類型OriginString 被替換內(nèi)容TargetString 替換內(nèi)容Description 為操作說明當(dāng) ActionType 為 sql 時(shí)，限查詢數(shù)據(jù)庫替換。例：當(dāng) ActionType 為 txt 時(shí)。即替換文本del 刪除文件必須參數(shù)FilePath 文件路徑 以“/”開頭即為網(wǎng)站根目錄，否則是當(dāng)前插件目錄Description 為操作說明Database （數(shù)據(jù)庫操作）Type 類型file 執(zhí)行腳本文件Database 的 InnerText

20、為腳本文件路徑，以“/”開頭即為網(wǎng)站根目錄，否則是當(dāng)前插件目錄 前面分 2000 或 2005 數(shù)據(jù)庫例如腳本文件為：2005Task.sql此處只需寫上 Task.sql txt 執(zhí)行 SQL 語句Database 的 InnerText 為 SQL 語句Menu （菜單操作） Type 類型admin 后臺(tái)菜單操作FilePath為后臺(tái)SiteMap路徑。必須是/開頭 user 會(huì)員中心菜單操作FilePath菜單xml。必須是/開頭Action 類型lnstall 菜單安裝Uninstall 菜單刪除注：菜單操作需注意菜單組織結(jié)構(gòu)，需對(duì)系統(tǒng)菜單有一定的了解才行。同類型的操作只能出 現(xiàn)一個(gè)

21、，即不能如下：兩個(gè)后臺(tái)菜單同時(shí)出現(xiàn)，可以Uninstall 節(jié)點(diǎn)，UninstallStep 中的操作和上面的基本相同。其中菜單部份 后臺(tái)菜單需要添加屬性TitleList 菜單的標(biāo)題（菜單命名時(shí)需要注意不能與系統(tǒng)的相同） 菜單標(biāo)題可以是多個(gè)，使用 | 分開。前臺(tái)菜單也要增加屬性id 前臺(tái)菜單對(duì)應(yīng)的 id。Upgrade 節(jié)點(diǎn)操作和上面的基本相同。特殊路徑：TemplateDir模板路徑SkinDir樣式路徑插件接口說明/ / public interface IPlugin/ / 是否出錯(cuò)/ bool IsErrorget;set;/ / 執(zhí)行方法/ / 插件路徑 /執(zhí)行信息/錯(cuò)誤信息 st

22、ring Exe(string pluginPath);插件實(shí)例 HelloWorld系統(tǒng)擴(kuò)展點(diǎn)說明系統(tǒng)插件擴(kuò)展點(diǎn)統(tǒng)一放在解決方FowrE 4E7, 0 i c i alJQT 個(gè)項(xiàng)目-：- FiwsrEasy. F&undkt i in-_戲PowerE asy. Foundati on+ 竊I Properti es+ Q引用+ - Li.II_J Cont ext_J Drawing.:obj_J SiteCache_J Sit eConfig_J UrLRewri ting：眄 AEzemblyEfiELecti on. ce 眄 IFLugin. ce;F *;F * erEasy.

23、 F u umli11 on. c spr u j.e c cI Settings. StvlCot這里為擴(kuò)展點(diǎn)。在系統(tǒng)啟動(dòng)時(shí)可以加載外部插件。插件編寫新建項(xiàng)目-l3 FlugirLHmoYfoi-ld+ 圉 Pr&psrti-引用_J P owerE asy. 7 cniiLd=it 1 on-I System=O System . Cor eq口 System.Q System. Data. Il；it：iS已tExt已tl烏i oilsQ System, fietiO System. K(TilSystem. Xml. Li rqKell off arid, csHelloWorld 繼承 IPluginLnt4t E4?24 PonFmiridati mlnamespaEe- Pl ugiJiHel 1 oWcrl dpublic class HellcWcrld : IPliJEirpiriblic Iot1 IsErrorpublic string Eefstiing pliiginPath)1PE Event. LogjLiiiSiu +- nw PE E vent - Log! nSuHanifLer C1 ogjn);catch (Ex