=== Easy search and use CC-licensed images for WP ===
Contributors: lenasterg
Donate link: 
Tags: cc, creative commons, media library, free image, free photo
Requires at least: 4.6
Tested up to: 6.7.1
Stable tag: 4.0
License: GPLv2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html

Search millions of CC-licensed images without leaving WordPress editor and use one into your post content or set as featured image very quickly.

== Description ==

Easy search and use CC-licensed images for WP helps you search millions of free photos using the [Openverse API](https://api.openverse.engineering/v1/) and insert the original image into your content or set as featured image very quickly. 
It allows the user to filter the provider source.											 
The plugin is inspired and based on the [CCSearch] (https://ccsearch.creativecommons.org/) and it wouldnt't be possible without the  [Openverse API](https://api.openverse.engineering/v1/). 

After the plugin's activation, you can see the "Image with CC License"  button above the editor and as option into the "Add Media" pop-up window. 
By pressing it  you can search using Latin characters for an image, browse the returned images, preview an image and its license and adjust the image settings: 
 - use of thumbnail or original image,
 - set the image link (if any). 
 - Insert the image into the post or as featured image.

= Features =

- Works in WordPress editor and add a button above the content text area and into the “Add Media” pop-up window.
- Via a pop-up window, allows searching through millions of images using Creative Commons Catalog API power.
- Allows filtering by a provider
- Paginated results
- Quick insert original image or thumbnail with an (optional) link to the image URL or the original site
- Use image as a featured image for the blog post
- WPML compatible
- Multisite compatible
- Translation ready (it’s already translated in Greek)
- Tested up to WordPress 5.9 with Classic Editor plugin

You can find a blog post in [opensource.creativecommons.org](https://opensource.creativecommons.org/blog/entries/2019-07-24-cc-search-wp-plugin/) about the inspiration and how it works.

NOTE 1: Please, verify the license at the source. Creative Commons does not host the content and does not verify that the content is properly CC-licensed or that the attribution information is accurate or complete. 
Please follow the link to the source of the content to independently verify before reuse.

NOTE 2: Currently, the plugin needs [Classic Editor](https://wordpress.org/plugins/classic-editor/) in order to work for WP 5+.


= Roadmap =
- Multiple images select support
- Gutenberg compatibility
- Multiselect options for filtering: providers
- select options for filtering: licenses, creator
- Image for the 'Image with CC license' editor button
- Info page
- Initial step for registring in the API and use of Bearer authentication 

= Credits =
- The plugin is inspired and based on the [CC Search] (https://ccsearch.creativecommons.org/) and wouldnt't be possible without the [Creative Commons Catalog API] (https://api.openverse.engineering)
- The plugin's code is based on the [WP Pexels] (https://wordpress.org/plugins/wp-pexels/)  code by WPclever.net
- Pointer's code is based on [https://code.tutsplus.com/articles/integrating-with-wordpress-ui-admin-pointers--wp-26853] (https://code.tutsplus.com/articles/integrating-with-wordpress-ui-admin-pointers--wp-26853)
- Many thanks to [Stavroula Stasinou](https://www.linkedin.com/in/stavroulastas/) for the free creation of header image and plugin icon.


== Installation ==

1. Unzip the ls-wp-ccsearch.zip
2. Copy ls-wp-ccsearch folder to wp-content/plugins
3. Go to Plugins > Installed Plugins, find Easy search and use CC-licensed images for WP and click Active
4. Now when you create/edit the post, you can see the "Image with CC License"  button above the editor and as option into the "Add Media" pop-up window. 
5. Enjoy!

== Screenshots ==
1. The "Image with CC license" button on editor
2. Search for an image 
3. Preview of an image and its license.
4. Image settings: use of thumbnail or original image, set the image link (if any). Insert the image into the post or as featured image.
5. The image and it's license into the editor
6. The published post with the image.

== Changelog ==

= 4.0 =
* Fix bug for displaying available images sources
* WordPress 6.5.4 compatibility

= 3.2 =
* Fix bug when image was set as post thumbnail. Props to @gnr5 for spotting the bug
* Display images sources sorted by name
* WordPress 6.1 compatibility

= 3.1 =
* Minor changes

= 3.0 =
* Changes to use openverse API urls

= 2.0 =
* Changes at creativecommons API urls
* Support also non -latin keywords

= 1.0 =
* Replaces curl with WordPress native functionality
* Fix some typos
* Sanitize input
* Renamed from WP CCsearch to Easy search and use CC-licensed images for WP

= 0.5.0 =
* Add class to img
* Larger colorbox height
* New strings added
* New screenshots
= 0.4.0 =
* Add wp-pointer on editor's button
* Fix: Wrong textdomain
* Removed unused code
* New strings added

= 0.3.0 =
* Add provider dropdown select
* Fix: Use full image when thumbnail url is broken 

= 0.2.0 =
* Fix ls-wp-ccsearch.pot
* Greek translation added

= 0.1.0 =
* Released
