Parce que j’en avais ma claque de chercher le texte des licences à ajouter en en-tête de mes sources¹, voici un bundle TextMate pour palier à cette répétitive perte de temps.

Table des matières

1. Installation
2. Utilisation du bundle
3. Personnaliser le sélecteur des licences
4. Corriger le formatage de la licence
5. Licences supportées
6. Développement

Installation

Depuis les sources, avec Git

cd ~/Library/Application\ Support/TextMate/Bundles
git clone git://github.com/piouPiouM/license-helper.tmbundle.git "License Helper.tmbundle"
osascript -e 'tell app "TextMate" to reload bundles'

Depuis les sources, sans Git

cd ~/Library/Application\ Support/TextMate/Bundles
wget http://github.com/piouPiouM/license-helper.tmbundle/tarball/master
tar zxf license-helper.tmbundle.tar.gz
rm license-helper.tmbundle.tar.gz
mv license-helper.tmbundle "License Helper.tmbundle"
osascript -e 'tell app "TextMate" to reload bundles'

Téléchargement direct

Après récupération, décompressez l’archive, renommez le dossier en License Helper.tmbundle. Acceptez le changement d’extension. Il ne reste plus qu’à installer le bundle d’un double-clic sur le fichier.

Utilisation du bundle

Utilisez le lanceur license⇥ pour sélectionner une licence via la boîte de dialogue qui s’affiche.

Choix d’une licence – License Helper Textmate Bundle

Un bloc de licence est inséré en tant que Snippet. Utilisez la touche de tabulation pour vous déplacez sur les différents placeholders.

Liste des variables d’environnement utilisées

Déclarez dans votre projet les variables d’environnement qui suivent pour auto-compléter les blocs de licence à insérer :

• TM_PROJECT_YEAR. L’année de production. Par défaut : l’année courante.
• TM_PROJECT_COPYRIGHT_HOLDERS ou TM_AUTHOR ou TM_ORGANIZATION_NAME. Les détenteurs du copyright.
• TM_ORGANIZATION_EMAIL. Adresse mail de l’organisation détentrice du copyright.
• TM_PROJECT_DESCRIPTION. Description brève du projet.

Notez que les variables sont utilisées en fonction de la licence choisie et qu’il n’est pas nécessaire de toutes les renseigner si vous n’en avez pas l’usage.

Vous pouvez fixer la licence de votre projet en ajoutant la variable d’environnement de projet TM_PROJECT_LICENSE. Ainsi, vous n’aurez plus à la sélectionner.

Personnaliser le sélecteur des licences

La commande accessible depuis le menu License Helper → Edit licenses order lance l’édition du fichier de configuration du bundle.
Modifiez l’ordre des licences déclarées selon vos préférences d’apparition dans le sélecteur de licences.

Corriger le formatage de la licence

Il est possible qu’avec certains langages, le rendu des blocs de licences ne corresponde pas à vos attentes. Si tel est le cas, définissez votre propre format :

1. Bundles → Bundle Editor
2. Dans l’entrée License Helper, créez une nouvelle Preference et donnez-lui le nom du langage.
3. Remplissez le champ Scope Selector avec le scope approprié – i.e. source.java pour les sources java.
4. Définissez les shellVariables TM_LICENSE_HELPER_HEADER (début du bloc de commentaire) et TM_LICENSE_HELPER_FOOTER (fin du bloc de commentaire), comme suit :

{  shellVariables = (
        {   name = 'TM_LICENSE_HELPER_HEADER';
            value = '/*';
        },
        {   name = 'TM_LICENSE_HELPER_FOOTER';
            value = '*/';
        },
    );
}

Note : chacune des lignes de la licence peut être préfixée de la variable TM_LICENSE_HELPER_LINE.

Licences supportées

La liste des licences prises en charge par le plugin n’est pas figée. N’hésitez pas à me soumettre celles qui vous font défaut.

• Affero GNU Public License 3.0
• Apache license 2.0
• CeCILL license
• Do What The Fuck You Want To Public License
• GNU General Public License version 2
• GNU General Public License version 3
• GNU Lesser General Public License version 3
• MIT license
• New and Simplified BSD licenses
• Original BSD license
• PostgreSQL license

Développement

Distribué sous license MIT, le code source du bundle est accessible sur GitHub.

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

Continuez votre lecture sur des sujets similaires

• TextMate : commande « Export words »
• TextMate : convertir une couleur hexadécimale en notation RGBA
• JavaScript : optimiser le calcul de l’intersection de tableaux de grandes tailles
• Une console JSLint pour aider vos validations JavaScript
• PHP : convertir un DATETIME en un timestamp UNIX

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
• JavaScript : tester le support des couleurs RGBA
• Supprimer les effets de neige avec Greasemonkey
• SPIP Google Tools 1.0.1

La version 1.0.1 du plugin SPIP Google Tools est disponible. Le plugin SPIP Google Tools ajoute proprement le code de suivi du service Google Analytics et le code de vérification du service Google Webmaster Tools sur les pages de votre site.

Cette nouvelle version supporte le nouveau tag Meta de validation de site requis par GWT. En effet, le nouveau meta tag google-site-verification remplace désormais l’ancien verify-v1.
Attention : la valeur du code de validation n’est plus le même ! N’oubliez pas de renseigner sa nouvelle valeur via la page d’administration du plugin.

Continuez votre lecture sur des sujets similaires

• SPIP Google Tools
• WordPress jQuery UI Effects
• Get Author’s Comments
• Bundle License Helper pour TextMate
• Du RGBA dans vos animations avec le plugin jQuery Color

Une des tâches les plus rébarbatives est bien l’ajout d’une licence d’utilisation à tous les fichiers sources de ses projets. Ajoutez à cela que, comme tout bon développeur, je n’aime pas répéter la même opération plus de deux fois, je me suis codé l’an dernier une tâche Phing pour automatiser cela¹ : Header.

Présentation

Phing Header se découpe en deux tâches : HeaderTask et HeaderPhpTask.

La tâche HeaderTask permet d’ajouter un en-tête à n’importe quel fichier. Elle peut être comparée au paramètre imbriqué header de la tâche Concat d’Ant².

Plus spécifique, la tâche HeaderPhpTask est à utiliser pour ajouter un en-tête aux fichiers PHP. Le tag PHP <?php précédera ainsi le contenu à concaténer ; le premier tag PHP étant supprimé.

Table des matières

1. Présentation
2. Téléchargement
3. Installation
4. Attributs
5. Tags imbriquées supportées
6. Exemples d’utilisation
7. Licence
8. Tâches à faire
9. Historique des versions et changelog

Téléchargement

Vous pouvez également cloner le projet depuis son dépôt GitHub.

Installation

Si vous suivez la documentation de Phing, il vous faut copier le répertoire³ header contenu dans l’archive dans le dossier classes/phing/tasks/my de votre installation Phing.

Personnellement je préfère utiliser un chemin externe à l’installation de base de Phing. Pour ce faire, il suffit de créer l’arborescence phing/tasks/my à l’endroit désiré (par exemple /Library/WebServer/share/php) et de déclarer ce dernier via la propriété include_path de votre fichier php.ini. Ce qui nous donne ici :

include_path = ".:/Library/WebServer/share/php:/usr/local/php5/lib/php"

et l’arborescence suivante :

/Library/WebServer/share/php/
  `-- phing/
       `-- tasks/
            `-- my/
                 `-- header/
                      |-- HeaderPhpTask.php
                      `-- HeaderTask.php

Vous devrez déclarer ces nouvelles tâches à l’aide de la tâche Taskdef dans vos fichiers de build. Par exemple :

<taskdef name="header" classname="phing.tasks.my.header.HeaderTask" />

Attributs

Les tâches HeaderTask et HeaderPhpTask se partagent la liste d’attributs qui suit :

Caractères de fin de ligne valides

• cr : un unique CR.
• lf : un unique LF.
• crlf : la paire CRLF.
• mac : un unique CR.
• unix : un unique LF.
• dos : la paire CRLF.

La valeur par défaut est dépendante de la plateforme utilisée. Pour les système Unix, le caractère de fin de ligne par défaut est LF. Pour les systèmes de types DOS (incluant Windows), il s’agit de CRLF. Enfin, CR est la caractère utilisé par défaut sur les systèmes Mac OS.

Tags imbriquées supportées

• FileSet.

Exemples d’utilisation

Ajouter un en-tête à un fichier PHP

<!-- load the header php task -->
<taskdef name="phpheader" classname="phing.tasks.my.header.HeaderPhpTask" />
 
<phpheader
    file="${project.basedir}/LICENSE"
    tofile="${project.basedir}/build/foo.php"/>
</phpheader>

Ajouter un en-tête à un ensemble de fichiers PHP

<!-- load the header php task -->
<taskdef name="phpheader" classname="phing.tasks.my.header.HeaderPhpTask" />
 
<phpheader file="${project.basedir}/LICENSE">
    <fileset dir="${project.basedir}/build">
        <include name="**/*.php" />
        <exclude name="**/foo*.php" />
    </fileset>
</phpheader>

Ajouter un en-tête encodé en ISO-8859-1 à un fichier encodé en UTF-8

<!-- load the header task -->
<taskdef name="header" classname="phing.tasks.my.header.HeaderTask" />
 
<header
    file="${project.basedir}/LICENSE"
    encoding="ISO-8859-1"
    tofile="${project.basedir}/build/foo.txt" />

Licence

Copyright (C) 2008 Mehdi Kabab, distribué sous licence LGPL version 3 ou supérieure.

Tâches à faire

Fonctionnalités en attente de développement.

• [HeaderPhpTask] Optimiser la détection des tags PHP.
• [Projet] Améliorer l’aspect POO.

Historique des versions et changelog

1.0

• Version initiale.

Continuez votre lecture sur des sujets similaires

• Générer des bookmarklets via Ant
• Bundle License Helper pour TextMate
• TextMate : commande « Export words »
• PHP : installer APC sous Mac OS X Leopard
• PHP : convertir un DATETIME en un timestamp UNIX

Le plugin SPIP Google Tools propose d’ajouter proprement¹ le code de suivi du service Google Analytics sur les pages de votre site.

Optionnellement, ce plugin vous permet de choisir le champ d’application du code de tracking GA : restreindre son ajout à l’espace publique ou le généraliser à l’ensemble du site (partie privée et publique).

Autre fonctionnalité, le plugin SPIP Google Tools propose d’inclure sur la page d’accueil du site la balise Meta de vérification de site proposé par le service Google Webmasters Tools.

Table des matières

1. Téléchargement
2. Installation
3. Compatibilité
4. Tâches à faire
5. Développement
6. Historique des versions et changelog

Téléchargement

Installation

1. Décompressez l’archive puis téléversez le répertoire spip-google-tools dans votre répertoire plugins.
2. Procédez à son activation.
3. Rendez-vous sur la page d’administration du plugin via le menu Statistiques > Google Tools.

Panel de configuration du plugin Spip Google Tools

Notes

• Le plugin ne nécessite aucune dépendance particulière.
• L’inclusion de la balise de validation de Google Webmasters Tools requiert la présence de la balise #INSERT_HEAD dans les squelettes.

Compatibilité

• SPIP 1.9.2+
• SPIP 2.0.0+

Tâches à faire

Fonctionnalités en attente de développement.

• Ajouter une gestion des liens sortants et des téléchargements.

Développement

Le code source du plugin, distribué sous licence GNU/GLP, est accessible sur ma forge InDefero.

Vous venez de trouver un bug ? N’hésitez pas à me le faire remonter !

Historique des versions et changelog

1.0.1

• Support du nouveau code Meta de vérification de site google-site-verification du service Google Webmaster Tools.

1.0.0

• Version initiale.

Continuez votre lecture sur des sujets similaires

• SPIP Google Tools 1.0.1
• WordPress jQuery UI Effects
• Get Author’s Comments
• Bundle License Helper pour TextMate
• Du RGBA dans vos animations avec le plugin jQuery Color

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
• Bundle License Helper pour TextMate
• Du RGBA dans vos animations avec le plugin jQuery Color