1. Présentation 

Ce script constitue un module supplémentaire pour GuppY.
Certaines variables et fonctions ne fonctionnent qu'avec l'architecture de GuppY :
il n'est donc pas question d'utiliser ce module avec d'autres CMS. 
ATTENTION! CETTE VERSION NE PEUT FONCTIONNER QU'AVEC LES VERSIONS 4.6.10 ET SUPERIEURES DE GUPPY

 2. Fonctionnement 

Ce module vous permet de proposer un forum différent de celui livré par GuppY.
C'est un module total, indépendant de la version du GuppY, sauf modification profonde du CMS.
En fait, c'est un plork, un plugin-fork, car vous devrez écraser un fichier GuppY pour que le module fonctionne correctement:
inc/includes.inc et le remplacer par celui contenu dans le plug-in dans le dossier /inc.
Quand vous mettrez à jour votre GuppY, pensez donc à forker de nouveau ce fichier.
Une bonne méthode consiste à renommer le fichier original en includes_original.inc
avant d'installer dans le même repertoire le fichier includes.inc provenant du FORUM C6.

Les points forts de C6 FORUM:

I - PARTIE VISITEURS

Dans "fortopic" (page avec les catégories de forums)

A - une nouvelle barre de navigation (entièrement "skinnable" au niveau des images), permettant:
1 - une recherche sur le forum toujours disponible, ainsi qu'une recherche avec Google
2 - l'affichage du nombre de personnes connectées sur le forum et sur le site
3 - icônes indiquant l'état de chaque forum - nouveau message, message de + de x jours et de moins de x jours,
sujet clos et pas de sujet. C'est le webmestre qui détermine le nombre de jours pour qu'un message soit clos,
le nombre de jours pour les messages de + ou - x jours et enfin, le temps de présence pendant lequel un message
doit être considèré comme nouveau. Tout est paramétrable.

B - l'apparition de commentaires pour chaque forum, pour préciser le contenu de chaque forum aux visiteurs

C - l'éventuelle création dans "fortopic" d'une section "PRIVEE", dont vous aurez déterminé les droits d'accès
et d'une section "MEMBRES" réservée aux membres et inaccessible aux simples visiteurs."

Dans "forum" (page avec les sujets d'un forum)

A - une nouvelle barre de navigation permettant :
1 - d'aller de forum en forum
2 - de classer les messages d'un sujet par ordre de préférence
3 - d'aller d'un sujet à l'autre à l'intérieur d'un même forum
4 - d'afficher le nombre de personnes connectées sur le forum et non pas sur le site
5 - au visiteur de prendre connaissance du réglement de votre forum (si vous l'avez souhaité dans la config générale)
6 - d'avoir une recherche sur le forum toujours disponible
7 - d'obtenir une aide sur les icônes du forum, toujours disponible
8 - d'afficher si besoin une barre de navigation entre sujets
(une barre de navigation peut aussi apparaît également en bas de page selon le nombre de messages ou de sujets)


B - des icônes indiquant l'état de chaque forum - nouveau message, message de + de x jours et de moins de x jours,
sujet clos et pas de sujet

C - une indication de présence d'un membre et possibilité de lui adresser un message ou de l'inviter à un chat privé
si les deux sont membres

D - une icône indiquant si vous avez ou non pris connaissance de tous les messages d'un sujet, avec éventuellement
le nombre de messages non lus


Dans "thread" (sujet ouvert avec messages)

A - une même barre de navigation que sous "forum" (page avec les sujets d'un forum)
B - une indication de présence d'un membre et la possibilité de lui adresser un message ou de l'inviter à un chat privé
si les deux sont membres
C - pour les membres rédacteurs, la possibilité de modifier leurs messages
C - pour les modérateurs, la possibilité de modifier tous les messages et éventuellement d'en supprimer, sans repasser par l'admin

II - MEMBRES

A - Les membres peuvent maintenant changer de pseudo sans perte de leurs mini-messages, ni de leur compteur de messages
B - Les membres peuvent accéder à la liste des autres membres, connaître leur site, leur envoyer mails ou mini-messages,
même s'ils ne sont pas connectés.
C - Les membres peuvent communiquer entre eux sur le site par un chat privé.
D - Les connexions se font par SESSIONS, sauf pour le membre à choisir une reconnaissance éventuelle par cookie aussi.
Ainsi, il peut choisir de se connecter au site par cookie à partir de son ordinateur personnel ou par session,
en entrant pseudo et mot de passe, quand il est au cybercafé.

III - PARTIE ADMINISTRATION

L'administrateur peut désormais :
1 - choisir le nombre de forums
2 - autoriser le choix d'un avatar autre que ceux par défaut. Il faudra alors paramètrer les conditions d'upload de l'avatar en taille et poids.
car l'avatar personnel sera contrôlé et ensuite enregistré sur le site. Donc, plus de forum déformé parce qu'il est indisponible sur un site distant.
3 - opter pour un forum avec notation, ou sans. Il faudra alors paramètrer le système de notation : nombre de message,images-symboles ...
4 - opter pour un système de chat entre membres.
5 - bloquer à tout moment les inscriptions, les connexions
6 - mettre le titre de la boîte centrale forum et les liens à plat (si vous avez une skin avec des images,
la boîte de titre du forum risquait d'être déformée)
7 - afficher (ou non) un Layer pour inciter les inscriptions comme membre
8 - afficher ou non le règlement interne du forum
8 - récupérer les anciens membres (GuppY)
9 - autoriser l'insertion d'images dans le forum. Il faudra alors paramètrer les conditions d'upload de l'image en taille et poids.
10 - autoriser l'envoi de pièces jointes et la récupération de ces pièces par tous les visiteurs.
Ces pièces seront compressées et l'archive contenue dans le zip sera au format ".txt"
11 - attribuer à chaque membre des droits d'accès spécifiques
et bien sûr plein d'autres choses, comme l'impression des messages, la création d'un fil RSS des posts du forum,
le choix des emails de supervision, l'affichage d'une boite membre très complète ...

et surtout l'accès à toute la documentation du plugin à partir de la zone administration. La grande nouveauté, c'est l'accès, pas la doc.
Parce que tous mes plugins sont toujours équipés d'une bonne documentation.
Et qu'il est important de souligner son existence et d'encourager sa consultation.

 3. Première installation 

Ce paragraphe vous explique comment installer ce script sur votre GuppY (deux méthodes d'installation sont possibles).

1. Méthode classique : Décompressez le fichier forum.zip avec votre programme de décompression favori (WinZip, UltimateZip...),
dans le même répertoire que celui dans lequel se trouve GuppY sur votre PC.
Méthode Gestplug : Ce Plug-In est totalement compatible avec Gesplug : ,
vous pouvez fort bien aussi l'installer à partir de l'administration de votre GuppY.
" Plugnico " et " Gestplug " étant déjà installés sur votre GuppY, rendez-vous dans votre zone d'Administration
et lancez votre module Gestplug afin d'Uploader votre fichier .zip.
2 - Dans votre zone "administration" l'icône s'est tout naturellement positionnée en bas. 

3 - Cliquez sur l'icône. Vous avez alors à votre disposition 8 icônes.

a) - Configuration générale : qui vous permettra de configurer complètement votre plug-in et la boîte qui l'accompagne.
b) - Catégories : vous avez dans cette partie déjà les catégories qui figuraient dans votre guppy, vous pouvez en ajouter d'autres, modifier, supprimer.
c) - Gestion des membres : Vous pourrez y gérer tous les membres: modification, suppression, attribution de droits d'accès.
d) - Gestion des évènements : Pour faire apparaître des images aléatoires dans les forums en fonction d'évènements dont vous fixez les dates.
e) - Gestion du forum : Pour gérer les sujets du forum et leurs réponses. C'est un lien vers la fonction classique du GuppY,
puisque C6 Forum utilise les datas de GuppY.
f) - Module dans la barre : Pour faire apparaître ce module dans la barre du haut. Un check box et ... valider 
g) - Update : qui vous permettra de savoir si vous avez bien la dernière version de ce plug-in.
h) - Documentation : accès à toute votre documentation. Pratique quand on installe le fichier zippé avec Gestplug et qu'on n'a pas regardé du tout le lisez-moi !

BRAVO, le module C6 FORUM est prêt à fonctionner !


 4. Mise à jour 
Pour mettre à jour le plugin forum, sauvegardez le dossier plugins/data puis réinstallez-le une fois terminée l'installation de la nouvelle version.


 REMARQUES IMPORTANTES 

N'oubliez pas de positionner par "config boîte" la "boîte membre" dans une colonne latérale. Sans elle, votre C6 FORUM ne fonctionnera pas.
Dans Config Services, décochez la case Section forum pour désactiver le forum GuppY.
Pour afficher les derniers posts du forum en page d'accueil, choisissez de placer la boite C6forum live.
La boîte forum classique du Guppy ne vous mènerait pas aux bons liens.

Voici comment mettre en place les droits sur les fichiers pour les serveurs internet qui le nécessitent (pas tous).

1. CHMOD plugins/forum/data 755 ou 777
2. CHMOD plugins/forum/data/ tous les fichiers 666
3. CHMOD plugins/forum/avatars_membres 755 ou 777
4. CHMOD plugins/forum/pj 755 ou 777

Que dire de plus ????
Amusez vous bien. 

Nicolas

v1.0 (08 Novembre 2005) : 

Première réalisation

 v1.1 (12 Novembre 2005) : 

Correction du fichier plugins/forum/plugin.inc, dans lequel j'avais mis la variable langue, alors que GuppY la donne par défaut dans les liens de barre du haut
Reprise du fichier tinymsg.php de GuppY pour l'ajouter au plug-in.
La création d'un avatar externe, entraînait une erreur d'affichage, car chemin de l'image inconnu par GuppY.
Correction du fichier plugins/forum/login.php
Ai ajouté la suppression des avatars externes, si le membre supprime ses préférences.
En cas de modification des préférences, si le membre changait uniquement dans son pseudo des lettres majuscules en majuscules, ou l'inverse, son fichier était alors supprimé, au lieu d'être modifié.
La fonction rename(); étant quelques fois absente sur certain site, j'ai été obligé de passer par des phases de copy(); suppression; copy(); suppression, pour palier ce problème

 v1.2 (13 Novembre 2005) : 

Correction du fichier plugins/forum/plguser.php
L'avatar externe était partiellement pris en compte, lorsqu'on ne choisissait pas d'avatar, ce qui entraînait un problème d'affichage sur le forum
Ai également ajouté un contrôle supplémentaire dans plugins/forum/thread.php pour que l'affichage ne pose plus de problème.

 v1.3 (17 Novembre 2005) : 

Correction du fichier plugins/forum/olduser.php, qui ne s'affichait pas correctement
Correction d'un problème dans la notion de groupe, qui était automatiquement attribuée à un visiteur si celui-ci avait le même pseudo qu'un membre
Correction de fichiers, qui interdisaient l'accès au forum si le websmaster avait opté pour une gestion membre. Il était alors impossible de s'inscrire et même de récupérer son login par mail
Introduction d'un chat privé entre deux membres

 v1.4 (25 Novembre 2005) : 

1 - Correction mineure apportée au fichier inc/bosplgforum.inc.
Si le Webmaster choisissait de recevoir un mail par php, le chemin était webmail.php qui n'existe plus.
(Merci à Okarina de m'avoir signalée ce problème)
2 - Correction de la notion groupe membre, qui affichait "Membres" alors qu'à l'inscription cette notion était automatiquement "Membre" (sans "s").
La correction peut se faire dans la zone admin membre
3 - Le Webmaster peut maintenant autoriser ou non l'impression des messages aux seuls membres ou à l'ensemble des visiteurs
L'impression des sujets peut se faire : sujet avec les réponses ou message par message
4 - Propagation sur le plug-in forum du message informant les visiteurs en cas de demande de chat.
5 - Ai aussi déplacé certaines icônes, pour donner un peu plus de lisibilité au forum.
6 - Correction de l'affichage des messages dans la boite centrale forum du site. Si des messages privés étaient présents, le décompte du nombre de messages à afficher était de config webmaster - messages privés .Ce qui pouvait donner un affichage totalement vide. (Merci à Laurent_P de m'avoir signalé ce souci)
7 - A compter de cette version, les fichiers joints avec les messages, ne sont plus transformés au format .TXT, dès lors que le type de fichier est un fichier image
Aussi les visiteurs qui téléchargeront de telles archives auront bien aune image et non plus un fichier .TXT à transformer au bon format

 v1.5 (29 Novembre 2005) : 

1 - Correction du fichier de gestion des membres.
En cas de suppression d'un membre, seule sa fiche était supprimée, rendant une nouvelle inscription impossible avec le même pseudo, puisque celui-ci restait présent dans la base des membres
(Merci à Laurent_P. de m'avoir signalé ce problème)
2 - Correction du fichier d'impression des sujet qui affichait une erreur dans le décompte des réponses
La première réponses faisant apparaître "réponse n°2 au lieu de réponse n° 1
3 - Ai ajouté la possibilité d'offrir en téléchargement les sujets avec les réponses
Bien sûr il vous appartient d'activer ou non cette possibilité dans la zone config générale du plug-in forum
Les fichiers au format ZIP, sont crées automatiquement et uniquement à la demande
4 - Corrections mineures dans les fichiers langues

 v1.6 (06 Décembre 2005) : 

1 - Correction pour la seconde fois ??? du fichier poste.php, qui empêchait l'affichage du textarea dans le cas ou l'administrateur ou un membre autorisé voulait modifier un message déjà saisi.
(Merci à Laurent_P. de m'avoir signalé ce problème)
2 - Correction du fichier postguest pour faire apparaître les images dans le corp du message reçu par mail par l'administrateur du site
3 - Correction du fichier désactivé qui renvoyait un erreur dans la barre de navigation
4 - Suppression d'une ligne dans le fichier plugins/forum/hpage.inc, qui faisait appel à un script javascript, que je n'ai finalement pas mis en place et qui antraînait une erreur d'afficahege javascript
3 - Introduction d'un javascript dans le fichier plugins/forum/hpage.inc, pour une meilleure lisibilité de la barre de navigation
4 - Correction du nombre de messages à lire, qui affichait 1 message à lire quand le rédacteur avait posté une réponse

 v1.7 (30 Janvier 2006) : 

1 - Possibilité de gérer des évènements particulier comme Noël, le jour de l'An ou tout autre évènement, au moyen d'images qui apparaîtront en bas des messages postés
Il vous suffit de configurer la nouvelle partie "Gestion évènements" dans la zone d'administration de ce plug-in.
2 - Introduction de forum réservés exclusivement aux membres
Vous pourrez donc avoir tout à la fois un ou des forums ouverts à vos visiteurs, un ou des forums ouverts uniquement à certains membres et enfin un ou des forums ouverts uniquement à vos membres.
Pour cela il vous suffira d'ajouter "fm" devant l'id du forum dans "Catégories"
3 - Quelle que soit l'image utilisée comme fond, pour la barre de navigation, elle s'adaptera maintenant automatiquement, sans avoir à toucher aux codes du fichier func_nav.php

 v1.8 (02 Mai 2006) : 

1 - Ai ajouté la fonction stripslashes(); aux messages du chat, pour enlever les slashs dans les textes des messages
2 - Ai ajouté la possibilité d'envoyer un même mini-message à plusieurs destinataires, même si ceux-ci sont absents
3 - Ai ajouté le choix pour le visiteur de demander à ce que son pseudo et mot de passe soient conservés, de manière à être reconnu à chaque connexion au moyen d'un cookie
4 - Ai ajouté la possibilité d'avoir les forums en format standard RSS pour publication sur un autre site web, des 20 derniers messages des forums.

 v2.0.4610 (01 Avril 2010): 

1 - Adaptation du forum à GuppY 4.6.10 (et supérieur)
2 - Mise en conformité avec PHP 5

 v2.1.4613 (22 mai 2010): 

1 - Stabilisation du Chat
2 - Fiabilisation des skins
3 - Modification de la Nicobarre (en particulier pour régler le problème d'édition des puces et des listes numérotées)
4 - Contrôle de la présence de l'includes.inc adapté et affichage d'un message d'erreur si ce n'est pas le cas.

 

Historique des versions
v1.0 (05 Decembre 2008) :

Première réalisation

---

Releases history

v1.0 (05th december 2008) :

Initial release

1. Présentation

Ce script constitue un module supplémentaire pour GuppY.
Certaines variables et fonctions ne fonctionnent qu'avec l'architecture de GuppY : il n'est donc pas
question d'utiliser ce module avec d'autres CMS.


2. Fonctionnement

Google Translator, va vous permettre de faire traduire de manière automatisée votre site en plusieurs langues par Google.
Vous pourrez choisir de faire apparaître ou non les drapeaux dans une boîte.
Ce plugin est livré avec 7 jeux de drapeaux différents, que vous pourrez choisir et visualiser dans la partie configuration générale.
Pour activer et configurer correctement ce plug-in, il vous faut choisir dans la zone de configuration générale de ce plug-in :
a - le nom attribué à la boîte Google Translator
b - de cacher ou non la boîte de ce plug-in
c - le design des drapeaux et les drapeaux à afficher
d - le nombre de drapeaux par ligne
Enfin, sachez que pour revenir à la page de votre site, il vous suffira de cliquer sur le dernier drapeau (celui du langage de votre site).

Simple, non ????

3. Première installation

Ce paragraphe vous explique comment installer ce script sur votre GuppY.

1. Décompressez le fichier googletranslate.zip avec votre programme de décompression favori (WinZip, UltimateZip...), dans le même répertoire que celui dans lequel se trouve GuppY sur votre PC.

2 - Dans votre zone "administration", l'icône Google Translator   s'est tout naturellement positionnée en bas.

3 - Cliquez sur l'icône.

4 - Donnez un nom à votre nouvelle boîte


BRAVO, le module Google Translator est prêt à fonctionner !



La présence de cette image   dans les plugins que vous aurez téléchargés indique que ceux-ci peuvent être installés et désinstallés avec GestPlug, ce qui est le cas de Google Translator.
Attention, il existe une restriction, l'hébergeur français Free et peut-être d'autres hébergeurs interdisent la destruction de répertoires par une commande PHP.
Avec ces hébergeurs, GestPlug ne fera que vider vos répertoires de leurs fichiers et vous devrez utiliser une commande FTP pour détruire vos répertoires.

REMARQUES IMPORTANTES

Pour activer ce plugin, rendez-vous dans admin puis config boîtes.
Il vous reste à sélectionner "boîte Google Translator" et à enregistrer votre nouvelle configuration. Sous GuppY 4.6x, cette opération est à effectuer pour chaque skin sous laquelle vous désirez afficher Google Translator.

REMARQUES IMPORTANTES

Le répertoire PLUGNICO doit être installé à la racine de votre GuppY pour que fonctionne Google Translator. La librairie de fonctions Plugnico peut être téléchargée sur le site de Stockastuces.

"CHMOD" :

Voici comment mettre en place les droits sur les fichiers pour les serveurs internet qui le nécessitent (pas tous).

1. CHMOD plugins/google_translate/data/"tous les fichiers à 666
2. CHMOD plugins/google_translate/data 755

Que dire de plus ????
Amusez vous bien.

Nicolas

v1.0 (03 Avril 2007) :

Première réalisation

v2.0 (19 Novembre 2008) :

1 - Modification du code PHP et "nettoyage" de celui-ci pour le rendre compatible avec PHP5
2 - Certains hébergeurs comme free.fr, n'autorisent pas la suppression de dossier, ce qui renvoie et affiche une erreur ddans la partie admin désinstallation
j'ai donc modifié le script pour :
a) - qu'il n'y ait plus de message d'erreur
b) - pour que les dossiers non supprimés et semblant vides s'affichent en dessous des éléments à supprimer

1. Présentation

Ce script constitue un module supplémentaire pour GuppY.
Certaines variables et fonctions ne fonctionnent qu'avec l'architecture de GuppY : il n'est donc pas
question d'utiliser ce module avec d'autres CMS.

2. Fonctionnement

Ce plug-in va vous permettre de décompresser sur votre site les plug-ins (c'est-à-dire : installer directement les plugins sur votre site à partir d'un fichier au format zip)
et de désinstaller un plug-in dont vous ne voulez plus.
Pour sa fonction de désinstallation, il saura supprimer tous les fichiers du plug-in, à une condition et une seule, il faut que les dossiers du plug-in que vous voulez supprimer, soient situés
1 - Dans la partie admin/plugins.
2 - Dans le dossier plugins, qui se trouve à la racine de votre site.
Ce qui veut dire qu'avec GESTPLUG, mes plug-ins seront complètement installés et/ou supprimés et que ce sera le cas pour la plupart des plug-ins distribués.


3. Première installation

Ce paragraphe vous explique comment installer ce script sur votre GuppY.

1. Décompressez le fichier gestplug.zip avec votre programme de décompression favori (WinZip, UltimateZip, Winrar...),
dans le même répertoire que celui dans lequel se trouve GuppY sur votre PC.

2 - Dans votre zone "administration", l'icône   s'est tout naturellement positionnée en bas.

4 - Cliquez sur l'icône.
Vous avez alors à votre disposition 4 icônes.
1 - Upload : qui donne accès à la zone de téléchargement, qui vous permet d'uploader vos fichiers au format zip et d'installer automatiquement vos plug-ins
2 - Désinstallation : pour pouvoir supprimer complètement un plug-in.
Pour désinstaller un plug-in, il vous suffira de cliquer sur son icône.
S'ouvrira alors une page, où il vous sera demandé de confirmer votre choix, de manière à éviter les fausses manoeuvres
3 - Update : qui vous permettra de savoir si vous avez bien la dernière version de ce plug-in.
4 - Licence: : Pour lire la licence GNU GENERAL PUBLIC LICENSE livrée avec ce plugin.

BRAVO, le module GestPlug est prêt à fonctionner !


La présence de cette image  dans les plugins que vous aurez téléchargés indique que ceux-ci peuvent être installés et désinstallés avec GestPlug.
Attention, il existe une restriction, l'hébergeur français Free et peut-être d'autres hébergeurs interdisent la destruction de répertoires par une commande PHP.
Avec ces hébergeurs, GestPlug ne fera que vider vos répertoires de leurs fichiers et vous devrez utiliser une commande FTP pour détruire vos répertoires.

REMARQUES IMPORTANTES

Remarque "CHMOD" : CHMOD 777 pour le répertoire admin/plugins/gestplug/tmpupload

Que dire de plus ????
Amusez vous bien.
Nicolas