PHPackages                             eighteen73/wordpress-thumbor - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Image & Media](/categories/media)
4. /
5. eighteen73/wordpress-thumbor

ActiveWordpress-plugin[Image & Media](/categories/media)

eighteen73/wordpress-thumbor
============================

A WordPress plugin to serve media via a Thumbor server

v0.2.0(9mo ago)26101[2 issues](https://github.com/eighteen73/wordpress-thumbor/issues)MITPHPPHP >=8.0

Since Feb 1Pushed 9mo ago4 watchersCompare

[ Source](https://github.com/eighteen73/wordpress-thumbor)[ Packagist](https://packagist.org/packages/eighteen73/wordpress-thumbor)[ RSS](/packages/eighteen73-wordpress-thumbor/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (3)Dependencies (1)Versions (9)Used By (0)

Thumbor for WordPress
=====================

[](#thumbor-for-wordpress)

**This plugin is in early development and may yet undergo changes that affect its functionality. Use it at your own risk until we publish a versioned release.**

This plugin modifies Wordpress image URLs so they can be served from [Thumbor](https://www.thumbor.org/).

A well configured Thumbor server can deliver highly optimised images to improve website load times, and take a large of your web server by removing the need for WordPress to generate image derivatives for itself.

Prerequisites
-------------

[](#prerequisites)

You need access to a Thumbor service to use this plugin.

Note this typically only works on remote WordPress websites because Thumbor needs web access to the uploaded images. With some environment configuration you may be able to make it work in a development environment but that setup is outside the scope of this plugin.

Installation
------------

[](#installation)

Install and activate the plugin as normal then add the following configuration to your website.

```
define( 'THUMBOR_URL', 'https://media.example.com' );
define( 'THUMBOR_SECRET_KEY', 'your_thumbor_secret_key' );
```

If you Thumbor server runs in unsafe mode (which is *highly* discouraged) you may set `THUMBOR_SECRET_KEY` to `null`.

### Optional: Disabling “big image” resizing

[](#optional-disabling-big-image-resizing)

WordPress can automatically resize large image uploads which will save unnecessarily large requests from your Thumbor server. This plugin can change that limit with the following configuration.

```
# Disable “big image” resizing
define( 'THUMBOR_UPLOAD_IMAGE_THRESHOLD', false );

# Set the longest image edge
define( 'THUMBOR_UPLOAD_IMAGE_THRESHOLD', 2000 );
```

See [`big_image_size_threshold`](https://developer.wordpress.org/reference/hooks/big_image_size_threshold/) docs for more information.

### Optional: Allow image upscaling

[](#optional-allow-image-upscaling)

By default image upscaling is disabled. However we have had the occasional need for this, so to enable this feature you can use this filter in your theme:

```
add_filter('thumbor_allow_image_upscaling', '__return_true');
```

### Optional: Delete prior image files

[](#optional-delete-prior-image-files)

Once the plugin is enabled you can make use of a WP-CLI command to delete any image derivatives that have already been created.

**Use this command with great care because it will delete media files from your server.**

```
wp media regenerate
```

Deactivating/pausing the plugin
-------------------------------

[](#deactivatingpausing-the-plugin)

The plugin automatically deactivates itself when `THUMBOR_URL` is not set. So in your development environment you can remove the above configuration to make WordPress return to its default behaviour.

While enabled the plugin has prevented WordPress from making it's own resized versions of images. You can use the following WP-CLI command to generate any missing images after disabling the plugin:

```
wp media regenerate --only-missing
```

Credits
-------

[](#credits)

This plugin is heavily based on code that was forked from the [Tachyon plugin](https://github.com/humanmade/tachyon-plugin) by Human Made. All due credit to the authors of that plugin.

###  Health Score

30

—

LowBetter than 64% of packages

Maintenance41

Moderate activity, may be stable

Popularity18

Limited adoption so far

Community13

Small or concentrated contributor base

Maturity41

Maturing project, gaining track record

 Bus Factor2

2 contributors hold 50%+ of commits

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~275 days

Total

3

Last Release

277d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/a6334a9b62ab581e2a9fe889d0e1777463e02096e38d941351ca2800f1460a8d?d=identicon)[edjeavons](/maintainers/edjeavons)

---

Top Contributors

[![edjeavons](https://avatars.githubusercontent.com/u/735284?v=4)](https://github.com/edjeavons "edjeavons (15 commits)")[![DanielHudson2](https://avatars.githubusercontent.com/u/35522603?v=4)](https://github.com/DanielHudson2 "DanielHudson2 (11 commits)")[![brettsmason](https://avatars.githubusercontent.com/u/73229?v=4)](https://github.com/brettsmason "brettsmason (5 commits)")

### Embed Badge

![Health badge](/badges/eighteen73-wordpress-thumbor/health.svg)

```
[![Health](https://phpackages.com/badges/eighteen73-wordpress-thumbor/health.svg)](https://phpackages.com/packages/eighteen73-wordpress-thumbor)
```

###  Alternatives

[milon/barcode

Barcode generator like Qr Code, PDF417, C39, C39+, C39E, C39E+, C93, S25, S25+, I25, I25+, C128, C128A, C128B, C128C, 2-Digits UPC-Based Extention, 5-Digits UPC-Based Extention, EAN 8, EAN 13, UPC-A, UPC-E, MSI (Variation of Plessey code)

1.5k13.3M39](/packages/milon-barcode)[bkwld/croppa

Image thumbnail creation through specially formatted URLs for Laravel

510496.0k22](/packages/bkwld-croppa)[marc1706/fast-image-size

fast-image-size is a PHP library that does almost everything PHP's getimagesize() does but without the large overhead of downloading the complete file.

959.4M20](/packages/marc1706-fast-image-size)[char0n/ffmpeg-php

PHP wrapper for FFmpeg application

495225.1k1](/packages/char0n-ffmpeg-php)[goat1000/svggraph

Generates SVG graphs

132849.6k3](/packages/goat1000-svggraph)[cohensive/embed

Media Embed (for Laravel or as a standalone).

120370.4k](/packages/cohensive-embed)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)