Aide et documentation

Démarrage rapide

1. 1InstallerDans l’administration, sous Extensions → Ajouter, recherchez « Replace External Images » et activez l’extension.
2. 2SélectionnerSous Articles ou Pages, cochez les entrées et choisissez l’action groupée « Replace External Images ».
3. 3VérifierLa fenêtre d’import affiche chaque image. Les images ignorées apparaissent dans le journal avec leur motif.

Installation

Replace External Images est disponible gratuitement sur WordPress.org et nécessite WordPress 5.0 et PHP 7.4.

1. Dans l’administration, allez dans Extensions → Ajouter.
2. Recherchez Replace External Images.
3. Cliquez sur Installer maintenant, puis sur Activer.

Au premier lancement, l’extension vous demande si vous souhaitez partager des données d’utilisation anonymes. C’est facultatif ; avec Passer, l’extension fonctionne exactement de la même façon. Vous trouverez ensuite dans la barre latérale la nouvelle entrée de menu Images externes.

Importer un article

1. Ouvrez l’article ou la page dans l’éditeur.
2. Dans la barre latérale, vous trouverez le panneau Replace External Images.
3. Cliquez sur Importer les images externes.
4. La fenêtre d’import s’ouvre et affiche la progression pour chaque image.

Enregistrez d’abord l’article si vous avez des modifications non enregistrées. L’extension travaille avec le contenu enregistré.

Plusieurs articles à la fois

1. Ouvrez Articles ou Pages (avec Pro, également les produits et les types de contenu personnalisés).
2. Cochez les entrées souhaitées. Via Options de l’écran, vous pouvez afficher davantage d’entrées par page.
3. Sous Actions groupées, choisissez Replace External Images et cliquez sur Appliquer.
4. Laissez l’onglet ouvert jusqu’à la fin de l’import.

La fenêtre d’import affiche en haut la progression globale et, en dessous, pour chaque entrée, les images importées, réutilisées ou ignorées. Avec Problèmes uniquement, vous masquez tout ce qui a réussi ; avec Copier le journal, vous copiez l’intégralité du journal dans le presse-papiers.

Ce qui se passe lors de l’import

• Trouver les images : l’extension recherche dans le contenu les images qui ne se trouvent pas sur votre propre domaine. Une image mise en avant externe est également prise en compte.
• Télécharger : chaque image est téléchargée et l’extension vérifie qu’il s’agit bien d’une image. Les pages contenant des messages d’erreur ou des formulaires de connexion ne sont pas enregistrées.
• Éviter les doublons : si une image a déjà été importée depuis la même adresse, elle est réutilisée. Des fichiers portant le même nom mais provenant de sources différentes reçoivent chacun leur propre nom.
• Remplacer : l’ancienne adresse de l’image dans le contenu est remplacée par l’adresse dans votre Médiathèque.
• Image mise en avant : si l’entrée n’a pas encore d’image mise en avant, la première image importée est utilisée.

Historique des imports

Sous Images externes → Historique des imports, chaque import figure avec sa date, la personne qui l’a lancé et son résultat. Afficher les éléments et le journal d’import montre les articles concernés et ce qui s’est passé pour chaque image. Copier le journal vous donne le journal complet, par exemple pour le support. L’historique est conservé 90 jours ; sous Images externes → Réglages, vous pouvez choisir entre 30 et 365 jours.

Annuler un import Pro

Dans l’Historique des imports, chaque import dispose d’un bouton Annuler. Après une brève confirmation, voici ce qui se passe :

• Toutes les entrées retrouvent le contenu qu’elles avaient avant l’import.
• L’image mise en avant précédente est restaurée.
• Les images ajoutées par l’import sont supprimées de la Médiathèque, à condition qu’elles ne soient utilisées nulle part ailleurs.

Si une entrée a été modifiée après l’import, elle est d’abord ignorée afin que vos modifications ne soient pas perdues. Un avertissement s’affiche alors, et vous pouvez restaurer ces entrées en connaissance de cause avec Restaurer quand même.

Activer Pro

1. Télécharger Pro : dans WordPress, sous Images externes → Aide et support, cliquez sur Télécharger Pro dans l’encadré « Votre licence ». Le lien de téléchargement figure aussi dans l’e-mail d’achat et dans votre compte client.
2. Téléverser et activer : sous Extensions → Ajouter une extension → Téléverser une extension, sélectionnez le fichier ZIP, installez-le et activez-le. La version gratuite est désactivée automatiquement ; vos réglages et l’historique des imports sont conservés.
3. Licence : si vous avez acheté depuis l’extension, la licence est déjà associée à votre site. Si vous avez acheté sur notre site, Pro vous demande au premier lancement la clé de licence figurant dans l’e-mail d’achat.

Vous trouverez à tout moment vos licences, factures et téléchargements dans votre compte client. Vous pouvez également y transférer une licence vers un autre site. Les environnements de test et de développement comme localhost ou staging ne comptent pas comme un site à part entière.

WP-CLI Pro Unlimited

Pour les grosses migrations, vous pouvez piloter l’extension en ligne de commande. Cela fonctionne sans navigateur et sans limite de temps.

Commande	Ce qu’elle fait
wp replexim scan	Liste toutes les entrées contenant des images externes.
wp replexim import	Importe toutes les images externes.
wp replexim runs	Affiche les derniers imports avec leur identifiant d’exécution (Run-ID).
wp replexim undo <run-id>	Annule un import.

Options utiles :

wp replexim scan --post_type=product --format=csv
wp replexim import --post_type=post,page --limit=500
wp replexim import --ids=12,15,99 --dry-run
wp replexim undo cli-20261018-150943-wzsvde --force

--dry-run affiche uniquement ce qui se passerait. Avec undo, --force restaure également les entrées modifiées après l’import.

Si des images ne sont pas importées

Certaines images ne peuvent techniquement pas être récupérées. Ce n’est pas une erreur de l’extension : le serveur tiers refuse de fournir l’image. L’extension ignore ces images, n’enregistre aucun fichier défectueux et indique le motif dans le journal.

Message	Signification	Ce que vous pouvez faire
Bloqué par la source (HTTP 403, 401, 451)	Le serveur refuse le téléchargement, souvent en raison d’une protection contre le hotlinking.	Télécharger l’image manuellement et la téléverser dans la Médiathèque.
Pas une image (text/html)	Au lieu de l’image, le serveur renvoie une page web, par ex. une page de connexion ou de vérification.	Ouvrir l’adresse dans le navigateur et vérifier ; si nécessaire, remplacer l’image manuellement.
Échec du téléchargement	Serveur injoignable, délai dépassé ou erreur SSL.	Réessayer plus tard ; si le domaine est hors service, l’image est perdue.
Réponse vide	Le serveur renvoie un fichier vide.	Réessayer plus tard ou remplacer l’image manuellement.

Vous pouvez relancer un import à tout moment. Les images déjà importées sont alors réutilisées et ne sont pas enregistrées en double.

Langues

L’extension suit la langue de votre installation WordPress. Elle est disponible en allemand, anglais, français, espagnol et italien. Les variantes régionales comme l’allemand (Autriche) ou le français (Canada) utilisent la langue principale ; toutes les autres langues utilisent l’anglais.

Questions fréquentes

Dois-je réenregistrer chaque article ?

Non. L’import groupé traite les articles existants directement depuis la liste.

Les images déjà présentes dans la Médiathèque sont-elles écrasées ?

Non. Seules les images externes sont importées. Les images déjà importées sont réutilisées.

Est-ce compatible avec Gutenberg et l’éditeur classique ?

Oui, avec les deux. L’extension travaille directement avec le contenu enregistré.

Est-ce compatible avec les produits WooCommerce ?

Oui, avec Pro. Pro prend en charge les produits WooCommerce et tous les types de contenu personnalisés.

L’extension collecte-t-elle des données ?

Uniquement si vous l’acceptez au premier lancement. Dans ce cas, des informations de base comme la version de WordPress et de PHP sont transmises via notre service de licences Freemius. Sans votre consentement, aucune donnée n’est envoyée.

J’ai acheté un module complémentaire par le passé. Que faire ?

Pro inclut tous les anciens modules complémentaires. Vous recevez Pro gratuitement : écrivez-nous simplement à plugins@hansandfriends.de.

Support

Pour que nous puissions vous aider rapidement : envoyez-nous l’adresse de l’article concerné ainsi que le journal d’import (bouton « Copier le journal » dans la fenêtre d’import). Le support couvre tout ce qui concerne l’extension, mais pas l’aide générale sur WordPress ni les problèmes liés au thème ou à l’hébergement.