Modifier le chemin des médias sous WordPress 3.5

Les nouvelles installations de WordPress à partir de la version 3.5 ne disposent plus de l’option permettant de définir manuellement le dossier de stockage des médias envoyés depuis l’éditeur et donc, l’URL des fichiers médias.

Une telle option n’a pas disparu pour autant du CMS, ce tutoriel vous montrera comment faire pour la configurer à nouveau. Pour utilisateurs avertis uniquement.

Ces deux réglages existent toujours en base de données (options upload_path et upload_url_path) et WordPress les applique encore. Mais les champs Stocker les téléversements dans ce dossier et Adresse web complète pour les fichiers ne s’affichent dans Réglages > Médias que si l’un d’eux contient déjà une valeur différente de celle par défaut, par exemple sur un site configuré avant WordPress 3.5. Sur une installation standard, la section Téléversement des médias se limite à une case à cocher.

Par défaut, WordPress stocke les médias dans le dossier /wp-content/uploads et les classe dans des sous-dossiers par année puis par mois tant que la case Organiser mes téléversements dans des dossiers mensuels et annuels est cochée, ce qui est le cas sur une nouvelle installation. C’est ce que je recommande.

Pour changer de dossier, connectez-vous à votre serveur FTP à l’aide de votre client FTP favori. À la racine de votre installation WordPress, modifiez le fichier wp-config.php avec un éditeur de texte. La constante UPLOADS s’ajoute au-dessus de la ligne /* C’est tout, ne touchez pas à ce qui suit ! Bonne publication. */ (/* That's all, stop editing! Happy publishing. */ sur une installation en anglais). Elle fonctionne sur toutes les installations, récentes ou non, et l’emporte sur les deux réglages évoqués plus haut.

Pour définir l’emplacement de stockage dans le dossier /wp-content/medias, ajoutez cette ligne :

define( 'UPLOADS', 'wp-content/'.'medias' );

Au contraire, si vous comptez placer le dossier à la racine de votre installation WordPress afin d’obtenir des adresses plus courtes (/medias/ au lieu de /wp-content/uploads/), indiquez ceci :

define( 'UPLOADS', ''.'medias' );

Dans les deux cas, le chemin est relatif au dossier d’installation de WordPress (celui qui contient wp-admin et wp-includes) et l’adresse des fichiers en découle : https://www.votresite.fr/medias/ pour le second exemple. N’y mettez ni barre oblique au début, ni chemin absolu du serveur, sous peine d’adresses erronées. Si WordPress est installé dans un sous-dossier, le dossier des médias s’y trouve aussi.

Sauvegardez le fichier modifié puis envoyez un fichier dans votre médiathèque pour tester l’effectivité du changement : WordPress crée lui-même le dossier s’il n’existe pas. S’il n’y parvient pas, il affiche le message « Impossible de créer le dossier… Son dossier parent est-il accessible en écriture par le serveur ? », signe d’un problème de droits sur le serveur. Dans ce cas, contactez votre hébergeur.

De prime abord, certains utilisateurs percevront ce changement comme un retour en arrière… en réalité, cette modification est largement justifiée (cf. WordPress trac). Un avis que je partage d’autant plus qu’une telle option peut casser un site en 2 secondes.

Et les médias déjà envoyés ?

La constante ne déplace aucun fichier : ceux déjà envoyés restent dans /wp-content/uploads. Or WordPress enregistre l’emplacement de chaque média par rapport au dossier des médias (sous la forme année/mois/photo.jpg) : dès le changement, il les cherche dans le nouveau dossier et leurs vignettes disparaissent de la médiathèque. Les adresses insérées dans vos contenus, elles, sont complètes et pointent toujours vers l’ancien dossier.

Pour garder un site cohérent, faites d’abord une sauvegarde complète (fichiers et base de données). Déplacez ensuite le contenu de /wp-content/uploads dans le nouveau dossier en conservant ses sous-dossiers, puis remplacez l’ancienne adresse par la nouvelle dans la base de données avec WP-CLI :

wp search-replace 'https://www.votresite.fr/wp-content/uploads/' 'https://www.votresite.fr/medias/' --skip-columns=guid --dry-run

Avec --dry-run, la commande affiche le nombre de remplacements par table sans rien modifier : relancez-la sans cette option une fois le résultat vérifié. wp search-replace gère les données sérialisées (réglages d’extensions, par exemple), et --skip-columns=guid laisse intacts les identifiants uniques des contenus, qui ne doivent jamais changer. Videz ensuite le cache de votre site s’il en utilise un.

Sur un réseau multisite

Sur un réseau multisite créé depuis WordPress 3.5, la constante vaut pour tout le réseau : le site principal utilise le dossier indiqué, et chacun des autres sites un sous-dossier sites suivi de son identifiant (par exemple medias/sites/2). La section Téléversement des médias n’apparaît d’ailleurs pas dans les réglages des sites d’un réseau. Si votre réseau fonctionne en sous-répertoires, gardez le dossier dans wp-content (premier exemple) : les règles de réécriture fournies pour ce type de réseau ne servent les fichiers des sites secondaires que dans wp-content, wp-admin et wp-includes, et leurs médias seraient introuvables ailleurs.

Placer les médias hors de WordPress ou sur un sous-domaine

Avec la constante UPLOADS, le chemin part toujours du dossier de WordPress et l’adresse des fichiers de celle du site. Pour stocker les médias ailleurs sur le serveur et les servir depuis un sous-domaine, utilisez plutôt le filtre upload_dir dans une extension « must-use », un fichier PHP à déposer dans le dossier /wp-content/mu-plugins :

<?php
/**
 * Plugin Name: Custom uploads location
 * Description: Stores uploads outside the WordPress folder and serves them from a dedicated domain.
 */

defined( 'ABSPATH' ) || exit;

// Replace both values with your own folder (absolute path) and address, without a trailing slash.
function wpc_custom_upload_dir( $uploads ) {
	$basedir = '/home/votrecompte/medias';
	$baseurl = 'https://medias.votresite.fr';

	$uploads['path']    = $basedir . $uploads['subdir'];
	$uploads['url']     = $baseurl . $uploads['subdir'];
	$uploads['basedir'] = $basedir;
	$uploads['baseurl'] = $baseurl;

	return $uploads;
}
add_filter( 'upload_dir', 'wpc_custom_upload_dir' );

Remplacez les deux valeurs par le chemin absolu du dossier sur votre serveur et par l’adresse qui le sert, sans barre oblique finale. Le sous-domaine doit déjà pointer vers ce dossier : c’est un réglage de votre hébergement. Une extension « must-use » est toujours active, quel que soit le thème : les adresses de vos médias ne dépendent donc pas d’un changement de thème. Comme avec la constante, les médias déjà envoyés doivent être déplacés et leurs adresses remplacées. Enfin, ce code est prévu pour un site unique : sur un réseau multisite, tous les sites partageraient ce dossier, et la suppression d’un site effacerait les médias de tous les autres.

Pour mieux classer vos fichiers dans l’administration, apprenez à organiser votre bibliothèque de médias en dossiers.