隨著版本的更新，模板文件可能有所增減，不過基本方法不變。大家舉一反三吧。
適用SS/XS全部版本




1，??SupeSite的模板文件和頁面的關(guān)聯(lián)

SupeSite的模板文件和頁面url鏈接地址是有關(guān)聯(lián)的。大家可以打開templates/default目錄，可以發(fā)現(xiàn)其文件名都是有規(guī)律的。下面我會詳細(xì)說明文件名和鏈接地址的具體關(guān)系。
下面列出的是templates/default里面的全部文件
可以看到文件名都是有規(guī)律的，以bbs_開頭的都是論壇的頁面文件，以blog_開頭的都是日志的頁面文件，同理文件、商品、書簽、圖片的頁面都是一樣的規(guī)律。
稍微懂點英文的人都可以看出，以論壇頁面文件為例，
bbs_footer.html.php? ? 代表論壇頁面的頁腳文件
bbs_forumdisplay.html.php??代表論壇頁面的板塊列表
? ?? ?? ?? ?? ?? ?? ???對應(yīng)url地址http://域名?action_forumdisplay_fid_板塊編號.html
bbs_header.html.php? ?代表論壇頁面的頭部文件
bbs_index.html.php? ? 代表論壇首頁文件? ?? ?? ?對應(yīng)url地址http://域名/action_bbs.html
bbs_viewthread.html.php??
代表論壇帖子查看頁面? ?對應(yīng)url地址http://域名/?action_viewthread_tid_帖子編號.html

從上面可以看出，url地址其實和文件名是一致的
再看日志的頁面文件
其中有一個比較特殊的，就是blog_category.html.php，根據(jù)頁面英文單詞可以猜測為日志分類頁面，確實是！
我們可以訪問日志的分類，http://域名?action_category_catid_日志分類編號.html，也和文件名吻合。
其他文件、商品、圖片、書簽頁面和日志是一模一樣的。
資訊頁面有2個特殊的，news_view.html.php??news_viewcomment.html.php
根據(jù)英文可以判斷是資訊查看頁面，和資訊評論查看頁面。
其對應(yīng)的url地址分別是http:/域名?action_viewnews_itemid_資訊編號.html
http://域名/?action_viewcomment_itemid_資訊編號.html

Snap2.jpg (121.38 KB)
2006-11-29 16:12
下面的圖片是站點的相關(guān)文件
同樣，根據(jù)上面的方法可以很快得出，分別是站點的公告頁面、頁腳、頭部文件、站點友情鏈接、登陸、站點地圖、快捷面板、投票、注冊、搜索、安全問答、tag、tag查看全部頁面、腳印頁面
Spaces_開頭的都是空間頁面，分別是個人空間分類頁面、個人空間頁腳、頭部、首頁。

Snap4.jpg (80.1 KB)
2006-11-29 16:12
搞清楚了上面的文件和對應(yīng)頁面url訪問鏈接關(guān)系之后，我們來接著看具體頁面里的模塊。
以站點首頁為例，我們可以很快定位他對應(yīng)的文件頁面是templates/default/index.html.php

2，如何讀懂模塊代碼

這個部分網(wǎng)點也說明過，大家可以看看http://www.discuz.net/thread-456494-1-1.html

首先需要說明的是SupeSite全部頁面的信息都是通過模塊來進(jìn)行匯集的。你所看到的頁面的每條內(nèi)容都是利用SupeSite后臺的模塊功能創(chuàng)建并提取出來的。通過SupeSite的模塊功能，您可以將X-Space、Discuz!的幾乎全部內(nèi)容都可以提出出來。
具體的創(chuàng)建模塊代碼，大家可以到SupeSite站點設(shè)置――模塊功能里面進(jìn)行創(chuàng)建，全過程都是采取的向?qū)Ｊ?#xff0c;非常簡單，Sup也做過一個視頻教程，大家可以看看http://www.discuz.net/thread-320058-1-1.html
推銷下，如果您對SupeSite不了解，不妨多看看幫助文檔板塊的帖子，還有各個板塊的置頂貼，相信對您了解SupeSite/X-Space將很有幫助。
下面我們來看一段最普通的模塊代碼，大家可以跟著我來讀懂他。
<!--{blockname="category" parameter="type/news/isroot/1/ischannel/2/order/c.displayorder/limit/0,10/cachetime/25200/cachename/category_news/tpl/data"}-->

SupeSite創(chuàng)建的所有模塊都具有下面的統(tǒng)一格式：
1）??以<!--{blockname="開始，以"}-->結(jié)束
2）??blockname=" "引號里面放的是模塊的類型，SupeSite的模塊類型都有固定的命名規(guī)則的。您可以這樣查看。
登陸SupeSite站點設(shè)置――模塊功能――模塊列表，可以看到有下列基本模塊

Snap6.jpg (76.2 KB)
2006-11-29 16:12

您可以將鼠標(biāo)放置在任何一個基本模塊的名稱上，然后查看地址欄，都可以看到類似下面的url地址：

http://域名/admincp.php?action=blocks&viewblocktype=spacenews&blocktype=spacenews&op=
其中blocktype=spacenews這里就可以告訴您當(dāng)前查看的模塊的類型是什么
根據(jù)英文可以得出，spacenews就是資訊模塊
同理其他模塊類型也可以很方便的知道。
blocktype=category? ?系統(tǒng)分類模塊
blocktype=spacenews??資訊模塊
blocktype=poll? ?? ? 投票模塊
blocktype=spaceblog? ?日志模塊
blocktype=spaceimage??圖片模塊
blocktype=spacefile? ? 文件模塊
blocktype=spacegoods??商品模塊
blocktype=spacelink? ? 書簽?zāi)K
blocktype=tag? ?? ?? ?TAG模塊
blocktype=spacetag? ???TAG文章信息模塊
blocktype=spacecomment? ?用戶回復(fù)模塊
blocktype=userspace? ? 個人空間列表模塊
blocktype=announcement? ?站點公告模塊
blocktype=bbsthread? ? 論壇主題模塊
blocktype=bbsannouncement? ?論壇公告模塊
blocktype=bbsforum? ?論壇板塊模塊
blocktype=bbslink? ? 論壇友情鏈接模塊
blocktype=bbsmember??論壇會員模塊
blocktype=bbsattachment??論壇附件模塊
blocktype=bbspost??論壇帖子模塊

1）??parameter=""這里存放的就是各個模塊的具體篩選參數(shù)了，相同的模塊類型調(diào)出來的內(nèi)容不同就是通過這里控制的，而這里的參數(shù)也是SupeSite/X-Space 模塊功能自動生成的。
2）??type/news/isroot/1/ischannel/2/order/c.displayorder/limit/0,10/cachetime/25200/cachename/category_news/tpl/data
這段就是模塊參數(shù)的篩選條件。這里由許多條件通過/組合起來。您稍微留心點，可以發(fā)現(xiàn)，上面的代碼通過/分成偶數(shù)段，從左至右每2段組成一個基本篩選條件，左邊代表篩選名字，右邊代表篩選條件
例如上面的
type/news??和/isroot/1 和ischannel/2 和order/c.displayorder 和limit/0,10 和cachetime/36800等都是一個獨(dú)立的基本篩選條件，
我稍微解釋下:
type/表示類型，右邊的/news表示資訊，所以type/news表示這個模塊取的內(nèi)容來自資訊
同理/isroot/1這個左邊isroot表示根分類，右邊1表示條件成立（這里1表示是，2表示否，下面的專題也是一樣），所以這個/isroot/1表示是根分類
ischannel/2這個左邊表示是專題，右邊2表示不屬于專題。
order/c.displayorder這個參數(shù)很重要，一般每個模塊都會有，這個代表的是排序的條件。
Limit/1,10這個參數(shù)也很重要，一般每個模塊都會有，這個代表的是取的數(shù)據(jù)的條數(shù)限制，limit右邊的2個數(shù)字，左邊代表的是取的數(shù)據(jù)的起始行數(shù)，右邊代表取的數(shù)據(jù)條數(shù)，所以Limit/1,10就表示從第一行數(shù)據(jù)開始取10條數(shù)據(jù)。
cachetime/25200表示的是緩存時間，單位為妙。所以這個就代表緩存時間是7小時
SupeSite有強(qiáng)大的緩存機(jī)制，可以將全部數(shù)據(jù)進(jìn)行緩存起來，有效的減少數(shù)據(jù)庫查詢，加快頁面的打開速度。

如果您要了解更多，可以登陸站點設(shè)置――模塊功能――創(chuàng)建模塊，隨便進(jìn)入一個創(chuàng)建模塊的頁面，查看源文件，就可以看到各個篩選條件對應(yīng)的變量了
以創(chuàng)建日志模塊為例，查看他的源文件：
隨便截取一段，如下圖：

Snap7.jpg (100.51 KB)
2006-11-29 16:19
其中黃色部分表示模塊變量的中文意思，藍(lán)色部分表示模塊變量，灰色部分表示其對應(yīng)的取值。
通過這種方法，您可以到各個創(chuàng)建模塊的頁面查看源文件，基本就能明白模塊代碼里面各個篩選條件是怎么來的，各自代表什么含義了。


通過上面的說明，相信以后大家見到一段模塊代碼都知道怎么入手分析了



3，??根據(jù)頁面查找模塊位置

我對邊在SupeSite/X-Space官方站點http://x.discuz.net隨便截了一張圖片，如下圖：
我們?nèi)绾握业近S色區(qū)域的模塊代碼呢？對于不懂div+css的用戶來說，也可以很快確定的～

首先，我們可以得到的直觀感覺就是他有15條記錄，并位于中間部位。
接下來，根據(jù)上面的內(nèi)容，我們很清楚這個頁面對應(yīng)的文件是templates/default/index.html.php
Snap5.jpg (122.16 KB)
2006-11-29 16:12

第三步，我們用記事本打開templates/default/index.html.php這個文件

根據(jù)上面的模塊知識，我們可以得到黃色部分肯定存在的一個篩選條件limit/*,15/
SupeSite的模塊一般都是從0開始的，所以您可以在文件中查找下limit/0,15/

這樣，您就可以很方便的找到
<!-- 1周回復(fù)熱點 -->
? ?? ?? ?? ?? ?? ?? ?<!--{block name="spaceblog" parameter="dateline/604800/notype/1/order/i.replynum DESC/subjectlen/34/subjectdot/1/limit/0,15/cachetime/1/showspacename/1/cachename/newinfos/tpl/data"}-->

如果他是唯一的，就說明您的模塊代碼找對了。如果不唯一，就可以再結(jié)合一點剛才說的模塊的知識和頁面的知識，也可以很快定位到具體的模塊代碼的。是不是很簡單呢？呵呵

標(biāo)準(zhǔn)頁面里面的模塊提取的內(nèi)容或許您不太滿意，同樣，利用剛才的模塊知識，您可以在讀懂了模塊調(diào)用的內(nèi)容之后根據(jù)您自己站點的需求修改為您自己的模塊代碼。

3，??修改模塊代碼適應(yīng)自己站點
以上面找到的模塊代碼為例：
<!-- 1周回復(fù)熱點 -->
? ?? ?? ?? ?? ?? ?? ?<!--{block name="spaceblog" parameter="dateline/604800/notype/1/order/i.replynum DESC/subjectlen/34/subjectdot/1/limit/0,15/cachetime/1/showspacename/1/cachename/newinfos/tpl/data"}-->

大家可以自己到SupeSite站點設(shè)置――模塊功能――創(chuàng)建一個新的模塊并獲取模塊代碼替換這段模塊代碼。
當(dāng)然，如果您通過多次實踐，已經(jīng)完全熟悉SupeSite的模塊參數(shù)說明，您也可以直接在這段模塊代碼中修改。
一般大家修改的比較多的無非是條數(shù)、緩存時間這些參數(shù)，可以這樣修改：
limit/0,15這里讀取的是從0行開始的15條數(shù)據(jù)，如果您需要8條數(shù)據(jù)，可以改為limit/0,8
cachetime/1這里表示的是緩存時間為1妙，如果您嫌太短，需要設(shè)置為1小時，可以修改為cachetime/3600
諸如此類。


最后，我要說明的是，SupeSite模塊功能給了大家一個強(qiáng)大的自定義站點功能，從現(xiàn)在開始，您不再需要局限于標(biāo)準(zhǔn)程序的設(shè)計，通過靈活運(yùn)用模塊功能，您可以利用SupeSite將站點內(nèi)的數(shù)據(jù)，打造出千千萬萬種站點模式！

轉(zhuǎn)載于:https://www.cnblogs.com/zhuboxingzbx/articles/1137933.html

總結(jié)

以上是生活随笔為你收集整理的[转]SupSite页面文件与模块关系说明的全部內(nèi)容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網(wǎng)站內(nèi)容還不錯，歡迎將生活随笔推薦給好友。