如何安裝外掛

phpBB.com Docs & KB Translation
收集所有官方的技術文件以及知識庫之譯文,以利分享!
(僅供瀏覽,由版主群維護)
回覆文章
頭像
心靈捕手
默默耕耘的老師
默默耕耘的老師
文章: 8510
註冊時間: 2004-04-30 01:54
來自: Taiwan

如何安裝外掛

文章 心靈捕手 »

在您開始之前, 您必須將您所有的檔案做好備份.

首先, 下載您要安裝的外掛, 然後開啟裡頭的安裝說明檔 (通常是 .txt 或 .mod).

做這事不難: 開啟這特別的檔案到文字編輯器中 (notepad, wordpad, editplus,...等).

1) 這 "COPY (複製)" 動作:
如果是在外掛中, 那麼您看到的情況像是這樣:

代碼: 選擇全部

#
#-----[ COPY ]------------------------------------------
#
copy file.php to file.php
copy file.tpl to templates/subSilver/file.tpl
這個意思只是您必須上傳 "file.php" 檔案到 phpBB 根目錄, 以及 "file.tpl" 檔案到風格目錄中, 不必編輯它們.


2) 這 "OPEN (開啟)" 動作:
這是首要的基本動作:

代碼: 選擇全部

#
#-----[ OPEN ]------------------------------------------
#
common.php
做這事不難: 開啟這特別的檔案到文字編輯器中 (notepad, wordpad, editplus,...等).


3) 這 "FIND (尋找)" 動作:
在 "OPEN (開啟)" 動作之後, 這是最普遍使用的動作, 因為在您可以做任何事之前, 您必須去尋找某些代碼.

代碼: 選擇全部

#
#-----[ FIND ]------------------------------------------
# around line 184
//
// Show 'Board is disabled' message if needed.
//
在您的文字編輯器中開啟一個檔案之後, 去尋找外掛所說的代碼, 然後去做任何的動作, 或在那行的附近再去尋找其他代碼.


4) 這 "BEFORE ADD (之前增加)" 動作:
在安裝說明檔中, 您也許會看見:

代碼: 選擇全部

#
#-----[ BEFORE, ADD]--------------------------------------
#
include($phpbb_root_path . 'attach_mod/attachment_mod.'.$phpEx);
因此, 當您找到之前所要尋找的代碼之後, 您可以在它之前增加. 此例中的結果, 像是這樣:

代碼: 選擇全部

include($phpbb_root_path . 'attach_mod/attachment_mod.'.$phpEx);
//
// Show 'Board is disabled' message if needed.
//

5) 這 "AFTER ADD" (之後增加)" 動作:

代碼: 選擇全部

#
#-----[ AFTER ADD]------------------------------------------
#
include($phpbb_root_path . 'attach_mod/attachment_mod.'.$phpEx);
它是類似 "BEFORE ADD (之前增加)" 動作, 但不同的是, 您得將尋找到的代碼在它之後增加.

此例中的結果, 像是這樣:

代碼: 選擇全部

//
// Show 'Board is disabled' message if needed.
//
include($phpbb_root_path . 'attach_mod/attachment_mod.'.$phpEx);

6) 這 "REPLACE WITH (取代成)" 動作:

代碼: 選擇全部

#
#-----[ REPLACE WITH ]------------------------------------------
#
<form action="{S_POST_ACTION}" method="post" name="post" onsubmit="return checkForm(this)" {S_FORM_ENCTYPE}>
這個動作總是和 "FIND (尋找)" 動作一起使用. 您必須找到一段代碼去取代.
但是, 假如您有安裝其他外掛的話, 那麼您必須小心處理這個動作.

建議您, 不要使用這個動作. 而改用 "in-line" 動作來安裝.

例如:

代碼: 選擇全部

#
#-----[ FIND ]---------------------------------------------
# around line 225
<form action="{S_POST_ACTION}" method="post" name="post" onsubmit="return checkForm(this)">

#
#-----[ REPLACE WITH ]---------------------------------------
#
<form action="{S_POST_ACTION}" method="post" name="post" onsubmit="return checkForm(this)" {S_FORM_ENCTYPE}>
此例中, 我必須先找到:

代碼: 選擇全部

<form action="{S_POST_ACTION}" method="post" name="post" onsubmit="return checkForm(this)">
...然後, 將它取代成:

代碼: 選擇全部

<form action="{S_POST_ACTION}" method="post" name="post" onsubmit="return checkForm(this)" {S_FORM_ENCTYPE}>
...所以, 結果將是這樣:

代碼: 選擇全部

<form action="{S_POST_ACTION}" method="post" name="post" onsubmit="return checkForm(this)" {S_FORM_ENCTYPE}>

7) 這 "IN-LINE FIND (在此行中, 尋找)" 動作:
這是關係到 "IN-LINE AFTER, ADD (在此行中, 之後增加)", "IN-LINE BEFORE, ADD (在此行中, 之前增加)", 以及 "IN-LINE REPLACE WITH (在此行中, 取代成)" 等動作. 稍後, 會有更多解釋; 對於外掛作者而言, 這是最好的動作說明.

這個動作, 再一次, 總是和 "FIND (尋找)" 動作一起使用.

代碼: 選擇全部

#
#-----[ IN LINE FIND ]------------------------------------------
#
t.topic_title,
像這樣是比較難理解的, 我將給您一個例子.

代碼: 選擇全部

#
#-----[ FIND ]------------------------------------------
#
$select_sql = ( !$submit ) ? ", t.topic_title, p.enable_bbcode, p.enable_html, p.enable_smilies, p.enable_sig, p.post_username, pt.post_subject, pt.post_text, pt.bbcode_uid, u.username, u.user_id, u.user_sig" : '';
#
#-----[ IN-LINE FIND ]------------------------------------------
#
t.topic_title,
您先用 "FIND (尋找)" 動作找到該段代碼, 然後再到該段代碼中, 去找到外掛所要求的代碼.


8) 這 "IN-LINE AFTER, ADD (在此行中, 之後增加)" 動作:
像是這樣:

代碼: 選擇全部

#
#-----[ IN-LINE AFTER, ADD ]------------------------------------------
#
t.topic_desc,
事實上, 使用 "REPLACE" 動作是比較好的 (這個是在您有安裝其他外掛的情況下使用).
這個動作是和 "FIND (尋找)" 動作以及 "IN-LINE FIND (在此行中, 尋找)" 動作一起使用.

例如:

代碼: 選擇全部

#
#-----[ FIND ]------------------------------------------
#
$select_sql = ( !$submit ) ? ", t.topic_title, p.enable_bbcode, p.enable_html, p.enable_smilies, p.enable_sig, p.post_username, pt.post_subject, pt.post_text, pt.bbcode_uid, u.username, u.user_id, u.user_sig" : '';
#
#-----[ IN-LINE FIND ]------------------------------------------
#
t.topic_title,
#
#-----[ IN-LINE AFTER, ADD ]------------------------------------------
#
t.topic_desc,
在此, 您必須尋找完整的一行 (原始的一行):

代碼: 選擇全部

$select_sql = ( !$submit ) ? ", t.topic_title, p.enable_bbcode, p.enable_html, p.enable_smilies, p.enable_sig, p.post_username, pt.post_subject, pt.post_text, pt.bbcode_uid, u.username, u.user_id, u.user_sig" : '';
在這一行中, 您必須再去尋找部分的代碼:

代碼: 選擇全部

t.topic_title,
...然後, 在此行中, 在它之後增加:

代碼: 選擇全部

t.topic_desc,
...如此, 這一整行 (已經修改過的一行) 將變成為這樣:

代碼: 選擇全部

$select_sql = ( !$submit ) ? ", t.topic_title, t.topic_desc, p.enable_bbcode, p.enable_html, p.enable_smilies, p.enable_sig, p.post_username, pt.post_subject, pt.post_text, pt.bbcode_uid, u.username, u.user_id, u.user_sig" : '';

9) 這 "IN-LINE BEFORE, ADD (在此行中, 之前增加)" 動作:
它是類似 "IN-LINE AFTER, ADD (在此行中, 之後增加)" 動作, 但不同的是, 您得將尋找到的代碼在它之前增加.

代碼: 選擇全部

#
#-----[ IN-LINE BEFORE, ADD ]------------------------------------------
#
, $topic_desc
例如:

代碼: 選擇全部

#
#-----[ FIND ]------------------------------------------
#
prepare_post($mode, $post_data, $bbcode_on, $html_on, $smilies_on, $error_msg, $username, $bbcode_uid, $subject, $message, $poll_title, $poll_options, $poll_length);
#
#-----[ IN-LINE FIND ]------------------------------------------
#
$poll_length)
#
#-----[ IN-LINE BEFORE, ADD ]------------------------------------------
#
$topic_desc,
在此, 您必須尋找完整的一行 (原始的一行):

代碼: 選擇全部

prepare_post($mode, $post_data, $bbcode_on, $html_on, $smilies_on, $error_msg, $username, $bbcode_uid, $subject, $message, $poll_title, $poll_options, $poll_length);
在這一行中, 您必須再去尋找部分的代碼:

代碼: 選擇全部

$poll_length)
...然後, 在此行中, 在它之前增加:

代碼: 選擇全部

$topic_desc,
...如此, 這一整行 (已經修改過的一行) 將變成為這樣:

代碼: 選擇全部

prepare_post($mode, $post_data, $bbcode_on, $html_on, $smilies_on, $error_msg, $username, $bbcode_uid, $subject, $message, $poll_title, $poll_options, $topic_desc, $poll_length);

10) 這 "INCREMENT (增加)" 動作:

代碼: 選擇全部

#
#-----[ FIND ]------------------------------------------
#
Powered by <a href="http://www.phpbb.com/" target="_phpbb" class="copyright">phpBB</a> &copy; 2001, {%:1} phpBB Group<br />{TRANSLATION_INFO}</span></div>
#
#-----[ INCREMENT ]-------------------------------------
#
%:1 +10
這 "INCREMENT (增加)" 動作是用來增加或減少數字. 這大部分使用於風格中的 colspans (跨欄位數) 或 rowspans (跨列位數).

這 "INCREMENT (增加)" 動作需要配合 "FIND (尋找)" 或 "IN-LINE FIND (在此行中, 尋找)" 動作執行 - 您需要以要增加或減少的數字去取代 {%:1}. 假如在此行中有多個數字需要增加或減少, 那麼使用 {%:2}, {%:3},...餘此類推.

這 "INCREMENT (增加)" 動作, 是將您尋找到的真實數字, 再增加或減少安裝說明中所指定的數字. 要增加的, 用 "+"; 要減少的, 用 "-". 您也可以不指定任何的數字, 而它的意思是 "+1". 在此, 舉些例子如下.

代碼: 選擇全部

#
#-----[ INCREMENT ]-------------------------------------
#
%:1

#
#-----[ INCREMENT ]-------------------------------------
#
%:2 -3

#
#-----[ INCREMENT ]-------------------------------------
#
%:3 +5
您可以使用 "IN-LINE INCREMENT (在此行中, 增加)" 來取代上頭的用法.


11 ) 這 "SQL (資料庫更新)" 動作:
這個動作是針對資料庫的修改 (增加欄位, 增加資料表, 修改資料表,...等).

代碼: 選擇全部

#
#-----[ SQL ]------------------------------------------
#
ALTER TABLE phpbb_topics ADD topic_desc varchar(255) DEFAULT '' AFTER topic_title
這個動作的意思是您需要去執行資料庫的更新語法. 最容易的方法是使用像是 phpMyAdmin 的程式去執行. 假如您沒有使用 phpMyAdmin 的權限, 那麼有些有效的網站可以自動解析在 PHP 檔案的 SQL 語法, 允許您簡單地上傳檔案以及在資料庫執行它. 例如: http://sql.phpmix.com/index.php


12) 這 "SAVE/CLOSE ALL FILES (儲存以及關閉所有檔案)" 動作:
這是最後一個動作. 當您做完了所有的修改之後, 儲存以及關閉所有檔案, 然後將它們上傳到您的網站. 檢查您的論壇, 以確認您可以正確地應用外掛. 假如您獲得錯誤, 那麼請重複兩次檢查您修改的檔案, 以確認您已經正確地安裝.

但是, 千萬別忘記: 安裝外掛之前, 請備份您的檔案以及資料庫!


13) 這 "DIY INSTRUCTIONS (自己做, 說明)" 動作:

代碼: 選擇全部

#
#-----[ DIY INSTRUCTIONS ]------------------------------------------
#
CHMOD foo.php and bar.php to 777
Open in your web browser and follow the instructions in db_install.php
有些外掛在完整地安裝之前有些額外的說明. DIY 的意思是 ''Do it yourself (自己做)'. 這些說明包含有執行 SQL 語法, 修改檔案權限, 或其他.


14) "MODx (以 XML 語法寫成的外掛)":
這是一個新的外掛說明風格, 建立在 XML 基礎上, 命名為 MODx.
您將會注意到在 'MOD Database Release (官方認證外掛)' 版面的主題, 假如有 MODx 風格的話, 那麼會有這個圖示:
modx.png
modx.png (5.1 KiB) 已瀏覽 17230 次
一般而言, 您可以使用瀏覽器來開啟它的安裝說明檔. 該檔檔名將會類似於 "name_of_the_mod.xml".

--
資料來源:
http://www.phpbb.com/kb/article/how-to-install-mods/
施比受有福,祝福您好運! ^_^
歡迎光臨★★心靈捕手★★ :: 討論區
https://wang5555.dnsfor.me/phpBB3/
回覆文章

回到「phpBB 技術文件與知識庫」