Vous l’aurez constaté, il est désormais possible d’ajouter une bannière au dessus de la fiche de son plugin pour la rendre un peu plus charmante.

Comment faire ?

1 – Préparer une image de 720×250 pixels (JPG|PNG)
2 – Créer un dossier ‘assets’ à la racine du SVN de votre plugin
3 – Ajouter dans le dossier ‘assets’ votre bannière que vous aurez renommée banner-772×250.png ou banner-772×250.jpg
4 – Faire un commit et attendre 15 minutes

Attention toutefois, Matt nous annonce que ceci n’est qu’un test et qu’il est probable que les dimension changent ou que la feature s’en aille tout simplement.

A vos toshops !

Pour cela, nous nous sommes appuyés sur les services (gratuits) d’Issuu dont la vocation est d’encoder des PDF que nous leur envoyons et ils nous les retournent sous forme de code embed à insérer. Jusque là, si vous vouliez insérer un flipbook Issuu, vous deviez vous rendre sur le site pour uploader votre PDF puis utiliser l’un des plugins WordPress pour insérer ce flipbook proprement.

Avec Issuu PDF Sync, nous vous proposons de rester au sein même de l’admin WordPress. Par défaut, le plugin est configuré pour automatiquement envoyer les PDF téléchargés depuis la bibliothèque vers Issuu. Vous pouvez désactiver cette option et choisir de les envoyer au cas par cas dans l’édition du média.

Lors de l’insertion d’un PDF dans un article, vous cliquerez comme à votre habitude sur le bouton « Ajouter un média » et si vous sélectionner un PDF, vous aurez un nouveau bouton « PDF Isssuu » qui vous permettra de récupérer le shortcode à insérer pour voir votre flipbook s’afficher dans votre article.

Voici un condensé des features proposées

• Envoi automatique des PDF sur Issuu (sans sortir de WordPress)
• Utilisation d’un shortcode (pas de code embed à rallonge)
• Possibilité de personnaliser au cas par cas le rendu des flipbooks et de modifier le rendu par défaut
• Anglais / Francais (+ fichiers mo/po pour autres langues)
• Développé en mode debug (aucune notice PHP)

C’est l’objet du plugin Post type / Taxonomy intersections. Vous pouvez avec ce plugin créer des vues du type :

votresite.com/slug_du_post_type/slug_de_la_taxo/slug_de_term/

Au niveau des fichiers du votre thème, c’est automatique si vous suivez la nomenclature suivante :

- archive-posttype-taxo-term.php
- archive-posttype-taxo.php
- archive-posttype.php
- archive.php
- index.php

Attention, il faut mettre à jour les permaliens pour que la réécriture d’URL fonctionne correctement.

Parlons peu parlons bien, Recommend a friend est un petit plugin qui vous permettra d’ajouter une popin de partage de vos articles/pages/types de contenu. En plus du partage Facebook et Twitter, Recommend a friend dispose de deux fonctionnalités supplémentaires. Le partage en entrant manuellement des adresses email et le partage semi-automatique d’Open Inviter.

Pour ceux qui ne connaissent pas, Open Inviter est un service qui permet en entrant ses identifiants Gmail, Hotmail ou Yahoo de récupérer ses contacts et de cocher simplement ceux à qui vous souhaiter recommander un site ou une page.

Vous pouvez installer et configurer ce plugin de plusieurs manières. Pour les plus novices, un widget configurable est prévu. Il est également possible d’ajouter automatiquement le bouton à la fin des articles. Pour les autres, vous pourrez appeler une fonction php et choisir l’emplacement exact du plugin.

Enfin, une page d’option est prévue pour activer/désactiver les fonctions dont vous avez besoin et vous pourrez personnaliser l’apparence de la popin.

Sans mettre la main dans le code, j’ai pu réaliser en 5 minutes, une page d’options pour mon thème contenant tous les textes statiques que l’on retrouvera sur le site, les catégories à mettre en avant et diverses autres options.

Première étape : créer les champs à éditer :

La capture d’écran ci-dessous montre tous les types de champs que l’on peut créer.

Quelques précisions sur les types de champs :

Heading : sert à créer des séparations pour classifier les options

Post : créer une liste déroulante avec tous les articles

Posts : créer des cases à cocher avec les articles (possibilité d’en cocher plusieurs)

Custom Post et Custom posts : idem mais il est possible de choisir un type de contenu avant

Measurement : permet de sélectionner un nombre de pixel, cm, points..

Vous commencerez donc par créer ces champs pour que l’administrateur du site puisse ensuite renseigner ces options.

Comment afficher ces options dans le thème ?

Nous avons vu comment créer des champs et comment les alimenter mais voyons maintenant comment afficher ces options dans la thème. Là encore, le plugin est très simple et contient une page de documentation qui rappelle comment utiliser la fonction php mise à disposition.

En résumé :

<?php get_option_tree( $item_id, $options, $echo, $is_array, $offset ); ?>

$item_id : correspond à l’identifiant que vous avez donné à votre champ. Seul paramètre obligatoire.

$options : Permet manifestement de personnaliser les requêtes en base de données mais je n’ai vu aucune exemple

$echo : true si vous voulez que la fonction afficher directement le contenu, fasle si vous souhaiter stocker ce contenu dans une variable.

$is_array : permet de préciser si le résultat est attendu sous forme de tableau ou non

$offset : permet lorsque is_array est sélectionné de démarrer l’affichage des données à partir d’un certain offset

Importer et exporter les options

OptionTree propose également l’import et l’export des options au format XML ou avec des caractères encodés à copier coller. Très pratique !

C’est ici : http://paris14mai2011.wordcamp.fr/inscription/

Si vous avez l’habitude d’ajouter quelques hacks dans votre fichiers functions.php, celui-ci deviendra très vite illisible et désorganisé puisque ça sera votre fichier « fourre-tout ». Pour parer à cela, je vous suggère de créer dans votre thème un dossier « inc » puis de créer autant de fichiers que vous écrierez de fonctions. Le morceau de code suivant est à placer dans votre fichier functions.php et va aller chercher tous les fichiers se trouvant dans le dossier inc et dont l’extension est php.

<?php
if( is_dir( TEMPLATEPATH.'/inc' ) ) {
	if( $dh = opendir( TEMPLATEPATH.'/inc' ) ) {
		while( ( $inc_file = readdir( $dh ) ) !== false ) {
			if( substr( $inc_file, -4 ) == '.php' ) {
				include_once( TEMPLATEPATH.'/inc/' . $inc_file );
			}
		}
	}
}
?>

2 / Réspecter les coding standards

Les coding standards sont un ensemble de règles fixées entre les développeurs qui consistent à harmoniser la façon dont le code source est présenté. L’indentation du code est naturellement très important mais vous noterez de nombreuses petites subtilités qui une fois respectées rendront la relecture de votre code beaucoup plus simple.

Voyons quelques exemples :

La gestion des espaces

FAUX

foreach($foo as $bar){ ...

BON (pensez à ajouter des espaces)

foreach ( $foo as $bar ) { ...

Les conditions

Si vous n’avez qu’une seule action à exécuter après votre condition, nul besoin d’utiliser des accolades :

if ( condition )
    action1();
elseif ( condition2 )
    action2();
else
    action3();

Les short tags php

BON

<?php $var; ?>

FAUX Attention au short tags de php. Si vous utilisez ce raccourcis, certains serveurs interpréteront cela comme du contenu XML et afficheront donc votre code source… Danger !

<? $var; ?>

> Lien vers le Codex – Coding Standards

3 / Ajouter des tailles de vignettes pour les images à la une

Il est important de recenser les différents formats d’image dans un même fichier. Vous pouvez les insérer directement dans votre fichier functions.php car vous aurez très souvent besoin d’en ajouter ou de vérifier leurs dimension/slugs.

> En savoir plus sur les tailles des thumbnails dans WordPress

4 / Définir des constantes

Si vous utilisez dans votre thème des ID, des slugs de pages, de taxonomies de custom post types ou autres, il faut utiliser des constantes. Ce sont des variables que vous allez définir dans votre fichier functions.php qui seront utilisables dans tout votre thème.

Exemple avec un numéro de page :

1 ) On déclare la constante une seule fois dans le fichier functions.php

<?php define ( 'IDPAGECONTACT', 34 );  ?>

2 ) On utilise non pas l’ID de la page directement mais le slug que nous auront défini

<?php echo get_permalink( IDPAGECONTACT ) ; ?>

Si l’ID de la page de contact vient à changer, plutôt que de scanner tout le thème pour savoir où nous avions utilisé cet ID, il suffira de modifier la valeur de la constante une seule fois.

5 / Créer un fichier 404.php

Une thème complet contient une page d’erreur 404 personnalisée (404.php). En la présence de ce fichier, les liens qui ne fonctionnent pas renverront automatiquement vers cette page qui peut au passage être personnalisés comme le montre cet article sur les plus belles pages 404. Vous pouvez également décider d’afficher en plus du message d’erreur les articles les plus populaires de votre blog pour vous éviter de perdre vos visiteurs.

6 / Modifier le fichier style.css et ajouter un fichier screenshot.png

Pour modifier les informations de base de votre thème, c’est le fichier style.css qu’il vous faudra modifier. Prenez comme modèle le thème par défaut de WordPress (Twenty Ten) et modifier ces informations à votre guise. Faites aussi une capture d’écran de votre thème puis renommez-là screenshot.png. Elle apparaîtra dans la page qui liste les thèmes.

6 / Supprimer tous les fichiers/dossiers inutiles

Il est plus qu’important au moment où l’on travaille sur un thème et qu’on commence à en maîtriser tous les fichiers de supprimer ceux qui ne servent à rien dans le contexte actuel. Vous ne souhaitez pas afficher les commentaires sur votre site ? Très bien mais pensez à supprimer tous les fichiers relatifs aux commentaires. Vous ne comptez pas utiliser le super slider en flash de votre thème gratuit ? Très bien mais supprimez tous les fichiers qui le compose. Cela vous servira lorsque vous vous replongerez dans un thème que vous avez utilisé plusieurs mois auparavant car il vous semblera bien plus léger.

7 / Utiliser un SVN

Un SVN (pour Subversion) est un système de gestion de versions. Un outil de développement collaboratif qui vous évitera la mauvaise surprise du « oups, je crois que j’ai supprimé un truc qui fallait pas ». Le principe est simple. Vous allez sauvgarder votre dossier de travail (votre thème dans notre cas) sur un dépot quelque part sur Internet. A chaque modification de votre part ou de l’un de vos collaborateurs, une version est sauvegardée et vous pourrez revenir dans le temps en cas de problème. Quand un fichier est modifié, vous pouvez le comparer avec ses précédentes versions et constater quelles lignes ont été modifiées. Vous pourrez aussi confier votre code à de nouveaux collaborateurs qui récupéreront votre thème dans l’état actuel, feront leurs modifications, et les ajouteront au thème.

8 / Don’t repeat yourself

Ce concept s’adapte à tous les langages de développement et l’idée est de ne jamais écrire deux fois les mêmes lignes de code s’il y a possibilité de les regrouper dans une fonction. Vous avez développé 10 lignes de code qui vous permettent d’aller récupérer le dernier article de la catégorie « Fruits et Légumes » et d’en afficher le titre et le permaliens ? Bien mais l’idéal aurait été d’en créer une fonction et de l’appeler ensuite là où vous en avez besoin. De manière générale, vous devez séparer le code « fonctionnel » (le développement) du code réservé à l’affichage de votre template (l’intégration).

9 / Commenter son code

Cela peut sembler inutile lorsque l’on est en train de travailler sur un projet puisque ayant la tête dedans jours et nuits, l’on en connaît les moindre recoins. Et bien c’est à ce moment qu’il faut faire une passe générale sur son thème et commenter les fonctions qui pourront par la suite être difficilement compréhensibles. De même, il convient d’utiliser des noms de variable et de fonctions qui ont une signification. ( $swf_url est plus compréhensible que $mavariable1 )

10 / Proposer son thème à la communauté WordPress

Si vous avez créé un thème from scratch et qu’il est suffisamment générique pour convenir à d’autres personnes, n’hésitez-pas à en faire profiter la communauté. Celle-ci vous en sera redevable et votre notoriété augmentera. J’écrierais prochainement un article sur les choses à faire pour ajouter son thème à la librairie officielle de WordPress.

Celui-ci permet d’aller chercher (ou non) dans les titres, contenus, tags et catégories des articles similaires. Chaque article obtient alors une note de complémentarité avec l’article affiché et les posts ayant les meilleurs notes remonteront. Vous pourrez configurer pas mal d’options (catégories et tags à exclure, nombre d’articles relatifs, configuration du seuil de complémentarité…) et créer vos propres templates d’affichage des articles relatifs en procédant comme suit :

Lorsque vous installerez ce plugin, l’on vous demandera de déplacer les fichiers contenus dans yarpp-templates au sein de votre dossier de thème. En fait, je vous suggère de ne copier que le fichier yarpp-template-example.php (que vous renommerez yarpp-template-xxxx.php) que vous pourrez modifier ensuite à votre guise pour personnaliser l’affichage des articles relatifs par la suite.

Rendez-vous ensuite sur la page d’option de YARPP et cochez « Utiliser un modèle personnalisé ». Vous trouvez alors dans la liste déroulante, votre fichier yarpp-template-xxx.php. C’est ce fichier qu’il faudra modifier pour modifier la structure des articles relatifs.