Ajouter une nouvelle page personnalisée

Consultez ici toute la documentation sur phpBB.

Ajouter une nouvelle page personnalisée

Message par Maël Soucaze » 13 Nov 2010, 14:59

Cette documentation vous expliquera comment ajouter une nouvelle page personnalisée à phpBB. Cela peut s'avérer très utile si vous souhaitez ajouter une nouvelle page ressemblant exactement à votre forum. Cette nouvelle page peut, par exemple, contenir une liste des règles de votre forum, ou encore intégrer des fonctionnalités plus avancées comme des scripts PHP.

Fichier PHP

Veuillez vous assurer qu'aucune ligne vierge ou qu'aucun espace ne soit présent avant la balise <?php et après la balise ?>. Ouvrez votre éditeur de texte et copiez le code suivant :
Code : Tout sélectionner
<?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('Titre de votre page');

$template->set_filenames(array(
    'body' => 'nom-de-votre-page-personnalisee_contenu.html',
));

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


Le premier changement que vous allez devoir apporter à ce fichier est le titre de la page que vous souhaitez afficher dans la barre de titre du navigateur Internet de vos utilisateurs. Par exemple, si vous souhaitez afficher le titre "Règles du forum", remplacez :
Code : Tout sélectionner
page_header('Titre de votre page'); 


Par :
Code : Tout sélectionner
page_header('Règles du forum'); 


Le second changement consiste à modifier le nom de la page qui contiendra le contenu texte. En effet, phpBB sépare le moteur (le code PHP) du graphisme (les couleurs, les images, etc.) et du texte (le fichier HTML). Par exemple, si vous souhaitez afficher utilisez le nom reglement_contenu.html, remplacez :
Code : Tout sélectionner
    'body' => 'nom-de-votre-page-personnalisee_contenu.html', 


Par :
Code : Tout sélectionner
    'body' => 'reglement_contenu.html', 


Vous pouvez à présent sauvegarder votre fichier en le nommant tel qui apparaîtra dans la barre d'adresse du navigateur Internet de vos utilisateurs. Par exemple, nommez-le reglement.php.

Astuces

Si vous souhaitez créer une page personnalisée faisant appel aux fichiers de langue de phpBB. Ceci est optionnel et vous n'en aurez sans doute pas besoin. Remplacez "nom-du-fichier-de-langue" par le nom du fichier de langue auquel vous souhaitez faire appel, en n'incluant pas l'extension .php. Par exemple, si vous souhaitez charger le fichier de langue viewtopic.php, remplacez :
Code : Tout sélectionner
$user->setup(); 


Par :
Code : Tout sélectionner
$user->setup('viewtopic'); 


Si vous souhaitez que votre page personnalisée ne soit accessible qu'aux utilisateurs inscrits sur votre forum, vous pouvez ajouter après la ligne :
Code : Tout sélectionner
$user->setup(); 


Ce petit morceau de code qui se chargera d'afficher l'écran de connexion :
Code : Tout sélectionner
if ($user->data['user_id'] == ANONYMOUS)
{
    login_box('', $user->lang['LOGIN']);
}
  


Fichier HTML

Nous allons à présent créer le fichier HTML qui contiendra le contenu texte tu fichier reglement.php. Ouvrez votre éditeur de texte et copiez le code suivant :
Code : Tout sélectionner
<!-- INCLUDE overall_header.html -->

<h2>Votre titre</h2>

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

   <div class="content">
      <p>
         Contenu de la page.
      </p>
   </div>

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

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


Le premier changement que vous allez devoir apporter à ce fichier est le titre affiché en gros dans le contenu de votre page. Par exemple, si vous souhaitez afficher le titre "Règles du forum", remplacez :
Code : Tout sélectionner
<h2>Votre titre</h2>


Par :
Code : Tout sélectionner
<h2>Règles du forum</h2>


Le second changement consiste à rédiger le contenu de votre page. Remplacez :
Code : Tout sélectionner
         Contenu de la page.


Par votre contenu.

Si vous le souhaitez, vous pouvez ajouter du code HTML, du CSS et du texte supplémentaire. Voici un petit exemple de contenu avec une mise en forme d'une liste :
Code : Tout sélectionner
         Voici les règles de notre forum à respecter sous peine de sanctions :
         <ul>
            <li>Les messages doivent être publiés dans le forum adéquat. Les utilisateurs sont priés de lire attentivement les différentes descriptions rédigées pour chaque forum avant toute participation.</li>
            <li>Les utilisateurs ne doivent pas oublier que ce forum est visité par un public de tout âge, de toute nationalité et de différents milieux. Les textes, les liens ou les images de type pornographique, discriminatoire, xénophobe, pédophile, injurieux, politique, religieux, etc. ne sont pas tolérés. Les utilisateurs ne doivent en aucun cas publier du contenu qui puisse troubler autrui, dans le respect des autres utilisateurs. La liberté des uns s'arrête là où commence celle des autres.</li>
            <li>Les utilisateurs sont priés de respecter les droits d'auteurs, les licences et les copyrights des autres utilisateurs, sites, médias, etc. Aucun texte, lien ou image pouvant enfreindre le Code de la propriété intellectuelle n'est toléré.</li>
         </ul>


Résultat final

Dans notre exemple, nous avons mis en place une page personnalisée, ressemblant à votre forum et contenant ses règles à respecter.

reglement.php :
Code : Tout sélectionner
<?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('Règles du forum');

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

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


reglement_contenu.html :
Code : Tout sélectionner
<!-- INCLUDE overall_header.html -->

<h2>Règles du forum</h2>

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

   <div class="content">
      <p>
         Voici les règles de notre forum à respecter sous peine de sanctions :
         <ul>
            <li>Les messages doivent être publiés dans le forum adéquat. Les utilisateurs sont priés de lire attentivement les différentes descriptions rédigées pour chaque forum avant toute participation.</li>
            <li>Les utilisateurs ne doivent pas oublier que ce forum est visité par un public de tout âge, de toute nationalité et de différents milieux. Les textes, les liens ou les images de type pornographique, discriminatoire, xénophobe, pédophile, injurieux, politique, religieux, etc. ne sont pas tolérés. Les utilisateurs ne doivent en aucun cas publier du contenu qui puisse troubler autrui, dans le respect des autres utilisateurs. La liberté des uns s'arrête là où commence celle des autres.</li>
            <li>Les utilisateurs sont priés de respecter les droits d'auteurs, les licences et les copyrights des autres utilisateurs, sites, médias, etc. Aucun texte, lien ou image pouvant enfreindre le Code de la propriété intellectuelle n'est toléré.</li>
         </ul>
      </p>
   </div>

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

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


Étapes finales

Transférez votre fichier reglement_contenu.html dans le répertoire styles/nom-de-votre-style/template/ de votre serveur Internet. Transférez également votre fichier reglement.php à la racine de phpBB, où vous pourrez voir des fichiers tels que faq.php, viewforum.php ou encore viewtopic.php.

Votre nouvelle page personnalisée est à présent accessible en y pointant votre navigateur ;) .


Source : http://www.phpbb.com/kb/article/add-a-n ... -to-phpbb/
MAËL SOUCAZE • STYLES TEAM MEMBER • TRANSLATIONS & INTERNATIONAL SUPPORT TEAMS MANAGER
STOP ACTA! HTTP://WWW.STOPACTA.INFO/
Maël Soucaze
Responsable Traduction
Responsable Traduction
 
Message(s) : 316
Inscription : 02 Nov 2010, 15:46
Localisation : France

Ajouter une nouvelle page personnalisée

Publicité

Publicité
 

Retour vers [Support 3.0.x] Documentation

Qui est en ligne ?

Utilisateur(s) parcourant ce forum : CommonCrawl [Bot] et 0 invité(s)