Supplies filters

Orignal use case was WordPress themes that used images from facebook which in schools was blocked. By proxying the image through wp-camo images from Facebook will now load in school.


  1. Upload the plugin files to the /wp-content/plugins/wp-camo directory, or install the plugin through the WordPress plugins screen directly.
  2. Activate the plugin through the ‘Plugins’ screen in WordPress
  3. Use the Settings->WP-Camo screen to configure the plugin

There are two settings that can be configured

  • Prevent Mixed Content Errors, which applies a filter to the_content which finds all http:// images and changes them to wp-camo images.
  • Apply WP-Camo to these domains, which will pass images on these domains through wp-camo regardless of if its hosted on https.

In your theme/plugin you can use the filter wp_camo_hash_url to get the location of the image through WP-Camo.

apply_filters('wp_camo_hash_url', $url);

The image’s url will be a location in /wp-content/uploads/wp-camo/. The image will be downloaded and cached on the server to reduce load.

There are 2 filters for changing the path wp-camo uploads images to.

  • wp_camo_disk_path which sets the on disk path of the wp-camo directory.
  • wp_camo_public_path which sets the public url of the wp-camo directory.


Images don’t appear

This could be for a few reasons, the most common are:

  • WP-Camo could not write to the disk.
  • Your web server could not request the image.

Contributors & Developers

“WP-Camo” is open source software. The following people have contributed to this plugin.


Translate “WP-Camo” into your language.

Interested in development?

Browse the code, check out the SVN repository, or subscribe to the development log by RSS.



  • Cache the images on the server instead of fetching them anew each request.