FAQ

Modules

FAQ Modules révisée en décembre 2022 par Mipel sur la base de la V 5.2

Qu'est-ce qu'un module ?
Un module est un composant qui permet à votre site PHPBoost d'obtenir de nouvelles fonctionnalités de façon simple et rapide.
Il en existe beaucoup comme par exemple : calendrier, news, articles...
Où puis-je trouver la liste des modules disponibles ?
La liste complète des modules disponibles pour la version 5.2 se trouve à cette adresse : Les modules de la version 5.2

Certains modules ne font pas partie du pack d'installation par défaut, on peut les trouver sur GitHub, dans la partie Modules : Modules sur GitHub
Comment installer un module ?
Il vous suffit de télécharger le module désiré dans la liste des modules

Ensuite, rendez-vous dans le Panneau d'administration / modules puis ajouter un module. Via parcourir vous sélectionnez le module que vous avez téléchargé puis cliquez sur Uploader. Le module est maintenant disponible dans la liste des modules à installer, vous pouvez alors cliquer sur 'installer'.
Voila votre module est installé.


Pour plus d'informations sur les modules, n'hésitez pas à consulter le Forum support des modules
Comment mettre à jour un module ?
Vous serez informé par un message dans votre Panneau d'administration si un module est à mettre à jour.
Pour réaliser la mise à jour, consultez la documentation sur la mise à jour d'un module
Est-il possible d'installer deux fois le même module ?
Non il n'est pas possible de le faire et ce n'est pas prévu, car cela nous pose trop de problèmes techniques et aucune solution simple n'a été trouvée.

Par contre, si vous souhaitez vous lancer dans le développement d'un nouveau module ou adapter un module existant, vous pouvez consulter cet article de la documentation : Dupliquer un module
Je souhaiterais un module mais il n'existe pas, comment le demander ?
Bien sur, vous pouvez demander la création d'un nouveau module. Pour cela rendez vous sur le Forum création de Modules
Faites votre demande en détaillant ce que vous souhaitez : fonctions recherchées, présentation générale, utilisateurs ciblés, etc. Plus vous décrirez correctement ce que vous attendez, plus les développeurs pourront vous renseigner sur la faisabilité de votre demande.

Si votre module est réalisable et qu'il est utile à un grand nombre d'utilisateurs, le développement pourra alors être lancé. Un module peut demander plusieurs semaines de conception entre la partie cahier des charges, le codage, et les nombreux tests à effectuer avant sa mise à disposition. Ne vous attendez donc pas à l'avoir le lendemain :wink
Comment restreindre l'accès à un module à une catégorie de membres ?

C'est très simple, allez dans l'administration / modules / nom_du_module / configuration, et pour chaque module choisissez les rangs des membres pouvant y accéder. Ceux qui n'auront pas accès auront ce message : 'vous n'avez pas le niveau requis'.
J'ai mis les droits à tout le monde pour un module, mais certains membres ont 'vous n'avez pas le niveau requis'. Que faire ?
Les droits des modules se donnent à 2 niveaux :
  • administration / menus / gestion des menus ==> Pour chaque lien de menu présent, vous pouvez modifier le rang minimum pour voir le module. Si on est au rang en dessous, le visiteur aura ce message : 'vous n'avez pas le niveau requis'
  • administration / modules / nom_du_module / configuration : là vous donnez les droits pour les fonctionnalités du module comme par exemple la visibilité d'une catégorie, les droits de modification, d'écriture...
Voici donc comment modifier les autorisation : pensez bien à aller à ces 2 endroits :)
Comment modifier le nom d'un module ?
Vous n'allez pas pouvoir changer le nom du répertoire qui contient votre module, par contre sur le site vous allez pouvoir changer le nom de votre module.
Voici comment procéder:

Il va y avoir 2 cas de figures selon les modules :
  1. Le module peut avoir, via le Panneau d'administration, l'option de changer le nom du module (ex: WIKI)
  2. Pour les autres, cette modification n'est pas réalisable via le Panneau d'administration, il va falloir modifier les fichiers de langue des modules.

Prenons par exemple le module News.
Editez le fichier ../news/lang/french/common.php, puis cherchez la ligne suivante en début de fichier :
$LANG['news'] = 'News';

Remplacez 'News' par le titre que vous souhaitez, sans toucher à la valeur située avant le signe =
Enregistrez votre fichier, la modification sera visible après avoir rafraîchi la page dans votre navigateur.
Comment ne pas afficher le bloc d'un module dans la page principale ?
Il suffit d'aller dans l'administration / contenu / menus et désactiver ceux que l'ont ne veut pas voir, ou bien changer les autorisations selon le niveau de l'utilisateur.
Désactiver ou supprimer un module ?
Vous voulez désactiver un mini-module ?
Dans l'administration, Contenu/Menus/gestion, (/admin/menus/menus.php) vous pouvez désactiver provisoirement un mini-module en cliquant sur cet icône
Le mini-module en question ne sera plus affiché mais sera disponible dans la partie centrale "Menus disponibles". Il restera toutefois installé et il sera possible de le ré afficher en effectuant l'opération inverse.

Vous voulez désactiver un module ?
Dans l'administration, Modules/gestion choisissez "non" dans la rubrique "Activé" en face du module à désactiver puis validez en bas de page. Cette option vous permet de désactiver le module (il n’apparaîtra plus sur votre site) sans perdre les données qu'il contient.

Vous voulez désinstaller un module ?
Il est préférable d'effectuer une sauvegarde des données du module avant cette opération.
Pour désinstaller définitivement un module, rendez-vous dans l'administration, Modules/gestion et choisissez "supprimer" en face du module à supprimer. Dans ce cas, une option vous demandera si vous souhaitez conserver ou non les fichiers du module. Dans les deux cas vous perdrez les données qu'il contient.
Si vous avez choisi "oui" lors de la suppression des fichiers et souhaitez remettre en service ce module, il faudra le télécharger à nouveau en vérifiant sa compatibilité avec votre version de PHPBoost et le réinstaller.

Pour ce type d'intervention, ne faites pas de manipulations à partir de votre ftp sous peine de retrouver votre site en erreur. Le menu d'administration gère parfaitement ces actions.
Articles - Mes articles n'apparaissent pas dans mes catégories. Pourquoi ?
Comme pour les modules, les articles sont accessibles selon les autorisations définies par l'administrateur.

  • la catégorie doit être lisible par le type de membre concerné
  • l'article doit être approuvé, soit lors de sa création, soit par le modérateur ou l'administrateur selon votre configuration de site


Un petit tour sur la doc devrait vous aider: administration du module articles

Voila rien de plus compliqué :)
Forum - Comment créer des forums réservés à certains membres ?
Lors de la création d'un forum (ou de son édition) vous pouvez choisir qui peut y accéder, poster et en assurer la modération.
Vous avez le choix entre les visiteurs / membres / modérateurs / administrateurs et les différents groupes que vous aurez créés.
Forum - J'ai créé une catégorie mais je n'arrive pas à poster dedans. Que faire ?
La gestion du forum est faite ainsi : chaque catégorie peut contenir des forums eux même pouvant accueillir des sous forums, etc.
On peut écrire des messages dans tous les forums, mais pas dans la catégorie.
Donc après avoir créé une catégorie, créez un forum dedans, et ensuite vous pourrez y mettre des posts !

Pour en savoir plus, consultez la documentation sur la gestion des catégories et forums
Galerie - Comment ajouter une grande quantité d'images d'un coup?
Ceci est tout à fait possible:

Envoyez par FTP vos images dans le répertoire /gallery/pics de votre serveur puis classez-les via le Panneau d'administration du module.
Pour plus d'information, consultez la documentation sur l'upload de masse d'images
News - Comment mettre en avant une news ?

Pour mettre en évidence une news, utilisez au mieux les possibilités offertes par le BBCode et ajoutez des photos si besoin.
Si la news propose beaucoup de contenu, pensez à cocher Afficher le condensé de la news et non la news entière dans la configuration du module.
Un lien "[Lire la suite]" sera alors automatiquement ajouté au début du texte (coupure à 128 caractères par défaut).

Pensez également que vous pouvez mettre votre news en tête de page en cochant Placer la news en tête de liste dans la partie Publication accessible en bas de page lors de la création.

La documentation est aussi là pour vous aider : module News
Téléchargements - Comment puis-je proposer un fichier à télécharger ?
L'administrateur du site peut définir qui aura les droits de mettre un fichier en téléchargement en gérant les autorisations du module ou des membres.

Suivez la documentation de ce module pour en savoir plus: téléchargement
Téléchargements - Où dois-je mettre les fichiers à télécharger ?
Les fichiers peuvent être mis n'importe ou sur votre serveur ou sur un serveur externe.
Il est conseillé de créer un répertoire à part sur votre serveur dans lequel vous stockerez vos fichiers, évitez de les mettre dans le dossier download.
Wiki - Comment mettre une table des matières?
Pour créer une table des matières, il suffit de mettre vos titres entre tirets selon le niveau d'organisation voulu.

Attention : L'ordre des titres est à respecter : un Titre niveau 1 doit toujours précéder un Titre de niveau 2 et ainsi de suite.
Code :
-- Titre niveau 1 --

Code :
--- Titre niveau 2 ---

Code :
---- Titre niveau 3 ----

Code :
----- Titre niveau 4 -----

Code :
------ Titre niveau 5 ------


On obtient alors :

wiki_table des matières



Pas bien compliqué et le résultat est assuré !
Wiki - Qu'est-ce que le statut d'un article du wiki et comment le définir ?
Cette fonctionnalité permet de mettre un message en début de l'article, par exemple pour dire que l'article est de qualité, ou alors qu'il est en cours de rédaction, ou qu'il n'est pas terminé, etc.

En général les droits sont donnés aux administrateurs, modérateurs ou à un groupe de rédaction.
Quand vous êtes sur l'article, cliquez sur le bouton 'outils' puis choisissez 'Type d'article' dans la liste déroulante. Vous accéderez à la page : "Gestion des statuts de l'article" dans laquelle vous pourrez définir votre choix.

Pour en savoir plus, vous pouvez consulter la documentation: utilisation du module wiki