竹貓星球

MOD淺談篇(一)

嗯.. 這篇教學不會太八股, 只是把我所認識的MOD稍微跟大家介紹一下...
ps. 我會寫code, 不會寫文章.. 所以... 嗯.. 開始囉



(一)甚麼是MOD??

MOD全名Modification, 這個字有很多種解釋, 儘管字面(修正, 修飾, 變異...)看起來不同, 但是都含有修改的意思. 那為\r
甚麼不叫做Hack了呢?? OOHOO也忘了, 印象中好像phpBB 2 RC1以後, 官方就不再使用Hack, 而以Mod取而代之, 但這兩種名
詞我們都翻成"外掛", 所以這個命名的部分我們就不再深入了.. (好像是由psoTFX公佈的). 再來, 其實Mod翻成"外掛"並不
是很貼切, OOHOO個人比較喜歡"改裝"這個翻譯, 就跟車子改裝一樣, 喜歡炫一點的外型, 就稍微作個外部修改, 想要好一點
的效能, 就要整個調校一下, 所以phpBB也跟一樣車子一樣, 可以依個人喜好來改裝.. 大改小改的差別而已.. 其實要怎麼叫\r
都可以, 大家能夠聽得懂就好了.



(二)MOD的種類

目前官方將MOD分成八大類, OOHOO稍微幫大家分析一下

Add-on's
外加型, 通常都是比較小規模的修改(在OOHOO的印象中), 像是Printable Topics(友善列印), Statistics Mod Add-on(統計
資料).. 等等, 外加一些額外的功能.

Admin Tools
管理型, 顧名思義, 就是增加管理控制台內的功能, 像是Enhanced Admin User Lookup(加強型會員管理), Change "Board
Disabled Message" via ACP(暫時關閉告示)... phpBB 的管理控制台, 老實說, 滿陽春的, 不過透過這些MODs, 後端功能\r
可以強化不少.

BBCode
BBCode代碼, 就是那些額外的BBCode功能, 像是PHP Syntax Highlighter BBCode(PHP語法), BBCode Blur(模糊), BBCode
Fade(淡化).. 這類的MODs, 嗯.. 不好裝, 修改檔案也多(bbcode.php, bbcode.tpl, posting.php, viewtopic.php.. 很多),
安裝時要小心, 尤其是安裝越多個越亂... 初學者, 嗯..不建議從這裡開始.

Communication
交流型(我亂翻的), 這個類型目前還沒有MOD, OOHOO判斷可能是像Shout Box(聊天室)之類的Mod.

Cosmetic
美化型, 像Fading Links MOD(淡化連結), Hypercell Mod(色塊變化), 藉由這些Mods, 您可以美化討論區的外觀. 這類的Mods
是目前最多的類型.

Profile
個人資料, 就是外加一些原本沒有的會員資料, 像是Gender MOD(性別顯示), Birthday Mod(會員生日), 這些MODs一般都會需
要在phpbb_users理增加新的欄位, 而且要修改memberlist, profile, viewtopic等檔案, 安裝比較複雜.

Security
安全性, 應該就是一些安全修正, phpBB 2 RC4時後修補了一個蠻大的安全漏洞, 暫時還沒有人找到新的安全問題.
(註. http://www.phpBB.com 日前被駭的原因, 是因為server未加裝的安全漏洞的patch, 官方證實與phpBB 2.0.0無關)

Syndication
統合型(又是亂翻), 目前有一個MOD, At A Glance (recent news and/or topics), 因為還沒時間裝, 所以無法講解, 不過應
該是有點像是可以在phpBB內任何頁面中, 加入簡單的主題檢視和新聞功能.

(註. 也有許多Mods是很難被分類的)



(三)安裝MOD須知

1. 選擇您想要的新功能, 和準備一個您最喜歡的文字編輯程式(最要有尋找功能).
2. 備份(至少要備份涉及到的檔案, 這些在安裝說明裡應該都有介紹).
3. 有失敗的心理準備, 因為所有的MODs都是以開發者本身的環境下去測試, 如果檔案已被其它Mod修改過了, 很容易會造成衝
突的情形發生(例:Quick_Reply及Message_Icon).
4. 安裝時要小心, 因為有時候安裝步驟過多, 一時閃神, 或是跳著作, 都很有可能會miss掉一些步驟, 或改錯地方. 這時候,
最好的方法就是, 還原回去再重裝一次.
5. 最好有點HTML的基礎, 這不是絕對必要的, 但是如果您有HTML的觀念, tpl檔應該是不難改, 您可以在不用動到code的原則
下, 作出跟別人不一樣的小變化.
6. 錯誤回報, 如果真的無法安裝起來, 您可以將這個問題回報給作者, 或是請教其他裝過的同學, 不過在問問題前, 請先再重
做心安裝一遍, 因為基本上, debug真的很累, 為了節省大家的時間, 這個步驟是少不了的.
7. 養成作記號的習慣, 在您修改過的地方, 最好留下一些記號, PHP是以 "//" 作為備註的符號, 也就是在 "//" 之後的文字
是不會被執行的(或是/* ... */), 不過請將備註加在空行, 或是修改區段的結尾 ";" 之後, 才不會造成執行的錯誤. 在\r
tpl裡, 就比較難做記號, 因為有時候改的地方比較細, 您可以用 <! -- Blah blah --> HTML 備註符號來作說明, 但請注\r
意, tpl檔裡的 <!-- BEGIN .... --> <!-- END .... --> 是有特殊作用, 不是拿來放備註的.



MOD淺談(一)咱們就說到這兒了, 如果您是個phpBB 新手, 那您有必要稍微看一下, 這會節省您許多時間的; 如果您已經是phpBB 老
手, 那也請您幫我看一下, 看看還有沒有甚麼可以提供給新手的意見.. 大家一起作功德吧\r



作者: OOHOO < webdev@phpbb-tw.net >
原始來源: 竹貓星球 < http://phpbb-tw.net/ >
參考資料: phpBB 官方資料 < http://www.phpbb.com/ >

辛苦了..!!

目前我最想做的是美化型...
只是改起來相當不簡單..只能乾瞪眼..

OOHOO 大大真是好人哪！！！！:-D
各位phpbb的新人们有福哦。。

我有一点小小的意见，
关于ADD-ON型的mod，我个人以为应该是指由添加程序文件来实现新增
功能的mod，而不仅仅是指比較小規模的修改，不知道OOHOO大大以为呢？

嗯.. 所以我說"印象中"修改的規模比較小^^, 如果比起BBCode 或是Profile 這些類型, Add-on's 真的算小型的

哇口連~~~我是屬於破壞性的~~誰來救救我~~ /______ \ "

lightARmoR 寫:辛苦了..!!

目前我最想做的是美化型...
只是改起來相當不簡單..只能乾瞪眼..

你的logo很好看喔

恩 mod
file attchnment最難加了啦\r
改超多的

人家又不像法蘭庫克兄你樣高手~~有沒有收跟班學徒之類的~~我第一個報名~~多謝cccc

IamJay 寫:人家又不像法蘭庫克兄你樣高手~~有沒有收跟班學徒之類的~~我第一個報名~~多謝cccc

我是肉腳啦\r
恩 叫我加mod 很容易
但叫我開發 粉困難 因為一堆狗屁到杜的事情沒弄
沒時間來好好搞一搞 專題還沒搞定
期中考也沒考完
好想睡喔

OOHOO 寫:(三)安裝MOD須知

1. 選擇您想要的新功能, 和準備一個您最喜歡的文字編輯程式(最要有尋找功能).

作者: OOHOO < webdev@phpbb-tw.net >
原始來源: 竹貓星球 < http://phpbb-tw.net/ >
參考資料: phpBB 官方資料 < http://www.phpbb.com/ >

關於第一點，提供一個小工具，如果MOD裝不起來，可以試著比對原先未修改檔案(當然首先是要有備份檔)

ExamDiff 1.6g
Visual File Comparison Tool

官方網站：http://www.prestosoft.com/examdiff/examdiff.htm

每次我只要安裝MOD失敗，就會使用它來看看到底漏掉了哪些地方....(它會將不一樣的地方用顏色區分開來，各位大大可以試用看看)

這東西很實用喔

哦，不错，是个好工具啦！
其实我也有写过类似的东西啦，不过是用来比对不同版本的语言包的（做汉化），
当然功能上就更是没得比拉！
现在好了，再次感谢szyang！！！

呵呵~~~當然好用 (不只修改php好用，debug也很好用呢 ^^)

對了，為避免離題，剛剛去新增一個主題囉~

大家還是淺談 MOD 吧！:P

謝謝博士詳盡的解說

看了這麼多解說,我才發覺我是屬於重灌型
phpbb重灌不下30次 ---->

不過經過個位大大的熱心指導,現在是 ---->(:F)

看到南宮博士的加MOD心得, 想起了一年前寫下的附在UBB中文化版本裡的文章, 對於修改phpBB也有參考價值, 因為修改上的原理是共通的. 貼出來讓大家參考一下.

1. 最重要的一點, 你要掛MOD的時候要確定你有足夠的精神! 因為你必須非常小心, 精神不夠時做錯了一步就往往要重新來過, 與其花時間把同一個MOD安裝多次, 不如一次過有精神時攪定它.

2. 有精神之後就要仔細, 掛第一個第二個MOD可以照著做就行, 但到了後面一些的MOD你就要非常仔細小心. 因為很多MOD與MOD之間是不兼容的. 這裡引申出兩個問題: i, 你必須學著去看懂那些MOD改動的地方是哪些? 為何要那樣改? 改動的參數背後代表了甚麼意義? ii, 若只是加上(add after/above)的話就好一點, 若你發現安裝說明裡有replace, delete的時候, 請你要非常小心! 因為可能之前原碼已經被其他MOD修動過, 你裝另一些MOD若有replace, delete的時候可能會刪改掉已經安裝好的MOD! 結果會是...

3. 在安裝MOD時請準備一份原phpBB英文檔, 因為有很多時候你需要參考/對照原英文檔(最乾淨沒改過的). 不參考的話, 你會加多了或加少了掛MOD要修改的地方, 那樣自然會出錯. 有時掛了許多MOD後, 你會找不到安裝說明上的那句string, 這個時候一份原英文檔就是用來對照的必須工具了.

4. 這點很累贅, 但也要說, 就是多backup. 我的做法是每加一個MOD backup一次. 也就是說掛9個MOD有8份備份. 反正不會佔很多Hardisk空間, 好處是可以隨時在任何一個掛MOD點重新來過.

此外討論到修改時用的工具程式. 有兩種我常用的, 感覺非常好用, 推薦給大家~

Beyond Compare

對照兩個檔案或兩個目錄下所有檔案的異同, 功能強大.

官方網頁在\r
http://www.scootersoftware.com/features.html

Editplus

用來修改CGI, PHP等程式語言的一個好工具. 它會自動把程式裡的文字/語法分類, 以不同顏色代表, 還支援多種文本, 並能進行多檔間同時編輯, 搜索字串(對中文化和掛MOD特別好用), 還有其他各種強大文件編輯功能. 此軟體一直是Cnet推薦的5星軟體.

官方網頁在\r
http://www.editplus.com/

太感激了,這幾個程式都拿來試試看,現在還都是用Wordpad開兩個檔,用目視法對來對去,又不懂程式,每次都對的快死掉,好累.....