Title: Media Sync
Author: erolsk8
Published: <strong>27 avril 2018</strong>
Last modified: 21 mai 2026

---

Recherche d’extensions

![](https://ps.w.org/media-sync/assets/icon.svg?rev=2021152)

# Media Sync

 Par [erolsk8](https://profiles.wordpress.org/erolsk8/)

[Télécharger](https://downloads.wordpress.org/plugin/media-sync.1.5.2.zip)

 * [Détails](https://fr.wordpress.org/plugins/media-sync/#description)
 * [Avis](https://fr.wordpress.org/plugins/media-sync/#reviews)
 *  [Installation](https://fr.wordpress.org/plugins/media-sync/#installation)
 * [Développement](https://fr.wordpress.org/plugins/media-sync/#developers)

 [Support](https://wordpress.org/support/plugin/media-sync/)

## Description

Cette extension vous permet d’examiner tous les fichiers dans le répertoire `uploads`
pour déterminer lesquels sont présents dans la médiathèque et lesquels sont simplement
inutilisés. Vous pouvez ensuite choisir les fichiers que vous souhaitez importer
dans la base de données, les incluant ainsi dans la médiathèque.

De plus, vous pouvez utiliser FTP pour téléverser des fichiers directement dans 
le répertoire `uploads` et ensuite ajouter ces fichiers à la médiathèque, évitant
ainsi toute limitation de taille de fichier.

#### Avertissements

 1. « 1 fichier d’abord »
     Veuillez essayer d’abord d’importer un seul fichier pour
    voir si cela fonctionne comme vous le souhaitez.
 2. « Tout à la fois »
     Cette extension est conçue pour scanner, sélectionner et importer**
    tous les fichiers à la fois**. Cependant, en fonction de la configuration de votre
    serveur, des problèmes de mémoire et de délai peuvent survenir avec de grandes 
    quantités de fichiers. Pour atténuer cela, une [nouvelle version pro](https://mediasyncplugin.com/?utm_source=readme&utm_medium=base_plugin&utm_campaign=aao)
    remaniée utilise des analyses de répertoires incrémentielles pour résoudre efficacement
    ces problèmes.
 3. « Votre configuration est unique »
     Veuillez être conscient que chaque installation
    de WordPress est unique, et il peut y avoir des cas où cette extension ne fonctionne
    pas comme prévu. Si cela se produit, nous vous recommandons d’activer la fonctionnalité
    de débogage dans les réglages de l’extension pour identifier le problème. Après
    enquête, veuillez fournir une description détaillée de vos conclusions dans la 
    section Support (ou [ici](https://users.freemius.com/store/6428/support) si vous
    utilisez la version pro). Plus les détails sont complets, plus la probabilité de
    résoudre le problème efficacement est élevée.

#### Fichiers ignorés

 * divers fichiers cachés (.DS_Store, .htaccess),
 * Miniatures générées par WP (fichiers se terminant par exemple par -100×100.jpg),
 * WP a généré des images redimensionnées (fichiers se terminant par -scaled),
 * versions .webp optimisées des images originales (.jpg.webp),
 * miniatures retina (-100×100@2x.jpg).

Ceux-ci peuvent être modifiés et améliorés à l’aide des nouveaux filtres avancés
disponibles dans la [version pro](https://mediasyncplugin.com/?utm_source=readme&utm_medium=base_plugin&utm_campaign=df).

#### Fonctionnalités de Media Sync Pro

 * **Analyse incrémentielle révisée** : Autorise l’analyse et l’importation d’un
   nombre illimité de fichiers.
 * **Ré-analyse rapide d’un seul répertoire** : Ré-analyser facilement un répertoire
   pour trouver de nouveaux fichiers ou appliquer un filtre différent sans recharger
   toute la page.
 * **Filtres avancés** : Trouvez n’importe quel fichier en personnalisant tous les
   filtres par défaut, recherchez un type de fichier spécifique (images, vidéos,
   etc.), passez par des règles sur mesure ou saisissez n’importe quelle composition
   personnalisée.
 * **Planifier les importations automatiques** : Sélectionnez un intervalle souhaité
   et laissez l’extension importer automatiquement tous les nouveaux fichiers qu’elle
   trouve.
 * **Journaux d’importation** : Voir l’historique des importations manuelles ou 
   planifiées.
 * **Limiter l’accès aux extensions** : Limiter l’accès aux extensions à un rôle
   spécifique.

Obtenez la [version pro ici](https://mediasyncplugin.com/?utm_source=readme&utm_medium=base_plugin&utm_campaign=pfl).

## Captures d’écrans

 * [[
 * Page d’accueil
 * [[
 * Exemple de sélection de fichiers à importer
 * [[
 * Importation vers la médiathèque en cours
 * [[
 * Importation terminée

## Installation

 1. Téléverser le répertoire `media-sync` dans le répertoire `/wp-content/plugins/`
 2. Activer l’extension via le menu « Extensions » dans WordPress.

## FAQ

### Bloqué sur l’importation/tourne indéfiniment

Veuillez essayer d’augmenter `max_execution_time` (et/ou `memory_limit`) dans `php.
ini` sur le serveur (comme décrit [« >ici](https://thimpress.com/knowledge-base/how-to-increase-maximum-execution-time-for-wordpress-site/)).

### Les fichiers n’apparaissent pas dans la médiathèque

Veuillez vous assurer que l’option « Dry Run » n’est PAS cochée. Il s’agit d’un 
mécanisme de sécurité pour vous assurer que vous savez ce que vous faites, alors
soyez prudent, essayez d’abord avec un seul fichier.

### Ne marche pas

Veuillez d’abord essayer d’activer le débogage dans Réglages -> Synchronisation 
des médias et vérifier l’[onglet Réseau dans Chrome DevTools](https://www.section.io/blog/chrome-developer-tools-tutorial-network/)
pour voir ce qui se passe en arrière-plan. Ensuite, signalez les erreurs réelles,
car il est difficile d’aider sans connaître l’erreur qui cause le problème.

## Avis

![](https://secure.gravatar.com/avatar/8006731d7ac58d1b431a0f826fa2ae72ca8552043e1e46ac7220d89ed5716c3b?
s=60&d=retro&r=g)

### 󠀁[Did exactly what I needed!](https://wordpress.org/support/topic/did-exactly-what-i-needed-42/)󠁿

 [swinggraphics](https://profiles.wordpress.org/swinggraphics/) 20 mai 2026

I needed to add some PDFs to the Media Library that were uploaded via FTP, without
changing their location. This plugin did that. 👍

![](https://secure.gravatar.com/avatar/cbd1a5c91b3aa3729370c69226023b710b1912ac6ba8fec130828068514e625c?
s=60&d=retro&r=g)

### 󠀁[Perfect!](https://wordpress.org/support/topic/perfect-10984/)󠁿

 [kiprokoparis](https://profiles.wordpress.org/kiprokoparis/) 14 mai 2026

So useful and simple to use

![](https://secure.gravatar.com/avatar/e84927b8e76c78f1fa46711e570fc521393028ec4faadcc0a470c55910179685?
s=60&d=retro&r=g)

### 󠀁[Great Timesaver!](https://wordpress.org/support/topic/great-timesaver-27/)󠁿

 [gopar3](https://profiles.wordpress.org/gopar3/) 1 février 2026

I backed up a site then brought the staging site live, only to find out they’d ‘
forgotten’ several important documents that had been on the old site but not the
new one. I was able to restore the files, but they didn’t show up in my Media Library.
This worked great and saved me a TON of time and headache. Thank you so much.

![](https://secure.gravatar.com/avatar/989824b0e7508599671c7f979acc5f858c1a8313c0ae0e6a11a5d26bb3639805?
s=60&d=retro&r=g)

### 󠀁[So useful!](https://wordpress.org/support/topic/so-useful-143/)󠁿

 [Cyrille Sanson](https://profiles.wordpress.org/css31/) 25 décembre 2025

The ideal tool for adding media files via FTP to the media library.Thanks a lot 
to the developer!

![](https://secure.gravatar.com/avatar/7c2a3a2948eac25be354a7672cf84b6fabd35b1cd018d4359e6f1a5adc1fbf92?
s=60&d=retro&r=g)

### 󠀁[Completly hang the admin](https://wordpress.org/support/topic/completly-hang-the-admin/)󠁿

 [remedia222](https://profiles.wordpress.org/remedia222/) 18 décembre 2025 1 réponse

The page simply hangs the server, Javascript crash, when it finally works counts
are completly off. I’m not trusting this quality of code with my database.

![](https://secure.gravatar.com/avatar/5f0765aae4be9ea123bad3160209865411d8b325077a927b9f2441c951d9315e?
s=60&d=retro&r=g)

### 󠀁[Exactly what it promised](https://wordpress.org/support/topic/exactly-what-it-promised/)󠁿

 [Fox Lee](https://profiles.wordpress.org/fox-lee/) 24 juillet 2025

I inherited a site with a badly broken media library, thanks to half-successful 
imports from multiple other sites and WIP versions. Media Sync was the perfect thing
for getting everything recognised, super quick and super easy. I love it when a 
tool just does exactly what it’s meant to!

 [ Lire les 84 avis ](https://wordpress.org/support/plugin/media-sync/reviews/)

## Contributeurs/contributrices & développeurs/développeuses

« Media Sync » est un logiciel libre. Les personnes suivantes ont contribué à cette
extension.

Contributeurs

 *   [ erolsk8 ](https://profiles.wordpress.org/erolsk8/)
 *   [ Simon Kane ](https://profiles.wordpress.org/simonkane/)

“Media Sync” a été traduit dans 6 locales. Remerciez [l’équipe de traduction](https://translate.wordpress.org/projects/wp-plugins/media-sync/contributors)
pour ses contributions.

[Traduisez « Media Sync » dans votre langue.](https://translate.wordpress.org/projects/wp-plugins/media-sync)

### Le développement vous intéresse ?

[Parcourir le code](https://plugins.trac.wordpress.org/browser/media-sync/), consulter
le [SVN dépôt](https://plugins.svn.wordpress.org/media-sync/), ou s’inscrire au 
[journal de développement](https://plugins.trac.wordpress.org/log/media-sync/) par
[RSS](https://plugins.trac.wordpress.org/log/media-sync/?limit=100&mode=stop_on_copy&format=rss).

## Journal des modifications

#### 1.5.2

 * When importing images or PDFs, use embedded metadata title (PDF info dictionary,
   XMP, or EXIF) instead of the filename.

#### 1.5.1

 * Fix file name corruption on Windows caused by `realpath()` returning OS-native
   paths. Path validation now preserves the original file path after security checks
   pass.

#### 1.5.0

 * Security: Fix path traversal vulnerability (CVE-2026-6670) in `sub_dir` and `
   media_items` parameters. File paths are now validated with `realpath()` and restricted
   to the « uploads » directory. Stream wrappers (e.g. `ftp://`, `php://`) are rejected.
   Reported by Drew Webber (mcdruid) via Wordfence.

#### 1.4.9

 * Fix regex to avoid PHP warnings.
 * Better error handling for expected memory or timeout issues when scanning for
   more files than your server is able to handle.
 * Tested for WordPress 6.9.
 * Tested for WordPress 6.9.4 and 7.0.

#### 1.4.8

 * Testé avec WordPress 6.8

#### 1.4.7

 * Replace loading of external script for purchasing Pro version with simple external
   link
 * Testé avec WordPress 6.7

#### 1.4.6

 * Minor maintenance adjustment to prepare promo banner for upcoming redesign
 * Tested for WordPress 6.6.1

#### 1.4.5

 * Fix DOM IDs when scanning directories or files with special non-latin characters
 * Bring back promo banner without remote fetch

#### 1.4.4

 * Decode `post_title` and `guid` in attachment data
 * Testé avec WordPress 6.5.5

#### 1.4.3

 * Disable fetching promo banner from remote origin in hopes of resolving 404 errors
 * Load plugin only on admin pages
 * Testé avec WordPress 6.5.4
 * Get proper error message from `wp_insert_attachment` function

#### 1.4.2

 * Fix enabling or disabling debugging option
 * Fix various issues with paths on Windows servers
 * Remove « Scan directory » option to simplify plugin maintenance and compatibility
   with Windows servers
 * Tested for WordPress 6.5.3

#### 1.4.1

 * Fix deprecated warnings with PHP 8.1
 * Increase required versions to WordPress 5.3 and PHP 7.1

#### 1.4.0

 * Add correct plugin version when loading assets and updated readme.txt.

#### 1.3.3

 * Fix detecting files that already in database when « Scan directory » option is
   used. Issue started in previous version (1.3.2).

#### 1.3.2

 * Fix handling file names with even rarer special characters that might have resulted
   in duplicate imports.

#### 1.3.1

 * Ignore optimized .webp versions of original images (e.g. .jpg.webp) and retina
   thumbnails (e.g. -100×100@2x.jpg) by default. It’s still possible to customize
   it with `media_sync_filter_is_scan_object_ignored` hook.

#### 1.3.0

 * New option to set custom Batch Size. This might help with errors due to server
   limits (e.g. max_execution_time).

#### 1.2.9

 * Fix selecting multiple files without clicking on checkbox (e.g. shift-select).
 * Minor code cleanup.
 * Update supported WordPress version to 6.2.

#### 1.2.8

 * Create a custom `_msc` record in `wp_postmeta` table to be able to differentiate
   files imported using this plugin. Could be useful to clean up the database later
   on.

#### 1.2.7

 * Extend plugin access to « Editor » and « Author » roles.

#### 1.2.6

 * If debugging is turned on, AJAX requests for import are now `html` which is rendered
   directly in UI.

#### 1.2.5

 * New filter hook (`media_sync_filter_before_update_metadata`) which can be used
   to customize how metadata is updated or to run additional actions after file 
   import.

#### 1.2.4

 * Handle files with quotes (apostrophes) or other special characters in the file
   name.
 * Continue importing other selected files if there was an error with some of the
   files.
 * Show errors in UI instead of alert.

#### 1.2.3

 * Better error handling and fallback when finding mime type

#### 1.2.2

 * Fix meta data errors caused by invalid mime types

#### 1.2.1

 * Much better error handling while importing

#### 1.2.0

 * Optimized directory scanning to use less memory
 * New option to turn on debugging for this plugin
 * Changed parameters passed to `media_sync_filter_is_scan_object_ignored` hook 
   function
 * Now requires PHP 5.5

#### 1.1.8

 * Fix handling big (« -scaled.jpg ») images [introduced in WordPress 5.3](https://make.wordpress.org/core/2019/10/09/introducing-handling-of-big-images-in-wordpress-5-3/).
   These files will now be skipped and won’t be imported multiple times.
 * Add handy « Re-scan » button.

#### 1.1.7

 * Fix issues when importing files containing special characters

#### 1.1.6

 * Slight improvements with error handling in JavaScript

#### 1.1.5

 * Always convert backslashes (`\`) to forward slashes (`/`) to fix various issues
   when using Windows Server.

#### 1.1.4

 * Important backslash (`\`) vs forward slash (`/`) fix for use on Windows Server.

#### 1.1.3

 * New option to set « Scan directory » in settings which will allow checking only
   certain sub directory.
 * New hook function `media_sync_filter_is_scan_object_ignored` which can be used
   to overwrite which files are ignored by default or to just skip additional files.

#### 1.1.2

 * Fix Smart File Time on Windows server

#### 1.1.1

 * Reduce the maximum number of items to import per batch from 20 to 10.
    So batch
   sizes are now: 1 (importing 1 to 10 items); 5 (importing 11 to 100 items) or 
   10 (importing more than 100 items)

#### 1.1.0

 * [IMPORTANT] Date of imported Media Library items now defaults to the current 
   date.
    But there are options to choose before importing and also a possibility
   to overwrite that using the custom hook.
 * New options page with the option to disable and hide « Dry Run ».
 * Fix Media Library filter that was showing all items when the filter didn’t find
   any result.

#### 1.0.4

 * Reduce the number of items to import per batch

#### 1.0.3

 * Support multisite network by changing required access [capability](https://wordpress.org/support/article/roles-and-capabilities/#capability-vs-role-table)
   from `update_plugins` to `import`

#### 1.0.2

 * Another fix for get_current_screen error

#### 1.0.1

 * Fix get_current_screen error

#### 1.0.0

 * New option to clean up Media Library from items that are missing actual files(
   using custom Media Library filter)
 * New filter when scanning uploads directory which can help to show only files 
   missing from Media Library

#### 0.1.6

 * Fix PHP short array syntax
 * Mettre à jour en version PHP 5.4 nécessaire

#### 0.1.5

 * Date of imported Media Library item is now set based on file modification timestamp

#### 0.1.4

 * Add plugin localization
 * Add Serbian translation

#### 0.1.3

 * Various improvements and fixes

#### 0.1.2

 * Fix sorting of directories and files
 * Minor wording changes and code cleanup

#### 0.1.1

 * Fix error on activation

#### 0.1.0

 * Initial plugin features

## Méta

 *  Version **1.5.2**
 *  Dernière mise à jour **il y a 1 semaine**
 *  Installations actives **40 000+**
 *  Version de WordPress ** 5.3 ou plus **
 *  Testé jusqu’à **7.0**
 *  Version de PHP ** 7.4 ou plus **
 *  Langues
 * [Chinese (Taiwan)](https://tw.wordpress.org/plugins/media-sync/), [Dutch](https://nl.wordpress.org/plugins/media-sync/),
   [English (US)](https://wordpress.org/plugins/media-sync/), [French (France)](https://fr.wordpress.org/plugins/media-sync/),
   [Russian](https://ru.wordpress.org/plugins/media-sync/), [Spanish (Chile)](https://cl.wordpress.org/plugins/media-sync/),
   et [Spanish (Spain)](https://es.wordpress.org/plugins/media-sync/).
 *  [Traduisez la dans votre langue](https://translate.wordpress.org/projects/wp-plugins/media-sync)
 * Étiquettes
 * [ftp](https://fr.wordpress.org/plugins/tags/ftp/)[import](https://fr.wordpress.org/plugins/tags/import/)
   [media](https://fr.wordpress.org/plugins/tags/media/)[server](https://fr.wordpress.org/plugins/tags/server/)
   [uploads](https://fr.wordpress.org/plugins/tags/uploads/)
 *  [Vue avancée](https://fr.wordpress.org/plugins/media-sync/advanced/)

## Évaluations

 4.7 sur 5 étoiles.

 *  [  77 avis à 5 étoiles     ](https://wordpress.org/support/plugin/media-sync/reviews/?filter=5)
 *  [  0 avis à 4 étoile     ](https://wordpress.org/support/plugin/media-sync/reviews/?filter=4)
 *  [  0 avis à 3 étoile     ](https://wordpress.org/support/plugin/media-sync/reviews/?filter=3)
 *  [  3 avis à 2 étoiles     ](https://wordpress.org/support/plugin/media-sync/reviews/?filter=2)
 *  [  4 avis à 1 étoiles     ](https://wordpress.org/support/plugin/media-sync/reviews/?filter=1)

[Your review](https://wordpress.org/support/plugin/media-sync/reviews/#new-post)

[Voir tous les avis](https://wordpress.org/support/plugin/media-sync/reviews/)

## Contributeurs

 *   [ erolsk8 ](https://profiles.wordpress.org/erolsk8/)
 *   [ Simon Kane ](https://profiles.wordpress.org/simonkane/)

## Support

Demandes résolues ces deux derniers mois :

     3 sur 6

 [Voir le forum de support](https://wordpress.org/support/plugin/media-sync/)

## Faire un don

Souhaitez-vous soutenir l’avancement de cette extension ?

 [ Faire un don à cette extension ](https://mediasyncplugin.com/?utm_source=readme&utm_medium=base_plugin&utm_campaign=donate_link)