BeamReactor — Module guestbook (Livre d'or) #

Version : 5.2.0

Auteur : Treveur Bretaudière

Depuis : 2002

Dernière mise à jour : 2026-02-11

Le module guestbook est un livre d'or permettant aux utilisateurs de laisser des messages publics. Il inclut la modération, la protection anti-flood, la validation des entrées, et la pagination.

• La table guestbook doit exister en base (vérification via sql_table_exists()).
• Accès de niveau GUESTBOOK_LEVEL_USER pour poster.
• Accès de niveau GUESTBOOK_LEVEL_MODERATOR pour supprimer.
• Classes Beamreactor\Database\SQL et Beamreactor\Sanitizer\Parser.

Table : guestbook

| Champ | Description |

|---|---|

| id | Identifiant unique (auto-increment) |

| name | Nom de l'auteur |

| email | Adresse email |

| website | Site web (optionnel) |

| country | Pays (sélection depuis une liste statique) |

| message | Contenu du message |

| time | Date de publication |

| ip | Adresse IP (via ipCheck()) |

Anti-flood #

Avant tout traitement, le module vérifie la dernière entrée depuis la même IP. Si moins de 10 secondes se sont écoulées, un message est affiché et le module fait return.

Suppression (modération) #

Un utilisateur de niveau GUESTBOOK_LEVEL_MODERATOR peut supprimer une entrée via le paramètre GET gbdelentry. Confirmation JavaScript côté client.

Ajout de message #

Le formulaire est affiché si l'utilisateur a le niveau GUESTBOOK_LEVEL_USER. L'action d'ajout est déclenchée quand le submit correspond à $dialgb[16].

| Champ | Contrôle |

|---|---|

| name | Obligatoire, Parser::sanitize($str, 'string', maxLength: 40) |

| email | Obligatoire, sanitisé via Parser::sanitize($str, 'email'), validé via Parser::check() |

| website | Optionnel, Parser::sanitize($str, 'string', maxLength: 120), valeur 'none' traitée comme vide |

| country | Obligatoire, doit différer de la valeur par défaut du select ($dialgb[6]) |

| message | Obligatoire, minimum 10 caractères, Parser::sanitize($str, 'string', maxLength: 1000) |

Le formulaire pré-remplit l'email depuis la session et conserve les valeurs saisies en cas d'erreur.

Affichage des messages #

Messages affichés par ordre décroissant d'ID, 10 par page. Chaque entrée montre le nom, le lien site web (si présent, préfixé http://), le pays, la date, et le message. Le lien de suppression [X] n'apparaît que pour les modérateurs.

Pagination #

Paramètre GET gbpage. Navigation précédent/suivant.

Le module embarque une liste statique d'environ 250 pays/territoires dans un tableau PHP $countries, incluant quelques entrées non-standard (Armor Breizh, Catalunya, Corsica, Scotland, les océans).

| Constante | Rôle |

|---|---|

| GUESTBOOK_LEVEL_USER | Niveau minimum pour poster |

| GUESTBOOK_LEVEL_MODERATOR | Niveau minimum pour supprimer |