模塊功能是 SupeSite 系統的一個亮點，通過該功能您可以隨心所欲的打造您需要的模板，什么地方顯示什么模塊，調用什么內容，如何樣的風格，盡在您的掌握。

在模塊管理中，通過選擇現有的模板代碼，根據自己的需要，添加到站點模板文件的任意位置中，便可以實現對論壇、UCenter Home 上面的信息的讀取顯示。選擇不同的基本模塊，可以查看該基本模塊下面的已有模塊代碼。您也可以通過創建模塊操作，根據自己的需求，進行模塊添加操作。只獲取數據的模塊只能進行模板內部調用，其他類模板代碼可以進行兩種模式的調用顯示：模板內部調用、JavaScript 調用。模板內部調用，此方式的調用代碼可以放置于本系統內部模板的任意位置，但不能放置于其他系統的模板頁面。采用批量緩存更新進制，效率高，服務器資源占有很少，速度快，推薦使用。JavaScript 調用，此方式的調用代碼可以放置于任何站點的任何頁面，適用范圍廣。數據會自動緩存并按指定的時間間隔進行周期更新。

通過創建不同的模塊代碼，并放置于模板中加以使用，就可以實現對論壇或 UCenter Home 上面的數據靈活顯示。選擇一個基本模塊，在出現的創建模塊向導頁面中，根據站內對顯示數據內容的需求進行自由設定，提交后就可以獲得需要的模塊代碼了。選擇模塊風格為只獲取數據時，模塊將會把滿足條件的數據讀入到 $_SBLOCK[變量名] 數組中，您可以在模板文件對該數組變量進行自由操作，非常方便。

模塊管理功能位于 SupeSite 后臺 => 模塊管理中，下面分為創建模塊和模塊管理兩個子項，如下圖所示：

一、創建模塊

此處以調用“資訊”的數據為例，創建一個調用最新發布的資訊列表，共調用5條，要求調用出資訊的內容及所屬分類的信息。

1、進入 SupeSite 后臺，點擊“模塊管理”的“創建模塊”。在此選擇需要調用的數據類型，例如“資訊”。

如上圖，填入模塊名，例如“5條最新資訊”，模塊名僅為一個標識，并無實際含義。“向導模式”，如果選擇“高級模式”，那么需要自己寫 SQL 語句來調用數據；如果選擇“向導模式”，那么程序會根據您做的過濾規則調用數據。對于剛剛接觸 SupeSite 的用戶，建議使用“向導模式”。

2、過濾設置，這里設置的是對于資訊數據的調用過濾條件，可以根據實際的需要去做調整。例如僅需要調用某一個或幾個指定的分類下的資訊數據，則可以在“站點分類”一項中，勾選對應的項目即可。這里如果設置了過濾條件，調用出來的資訊數據則需要滿足這里的設置，如果要調用全部的資訊數據，則不用設置。本例中沒有限定資訊的過濾條件，則不用設置。

3、排序設置：設置數據的顯示順序?？梢砸罁l布時間、回復時間、查看數、回復數、精華級別、好評分、差評分來排序，排序的規則有：遞增和遞減。可以設置三個排序依據，第一排序的優先級最高，第二、第三的優先級遞減。本例中要創建的為“最新資訊”，所以這里設置第一排序為“發布時間”，“遞減”，則表明調用出的數據為最新的資訊。

4、數據設置：設置調用數據的條數，如果要調用指定條數的數據，請選擇“顯示指定數目的信息”；如果需要分頁顯示調用的數據，請選擇“讀取所有滿足條件的信息，并分頁顯示”。

當選擇“顯示指定數目的信息”時，需要設置“起始數據行數”及“顯示數據條數”。本例中需要調用最新的5條資訊，則“起始數據行數”設置為0，“顯示數據條數”設置為5，這樣調用出來的數據就是前5條數據。如果要調用第6條至第10條數據，就需要將“起始數據行數”設置為5，“顯示數據條數”設置為5。

當選擇“讀取所有滿足條件的信息，并分頁顯示”時，需要設置“每頁顯示數目”，例如設置為10，就表示一頁需要顯示10條數據。啟用數據分頁顯示后，在下面的“顯示風格”配置環節，您必須指定“變量名”，并且模塊風格文件只能選擇“只獲取數據”，此外，緩存更新時間設置將無效，數據不會被緩存。列表信息將儲存到 $_SBLOCK[變量名] 變量中，分頁信息將儲存到 $_SBLOCK[變量名_multipage] 變量中，您只需要在模板中對列表變量、分頁變量加以靈活利用就可以了。

5、緩存設置和顯示處理

緩存設置：設置數據緩存更新的時間間隔，默認為900，單位秒，即15分鐘。數據設置選擇“讀取所有滿足條件的信息，并分頁顯示”時，緩存更新時間設置將無效，數據不會被緩存。

顯示處理：設置是否需要讀取某些信息。

標題長度：設置數據調用后，將標題要截取的長度，單位字節。例如設置為20，則表示查詢出的文章標題被截取為20字節長，其中已包含下面要設置的省略號的3個字節。

標題截取省略號：設置截取后的文章標題后是否添加省略號。

讀取所在分類欄目名：選擇“讀取”，則可以將當前資訊所在的分類的信息一同調用出來。

讀取詳細內容信息：選擇“讀取”，則可以將當前資訊的內容讀取出來。讀取詳細內容信息，這將增加服務器負擔。如果您只想獲取標題列表，請不要選擇該項。

內容長度：含義同“標題長度”。

內容截取省略號：含義同“標題截取省略號”。

本例中需要調用出資訊的內容及所屬分類的信息，則需如下圖所示：

6、顯示風格：這里要設定列表信息將儲存到的變量名，選擇或自己輸入一個模塊風格文件。

變量名：您可以把獲取的數據集合放置到一個模塊變量中。在模板文件中可以使用 $_SBLOCK[變量名] 來調用該數據集合。

選擇模塊風格文件：針對不同的模塊，有不同的模塊風格來控制該模塊數據的顯示樣式。您可以通過 模塊風格 功能，來為該模塊添加、設置不同的風格。注意：這里如果選擇“只獲取數據”，那需要您自己寫模塊代碼，將數據顯示到頁面，如果選擇其他的風格文件，或在下面指定自己的風格文件，則可以獲得站外調用時使用的 JS 代碼。

自己輸入模塊風格文件：如果默認的模塊文件中沒有您需要的，您可以自己指定自己的模塊風格文件地址。模塊風格文件必須先上傳，并放置于 styles 目錄下面，后綴為 .html.php。

本例中我們要創建的調用為最新資訊，可以通過含義命名“變量名”為“new_news”，且該調用是用于本站的模板使用，后面需要在模板中手動編寫模塊的顯示代碼，故選擇“只獲取數據”即可。

至此，數據模型已經設置完畢，點擊“提交”，您將獲得一段這樣的模板內部調用代碼：

<!--{block name="spacenews" parameter="order/i.dateline DESC/limit/0,5/cachetime/900/subjectlen/20/showdetail/1/messagelen/200/messagedot/1/showcategory/1/cachename/new_news/tpl/data"}--><!--5條最新資訊-->

注意：此處創建的模板內部調用代碼也可以直接通過手寫生成，并不一定需要通過“創建模塊”來創建，所以“創建模塊”僅僅是創建模塊的一個輔助工具，而不是決定工具。

二、使用獲得的模板內部調用代碼

注：模板代碼此處不贅述。

將上面獲取的代碼復制到 SupeSite 的模板文件中（默認模板的目錄為 templates/default），例如加入到 SupeSite “綜合首頁”的模板中 index.html.php 的合適的位置。

在模塊的下一行開始書寫模塊顯示的模板代碼，例如：

從上面的代碼可以看出該模塊查詢出的數據存儲在了 $_SBLOCK[new_news] 這樣的一個變量中，其中 new_news 就是在上一步中設定的“變量名”，如過當前設置為分頁調用數據，則可以通過 $_SBLOCK[new_news_multipage] 這個變量直接輸出分頁的全部代碼，無需再次書寫任何模板代碼。

從本例中的模板代碼可以看到 $value[catname][catid] 、 $value[subject] 、 $value[message] 等變量的使用，而這些具體的數據參數是通過模塊代碼無法獲得的。不過，可以通過下面的代碼將該模塊查詢出的信息全部輸出，其中包含了所有可以使用參數名稱及該參數對應的數據值。了解清楚之后，需要將下面這段代碼刪除調用，再編寫模塊顯示的模板代碼。

三、管理模塊

通過“管理模塊”可以查看所有添加的模塊，也可以通過“基本模塊”分類查看。勾選模塊前面的復選框，點擊“提交”就可以刪除模塊。點擊模塊后面的編輯，則可以重新設置該模塊的所有設置項目，并重新生成該模塊。