WP Manifestindependent plugin directory
manifest / media / linda-media-sync

Linda Media Sync

Sync unregistered media files to your WordPress Media Library

by lindawp · github.com/onjoma/linda-media-sync · website

★ 0stars
0forks

Install

No release zip yet. The repository archive installs, but the folder name will carry the branch suffix and updates will not flow:

wp plugin install https://github.com/onjoma/linda-media-sync/archive/refs/heads/main.zip
Readme github.com/onjoma/linda-media-sync ↗

🔄 Linda Media Sync

Sync unregistered media files to your WordPress Media Library

Features • Installation • Usage • FAQ • Changelog

🎯 The Problem

You've uploaded files via FTP, migrated from another site, or restored from backup — but those files don't appear in your WordPress Media Library. They exist on your server, but WordPress doesn't know about them. You can't search for them, insert them into posts, or manage them.

✨ The Solution

Linda Media Sync scans your uploads directory, finds unregistered files, and syncs them to your Media Library — making them fully searchable and manageable just like any other media file.

🚀 Features

📁 Smart Scanning

  • Detects unregistered media files
  • Skips WordPress-generated thumbnails
  • AJAX-powered (no timeouts)

🔍 Make Files Searchable

  • Synced files appear in Media Library search
  • Insert into posts/pages normally
  • Full WordPress media management

🎛️ Advanced Filters

  • Filter by type: Images, Documents, Video, Audio
  • Filter by format: JPG, PNG, WebP, PDF, MP4...
  • Date range filtering
  • Duplicate detection (MD5 hash)

📊 User Experience

  • Preview thumbnails for images
  • Pagination (20 files per page)
  • Bulk selection across pages
  • Real-time progress bars

📝 Logging & Reports

  • Complete sync history
  • Export logs to CSV
  • Detailed error tracking

🔒 Safe & Secure

  • Admin-only functionality
  • Preserves original filenames
  • Preserves modification dates
  • No file modifications

📦 Installation

Option 1: Upload via WordPress Admin

  1. Download the plugin zip file
  2. Go to Plugins → Add New → Upload Plugin
  3. Upload and activate

Option 2: Clone from GitHub

cd wp-content/plugins/
git clone https://github.com/yourusername/linda-media-sync.git

🎮 Usage

Media → Linda Media Sync
  1. Set Filters — Choose file type, date range, enable duplicate detection
  2. Scan — Click "Scan for Unsynced Media"
  3. Select — Review results and select files to sync
  4. Sync — Click "Sync Selected" to add to Media Library
  5. Done — Files are now searchable and manageable!

📋 Requirements

Requirement Version
WordPress 5.0+
PHP 7.4+
Permissions Write access to uploads

❓ FAQ

Will this modify my original files?

No. The plugin only creates Media Library database entries. Your files remain exactly where they are, unchanged.

Will synced files be searchable in the Media Library?

Yes! Once synced, files appear in Media Library search results and can be inserted into posts/pages just like any uploaded file.

Does it work with FTP uploads?

Yes! This is the primary use case. Any file in your uploads directory that isn't registered in WordPress can be synced.

What about WordPress thumbnails?

The plugin automatically skips generated thumbnails (e.g., image-300x200.jpg) to prevent duplicates.

Is it safe for production?

Yes. Admin-only, uses WordPress core functions, includes nonce verification, capability checks, and path validation.

📜 Changelog

v2.1.0

  • ✅ Added pagination (20 files per page)
  • ✅ Persistent selection across pages
  • ✅ "Select All Files" bulk action

v2.0.0

  • 🔄 Complete AJAX rewrite
  • 🎛️ File type & extension filters
  • 📅 Date range filtering
  • 🔍 MD5 duplicate detection
  • 🖼️ Preview thumbnails
  • 📊 Sync logging with CSV export
  • 💻 Windows path compatibility

v1.0.0

  • 🎉 Initial release

🤝 Contributing

Contributions welcome! Feel free to submit a Pull Request.

📄 License

GPL v2 or later

Made with ❤️ by LindaWP

Report Bug • Request Feature