HomeLanding - page d'accueil

[page]Présentation et installation[/page]
Il fallait un module "Page d'accueil" administrable pour PHPBoost, c'est fait.

Ce module signe mes premiers pas en programmation php et permet d'afficher une page d'accueil regroupant les derniers items de chaque module officiel de PHPBoost. Il existait déjà un tel module pour le cms, mais il était réservé aux programmeurs capables d'implémenter un tel fonctionnement. Maintenant, ce nouveau module vous permet, grâce à une page d'administration, de choisir en quelques clics quels modules seront affichés, dans quel ordre et le nombre d'items pour chaque module. Vous y trouverez également la possibilité d'ajouter un édito, un carrousel d'image ainsi que l'affichage d'un fil rss d'un site externe.

Étant débutant, j'ai soumis le module au grand chef qui l'a amélioré en créant un objet pour pouvoir ajouter facilement des modules supplémentaires (connaissance en programmation php nécessaires), ainsi qu'une page d'administration spécifique pour gérer l'ordre d'affichage des modules.

Installation


Ce module s'installe comme tout autre module dans PHPBoost:
au choix:Une fois le module installé, rendez vous dans la configuration générale et choisissez le comme "Page de démarrage".

[page]Configuration[/page]
La configuration du module se trouve dans l'onglet Contenu de l'administration.
Toute modification doit être validée en bas de page de la configuration.

Affichage du titre de la page et des emplacements de menus


Vous pouvez définir un titre spécifique à la page

Selon la configuration de votre site (une, deux ou trois colonnes) vous avez la possibilité de masquer tout ou partie de ces emplacements sur la page d'accueil.



Le carrousel


Une fois activé, le carrousel vous permet d'ajouter autant d'images que vous voulez, ainsi qu'une description qui les accompagne (optionnelle).
Des options sont également prévues pour gérer le défilement des images : vitesse de défilement, durée d'affichage de chaque image, affichage de flèches de navigation, blocage du défilement au survol des images, choix du type d'affichage des miniatures de navigation (images ou points).



L'édito


Cette option vous permet d'afficher un texte libre géré par le RichTextEditor



Les derniers commentaires


Cette option permet d'afficher les derniers commentaires postés sur votre site, avec gestion du nombre de commentaires à afficher ainsi que du nombre de caractères par commentaires.



Fil Rss


Cette option permet d'afficher les derniers items d'un site externe, avec configuration du titre du site, d'un lien vers le site, du lien vers le fichier xml de son fil rss, du nombre d'items à afficher et du nombre de caractères par lien.
Les sites en https ne sont pas gérés pour l'instant



[page]Les Modules[/page]
La gestion d'un module n'est visible que s'il est installé et activé.

Articles


Affichage des derniers items du module et/ou affichage d'une seule catégorie avec la possibilité de configurer l'affichage de ses sous-catégories.



Calendrier


Affichage des derniers événements du calendrier. Seuls les événements à venir sont affichés.



Contact


Affichage du formulaire d'envoi de message du module.



Téléchargements


Affichage des derniers items du module et/ou affichage d'une seule catégorie avec la possibilité de configurer l'affichage de ses sous-catégories.



Forum


Affichage des derniers messages postés dans le forum.



Galerie


Affichage des dernières images de la galerie. En front, le clic sur une image renvoie vers sa catégorie.



Livre d'or


Affichage des derniersmessages postés dans le livre d'or.



Multimedia


Affichage des derniers items du module.



News


Affichage des derniers items du module et/ou affichage d'une seule catégorie avec la possibilité de configurer l'affichage de ses sous-catégories.



Liens web


Affichage des derniers items du module et/ou affichage d'une seule catégorie avec la possibilité de configurer l'affichage de ses sous-catégories.
Seuls les liens "partenaires" sont affichés.



[page]Ajouter un module[/page]
Avant d'ajouter un module, il est préférable de dupliquer le module HomeLanding afin de ne pas être impacté par les mises à jour qui vous feraient perdre vos modifications. Voir le tutoriel de duplication de module, valable pour toute version de phpboost.

Les fichiers à modifier


  1. /controllers/AdminHomeLandingConfigController.class.php
    permet d'afficher le nouveau module et ses options dans l'administration.
  2. /controllers/HomeLandingHomeController.class.php
    permet de définir les propriétés du module à afficher sur la page d'accueil.
  3. /lang/english/common.php
    permet de définir les variables de langues en anglais.
  4. /lang/french /common.php
    permet de définir les variables de langues en français.
  5. /phpboost/HomeLandingConfig.class.php
    permet d'ajouter votre module dans la liste des modules.
  6. /templates/pagecontent/home.tpl
    permet d'ajouter l'affichage de votre module sur la page d'accueil.
  7. /templates/pagecontent/HomeLanding.css
    permet d'ajouter les classes css spécifiques à votre module.
  8. /templates/pagecontent/nomdumodule.tpl
    permet de définir ce que vous voulez afficher du module entier.
  9. /templates/pagecontent/nomdumodule-cat.tpl
    permet de définir ce que vous voulez afficher des catégories du module.