Présentation

Le module comments de Copix (utilisé sur ce même site en bas de page), situé dans stable/tools/comments, vous permet de laisser la possibilité à vos internautes de laisser des commentaires sur n'importe quelle page de votre site, simplement en appelant la zone "comment" depuis vos templates.

Fonctionnalités

• Système de captcha activable
• Possibilité d'indiquer les droits nécessaires à la création de commentaire.
• Système de liens direct vers les commentaire
• Modes plié / déplié
• Administration des commentaires
• Possibilité de vérouiller les commentaires.

Paramètres du module

• captcha, valeur par défaut 0
  • Indique si les captcha sont actifs (1) ou non (0). Vous pouvez administrer les captchas en créant vos propres questions.
• aminitemsperpage, valeur par défaut 10
  • Indique le nombre de commentaire que vous voyez simultanéement dans l'écran d'administration des commentaires.

Zone du module

La zone comment est la zone que vous utiliserez dans vos templates lorsque vous souhaiterez laisser la possibilité à vos internautes de commenter les pages de votre site.

Exemple d'appel de la zone dans Smarty

Cette exemple demande à la zone de permettre des commentaires pour la page courante. L'identifiant du commentaire sera construit à partir des informations module, group, action et title de la requête.

required=false permet d'indiquer au tag copixzone de ne pas générer de contenu si le module comments n'est pas installé.

{copixzone process="comments|comment" id="module;group;action;title" required=false}

Paramètre id

Le paramètre id indique les paramètres issus de la requête qui doivent représenter l'identifiant du commentaire.

Vous spécifiez cette liste de paramètre sous la forme d'une chaine séparée par des points virugules ";".

Par exemple

{* utilisera les paramètres module group action et id comme identifiant de commentaire *}
{copixzone process="comments|comment" id="module;group;action;id" required=false}

{* utilisera les paramètres module id et langue comme identifiant de commentaire *}
{copixzone process="comments|comment" id="module;id;langue" required=false}

Si vous le souhaitez, vous pouvez assigner des valeurs par défaut à ces paramètres, simplement avec l'opérateur d'affectation (=) pour le paramètre en question.

Par exemple

{* utilisera les paramètres module group action et id comme identifiant de commentaire 
module aura pour valeur test, action aura pour valeur show. Les autres paramètres utiliseront 
la requête pour déterminer leur valeur. *}
{copixzone process="comments|comment" id="module=test;group;action=show;id" required=false}

{* utilisera les paramètres module id et langue comme identifiant de commentaire 
langue prendra pour valeur la variable $langue. Les autres paramètres utiliseront 
la requête pour déterminer leur valeur.  *}
{copixzone process="comments|comment" id="module;id;langue=$langue" required=false}

Paramètre mode

Ce paramètre peut prendre 3 valeurs :

• list pour afficher la liste des commentaires ainsi que le formulaire d'ajout (si les droits sont suffisants)
• summary pour afficher le nombre de commentaires sur l'élément
• request pour utiliser la valeur du paramètre "comments" de la requête pour déterminer le mode.

Par défaut, le mode est défini à "request", puis, si rien n'est spécifié dans la requête, le mode par défaut est summary.

Paramètre moreUrl

Ce paramètre indique l'url ou doit se rendre l'internaute lorsqu'il clique sur le nombre de commentaires (mode summary uniquement).

Paramètre credentialRead

Indique les droits nécessaires pour pouvoir lire les commentaires.

Dans l'exemple suivant, on indique que seuls les internautes connectés peuvent lire les commentaires.

{copixzone process="comments|comment" id="module;group;action;id" credentialRead="basic:registered" required=false}

Paramètre credentialWrite

Indique les droits nécessaires pour pouvoir écrire un commentaire.

Dans l'exemple suivant, on indique que seuls les internautes connectés peuvent écrire des commentaires.

{copixzone process="comments|comment" id="module;group;action;id" credentialWrite="basic:registered" required=false}