HomECOMment [HECOM]

Manuel d'utilisation

Instanciation de classe

Lorsque la classe est instanciée en mode public, tout visiteur peut laisser un/des commentaires. A l'opposé, lorsque la classe est intanciée en mode administration, il est impossible à l'administrateur d'en laisser : ce mode ne sert qu'à valider/supprimer des commentaires.

mode public

$id_variable identifiant objet=new hecom( [url_string_url (réelle ou virtuelle) sur laquel doit être basée l'instance] );

mode administration

$id_variable identifiant objet=new hecomAdmin( [url_string_url (réelle ou virtuelle) sur laquel doit être basée l'instance] );

• Notes :

  • La classe peut-elle être instanciée n'importe où dans la page ? A VOIR
  • Le fichier dans lequel les commentaires seront enregistrés porte l'extension ".hecom".
  • Ce fichier n'a pas besoin d'être créé à l'avance sur le serveur, le script s'en charge.
  • Si vous avez besoin (pour un autre script de la page, par exemple) de récupérer la liste des commentaires, elle sera disponible par la variable $id_variable identifiant objet::liste sous forme d'un tableau ayant la structure suivante :
    array("timestamp_date"=>array("date"=>timestamp_date,"nom"=>string_nom,"mail"=>string_adresse mail,"message"=>string_commentaire))

Affichage

affichage direct_code xhtml $id_variable identifiant objet -> display( [$nombre_int nombre maxi de commentaires à afficher , $true/false_bool_affichage du formulaire d'ajout autorisé] )
Par défaut, le nombre maxi des commentaires à afficher est le nombre total, l'affichage du formulaire est autorisé

Suivant le mode dans lequel a été instanciée la classe, l'affichage sera composé de :

• Mode public

  1. Formulaire d'ajout de commentaires
  2. Liste des messages existants, classés dans l'ordre inverse (les derniers en premier), liste éventuellement limitée au nombre passé en argument à la fonction display()

• Mode Administration

  1. formulaire de changement de type d'affichage
  2. Affichage de la liste avec champs (type radio) de validation/mise en attente/suppression
  3. Bouton de mise en application des modifications

Vous pouvez également afficher ailleurs dans la page (en haut de page, par exemple) le nombre de commentaires déjà effectués en faisant appel à la fonction (résultat_int) $id_variable identifiant objet -> nombreMessages(). (Attention, cette fonction ne renvoie qu'un nombre !)

Mise en page

Le code source est fourni avec une feuille de styles que vous pouvez modifier pour intégrer la classe à votre présentation globale.

Exemple(s) d'utilisation

Avertissement : IL est évident que le fait d'autoriser des utilisateurs multiples à utiliser les fonctions d'administration sur le même fichier peut créer des difficultés d'accès à cette zone de test. Cet accès est surtout destiné à donner un aperçu de l'interface. Si vous souhaitez vrament tester plus en détail les fonctionnalités de cette classe, faites-le sur un serveur où vous serez le seul à accéder à l'administration...

Tester l'espace public de HomECOMment - Tester l'administration de HomECOMment

Télécharger les sources

Lancer le téléchargement (archive au format ".zip" - Nombre de téléchargements : 9402)

Licence

Cette création est mise à disposition sous contrat Creative Commons.

Si vous utilisez régulièrement nos scripts, merci de créer un lien sur vos pages...
http://hometools.free.fr