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

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

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

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

一、創(chuàng)建模塊

此處以調(diào)用“資訊”的數(shù)據(jù)為例，創(chuàng)建一個調(diào)用最新發(fā)布的資訊列表，共調(diào)用5條，要求調(diào)用出資訊的內(nèi)容及所屬分類的信息。

1、進入 SupeSite 后臺，點擊“模塊管理”的“創(chuàng)建模塊”。在此選擇需要調(diào)用的數(shù)據(jù)類型，例如“資訊”。

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

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

3、排序設置：設置數(shù)據(jù)的顯示順序�？梢砸罁�(jù)發(fā)布時間、回復時間、查看數(shù)、回復數(shù)、精華級別、好評分、差評分來排序，排序的規(guī)則有：遞增和遞減�？梢栽O置三個排序依據(jù)，第一排序的優(yōu)先級最高，第二、第三的優(yōu)先級遞減。本例中要創(chuàng)建的為“最新資訊”，所以這里設置第一排序為“發(fā)布時間”，“遞減”，則表明調(diào)用出的數(shù)據(jù)為最新的資訊。

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

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

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

5、緩存設置和顯示處理

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

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

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

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

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

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

內(nèi)容長度：含義同“標題長度”。

內(nèi)容截取省略號：含義同“標題截取省略號”。

本例中需要調(diào)用出資訊的內(nèi)容及所屬分類的信息，則需如下圖所示：

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

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

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

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

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

至此，數(shù)據(jù)模型已經(jīng)設置完畢，點擊“提交”，您將獲得一段這樣的模板內(nèi)部調(diào)用代碼：

<!--{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條最新資訊-->

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

二、使用獲得的模板內(nèi)部調(diào)用代碼

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

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

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

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

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

三、管理模塊

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

查看更多 supesite教程  supesite模板