1. 程式人生 > >SiteServer CMS 5.0 原始碼入門

SiteServer CMS 5.0 原始碼入門

如果您覺得文章對您有點用,麻煩在您閱讀、收藏、轉發的時候,順手幫忙點個贊、留個言、加關注,這是我繼續寫下去的絕佳動力。
一、準備開發環境
想學習SiteServer CMS的或者想利用SiteServer CMS原始碼進行專案定製開發的程式設計師,需要提前準備好開發環境。具體要求如下:
1、.Net Framework 4.5.2或以上版本;
2、Visual Studio 2015或以上版本;
3、SQLServer 2008及以上版本或MySql 5.0 及以上版本;
4、NodeJS 最新版(可選);
說明:如果需要修改使用者中心的前臺頁面程式碼,或者需要重新制作安裝包或升級包,才需要安裝NodeJS。
二、獲取程式碼
官方在GitHub上提供的原始碼,地址為:https://github.com/siteserver/cms
通過Git命令或者從上圖頁面直接下載最新原始碼。
產品使用文件或開發文件,請關注官方的開發者中心:http://developer.siteserver.cn/

三、原始碼結構初析
1、解壓原始碼壓縮包

注意:如果只修改SiteServer CMS後臺功能或後臺介面的話,只需要關注source資料夾裡的程式碼即可。
2、Visual Studio 開啟C#程式碼

注意:
SiteServer.API 專案對應原始碼解壓出來的資料夾是source資料夾下的SiteServer.Web資料夾,並沒有一個名叫SiteServer.API的資料夾。
SiteServer.API 並不是提供給第三方系統與SiteServer資料交換用的,而是SiteServer系統內部使用的一些API介面,比如使用者中心現在前後端完全分離,前端用ReactJS來實現,和後端的資料交換就是通過SiteServer.API來實現的。
SiteServer.Plugins才剛剛開始,標準格式還沒完全定下來,現在官方已經開發了 幾個外掛:阿里雲端儲存外掛、微信外掛、投票外掛等。
四、安裝SiteServer CMS
1、新建空資料庫,設為啟動專案
在Sql Server Management Studio中新建名為cms5.0的空資料庫。在Visual Studio中把SiteServer.API設定為啟動專案。

2、安裝SiteServer CMS
如果是下載完原始碼第一次執行程式,則會需要進入安裝SiteServer CMS的流程。具體是在Visual Studio中按F5開始除錯,出現如下空白介面:

然後在瀏覽器地址中後面加入/siteserver,再回車,即地址變成:
http://localhost:58059/siteserver,則會出現如下安裝介面:

按介面提示點下一步即可完成安裝。具體安裝說明可參考:http://docs.siteserver.cn/getting-started/index.html
安裝完成之後點選進入後臺管理,需要新建站點,如下圖:

輸入站點名稱即可以建立一個空的新站點,並自動進入後臺站點管理介面:

五、開始修改除錯原始碼
經過前面的操作,我們已經把SiteServer CMS執行起來了,並已經經入了除錯狀態。現在我們就以一個具體例子來演示一下如何進行程式碼修改並除錯。
任務:把下圖中的紅框內容部分改成“歡迎使用SiteServer CMS 管理後臺”

1、找到對應前臺頁面檔案
執行程式,登入後臺,進入到主介面。然後在紅框位置按滑鼠右鍵,點選“檢視框架原始碼”,彈出如下圖:

通過上圖可以看到,本頁面路徑是在siteserver資料夾裡的pageRight.aspx檔案,好對應原始碼解壓出來的位置就是:source\SiteServer.Web\SiteServer\pageRight.aspx。此時我們可以通過Visual Studio、Visual Studio Code或Atom編輯器開啟此檔案:

通過上圖兩個黃框,我們可以找到兩個重要資訊:
一個是控制pageRight.aspx檔案業務邏輯的CS程式碼檔案類:SiteServer.BackgroundPages.PageRight;
另一個是顯示歡迎資訊的asp.net伺服器控制元件ID為LtlWelcome。
2、找到前臺頁面對應的後端c#程式碼檔案
通過前一步找到控制pageRight.aspx檔案業務邏輯的CS程式碼檔案類是SiteServer.BackgroundPages.PageRight,這很清楚就是在SiteServer.BackgroundPages專案中,在Visual Studio中很容易就找到PageRight.cs檔案:

在Visual Studio中開啟PageRight.cs檔案:

很清楚就看到了控制顯示歡迎資訊的伺服器控制元件LtlWelcome。
3、修改並除錯程式碼
在修改程式碼之前需要停止除錯,然後把程式碼進行如下修改,並設定斷點(F9),然後啟動F5執行程式並進入除錯狀態,登入之後會是這樣:

點選繼續之後,出來的結果就是這樣:

至此,我們就完成了開始提出的修改任務,並也能斷點進行除錯。
開心一笑
一對夫婦小孩肚子餓,請大巴司機讓他們中途下車吃飯。吃完飯後,就看到一則即時新聞:他們乘坐的輛巴被山上的落石擊中,無一倖存者。妻子喃喃的說 到:“要是剛才我們當時沒有下車就好 了……” 丈夫怒道上:“如果…” 語音未落,他也懂了妻子言中之意,“要是我們當時沒下車就好了...... ” 真的好心酸