imgix-wordpress

A WordPress plugin to automatically use your existing (and future) WordPress images via imgix for smaller, faster, and better looking images.

• Features
• Getting Started
• Updates

Features

• Your images behind a CDN.
• Automatically smaller and faster images with the Auto Format option.
• Automatically better looking images with the Auto Enhance option.
• Use arbitrary imgix API params when editing <img> tags in "Text mode" and they will pass through.
• No lock in! Disable the plugin and your images will serve as they did before installation.

Getting Started

If you don't already have an imgix account then sign up at imgix.com.

1. Create a Web Folder imgix source with the Base URL set to your WordPress root URL (without the wp-content part). For example, if your WordPress instance is at http://students.miguelcardona.com and an example image is http://students.miguelcardona.com/wp-content/uploads/2013/01/beat.jpg then your source's Base URL would be just http://students.miguelcardona.com/.

2. Download the imgix WordPress plugin imgix_plugin.zip and install on your WordPress instance. In the WordPress admin, click "Plugins" on the right and then "Add New". This will take you to a page to upload the imgix_plugin.zip file. Alternatively, you can extract the contents of imgix_plugin.zip into the wp-content/plugins directory of your WordPress instance.

3. Return to the "Plugins" page and ensure the "imgix plugin" is activated. Once activated, click the "settings" link and populate the "imgix Host" field (e.g., http://yourcompany.imgix.net). This is the full host of the imgix source you created in step #1. Optionally, you can also turn on Auto Format or Auto Enhance. Finally, click "Save Options" when you're done.

4. Go to a post on your WordPress blog and ensure your images are now serving through imgix.

Updates

If you find bugs or have a feature request please open a github issue. Thanks!

Testing

This plugin uses phpunit to run its tests. You will need to set up a local test database to run these tests. You can do that using the bootstrap scrip:

$ bin/install-wp-tests.sh imgix_wordpress_tests <YOUR MYSQL USERNAME> <YOUR MYSQL PASSWORD>

Then running the tests is as simple as:

$ phpunit