Les images individuelles et autres fichiers téléchargés sur votre site Web sont affichés sur une seule page de pièces jointes. Cependant, de nombreux thèmes ne fournissent pas de modèle pour les pièces jointes.
La création d'un modèle de pièces jointes personnalisé dans WordPress vous permet de contrôler la façon dont les pages de pièces jointes individuelles sont affichées, vous donnant la flexibilité d'améliorer à la fois la fonctionnalité et l'esthétique.
Dans cet article, nous vous montrerons comment créer facilement un modèle personnalisé pour les pièces jointes uniques dans WordPress.

Qu'est-ce qu'une page de pièces jointes dans WordPress ?
Par défaut, une page unique est automatiquement créée pour chaque pièce jointe multimédia que vous avez sur votre site Web WordPress. Cela inclut les images, les vidéos, les fichiers audio, les PDF, etc.
Comme les articles et les pages, les pièces jointes sont stockées dans la table wp_posts de votre base de données WordPress. En fait, les pièces jointes sont un type spécial d'article et ont le type d'article 'attachment'. Cela facilite leur recherche et leur affichage.
Les pages de pièces jointes vous permettent d'ajouter des métadonnées à vos téléchargements de fichiers, tels qu'un titre, une légende et une description. Elles permettent également à vos visiteurs de commenter vos images et vidéos.
De nombreux utilisateurs aiment personnaliser leurs modèles de pièces jointes pour afficher des informations supplémentaires. Par exemple, un thème de photographie pourrait utiliser la page de pièce jointe pour afficher les données EXIF. Cela pourrait montrer le modèle d'appareil photo utilisé, les réglages de l'appareil photo et même les données de localisation de l'image.
Cependant, nous vous recommandons de désactiver ces pages de pièces jointes si vous n’avez pas l’intention de les utiliser.
Cela dit, examinons comment créer un modèle personnalisé de pièce jointe unique dans WordPress. Voici ce que nous allons couvrir dans ce guide :
- Comment afficher une page de pièce jointe dans WordPress
- Quel modèle est utilisé pour une page de pièce jointe ?
- Désactiver les pages de pièces jointes dans WordPress
- Créer un modèle personnalisé de pièce jointe unique avec un plugin de constructeur de thème
- Créer un modèle personnalisé de pièce jointe unique à l’aide de code
- Bonus : Ajouter une pièce jointe de publication comme image mise en avant dans WordPress
Comment afficher une page de pièce jointe dans WordPress
Lors de la personnalisation de votre modèle de pièce jointe unique, il est utile d’afficher une page de pièce jointe pour voir vos modifications. Voici quelques façons d’afficher les pages de pièces jointes dans WordPress.
Afficher une page de pièce jointe depuis la médiathèque
Vous devez accéder à la page Média » Bibliothèque depuis le tableau de bord WordPress et cliquer sur une image ou une autre pièce jointe. La fenêtre « Détails de la pièce jointe » s’ouvrira.
Ici, vous pouvez saisir le texte alternatif, le titre, la légende et la description de l’image. Ces informations peuvent être affichées sur la page de pièce jointe, il est donc judicieux de remplir les champs afin de voir comment ils sont affichés.

En bas à droite de la fenêtre, vous verrez un lien « Afficher la page de pièce jointe ».
Lorsque vous cliquez sur ce lien, vous serez redirigé vers la page de pièce jointe de cette image.
Afficher une page de pièce jointe à partir d’une publication ou d’une page
Vous devez simplement ouvrir une publication ou une page dans l’éditeur de contenu WordPress, puis ajouter une image.
Ensuite, sélectionnez l’image et cliquez sur le bouton « Lien » dans la barre d’outils. Dans le menu déroulant, vous verrez l’option pour sélectionner la « Page de pièce jointe ».

Maintenant, lorsque vous cliquerez sur l’image, vous serez redirigé vers sa page de pièce jointe.
Quel modèle est utilisé pour une page de pièce jointe ?
Comme les articles et les pages, vos pièces jointes sont affichées à l'aide d'un modèle. Celui qui est utilisé dépend des modèles disponibles dans votre thème et de la hiérarchie des modèles WordPress.
S'il existe, WordPress utilisera un modèle attachment.php pour contrôler l'apparence de vos pages de pièces jointes. Cependant, vous pouvez également créer différents modèles pour chaque type de fichier qui peut être téléchargé sur votre site.
Par exemple, un fichier modèle nommé image.php contrôlera l'apparence des pages de pièces jointes d'images, et les pages de pièces jointes vidéo peuvent être contrôlées par un modèle appelé video.php.
Vous pouvez même créer un modèle de pièce jointe personnalisé pour des extensions de fichiers spécifiques. Par exemple, le modèle image-gif.php contrôlera les pages de pièces jointes d'images GIF.

Cependant, si votre thème WordPress n'offre pas de modèle spécifique pour les pièces jointes, il utilisera par défaut single.php, le modèle de type de publication unique, ou index.php, le modèle de secours par défaut.
Lorsque cela se produit, vos pages de pièces jointes auront la mise en page de n'importe quel autre article ou page, ce qui ne sera pas toujours esthétique.
Désactiver les pages de pièces jointes dans WordPress
Si vous n'avez pas l'intention d'utiliser les pages de pièces jointes dans WordPress, nous vous recommandons de les désactiver.
De nombreux thèmes n'ont pas de modèles spéciaux pour les pièces jointes, elles peuvent donc ressembler à des pages incomplètes sur votre site. Cela peut laisser une mauvaise impression aux visiteurs.
Elles peuvent également avoir un impact SEO négatif sur votre classement dans les moteurs de recherche. En effet, les moteurs de recherche considèrent les pages avec peu ou pas de texte comme du « contenu de faible qualité » ou « contenu mince ».
Vous pouvez en savoir plus dans notre guide sur comment désactiver les pages de pièces jointes d'images dans WordPress.
Cependant, si vous prévoyez d'utiliser les pages de pièces jointes, continuez à lire pour apprendre comment personnaliser le modèle de pièce jointe dans WordPress. Nous aborderons deux méthodes. La première est la plus simple et utilise un plugin.
Créer un modèle personnalisé de pièce jointe unique avec un plugin de constructeur de thème
La façon la plus simple de créer un modèle personnalisé pour les pièces jointes uniques est d'utiliser SeedProd. C'est le meilleur constructeur de thèmes WordPress et il peut créer de magnifiques mises en page de sites Web et des modèles personnalisés sans écrire de code.
Vous pouvez utiliser SeedProd pour créer un thème WordPress entièrement personnalisé, y compris un modèle personnalisé pour les pièces jointes uniques. Pour plus de détails, vous pouvez consulter notre critique complète de SeedProd.
Remarque : Il existe une version gratuite de SeedProd, mais vous aurez besoin de la version Pro pour accéder au constructeur de thèmes et créer un modèle de pièces jointes personnalisé.
Tout d'abord, vous devez installer et activer le plugin SeedProd. Pour plus de détails, consultez notre guide étape par étape sur comment installer un plugin WordPress.
Après activation, vous devez saisir votre clé de licence. Vous trouverez ces informations dans votre compte sur le site Web de SeedProd.

Après cela, vous devez utiliser SeedProd pour créer facilement un thème WordPress personnalisé.
Créer un thème WordPress personnalisé
Vous trouverez le constructeur de thèmes SeedProd en naviguant vers la page SeedProd » Theme Builder. Ici, vous utiliserez l'un des kits de site ou modèles prêts à l'emploi de SeedProd comme point de départ. Cela remplacera votre thème WordPress existant par un nouveau design personnalisé.
Vous pouvez le faire en cliquant sur le bouton « Thèmes ».

Une liste de thèmes conçus par des professionnels et adaptés à différents types de sites Web vous sera présentée. Par exemple, il existe des modèles appelés « Modern Business », « Marketing Agency » et « Mortgage Broker Theme ».
Parcourez les options et sélectionnez celle qui correspond le mieux à vos besoins en cliquant sur l'icône de coche.

Une fois que vous avez choisi un thème, SeedProd générera tous les modèles de thème dont vous avez besoin. Maintenant, vous pouvez créer un modèle personnalisé pour les pièces jointes uniques.
Création d'un modèle de pièces jointes personnalisé
Par défaut, il n'y a pas de modèle de pièce jointe, et le modèle d'article unique sera utilisé pour les pièces jointes de ce type.

Nous allons corriger cela en créant un nouveau modèle de pièce jointe. Nous utiliserons le modèle d'article unique comme point de départ afin que le nouveau modèle soit cohérent avec votre thème.
Pour ce faire, vous devez survoler le modèle d'article unique. Dupliquez le modèle d'article unique jusqu'à ce que des liens apparaissent. Vous devriez maintenant cliquer sur le lien « Dupliquer » pour créer une copie de ce modèle.

Vous verrez maintenant un nouveau modèle appelé « Article unique - Copie » en haut de la liste.
Pointez simplement votre souris sur le nouveau modèle, puis cliquez sur le lien « Modifier les conditions » qui apparaît.

Une fenêtre apparaîtra, vous permettant de modifier les paramètres du modèle. Vous pouvez commencer par lui donner le nom « Pièces jointes ».
Ensuite, vous devez définir les conditions d'utilisation de ce modèle. Dans la section « Conditions », laissez le premier réglage sur « Inclure », puis sélectionnez « Est une pièce jointe » dans le deuxième menu déroulant.

Après cela, vous devez attribuer une priorité au modèle. Le modèle d'article unique a une priorité de 0, vous devez donc donner à ce modèle une priorité plus élevée afin qu'il soit utilisé à la place pour toutes les pages correspondantes. Pour ce tutoriel, nous attribuerons une priorité de 5.
Une fois que vous avez terminé, assurez-vous de cliquer sur le bouton « Enregistrer » pour sauvegarder les nouveaux paramètres.
Il est maintenant temps de personnaliser le design et le contenu du modèle. Vous pouvez le faire en cliquant sur le lien « Modifier le design ».

Cela ouvrira le constructeur de pages SeedProd. Ici, vous pouvez ajouter du nouveau contenu en faisant glisser des blocs sur la page et en réorganisant le contenu à l'aide du glisser-déposer.
Vous pouvez accéder aux paramètres de n'importe quel bloc en cliquant dessus, et lorsque vous survolez un bloc, vous pouvez le supprimer en cliquant sur l'icône de la corbeille.

Pour ce tutoriel, nous allons supprimer les deux blocs en haut de la page qui sont liés au blog et faire glisser le bloc « Informations sur l'article » pour qu'il soit sous l'image.
Nous allons également supprimer la section des commentaires en bas de la page. Lorsque vous avez terminé, assurez-vous de cliquer sur le bouton « Enregistrer » en haut de la page. Ensuite, vous pouvez fermer le constructeur de pages en cliquant sur le bouton « X » en haut à droite.

Vous vous retrouverez maintenant dans la liste des modèles. Vous devrez activer le nouveau modèle en activant le bouton « Publié ».
Vous pouvez maintenant afficher une page de pièce jointe sur votre site Web pour voir les modifications.

Créer un modèle personnalisé de pièce jointe unique à l’aide de code
Cette méthode est plus avancée et vous devrez ajouter du code aux fichiers de modèle de votre thème WordPress. Si vous ne l'avez jamais fait auparavant, consultez notre guide sur comment copier et coller du code dans WordPress.
Vous perdrez de nombreuses personnalisations de votre thème lors de l'installation d'une mise à jour de votre thème. Nous vous recommandons d'éviter cela en créant un thème enfant et en le personnalisant à la place. Vous en apprendrez davantage dans notre guide sur comment mettre à jour un thème WordPress sans perdre les personnalisations.
Création d'un fichier de modèle de pièce jointe
Tout d'abord, vous devez choisir un modèle que vous allez personnaliser. Pour modifier l'apparence de toutes les pièces jointes, vous devrez personnaliser attachment.php.
Cependant, si vous souhaitez personnaliser uniquement vos images ou vidéos, vous devrez modifier image.php ou video.php.
Ensuite, vérifiez si votre thème contient déjà ces fichiers de modèle. Par exemple, vous trouverez les modèles pour le thème Twenty Twenty-One en visitant le dossier wp/content/themes/twentytwentyone sur le gestionnaire de fichiers de votre hébergement WordPress.

Nous pouvons constater que le thème Twenty Twenty-One possède un modèle image.php mais pas de modèle attachment.php.
Si votre thème ne possède pas le modèle que vous souhaitez personnaliser, vous devrez le créer. Enregistrez simplement un fichier vierge avec le nom de fichier dont vous avez besoin.
Ensuite, copiez le contenu du fichier single.php dans votre nouveau fichier vierge, puis enregistrez-le. Cela garantira que votre modèle de pièce jointe soit visuellement cohérent avec le reste de votre site Web.
Vous avez maintenant un nouveau modèle de pièce jointe, mais jusqu'à présent, vos pages de pièces jointes auront la même apparence qu'auparavant. Il est temps de faire quelques personnalisations.
Personnalisation du fichier de modèle de pièce jointe
Vous pouvez maintenant personnaliser votre page de pièces jointes en apportant des modifications au code du modèle. Le fichier de modèle est comme tout autre fichier de thème dans WordPress. Vous pouvez ajouter n'importe quel HTML, balises de modèle ou code PHP à ce fichier.
Vous pouvez télécharger le modèle sur votre ordinateur et l'ouvrir dans n'importe quel éditeur de texte, tel que le Bloc-notes. Une fois que vous avez terminé de modifier le code, enregistrez simplement le fichier et téléchargez-le à nouveau dans votre dossier de thème à l'aide de FTP.
Voici quelques exemples de la façon dont vous pourriez personnaliser le modèle image.php du thème Twenty Twenty-One. Voici à quoi il ressemble avant que nous apportions des modifications.

La page commence par le titre de l'image, suivi de l'image elle-même et d'une légende. Ensuite, vous trouverez une description de l'image et d'autres détails la concernant. Enfin, la section des commentaires s'affiche.
Vous pouvez réorganiser l'ordre dans lequel ces sections sont affichées. Par exemple, vous pourriez déplacer le code de l'image au-dessus du titre.

Vous pouvez également supprimer la légende de l'image en supprimant simplement les lignes de code qui l'affichent.
Voici à quoi ressemble maintenant la page de la pièce jointe.

Si vous préférez ne pas autoriser vos visiteurs à laisser des commentaires sur vos images, vous pouvez supprimer complètement la section des commentaires.
Supprimez simplement les lignes de code près du bas qui affichent la section des commentaires.

Bonus : Ajouter une pièce jointe de publication comme image mise en avant dans WordPress
La plupart des thèmes WordPress affichent des miniatures à côté des articles de blog sur votre site Web. Cependant, si vous venez de passer d'un thème qui ne prenait pas en charge cette fonctionnalité, vous aurez beaucoup d'espace noir sur votre page de blog.
Comme il est long de créer des images mises en avant pour tous les articles de blog publiés, vous pouvez utiliser les pièces jointes des articles comme miniatures. Cela augmentera le trafic de votre blog et l'engagement des utilisateurs.
Pour ce faire, installez et activez le plugin Auto Featured Image. Ensuite, visitez la page Auto Featured Image » Paramètres et sélectionnez l'option « Trouver dans l'article » dans le menu déroulant « Méthode de génération ».

Ensuite, décochez l'option « Pages » dans la section « Générer pour les types d'articles ».
Ensuite, passez à la section « Générer des images » en haut et choisissez l'option « Articles » dans le menu déroulant « Type d'article ».
Le plugin affichera maintenant le nombre d'articles de blog qui n'ont pas d'image mise en avant. Ici, cliquez sur le bouton « Générer des images mises en avant ».

Désormais, tous les articles de blog qui n'ont pas d'image mise en avant afficheront automatiquement la première image jointe comme miniature. Pour plus de détails, consultez notre tutoriel sur comment ajouter des pièces jointes d'article comme images mises en avant dans WordPress.
Nous espérons que ce tutoriel vous a aidé à apprendre comment créer un modèle personnalisé pour les pièces jointes dans WordPress. Vous pourriez également vouloir apprendre comment retirer une page WordPress de la publication ou consulter notre liste des pages importantes que chaque blog devrait avoir.
Si cet article vous a plu, abonnez-vous à notre chaîne YouTube pour des tutoriels vidéo WordPress. Vous pouvez également nous retrouver sur Twitter et Facebook.


apachx
Comment ouvrir n'importe quelle image d'un article dans une nouvelle page comme ceci :
Et comment afficher toutes les images d'un article en bas de cette page d'image (plus les boutons SUIVANT, PRÉCÉDENT) ?
Caroline
J'ai créé un attachment.php mais il semble ne pas fonctionner. Les pages de pièces jointes et leur mise en page ressemblent toujours à avant. Ai-je manqué quelque chose ?
Wayne G.
Merci pour cet article. Il m'a vraiment aidé.
J'ai eu un problème où Google a indexé une de mes pages de pièces jointes comme s'il s'agissait de contenu. J'ai cherché des recettes pour le résoudre et rien ne semblait fonctionner. Le plugin SEO de Yost fait cela, mais j'en utilise un autre et je ne veux pas le changer. D'autres suggestions ont fonctionné, mais elles ont affecté certains de mes travaux sur les types de publication personnalisés.
Puis j'ai vu cet article et j'ai réalisé que tout ce que j'avais à faire était de créer une page single-attachment.php avec du javascript qui se rafraîchit vers la page d'accueil et cela fonctionne très bien !
Quelqu'un sait-il s'il y a un inconvénient à faire cela ?
L'équipe de WPBeginner
Monolops, vous pouvez joindre des fichiers .zip à une publication et, lors de leur ajout à une publication, vous pouvez choisir de lier à la page de pièce jointe au lieu du fichier. Désormais, lorsque les utilisateurs cliqueront sur le lien du fichier, ils seront dirigés vers la page de pièce jointe.
Découvrez comment le thème Twenty Thirteen affiche les fichiers .zip différemment des images en étudiant son modèle attachment.php.
Une solution plus simple pourrait être d'utiliser le plugin WP File Manager.
monoloops
Salut, merci de l'avoir signalé. Je vais chercher la page de pièce jointe dans ce thème... Je sais que je peux pointer un fichier .zip vers la page de pièce jointe mais je ne sais pas comment le personnaliser... C'est mon problème... WP File Manager est un bon plugin mais il n'offre que des téléchargements directs. Mais avec la page de pièce jointe, vous obtenez un endroit agréable supplémentaire pour les publicités lorsque quelqu'un veut télécharger ces fichiers gratuits...
monoloops
Very nice tutorial..I am wordpress beginer in customizing and I love your website. Can you please help me with this matter but instead of photography I need file attachment like .zip or .rar. I’ve tried to work on my own based on your tutorial but my skills isn’t on that level yet
Every google search for customizing attachment page is about images. No one thinks that people might want to share files i guess…
Rita
Ce code a fonctionné à merveille – merci beaucoup !
Agnes
Je suis intéressé à utiliser single-attachment.php pour afficher les pièces jointes avec du contenu.
Cependant, ce que j'aimerais vraiment, c'est d'obtenir la liste de ces pages dans mon sitemap, et je n'ai pas pu y parvenir avec les plugins existants (une liste d'URL d'images, mais pas l'URL des pages d'images/pièces jointes)
Je pense donc à avoir une page ou une archive qui listerait toutes les URL des pages d'images/pièces jointes. Comment ferais-je cela ?