Ajouter automatiquement des valeurs par défaut aux médias

Cette astuce permet d’ajouter des champs personnalisés par défaut lors de l’ajout d’un média (image ou autre).

Dans WordPress quand on upload des médias, les champs n’ont ni description, ni titre etc… Il pourrait être interessant de remplir automatiquement et intelligemment ces informations.

Dans cette astuce, nous allons aborder deux types de fichier : une image et un fichier zip. Ensuite, libre à vous de faire ce que bon vous semble selon le type de fichier que vous envoyez.

Pour commencer, voici un exemple où l’on peut automatiquement fermer les ping et les commentaires, puis modifier le titre du média et ajouter en description le type de fichier :

Copier le code ci-dessous dans le fichier functions.php présent à la racine de votre thème :
[pastacode lang=”php” message=”” highlight=”” provider=”manual”]

function baw_attachment_fields_to_save( $post ) {
   
    // Récupération dans 2 variables du type de mime et sous type de mime.
    list( $mime_type, $mime_subtype ) = explode( '/', $post['post_mime_type'] );
    
    // Affectation directement dans l'objet $post
    $post['post_content'] = sprintf( '%s (%s)', $mime_type, $mime_subtype );
    $post['post_title'] = $post['post_name'];
    $post['comment_status'] = 'closed';
    $post['ping_status'] = 'closed';
    return $post;
}
add_filter('attachment_fields_to_save', 'baw_attachment_fields_to_save' );

[/pastacode]

C’est tout, il m’a suffit d’utiliser le hook attachment_fields_to_save pour toucher l’objet $post et modifier facilement tout ce que je veux.

Voici 2 exemples qui vont vous permettre d’appréhender les capacités de cette astuce :

Exemple d’utilisation avec une image

Amis photographes, je vais maintenant lire les données EXIF des images uploadées pour les insérer dans la description. Beaucoup de sites de photographies affichent ces informations (ouverture de la lentille, focale, flash ou pas etc), mais certains scripts relisent les données EXIF à chaque affichage des images, ce qui n’est évidemment pas optimisé.

Je vais ajouter une condition sur le type de mime en intégrant le code ci-dessous dans le fichier functions.php présent à la racine de notre thème :
[pastacode lang=”php” message=”” highlight=”” provider=”manual”]

function baw_attachment_fields_to_save( $post, $attachment ) {
   
    // je crée le chemin sur le serveur du fichier et non pas une URL
    $docpath = str_replace( home_url(), $_SERVER['DOCUMENT_ROOT'], $attachment['url'] );
    
    // Comme au dessus, je liste les mimes
    list( $mime_type, $mime_subtype ) = explode( '/', $post['post_mime_type'] );
    
    // Je crée un contenu vide
    $content = '';
    
    // Si le média est une image de type JPEG
    if( $mime_type == 'image' && $mime_subtype == 'jpeg' ) {
        
        // Je peut modifier son excerpt aussi
	$post['post_excerpt'] = sprintf( 'Image %s (%s)', $post['post_name'], $mime_subtype );
        
        // Je lis les données EXIF du fameux $docpath
	$exif = wp_read_image_metadata( $docpath );
        
        // Si il y en a, pour chaque entrée trouvée je vais l'écrire dans la variable $content,
        // petite exception pour "created_timestamp" que je modifie en "Date" pour faire plus propre.
	if( $exif )
	     foreach( $exif as $key => $value )
	          if( $value )
		        if( $key == 'created_timestamp' )
			     $content .= 'Date: ' . date_i18n( get_option( 'date_format') . ' @ ' . get_option( 'time_format' ), $value ) . "n";
			else
			    $content .= ucwords( $key ) . ': ' . $value . "n";
    }
    
    // Puis je modifie le contenu si il n'est pas déjà renseigné
    $post['post_content'] = $post['post_content']!='' ? $post['post_content'] : $content;
    $post['post_title'] = $post['post_title']!='' ? $post['post_title'] : $post['post_name'];
    
    // Libre à vous de laisser ouvert les commentaires
    $post['comment_status'] = 'closed';
    $post['ping_status'] = 'closed';
    return $post;
}
add_filter('attachment_fields_to_save', 'baw_attachment_fields_to_save', 10, 2 );

[/pastacode]

Petite démo avec une image libre de droit que j’ai trouvé dans mes documents :

Exemple d’utilisation avec une archive ZIP

Dans le cas où vous proposez des téléchargements sur vos pages, pourquoi ne pas afficher le contenu du zip ?

[pastacode lang=”php” message=”” highlight=”” provider=”manual”]

function baw_attachment_fields_to_save( $post, $attachment ) {
    
    $docpath = str_replace( home_url(), $_SERVER['DOCUMENT_ROOT'], $attachment['url'] );
    list( $mime_type, $mime_subtype ) = explode( '/', $post['post_mime_type'] );
    $content = '';
    
    if( $mime_subtype == 'zip' ) {
        
        // Je crée un objet ZipArchive
	$za = new ZipArchive();
        
        // J'ouvre mon $docpath
	$za->open( $docpath );
        
        // Je récupère l'information du nombre de fichiers du zip
	$content .= 'Nombre de fichiers : ' . $za->numFiles . "n";
        
        // Pour chaque fichier/dossier trouvé, je le liste par son nom
	for( $i=0; $inumFiles; $i++ ){
		$c = $za->statIndex($i);
                // Libre à vous d'afficher le poids, la date ou autre, la doc est ici :
                // http://php.net/manual/en/ziparchive.statindex.php
		$content .= $c['name']."n";
	}
    }
    $post['post_content'] = $post['post_content']!='' ? $post['post_content'] : $content;
    $post['post_title'] = $post['post_title']!='' ? $post['post_title'] : $post['post_name'];
    $post['comment_status'] = 'closed';
    $post['ping_status'] = 'closed';
    return $post;
}
add_filter('attachment_fields_to_save', 'baw_attachment_fields_to_save', 10, 2 );

[/pastacode]

Démonstration avec le .zip du plugin “Widget Saver”: