WordPress jQuery UI Effects est un plugin pour WordPress permettant d’enregistrer et de charger les composants JavaScript de la librairie jQuery UI Effects.

Ce ne sont pas moins de 14 effets que vous pourrez utiliser dans vos développement de plugins ou dans la personnalisation de vos thèmes : Blind, Clip, Drop, Explode, Fold, Puff, Slide, Scale, Bounce, Highlight, Pulsate, Shake, Size et Transfer.

Table des matières

1. Téléchargement
2. Installation
3. Foire aux questions
   1. Comment utiliser ce plugin ?
   2. Comment déclarer un script dépendant de l’effet jQuery UI Effect Highlight ?
   3. Comment trouver la liste des gestionnaires disponibles ?
   4. La librairie jQuery UI est-elle nécessaire au fonctionnement de jQuery UI Effects ?
4. Développement
5. Historique des versions

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

WordPress jQuery UI Effects s’installe en 3 étapes :

1. Téléversez le répertoire wp-jquery-ui-effects et son contenu dans votre répertoire /wp-content/plugins/.
2. Activez le plugin WordPress jQuery UI Effects via le menu Extensions du panel d’administration de WordPress.
3. C’est tout

Foire aux questions

Comment utiliser ce plugin ?

Pour charger l’effet Bounce dans votre thème ou un plugin, utilisez la méthode wp_enqueue_script :

1
2
3
4
5
6
7
8

<?php
function my_init_method()
{
    wp_enqueue_script('jquery-ui-effects-bounce');
}
 
add_action('init', 'my_init_method');
?>

WordPress chargera¹ l’effet jQuery UI Effects Bounce et, si besoin est, ses dépendances : jQuery et jQuery UI Effects Core.

Comment déclarer un script dépendant de l’effet jQuery UI Effect Highlight ?

Déclarez et chargez en toute simplicité un nouveau script dépendant de jQuery UI Effect Highlight :

1
2
3
4
5
6
7
8
9

<?php
wp_enqueue_script(
    'my-script',
    get_bloginfo('template_url', 'raw') . '/js/my-script.js',
    array('jquery-ui-effects-highlight'),
    '1.0',
    true
);
?>

Comment trouver la liste des gestionnaires disponibles ?

Préfixez le nom de l’effet voulu par jquery-ui-effects- pour obtenir le nom du gestionnaire associé². Attention, le nom du gestionnaire doit être en minuscules.

Par exemple, chargez l’effet Shake soit :

• avec le gestionnaire jquery-ui-effects-shake ;
• en utilisant la méthode statique WPjQueryUIEffects::getHandle('shake').

La librairie jQuery UI est-elle nécessaire au fonctionnement de jQuery UI Effects ?

Non. Vous n’avez donc pas à charger le gestionnaire jquery-ui-core (fichier ui.core.js) en tant que dépendance d’un quelconque effet pour que ce dernier fonctionne.

Quelle est la version de jQuery UI Effects utilisé ?

Le plugin utilise jQuery UI Effects dans sa version 1.7.2.
Il nécessite également jQuery 1.3+, disponible depuis WordPress 2.8.

Développement

Distribué sous licence GNU/GLP, le code source du plugin est accessible sur GitHub.

Une suggestion, une amélioration, une critique ou un bug à me soumettre ? Ça se passe du côté du bugtracker

Historique des versions

1.0.0

• Version initiale.

Continuez votre lecture sur des sujets similaires

• Du RGBA dans vos animations avec le plugin jQuery Color
• Get Author’s Comments
• WordPress : forcer le chargement de jQuery en bas de page
• JavaScript : tester le support des couleurs RGBA
• Supprimer les effets de neige avec Greasemonkey

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.

Continuez votre lecture sur des sujets similaires

• WordPress jQuery UI Effects
• SPIP Google Tools 1.0.1
• SPIP Google Tools
• Shortcode WordPress : afficher les documents liés aux billets
• WordPress : une classe abstraite pour aider la création de shortcodes