在 phpBB3 中增加新的自訂頁面

與 phpBB 3.0.x 相關主題。
回覆文章
頭像
心靈捕手
默默耕耘的老師
默默耕耘的老師
文章: 8629
註冊時間: 2004-04-30 01:54
來自: Taiwan

在 phpBB3 中增加新的自訂頁面

文章 心靈捕手 » 2008-02-23 11:34

在 phpBB3 中增加新的自訂頁面

大家好!

這個教學將展示給您如何在 phpBB3 中增加新的頁面. 為什麼您需要如此做呢? 比方說, 您想要新增一個類似您的論壇的網頁. 這新的頁面能夠包含任何您想要的東西, 從透過簡單的文字像是規則的列表, 到更複雜的事情像是其他的 PHP scripts, 例如: 行事曆. 讓我們開始吧!

這 aboutus.php 檔案

當您建立一個 aboutus.php 頁面, 請確認在 <?php 之前, 以及在 ?> 之後, 沒有留下空行.

例如, 我們要建立一個簡單的頁面來說明關於網站的一些事情, 請複製以及貼上下列的代碼到您最愛的文字編輯器中:

代碼: 選擇全部

<?php
define('IN_PHPBB', true);
$phpbb_root_path = (defined('PHPBB_ROOT_PATH')) ? PHPBB_ROOT_PATH : './';
$phpEx = substr(strrchr(__FILE__, '.'), 1);
include($phpbb_root_path . 'common.' . $phpEx);

// Start session management
$user->session_begin();
$auth->acl($user->data);
$user->setup();

page_header('Title Here');

$template->set_filenames(array(
    'body' => 'yourpage_body.html',
));

make_jumpbox(append_sid("{$phpbb_root_path}viewforum.$phpEx"));
page_footer();
?>

是嗎? 不全都是, 讓我解釋一下.

如果您正在建立一個完整地自訂頁面, 那麼您可能不需要如此做; 但是如果您需要使用到 phpBB 語言檔, 那麼請改變這一行:

代碼: 選擇全部

$user->setup();
  
取代成:

代碼: 選擇全部

$user->setup('base-name-of-language-file-here');
  
用您要使用的語言檔之檔名替換 base-name-of-language-file-here, 不需要 .php 副檔名. 例如, 如果您要上載 viewtopic.php 語言檔, 那麼使用代碼如下:

代碼: 選擇全部

$user->setup('viewtopic');
  
首先, 您需要改變的是這一行:

代碼: 選擇全部

page_header('Title Here');
  
只要改變 Title Here 為您想要顯示在瀏覽器的抬頭訊息. 例如, 我們將它改變為 About Us.

接著, 您需要改變這一行:

代碼: 選擇全部

'body' => 'yourpage_body.html',
  
再一次, 讓我詳加解釋為何您需要做此改變. phpBB 分開網頁 (所有的 PHP 代碼) 的邏輯, 從構思 (顏色, 圖像,背景, 等等) 和文字 (HTML 檔案). 您將需要改變 yourpage_body.html 像是 aboutus_body.html -- 我們已經編輯的樣板檔. 儲存上頭在文字編輯器的檔案為 aboutus.php

獎勵 (限制訪客瀏覽) 的秘訣

如果您想要只有已經登入的會員 (限制訪客) 瀏覽此頁的話, 那麼可以這麼做, 找到這行:

代碼: 選擇全部

$user->setup(); 
  
在之後 (下一行), 新增代碼, 如下:

代碼: 選擇全部

if ($user->data['user_id'] == ANONYMOUS)
{
    login_box('', $user->lang['LOGIN']);
}
  
這 aboutus_body.html 檔案

下一步, 我們將建立包含 aboutus.php 實際內容的 HTML 檔案. 再一次, 使用您最愛的文字編輯器開啟此檔, 複製以下代碼:

代碼: 選擇全部

<!-- INCLUDE overall_header.html -->

<h2>Title Here</h2>

<div class="panel">
   <div class="inner"><span class="corners-top"><span></span></span>

   <div class="content">
      <p>
         Content in here.
      </p>
   </div>

   <span class="corners-bottom"><span></span></span></div>
</div>

<!-- INCLUDE jumpbox.html -->
<!-- INCLUDE overall_footer.html -->

這是相當容易的. 要改變這一頁顯示在上頭的大字, 只要改變這一行:

代碼: 選擇全部

<h2>Title Here</h2>
例如: 以 About Us 取代 Title Here.

而這個區塊將取代成您的實際內容:

代碼: 選擇全部

         Content in here.
在這裡, 您可以增加您想要的 HTML, CSS 代碼以及文字. (如果您不懂 HTML 或 CSS, 那麼我建議您去學習它們. 兩者都是非常容易學的. 這 W3Schools 網站有非常棒的教學.) 在此, 是用一個項目的列表所展示之例子:

代碼: 選擇全部

         We were founded this year to bring you the best forum on the Internet!
         
         We promise to do the following:
         <ul>
            <li>Provide new content</li>
            <li>provide a friendly atmosphere</li>
            <li>Provide an environment where you can have fun!</li>
         </ul>
總結

如果您依照這裡的說明, 那麼這兩個檔案現在看起來應該像這樣:

aboutus.php:

代碼: 選擇全部

<?php
define('IN_PHPBB', true);
$phpbb_root_path = (defined('PHPBB_ROOT_PATH')) ? PHPBB_ROOT_PATH : './';
$phpEx = substr(strrchr(__FILE__, '.'), 1);
include($phpbb_root_path . 'common.' . $phpEx);

// Start session management
$user->session_begin();
$auth->acl($user->data);
$user->setup();

page_header('About Us');

$template->set_filenames(array(
    'body' => 'aboutus_body.html',
));

make_jumpbox(append_sid("{$phpbb_root_path}viewforum.$phpEx"));
page_footer();
?>
aboutus_body.html:

代碼: 選擇全部

<!-- INCLUDE overall_header.html -->

<h2>About Us</h2>

<div class="panel">
   <div class="inner"><span class="corners-top"><span></span></span>

   <div class="content">
      <p>
         We were founded this year to bring you the best forum on the Internet!
         
         We promise to do the following:
         <ul>
            <li>Provide new content</li>
            <li>provide a friendly atmosphere</li>
            <li>Provide an environment where you can have fun!</li>
         </ul>
      </p>
   </div>

   <span class="corners-bottom"><span></span></span></div>
</div>

<!-- INCLUDE jumpbox.html -->
<!-- INCLUDE overall_footer.html -->

最後的步驟

現在儲存已經修改的檔案, 上傳到您的網站. 其中, aboutus_body.html 是上傳到 styles/your_style/template/ 底下; aboutus.php 則是上傳到 phpBB 的根目錄底下 (這個地方有存放檔案, 像是 faq.php, viewforum.php, viewtopic.php,...等.).

最後, 在瀏覽器網址列輸入 http://YOUR_WERSITE/phpBB3_ROOT/aboutus.php 去檢視您的新網頁!

與您分享之! :mrgreen:

--
資料來源:
http://www.phpbb.com/kb/article/add-a-n ... -to-phpbb/
最後由 心靈捕手 於 2010-02-25 08:40 編輯,總共編輯了 4 次。
理由: 修改成 PHP 語法, 並移除尾端空行.
施比受有福,歡迎來信賜教,謝謝 & 再見!
祝福您 好運 ^_^
歡迎加入★★心靈捕手★★ :: 討論區!!
http://wang5555.hopto.org/phpBB3/
p.s. 奉老婆之命:在晚上十一點前,得關機睡覺!!!

頭像
心靈捕手
默默耕耘的老師
默默耕耘的老師
文章: 8629
註冊時間: 2004-04-30 01:54
來自: Taiwan

修訂 PHPBB_ROOT_PATH 語法與新增獎勵 (限制訪客瀏覽) 的方法

文章 心靈捕手 » 2008-04-23 09:37

#
#-----[ OPEN ]-----
#
aboutus.php

#
#-----[ FIND ]-----
#

代碼: 選擇全部

$phpbb_root_path = './';
#
#-----[ REPLACE WITH ]-----
#

代碼: 選擇全部

$phpbb_root_path = (defined('PHPBB_ROOT_PATH')) ? PHPBB_ROOT_PATH : './';
#
#-----[ FIND ]-----
# 如果您想要只有已經登入的會員 (限制訪客) 瀏覽此頁的話, 那麼可以這麼做.
#

代碼: 選擇全部

$user->setup();
#
#-----[ AFTER, ADD ]-----
#

代碼: 選擇全部

if ($user->data['user_id'] == ANONYMOUS)
{
    login_box('', $user->lang['LOGIN']);
}
#
#-----[ SAVE & CLOSE ]-----
#

--
資料來源:
http://www.phpbb.com/kb/article/add-a-n ... -to-phpbb/
20080331 - edited by pentapenguin to utilise PHPBB_ROOT_PATH constant and added bonus tip

--
感謝 rex 來函告知!
第一篇文章已修正.
施比受有福,歡迎來信賜教,謝謝 & 再見!
祝福您 好運 ^_^
歡迎加入★★心靈捕手★★ :: 討論區!!
http://wang5555.hopto.org/phpBB3/
p.s. 奉老婆之命:在晚上十一點前,得關機睡覺!!!

回覆文章

回到「3.0」