Get Author’s Comments

Get Author’s Comments est un plugin pour WordPress permettant de récupérer ou d’afficher la liste des commentaires posté par un utilisateur. De nombreuses options sont disponibles offrant entre autres comme possibilités de :

• lister les commentaires d’un utilisateur dans l’article courant.
• récupérer les commentaires qu’une personne a posté dans un article donné.
• afficher les 10 derniers commentaires d’un utilisateur.
• etc.

Afin d’éviter les homonymes, un utilisateur est identifié par son nom et son ou ses adresses e-mails.

En affichage direct, Get Author’s Comments produit des items de liste (<li>). Il se base en effet sur la fonction wp_list_comments qui a été introduite dans la version 2.7 de l’API de WordPress.

Table des matières

1. Téléchargement
2. Installation
3. Exemples d’utilisation
4. Liste des paramètres
5. Tâches à faire
6. Historique des versions et changelog

Téléchargement

Vous pouvez également vous rendre sur la page WordPress.org du plugin ou lancer son téléchargement et installation directement depuis l’interface d’administration de votre WordPress.

Installation

Get Author’s Comments s’installe en 3 étapes :

1. Téléversez le répertoire get_authors_comments dans votre répertoire /wp-content/plugins/.
2. Activez le plugin Get Author's Comments via le menu Extensions du pannel d’administration de WordPress.
3. Utilisez-le dans votre thème :

1
2
3
4
5

<?php if (function_exist('ppm_author_comments')): ?>
    <ol>
        <?php ppm_author_comments('nom', 'email', 'post_ID', 'args'); ?>
    </ol>
<?php endif ?>

Exemples d’utilisation

Afficher les commentaires d’un utilisateur postés dans l’article courant

1
2
3
4
5

<?php
    <ol>
        <?php ppm_author_comments('piouPiouM', 'foo@example.com'); ?>
    </ol>
?>

Ou, si l’utilisateur piouPiouM a écrit avec 2 adresses e-mails différentes :

1
2
3
4
5

<?php
    <ol>
        <?php ppm_author_comments('piouPiouM', array('foo@example.com', 'bar@example.org')); ?>
    </ol>
?>

Afficher l’intégralité des commentaires posté par un utilisateur sur le site

1
2
3
4
5

<?php
    <ol>
        <?php ppm_author_comments('piouPiouM', 'foo@example.com', null, 'all=1'); ?>
    </ol>
?>

Lister les commentaires rédigés par un utilisateur dans l’article ayant 9 pour identifiant

1
2
3
4
5

<?php
    <ol>
        <?php ppm_author_comments('piouPiouM', 'foo@example.com', 9); ?>
    </ol>
?>

Note :
Si vous utilisez les fonctions ppm_author_comments ou ppm_get_author_comments à l’intérieur de la boucle, l’argument $postID sera remplacé automatiquement par l’identifiant numérique de l’article courant s’il n’était pas renseigné ou défini à null.

Afficher les derniers commentaires d’un utilisateur, ordonnés par post_ID

Le code qui suit sert à lister les 10 derniers commentaires de piouPiouM, ordonnés par post_ID ascendant, et affichera la date et l’extrait des commentaires concernés.

1
2
3
4
5
6
7
8
9
10
11
12

<?php
    $comments = ppm_get_author_comments('piouPiouM', 'foo@example.com', null, 'number=10&order=ASC&orderby=post_id');
    foreach ($comments as $comment):
?>
<p><cite><?php comment_author_link() ?></cite> à dit&nbsp;:</p>
<ol>
    <li>
        <p>Commentaire posté le <?php comment_date('n-j-Y'); ?>:<br/></p>
        <p><?php comment_excerpt(); ?></p>
    </li>
</ol>
<?php endforeach; ?>

Commentaires avec un affichage personnalisé

1
2
3
4
5

<?php
    <ol>
        <?php ppm_author_comments('piouPiouM', 'info@example.com', null, 'callback=mytheme_comment'); ?>
    </ol>
?>

Se reporter à la page Comments Only With A Custom Comment Display pour un exemple d’utilisation de la fonction de callback.

Afficher un compteur des commentaires posté par l’utilisateur identifié sur le site

1
2
3
4
5
6
7
8
9
10
11
12

<?php
    get_currentuserinfo();
    $comments = ppm_get_author_comments($current_user->display_name, $current_user->user_email, null, 'all=1');
    printf('Hello <a href="/author/%s/">%s</a>&nbsp;! '
         . '[ <a href="%s" class="logout">Déconnexion</a> ]<br/>'
         . '%d articles and %d commentaires',
        $current_user->user_login,
        $current_user->display_name,
        wp_logout_url(),
        get_usernumposts($current_user->ID),
        count($comments));
?>

Produira le code HTML :

1
2

Hello <a href="/author/piouPiouM/">piouPiouM</a>&nbsp;! [ <a href="http://www.example.com/wp-login.php?action=logout&amp;_wpnonce=xxxxxxxxxx" class="logout">Déconnexion</a> ]<br/>
12 articles and 35 commentaires

Afficher un compteur de commentaires pour un utilisateur donné. Source : La Lune Mauve.

Liste des paramètres

Voici la liste des paramètres acceptés par le 4^ème argument $args des fontions ppm_get_author_comments et ppm_author_comments :

all
(boolean) (optionnel) Récupérer tous les commentaires. Par défaut à FALSE.

number
(integer) (optionnel) Le nombre de commentaires à retourner. Par défaut à None, retourne tous les commentaires.

offset
(integer) (optionnel) Numéro de commentaire à partir duquel la recherche sera effectuée. Par défaut à 0.

orderby
(string) (optionnel) Ordonner les commentaires par l’une ou plusieurs des valeurs qui suivent (séparées par un espace) :

• 'comment_ID' - Trier numériquement par l’ID des commentaires.
• 'content' - Trier suivant le contenu.
• 'date' - Trier selon la date de création. (Par Défaut)
• 'post_ID' - Trier numériquement par l’ID des articles.
• 'rand' - Trier aléatoirement.
• 'status' - Trier par statut.
• 'type' - Trier par type.

order
(string) (optionnel) Ordre de tri. Les valeurs valides sont :

• 'ASC' - Croissant (du plus petit au plus grand).
• 'DESC' - Décroissant (du plus grand au plus petit). (Par défaut)

output
(string) (optionnel) Le format de sortie. Seulement pour ppm_get_author_comments.

• OBJECT - Retourne un objet. (Default)
• ARRAY_A - Retourne un tableau associatif (nom des champs => valeurs).
• ARRAY_N - Retourne un tableau indexé numériquement de la valeur des champs.
• HTML - Retourne une version (x)HTML générée par la fonction wp_list_comments.

status
(string) (optionnel) Les statut des commentaires. Par défaut à « en attente » et « approuvé ». Valeurs valides :

• 'hold' - En attente de validation.
• 'approve' - Approuvé.
• 'spam' - Indésirable.

Tâches à faire

Fonctionnalités en attente de développement.

• Tester la prise en charge de la pagination.

Historique des versions et changelog

1.1.0

• Ajout du paramètre all permettant de récupérer tous les commentaires d’un utilisateur.
• Ajout du changelog et de nouveaux exemples d’utilisation.

1.0.1

• Les paramètres de $args sont désormais non sensibles à la casse.
• Support de 2 nouveaux paramètres de tri : comment_ID et post_ID.
• Définit par défaut le tri par date.

1.0.0

• Version initiale.