Il faut aussi signaler les articles publiés ici et marqués du mot-clé WordPress

Guest blogging

Je ne sais pas s’il existe un mot français pour désigner cette pratique, mais il s’agit de publier des articles sur d’autres blogs.

• Pièces jointes dans WordPress : Un peu de théorie
• Pièces-jointes dans WordPress : Un exemple pratique

Les extensions

• Use-theme-iconset : permet de choisir un jeu d’icône personnalisé pour les fichiers en pièce jointe.

Les forums

C’est l’outil de support de prédilection. J’ai répondu à des questions sur les forums :

• sur wordpress-fr.net
• sur wordpress.org

Trac WordPress

C’est l’outil de supervision des bugs et des améliorations de WordPress.

• J’ai trouvé une petite erreur (une action mal utilisée). Ça ne va pas changer WordPress, mais je suis tout de même très fier de l’avoir détectée. J’ai publié mon ticket qui a été corrigé ici (la modification sortira avec une prochaine version de WordPress)

For explanations in english, see the official wordpress plugins directory.

use_theme_iconset est une petite extension (ou plug-in) pour WordPress qui permet de changer le jeu d’icône utilisé par défaut dans WordPress.

Après l’activation du plug-in, les icônes utilisées sont celles situées dans le dossier iconset du thème actif (s’il existe). Le dossier iconset remplace wp-includes/images/crystal.

Il ne s’agit que de 13 lignes de code…

(A lire également : description du jeu d’icône utilisé par défaut dans WordPress)

Le code

Télécharger l’extension : use-theme-iconset.zip

Vous pouvez aussi copier-coller le code ci-dessous dans un fichier use_theme_iconset.php à la racine du dossier plugin.

<?php
/*
Plugin Name: Use Theme Icon Set
Plugin URI: http://docs.jmini.fr/code/wordpress-use_theme_iconset
Description: Use a directory called iconset in your theme directory for the files icons (instead of wp-includes/images/crystal)
Version: 1.0
Author: Jérémie Bresson
Author URI: http://jmini.fr/

---
Copyright 2008 Jérémie BRESSON (jmini@jmini.fr)

This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
*/

function use_theme_iconset($cnt) {
	if (is_dir(get_template_directory().'/iconset')) {
		if (is_dir($cnt)) {
			return get_template_directory().'/iconset';
		} else {
			return get_template_directory_uri().'/iconset';
		}
	} else {
		return $cnt;
	}
}
add_action('icon_dir', 'use_theme_iconset');
add_action('icon_dir_uri', 'use_theme_iconset');

?>

Remarques :

1) La modification est effectuée partout, y compris dans l’espace d’administration. Pour n’utiliser des icônes personnalisées que dans son thème, je recommande de personnaliser les templates (lire à ce sujet mon exemple pratique de template attachment.php sur le site de fran6art)

2) Le format d’image utilisé n’est pas important, par contre, pour garantir un bon affichage du thème dans l’interface d’administration je recommande de conserver la taille des icônes (46×60 pixels)

Il existe également des options supplémentaires qui ne sont pas mentionnées dans le fichier modèle. Je recense dans cette note celles qui me sont utiles.

Empêcher le suivi des versions

(lu sur wordpress-fr)

define('WP_POST_REVISIONS', false);

Allonger la sauvegarde automatique

(source)

define( 'AUTOSAVE_INTERVAL', 1800 );

Voir également Revision Management (EN) dans le codex

Wordpress trie les pièces jointes dans plusieurs types de fichiers en fonction de l’extension, ceci afin de proposer plus qu’une seule icone de fichier joint.

La fonction wp_ext2type($ext) (dont le code est copié à la fin de cet article, disponible dans le fichier wordpress/wp-includes/fonctions.php) permet de récupérer le type de fichier en fonction de l’extension :

Ce à quoi s’ajoute à mon avis les types suivants :

Images :

Par défaut Wordpress incorpore déjà un jeu d’icône pour représenter les fichiers :
On le trouve dans le dossier : wordpress/wp-includes/images/crystal

Jeu d’icône crystall inclus dans wordpress

Un dossier d’images doit contenir les fichiers suivants :

• archive.png
• audio.png
• code.png
• default.png
• document.png
• interactive.png
• image.png *
• spreadsheet.png
• text.png
• video.png

* image.png n’est pas dans le package par défaut de wordpress. En effet pour les images, wordpress utilise plutôt les miniatures.

Les images standards mesurent 46 pixels de largeur et 60 pixels de hauteur. Proposer un jeu de fichier avec d’autres dimensions peut provoquer des erreurs d’affichage dans l’administration de wordpress.

Evidement les images ne sont pas obligatoirement des png.

Fonctions :

Voici une petite fonction php pour récupérer le nom du type associé à un fichier. Cette fonction utilise la fonction incluse dans wordpress, avec quelques améliorations :

• Il est possible d’utiliser le nom complet du fichier ou juste l’extension
• Le type image a été ajoutée
• Dans tous les cas, on obtient un résultat (en utilisant le type « default »).

<?php
/** jmini - oct 2008 - http://docs.jmini.fr/notes/wordpress-categories-pj **/
function get_filecat($file_name) {
   $pos = strripos($file_name, ".");
   if ($pos === false) {
       $ext=$file_name;
   } else {
       $ext=substr($file_name,$pos+1);
       }
   $c=wp_ext2type($ext);
   if($c==null) {
      if (in_array($ext, array('gif', 'jpg', 'jpeg', 'png', 'tif', 'tiff', 'psd', 'bmp'))) {
         return 'image';
      } else {
         return 'default';
      }
   } else {
      return $c;
   }
}?>

Pour l’utiliser, il suffit de copier le code ci-dessus dans le fichier functions.php du thème utilisé ou même dans le template concerné.

Fonction incluse dans wordpress (wordpress/wp-includes/fonctions.php) :

<?php
function wp_ext2type( $ext ) {
   $ext2type = apply_filters('ext2type', array(
      'audio' => array('aac','ac3','aif','aiff','mp1','mp2','mp3','m3a','m4a','m4b','ogg','ram','wav','wma'),
      'video' => array('asf','avi','divx','dv','mov','mpg','mpeg','mp4','mpv','ogm','qt','rm','vob','wmv'),
      'document' => array('doc','pages','odt','rtf','pdf'),
      'spreadsheet' => array('xls','numbers','ods'),
      'interactive' => array('ppt','key','odp','swf'),
      'text' => array('txt'),
      'archive' => array('tar','bz2','gz','cab','dmg','rar','sea','sit','sqx','zip'),
      'code' => array('css','html','php','js'),
   ));
   foreach ( $ext2type as $type => $exts )
      if ( in_array($ext, $exts) )
         return $type;
}
?>

Dans ce template, les fonctions previous_post_link() et next_post_link() ne fonctionnent pas comme je l’attendais :

• previous_post_link() : affiche un lien vers l’article «parent» de la pièce jointe
• next_post_link() : n’affiche jamais rien.

Je voulais pouvoir naviguer à l’intérieur des différentes pièces jointes (dans le cas de plusieurs fichiers joints à un article, je pense par exemple que si l’on affiche la page de présentation de la pièce jointe, il peut être utile de pouvoir naviguer d’une pièce jointe à l’autre sans repasser par l’article)

J’ai donc créé deux nouvelles fonctions :
previous_att_link() et next_att_link() qui fonctionnent exactment comme previous_post_link() et next_post_link()

Télécharger l’archive ou copier le code (présent à la fin de cet article).

Installation :

- copier le contenu du fichier functions.php dans le fichier functions.php du thème ou au début du fichier où la fonction sera utilisée.
- Appeler la fonction dans le template comme c’était le cas avec previous_post_link(). Il est possible de juste remplacer le nom.

Paramètres :

format

(chaîne) [cf previous_post_link()] Chaîne de formatage pour le lien. C’est ici que vous contrôlez ce qui vient avant ou après le lien. ‘%link’ dans la chaîne sera remplacé par ce qui est déclaré comme lien dans le paramètre suivant. ‘Aller à %link’ générera « Aller à <a href=…" Placer des marqueurs HTML ici pour styliser le résultat final. '&laquo; %link' par défaut.

link

(chaîne) [cf previous_post_link()] Texte du lien à afficher. Défini par défaut au titre de l’article précédent (‘%title’).

in_same_mime

(booleen) Permet de n’’afficher que les liens vers les documents de même type (basé sur le type mime)

d2

(chaîne) Non utilisé, permet d’avoir la même signature que previous_post_link()

limitation connue :

Les types mime sont constitués d’un type principal et secondaire (ex : image/jpeg, application/pdf…) seul le type principal est pris en compte. Autrement dit, de nombreux fichiers (ceux qui sont de type principal « application » : xls, pdf, zip…) sont considéré comme du même type.

Le code

<?php
/* previous_att_link() &amp; next_att_link()
 * 2 functions to replace previous_post_link() &amp; next_post_link() in the attachment.php template
 * Require Wordpress 2.5; compatible up to Wordpress 2.6.2
 *
 * Parameters : $format : @see previous_post_link()
 *              $link : @see previous_post_link()
 *              $in_same_mime : only search attachments with the same mime type (subtype is not considered)
 *              $d2 : [not used] preserve the previous_post_link() signature
 *
 * based on previous_image_link() &amp; next_image_link() in wp-include/media.php
 * and previous_post_link() &amp; next_post_link() in wp-include/link-template.php
 *
 * Version 1
 * Copyright 2008 - Jeremie Bresson (email : contact@jmini.fr) - http://jmini.fr
 *
 * This program is free software; you can redistribute it and/or modify
 * it under the terms of the GNU General Public License as published by
 * the Free Software Foundation; either version 2 of the License, or
 * (at your option) any later version.
 *
 * This program is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * GNU General Public License for more details.
 *
 * You should have received a copy of the GNU General Public License
 * along with this program; if not, write to the Free Software
 * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA
 */

function previous_att_link($format='&laquo; %link', $link='%title', $in_same_mime = false, $d2 = '') {
		adjacent_att_link($format, $link, $in_same_mime, true);
}
function next_att_link($format='%link &raquo;', $link='%title', $in_same_mime = false, $d2 = '') {
		adjacent_att_link($format, $link, $in_same_mime, false);
}
// do not call adjacent_att_link directely
function adjacent_att_link($format, $link, $in_same_mime, $previous = true) {
	global $post;
	$post = get_post($post);
	if($in_same_mime) {
		$mime = ereg_replace("/[a-zA-z\.\-]*$","",$post->post_mime_type);
		$attachments = array_values(get_children("post_parent=".$post->post_parent."&amp;post_type=attachment&amp;post_mime_type=".$mime."&amp;orderby=menu_order ASC, ID ASC"));
	}else {
		$attachments = array_values(get_children("post_parent=".$post->post_parent."&amp;post_type=attachment&amp;orderby=menu_order ASC, ID ASC"));
	}
	foreach ( $attachments as $k => $attachment ) {
		if ( $attachment->ID == $post->ID )
			break;
	}
	$k = $previous ? $k - 1 : $k + 1;
	if (! isset($attachments[$k]) )
			return;
	$title = $attachments[$k]->post_title;
	if ( empty($attachments[$k]->post_title) )
		$title = $previous ? __('Previous Post') : __('Next Post');
	$title = apply_filters('the_title', $title, $attachments[$k]);
	$string = '<a href="'.get_permalink($attachments[$k]).'">';
	$link = str_replace('%title', $title, $link);
	$link = $string . $link . '</a>';
	$format = str_replace('%link', $link, $format);
	echo $format;
}
?>