=== Stock Photos, Videos & Icons – ATTN Stock Hub ===
Contributors: hellosabrinamok
Tags: stock images, stock photos, media library, pexels, icons
Requires at least: 6.0
Tested up to: 7.0
Requires PHP: 7.4
Stable tag: 1.0.3
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Search and import stock photos, videos, and SVG icons from Pexels, Pixabay, Unsplash, and Iconify into the WordPress Media Library.

== Description ==

Find media without repeatedly downloading files, switching tabs, and uploading them manually.

**ATTN Stock Hub** lets WordPress administrators and content editors search supported stock-media providers and import selected photos, videos, and SVG icons directly into the WordPress Media Library.

**Key features:**

* Search several stock-media providers from one WordPress screen.
* Import selected photos directly into the Media Library.
* Search and import supported stock videos.
* Browse and import SVG icons from Iconify.
* Keep imported files available for use across the website.
* Make requests only when an authorized user initiates a search or import.

**Supported providers:**

* Pexels: photos and videos
* Pixabay: photos and videos
* Unsplash: photos
* Iconify: SVG icons

API keys are supplied and controlled by the site administrator. Iconify search does not require an API key.

== External services ==

ATTN Stock Hub connects to third-party external services to provide its search and import functionality. These services are used only when a logged-in WordPress user with upload permissions manually submits a search or imports a selected asset. The plugin does not make automated background search requests, does not preload large third-party libraries, and does not use provider content for AI/ML training.

Pexels

Service used for: Searching and importing stock photos and videos from Pexels.

Data sent and when: When a user manually performs a Pexels search, the search keyword and the site administrator's Pexels API key are sent to the Pexels API. When a user imports a selected asset, the selected asset URL is requested so the file can be downloaded into that WordPress site's Media Library.

Account/API key: A user-provided Pexels API key is required.

Terms: https://www.pexels.com/terms-of-service/
Privacy: https://www.pexels.com/privacy-policy/

Pixabay

Service used for: Searching and importing stock photos and videos from Pixabay.

Data sent and when: When a user manually performs a Pixabay search, the search keyword and the site administrator's Pixabay API key are sent to the Pixabay API. When a user imports a selected asset, the selected asset URL is requested so the file can be downloaded into that WordPress site's Media Library.

Account/API key: A user-provided Pixabay API key is required.

Terms: https://pixabay.com/service/terms/
Privacy: https://pixabay.com/service/privacy/

Unsplash

Service used for: Searching and importing stock photos from Unsplash.

Data sent and when: When a user manually performs an Unsplash search, the search keyword and the site administrator's Unsplash Access Key are sent to the Unsplash API. When a user imports a selected asset, the selected asset URL is requested so the file can be downloaded into that WordPress site's Media Library. The plugin also sends a request to the Unsplash download tracking URL returned by the Unsplash API when an Unsplash asset is imported.

Account/API key: A user-provided Unsplash Access Key is required.

Terms: https://unsplash.com/terms
Privacy: https://unsplash.com/privacy

Iconify

Service used for: Searching and importing SVG icons from Iconify.

Data sent and when: When a user manually performs an Iconify search, the search keyword is sent to the Iconify API. When a user imports a selected icon, the selected icon name is used to request the SVG file from the Iconify API so it can be saved into that WordPress site's Media Library.

Account/API key: Iconify does not require an API key.

API documentation: https://iconify.design/docs/api/
Privacy: https://iconify.design/privacy/
License information: https://iconify.design/

== Installation ==

1. Upload the plugin files to the `/wp-content/plugins/attn-stock-hub-stock-photos-videos-icons` directory, or install the plugin through the WordPress plugins screen.
2. Activate the plugin through the Plugins screen in WordPress.
3. Go to Settings > ATTN Stock Hub.
4. Add your API keys for supported providers.
5. Go to Media > Stock Hub to search and import media.

== Frequently Asked Questions ==

= Do I need API keys? =

Yes, for Pexels, Pixabay, and Unsplash. Iconify does not require an API key.

= Does this plugin make automated API requests? =

No. Search requests are only triggered when a logged-in user manually submits a search.

= Does this plugin store or cache large provider libraries? =

No. Assets are imported one at a time only when selected by a user.

= Can I use imported media commercially? =

Please review the licensing terms of the original provider before using any imported asset.

= Does this plugin support videos? =

Yes. Pexels and Pixabay videos are supported when the relevant API key is configured.

= Can I import SVG icons? =

Yes. Iconify icons can be imported as SVG files when SVG import is enabled in the plugin settings.

= Where are imported assets stored? =

Selected assets are downloaded into the site's WordPress Media Library.

== Screenshots ==

1. Search Pexels stock videos and import selected videos into the WordPress Media Library.
2. Configure provider API keys and enable Iconify SVG imports in Stock Hub settings.

== Changelog ==

= 1.0.3 =
* Added screenshots and updated screenshot captions.

= 1.0.2 =
* Improved the plugin name, directory description, tags, and documentation.

= 1.0.1 =
* Updated text domain to match the WordPress.org plugin slug.
* Updated internal prefixes to be more unique.
* Updated API key handling to preserve valid secret values.
* Expanded readme information about external services.

= 1.0.0 =
* Initial release.
