dshovchko/flarum-image-migrate

Check and migrate external images in posts

Maintainers

Details

github.com/dshovchko/flarum-image-migrate

Source

Issues

Installs: 1

Dependents: 0

Suggesters: 0

Security: 0

Stars: 0

Watchers: 0

Forks: 0

Open Issues: 0

Type:flarum-extension

pkg:composer/dshovchko/flarum-image-migrate

v1.0.0 2025-11-23 14:38 UTC

Requires

MIT 88e66117213570d10c2a8355883ce0b27ac3c0b7

  • Dmytro Shovchko <d.shovchko.woop@gmail.com>

migrationimagesflarum

This package is auto-updated.

Last update: 2025-11-23 15:53:34 UTC

README

MIT license Latest Stable Version Total Downloads

A Flarum extension that detects external images in posts and helps migrate them to your own storage.

Features

  • 🔍 Detects external images from non-whitelisted domains
  • 📧 Email reports with detailed statistics
  • ⏰ Scheduled automatic checks (daily/weekly/monthly)
  • đŸŽ¯ Flexible checking: all posts, specific discussion, or single post
  • ⚙ī¸ Configurable allowed domains
  • 📊 Grouped reporting by discussions and posts

Installation

composer require dshovchko/flarum-image-migrate

Usage

Configuration

Configure the extension via the admin panel:

  1. Go to Admin → Extensions → Image Migrate
  2. Set Allowed Origins (comma-separated domains, e.g., example.com, cdn.example.com)
  3. Enable Scheduled Checks (optional)
  4. Set Check Frequency (daily/weekly/monthly)
  5. Add Email Recipients (comma-separated)

⚠ī¸ Scheduled checks require Flarum scheduler to be configured. Add to your crontab:

* * * * * cd /path/to/flarum && php flarum schedule:run >> /dev/null 2>&1

Manual Console Command

Check for external images using the image-migrate:check console command:

# Check a single discussion
php flarum image-migrate:check --discussion=123

# Check a specific post
php flarum image-migrate:check --post=456

# Scan all discussions
php flarum image-migrate:check --all

# Email the report
php flarum image-migrate:check --all --mailto=admin@example.com

# Combine options
php flarum image-migrate:check --all --mailto=admin@example.com,moderator@example.com

ℹī¸ The command requires one of --discussion=<id>, --post=<id>, or --all.

Email Reports

Reports include:

  • Total number of external images found
  • Number of discussions with issues
  • Detailed breakdown by discussion and post
  • Direct links to affected discussions and posts
  • List of external image URLs

Example report format:

External Images Report

Total external images: 56
⚠ī¸ Discussions with issues: 8
==================================================

⚠ī¸ Discussion 8
https://example.com/d/8
 external images in posts (10)
 posts: 14 15 16 17 18 19
  Post #14: 3 image(s)
    https://example.com/d/8/1
    - https://external-cdn.com/image1.jpg
    - https://external-cdn.com/image2.jpg

How It Works

  1. The extension scans post content for <img> tags
  2. Extracts image URLs from the src attribute
  3. Compares image domains against your allowed origins list
  4. Reports any images hosted on external domains
  5. Groups results by discussion and post for easy review

Allowed Origins

Domains in the allowed origins list are considered "internal" and won't be flagged:

  • Exact domain match: example.com matches example.com
  • Subdomain match: example.com matches cdn.example.com, images.example.com
  • Case-insensitive matching
  • Automatic www. prefix handling

Requirements

  • Flarum ^1.0
  • PHP 7.4+

Future Features

  • Automatic image migration to S3/local storage
  • Batch image replacement in posts
  • Integration with external image conversion services

Links

License

MIT