=== FLS Stock Photo Importer ===
Contributors: franklamsheung
Tags: stock images, media library, pexels, pixabay, openverse
Requires at least: 6.0
Tested up to: 6.9
Requires PHP: 7.4
Stable tag: 1.0.7
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Search Pexels, Pixabay and Openverse images from the WordPress editor and import them directly into your Media Library.

== Description ==

FLS Stock Photo Importer allows editors to search selected royalty-free image providers directly from the WordPress post editor. Images can be previewed, imported into the Media Library, and inserted into posts without leaving the editor.

[Plugin homepage and documentation](https://franklamsheung.com/fls-stock-photo-importer)

Supported providers:

* Pexels (API key required)
* Pixabay (API key required)
* Openverse (API key optional)

Features:

* Search and preview images in the editor
* Import images to the Media Library (stored locally)
* Insert images into post content
* Set imported images as the featured image
* Store provider and source metadata on the attachment
* Optional attribution line on insert (recommended)

== External Services ==

This plugin connects to third-party image provider APIs to search for images and may download selected images to your Media Library.

When you search, the plugin sends:

- Your search query
- Pagination parameters (for example results per page)
- Your provider API key (for providers that require one)

Providers used by this plugin:

* Pexels API (requires API key): https://api.pexels.com/
  Privacy Policy: https://www.pexels.com/privacy-policy/

* Pixabay API (requires API key): https://pixabay.com/api/
  Privacy Policy: https://pixabay.com/service/privacy/

* Openverse API (optional key): https://api.openverse.org/
  Privacy: https://openverse.org/privacy

== Installation ==

1. Upload the plugin folder to `/wp-content/plugins/` or install via the Plugins screen.
2. Activate the plugin.
3. Go to **Settings ? FLS Stock Photo Importer** and add your provider API keys.
4. Edit a post and use the FLS Stock Photo Importer panel to search and import images.

== Frequently Asked Questions ==

= Does this plugin track users or send analytics? =

No. The plugin does not collect analytics or track users.

= Where do searches go? =

Search requests are sent directly from your site to the provider API you choose, using your own API keys.

= Does it add watermarks? =

No. The plugin does not modify image pixels or add watermarks.

= What about attribution? =

Attribution requirements vary by provider and license. The plugin can insert a small credit line below inserted images and also stores credit/source metadata on the attachment.

== Screenshots ==

1. Search and select an image in the editor
2. Import to the Media Library and insert into a post

== Changelog ==

= 1.0.3 =
* Improve documentation and readme.

= 1.0.2 =
* Security: validate and restrict imported image URLs (basic SSRF hardening).
* Compatibility: block editor insertion support (in addition to Classic Editor).

= 1.0.1 =
* Fix: editor insertion now writes into Classic Editor/TinyMCE/textarea so Preview and Update include the inserted image.
* Improvement: include bundled JS/CSS assets in the plugin package.
