phpBB.cz - Přidání vlastní stránky do phpBB

V tomto návodu vám ukáži jak přidat vlastní novou stránku do phpBB. K čemu byste to mohli potřebovat? Řekněme třeba v případě, že chcete vytvořit stránku, která bude vypadat jako vaše fórum. Tato stránka pak může obsahovat cokoli od prostého textu až po složité PHP skripty, jako například kalendář a podobné.

Soubor onas.php

Při vytváření stránky onas.php dbejte na to, aby před <?php a za ?> nebyly prázdné řádky, nebo zbytečné mezery.

V tomto příkladě vytvoříme obyčejnou stránku, která řekne něco málo o našem portále. Zkopírujte a vložte následující kód do vašeho oblíbeného textového editoru.

Code: Vybrat vše

<?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('Titulek stránky');

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

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


To je vše? Ne zcela, ještě to rozvedeme.

Když vytváříte vlastní kompletní stránku asi to nebudete potřebovat, ale pokud budete potřebovat přístup k jazykovým souborům phpBB, změňte tento řádek:

Code: Vybrat vše

$user->setup(); 

na

Code: Vybrat vše

$user->setup('samotny-nazev-jazykoveho-souboru'); 

Zaměňte samotny-nazev-jazykoveho-souboru jménem požadovaného jazykového souboru bez přípony .php. Například pokud chcete použít jazykový soubor pro viewtopic.php, použijte tento kód:

Code: Vybrat vše

$user->setup('viewtopic'); 

První základní změna, kterou budete potřebovat je na tomto řádku:

Code: Vybrat vše

page_header('Titulek stránky'); 

Jednoduše zaměňte Titulek stránky za nadpis stránky, který se bude zobrazovat v záhlaví prohlížeče. V tomto příkladě nadpis nastavíme na O nás.

Další změnu uděláme na tomto řádku:

Code: Vybrat vše

'body' => 'telo_vasi_stranky.html' 

Ještě chvíli mě nechte vysvětlovat, proč je nutné toto měnit. phpBB odděluje logiku stránky (PHP kódy) od designu (barvy, obrázky, pozadí apod.) a textu (HTML soubor). Budete muset změnit telo_vasi_stranky.html na něco výstižnějšího, třeba onas_body.html. Tímto jsme hotovi s úpravou tohoto souboru. Uložte soubor jako onas.php (pozor: Microsoft Windows snaží soubor uložit s koncovkou .txt, proto ho uložte jako „onas.php“ včetně uvozovek).

Něco navíc

Pokud chcete omezit přístup ke stránce jen přihlášeným uživatelům, najděte tento řádek:

Code: Vybrat vše

$user->setup();  

A přidejte za něj tento kód:

Code: Vybrat vše


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

Soubor onas_body.html

Dále musíme vytvořit HTML soubor, který bude obsahovat aktuální obsah stránky onas.php. Znovu otevřete oblíbený textový editor a zkopírujte do něj následující kód:

Code: Vybrat vše

<!-- INCLUDE overall_header.html -->

<h2>Nadpis zde</h2>

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

   <div class="content">
      <p>
         Zde bude obsah
      </p>
   </div>

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

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


Je to velmi jednoduché. Jednoduše změňte nadpis stránky, který bude zobrazen velkým písmem na začátku stránky na tomto řádku:

Code: Vybrat vše

<h2>Nadpis zde</h2>

Nahraďte Nadpis zde za O nás.

A toto je část do které můžete vložit váš obsah:

Code: Vybrat vše

         Zde bude obsah

Můžete přidat jakýkoliv HTML a CSS kód do požadovaného textu. (Pokud neovládáte HTML nebo CSS doporučuji vám si o tom něco přečíst. Nejlépe něco snadného. Příkladem může být z českých zdrojů JakPsatWeb.cz, nebo mezinárodní The W3Schools site kde jsou výborné návody.) Zde je rychlý příklad s trochou textu a seznamem položek:

Code: Vybrat vše


        Byli jsme založeni tento rok a plánujeme být nejlepším fórem na internetu!
         
         Slibujeme následující:
         <ul>
            <li>Poskytovat nový obsah</li>
            <li>Poskytovat přátelskou atmosféru</li>
            <li>Posyktovat prostředí, které Vás bude bavit!</li>
         </ul>


Zprovoznění

Pokud jste došli až jsem vytvořené soubory nyní vypadají takto:

onas.php:

Code: Vybrat vše


<?php
define('IN_PHPBB', true);
$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('O nás');

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

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


onas_body.html:

Code: Vybrat vše

<!-- INCLUDE overall_header.html -->

<h2>O nás</h2>

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

   <div class="content">
      <p>
        Byli jsme založeni tento rok a plánujeme být nejlepším fórem na internetu!
         
         Slibujeme následující:
         <ul>
            <li>Poskytovat nový obsah</li>
            <li>Poskytovat přátelskou atmosféru</li>
            <li>Poskytovat prostředí, které Vás bude bavit!</li>
         </ul>
      </p>
   </div>

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

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



Poslední kroky

Nyní uložte vytvořený soubor onas_body.html a nahrajte ho do složky styles/název vašeho tématu/template/ na vašem webovém serveru. Taktéž nahrajte soubor onas.php do hlavního adresáře phpBB (stejný adresář ve kterém jsou soubory jako faq.php, viewforum.php, viewtopic,php atd.).

Nyní navštivte http://www.example.com/vase_forum/onas.php, kde uvidíte výsledek vaší práce.