Navigation rapide


HomECOMment [HECOM] (Classe PHP5)

Auteur : Samuel Desnoes

Date de création : 09 04 2005

Version en cours : 2.0 (30 01 2007)

Licence : CC by-sa (Merci de conserver les en-têtes des fichiers sources)

Fonctionnalités

[HECOM] permet d'enregistrer et d'administrer des commentaires sur une page Web très simplement.

[HECOM] n'utilise pas de base de données. Les commentaires sont enregistrés sur le serveur dans des fichiers textes (flatfiles).

NOUVEAU : [HECOM] utilise un système "anti-spam" lors de l'ajout de commentaires

[HECOM] dispose d'une interface d'administration d'une utilisation extrêmement simple(iste ;-)).

 

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 : 523)

Licence

Creative Commons License
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


 

Vos avis sur le script HomECOMment [HECOM]

Commenter...

Merci de respecter les règles élémentaires de la courtoisie et de la communication. Tout message importun sera supprimé sans péavis par l'administrateur...





Les 5 derniers commentaires :

674173 (jfvynms4281rt_at_hotmail_dot_com) le 30/12/2016 17:00

9QkLgq http://www.FyLitCl7Pf7ojQdDUOLQOuaxTXbj5iNG.com

45496 (hldgss_at_imxzca_dot_com) le 17/08/2014 08:38

UsISmY yvktulysxpod, [url=http://rryrwvuzsllp.com/]rryrwvuzsllp[/url], [link=http://bwjjcyintkdr.com/]bwjjcyintkdr[/link], http://svcjrtgconze.com/

test le 08/05/2009 15:17

ertygret


Les commentaires :

674173 (jfvynms4281rt_at_hotmail_dot_com) le 30/12/2016 17:00

9QkLgq http://www.FyLitCl7Pf7ojQdDUOLQOuaxTXbj5iNG.com

45496 (hldgss_at_imxzca_dot_com) le 17/08/2014 08:38

UsISmY yvktulysxpod, [url=http://rryrwvuzsllp.com/]rryrwvuzsllp[/url], [link=http://bwjjcyintkdr.com/]bwjjcyintkdr[/link], http://svcjrtgconze.com/

test le 08/05/2009 15:17

ertygret