Avertissement

Cet article est pour le moment une ébauche permettant aux premiers utilisateurs et contributeurs d’en connaitre l’existence et de permettre des échanges sur ce thème. Il sera amélioré et modifié au fur et à mesure du temps et des échanges...

Télécharger le plugin

Ce plugin est déjà disponible sur la Zone (Spip Zone) ici :

Télécharger le plugin pour SPIP 2.0

Attention à votre version de SPIP ! Pour Spip 1.9.2, télécharger http://files.spip.org/spip-zone/spi...

Démo : pour tester ce plugin en action

Pour tester le plugin en ligne, une version de démo basée sur SPIP 2.0 et SpipBB (>0.5.0) est en ligne : Zone de Démonstration .

Fonctionnalités

 Installation simplifiée « plug&play »
 Utilisation immédiate (ou presque)
 Import de forums PhpBB (v2 et v3)
 Import de forums Phorum (v5)
 Comptage des visites de chaque forum (grâce à une balise spécifique dans le squelette)
 Anti-spam
 Inclusion directe des parties du forum dans le design de votre propre site
 Panneau d’administration (présentation + fonctionnalités)
 Liste des messages par utilisateurs.

Compatibilité

Deux versions du plugin existent :

• une version en cours de développement adaptée à SPIP 2.0
• une version adaptée à SPIP 1.9.2.

N’hésitez pas à nous signaler tout bug ou dysfonctionnement...

Historique

Versions anciennes et à venir :

• 0.1.x : transformation complète (du code existant) en plugin compatible SPIP 1.9.x
• 0.2.x : mise en place de l’interface d’administration
• 0.3.x : intégration des fonctionnalités de GAFoSPIP
• 0.4.x : ajout de fonctionnalités (voir ici SpipBB - GaFoSpip et la gestion de forums avec SPIP) + compatibilité avec spip mutualisé (déjà amorcée en 0.3)
• 0.5.x : nettoyage du code, meilleure sécurisation - séparation pour les différentes versions de SPIP

Idées et objectifs initiaux :

• Reprendre ce qui a déjà était fait pour les version précédentes (spip 1.8 et début pour la 1.9) , le transformer réellement en plugin (une ébauche avait été réalisée).
• Avoir un plugin « simple » qui s’installe « simplement » et quelques clics (du moins à la base) pour les débutants. Plus de fichiers à éditer de rubriques et autres problèmes de mot clés... Tout se gère via l’interface du plugin et des outils associés.
• Nettoyer les squelettes « anciens », très beaux mais il y a des mélanges entre un site spécifique et un squelette standard notamment au niveau des CSS.

Ce qui a été réalisé :

• Plugin « plug and play »
• Gros nettoyage des squelettes (il reste beaucoup de travail)
• Un début d’interface d’administration...
• Un rapprochement avec le travail fait pour GAFoSPIP.

Les auteurs :

Vous trouverez ici la liste plus ou moins complète des contributeurs directs au code et à la présentation, il manque ceux dont on a utilisé une portion de code ou une fonction. Ils sont parfois cités dans le code (sauf omission ou demande des auteurs concernés). Si on vous a oublié, n’hésitez pas à le signaler.

• James aka Kliké http://www.laprise.org/
• BoOz http://bloog.net/
• Nikau http://esprit-str.com/
• Nadège aka Miss Mopi http://www.missmopi.net/
• Stéphane à trouver pour les logos
• Allergie Lien vers l’auteur à vérifier
• Physiquark Lien vers l’auteur à vérifier
• Gurdil
• Scoty
• Chryjs
• Les développeurs de SPIP (le noyau) pour toutes les librairies, l’aide etc.

Utilisation du plugin étape par étape

 Préalable Il s’agit encore d’une version instable du plugin donc :

• ne l’installez pas sur un site en production !
• si vous l’installez, lors de la désinstallation ne vous contentez pas de le désactiver, appuyez sur le bouton de désinstallation (le petit paquet) !!!

 Installation et activation du plugin Comme tous les plugins de SPIP, vous installez « SpipBB » dans le répertoire plugins situé à la racine de votre site SPIP comme indiqué ici sur spip.net. Puis vous vous rendez dans l’espace privé et activez le plugin.

 Configuration initiale Depuis la version 0.2.8, ce plugin n’est plus directement actif. Il faut maintenant passer par la page de configuration qui vous demandera de renseigner certains éléments ou tout au moins de les confirmer (choix par défaut).

 Configuration initiale des forums

1. Pour démarrer la gestion du point de vue de la partie publique, il vous faut au minimum un secteur dédié aux forums (quelles que soient les langues que vous voulez utiliser), prenons par exemple le secteur nº 1 sur le site de démonstration : « Forum de démonstration ». Une fois ce secteur créé, vous pouvez visiter la page de configuration de SpipBB (http://www.monsite.com/ecrire/?exec...) dans laquelle vous sélectionner ce secteur et validez.
2. Dans ce secteur, vous créez au moins une (ou plusieurs) rubrique qui servira de "catégorie". Chaque titre de rubrique est soit à numéroter (sous la forme "10. Mon titre"), soit à numéroter automatiquement en visitant la page "Gestion des forums" dans l’interface d’administration. Ceci permet de les présenter dans l’ordre souhaité. Vous pouvez évidemment choisir différentes langues de publication, qui modifieront notamment le style de la date et les différents affichages spécifiques. Sur le site de démonstration vous trouverez la rubrique "Thèmes" par exemple.
3. Puis, dans cette rubrique, vous créez au moins un article qui sera en fait un forum. Le titre et la description sont repris dans l’affichage. Le titre de chaque forum créé peut (et doit) être numéroté pour permettre un tri en fonction de vos critères. Sur le site de démonstration vous trouverez l’article "Squelette SpipBB" par exemple.
4. Une fois cet article publié (ce forum activé), si vous avez déjà activé les forums dans la configuration principale de SPIP, vous pouvez d’ores et déjà l’utiliser.

Interface d’administration

Accessible soit via le bouton associé au secteur forum, soit par le bouton forum, vous avez accès à un panneau d’administration des forums (encore une ébauche à cet instant), soit dans ecrire/?exec=spipbb_admin_configuration. Vous pourrez :

• activer SpipBB (qui ne l’est pas par défaut) :

• paramétrer SpipBB (une fois activé) :

• y retrouver la synthèse de toutes les informations sur votre forum
• gérer les forums (priorités d’affichage)
• utiliser des outils spécifiques (par exemple import d’une base phpBB)
• activer et gérer l’antispam dans les forums (pour le moment à base de mots clefs)
• une page de "Debug" (qui sera désactivée en version stable).

Paramètres avancés - niveau expert

Il est a priori possible de :
 choisir d’autre squelettes que les squelettes par défaut pour les catégories (groupes) de forums et les fils
 modifier l’interface publique (en créant vos propres squelettes et modèles) et en intégrant les pages des forums (cf documentation sur GafoSPIP)
 choisir ses propres mots clés (et/ou en changer la définition) pour les annonces, postit et messages fermés
 modifier les squelettes de l’interface privée.

Autres plugins requis

• Le plugin spipBB utilise le plugin CFG (qui doit donc être installé). C’est nécessaire (au moment de la rédaction de cet article). Cela permet l’utilisation de certaines fonctions fournies par CFG.
• Le plugin BALISE_SESSION doit être installé si vous utilisez Spip 1.9.2 et le plugin SPIPBB.

Compatibilité avec les autres plugins

Progressivement, nous testons la compatibilité avec d’autres plugins. D’ores et déjà les plugins suivant sont compatible (sauf erreur ou omission) avec le plugin spipBB :

• CFG
• Balise session
• Les Crayons
• Autorité (Les Crayons et Autorités réunis vous permettent d’éditer les messages au sein de SpipBB)
• Mail SMTP
• Langue préférée
• Accès restreint
• Spip-listes
• Mots partout
• SpipClear
• Mutualisation.

Contributions

Il vous est possible de contribuer à ce plugin par le biais de SVN sur SPIP-Zone. Merci de contacter l’équipe avant de contribuer.