Avertissement
Cet article est pour le moment une ébauche permettant aux premiers utilisateurs et contributeurs d’en connaître 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 :
Démo : pour tester ce plugin en action
Pour tester le plugin en ligne, une version de démo basée sur SPIP 1.9.3 et SpipBB (>0.3.0) est en ligne : Zone de Démonstration .
NB : Attention l’"ancien" site de démonstration sera bientôt fermé.
Fonctionnalités
Installation simplifiée « plug&play »,
Utilisation immédiate (ou presque),
Import de forums PhpBB,
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.
Compatibilité
A priori ce plugin est développé pour SPIP 1.9.3 (SVN à l’heure actuelle). Toutefois il devrait être compatible avec SPIP 1.9.2 . Si tel n’était pas le cas, 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
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
- 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.
- 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.
- 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.
- 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 SPIPBB à partir de la version 0.3.0.
Fonctionnalités envisagées - TODO
Panneau d’administration (présentation + fonctionnalités)
Meilleur affichage des profils utilisateurs
Liste des messages par utilisateurs
Utiliser les mots-clés
RSS 2.0