=== Freemage ===
Contributors: bfintal, gambitph
Donate link: https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=D2MK28E7BDLHC
Tags: free images, images, creative commons, creative, commons, flickr, media manager, media, image, inject, featured image, photo, photos, pictures, wpinject, imageinject
Requires at least: 4.4
Tested up to: 4.6
Stable tag: 1.0
License: GPLv2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html

Search for free or creative commons images from your media manager. Great for finding featured images or photos for your blog posts.

== Description ==

<strong>Freemage makes it easier to find the perfect featured image, or even companion images for your articles.</strong> Just pop open your media manager, and the "Freemage Search" tab automatically shows up beside your media library for quick access. From there you'll be able to search for free / Creative Commons images from [Flickr](http://flickr.com) and GIFs from [Giphy](http://giphy.com)*. Just click on download button on the images or photos that you like, and Freemage will download them straight to your media library. You'll be able to use these images on your site wherever you like!

> *The premium version allows you to search from Flickr, Pixabay, Giphy, Pexels, Unsplash, and 500px.

= Automatic Attribution =

You may come across images that have a Creative-Commons Attribution license. These images need attribution, but don’t worry, Freemage takes care of this for you. It automatically adds attribution as captions to the downloaded images using the [best practices for attribution as listed in the Creative Commons Wiki](https://wiki.creativecommons.org/wiki/Best_practices_for_attribution). This way, you don't have to worry about wrongly credited images.

= Integrates into your Media Manager =

We believe in being as native to WordPress as possible. To provide you with a seamless experience, we blend into your Media Manager, beside the uploads tab and the media library tab. So wherever you have access to the media manager, you'll have access to Freemage, too.

= Page Builder Compatible =

Freemage works well with page builders as well. Use Freemage with your favorite page builders without a hitch: Page Builder Sandwich, Beaver Builder or Visual Composer.

> We highly recommend [Page Builder Sandwich](https://pagebuildersandwich.com)

= Upgrade to Premium to Search More Image Providers =

Flickr already has millions of photos to search from, but if you want more, upgrade to premium to find images from these awesome places:

* [Flickr](http://flickr.com)
* [Giphy](http://giphy.com)
* [Pixabay](http://pixabay.com) (Premium only)
* [Pexels](http://pexels.com) (Premium only)
* [Unsplash](http://unsplash.com) (Premium only)
* [500px](http://500px.com) (Premium only)

== Installation ==

1. Head over to Plugins > Add New in the admin
2. Search for "Freemage"
3. Install & activate the plugin
4. Visit any post or page in your backend, then click on "Add Media" to open the Media Manager
5. Click on the "Freemage Search" tab, then type in your search keywords in the text field.
6. Image search results should appear, hover over your desired image then click on the download button to begin downloading an image.
7. Go back to your media library and your downloaded image should be there ready for use.

== Screenshots ==

1. Freemage tab and search results
2. Downloaded images go straight into your media library
3. Images automatically get captions with the correct attribution

== Frequently Asked Questions ==

= Q. I upgraded to Premium, but I still can't search the other providers =

Thanks for going premium! The premium plugin is different from the lite plugin. Once you've purchased the premium, you should have gotten an email with the download link. Install the premium version to enable searching on the other providers.

= Q. How do I search for images? =

Open up your media manager then click on the "Freemage Search" tab. Type in your search keywords in the text field to begin searching.

= Q. How do I download images? =

Once search results appear, hover your mouse over any of the image search results. A download button should appear on the upper right corner of the image. Click on that and wait for your image to download. Once completed, a check mark will appear, and your image will now become available in your media library.

= Q. How do I open my media manager? =

Create or edit a page or a post, then click on the "Add Media" button to bring up your media manager.

== Upgrade Notice ==

== Changelog ==

= 1.0 =

* First release