=== LS Stock Portfolio ===
Contributors: lakestylez
Donate link: https://www.paypal.com/donate?hosted_button_id=KDN9QUMA5JHHE
Tags: adobe stock, unsplash, pixabay, portfolio, gallery
Requires at least: 6.2
Tested up to: 6.9
Stable tag: 1.1.0
License: GPL-2.0-or-later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Display Adobe Stock, Unsplash and Pixabay portfolios in responsive masonry or grid layouts with Lightbox and load-more functionality.

== Description ==

**LS Stock Portfolio** lets you embed your image portfolio from **Adobe Stock**, **Unsplash**, or **Pixabay** directly into your WordPress site.

The plugin supports:

- Adobe Stock contributor pages (via URL)
- Unsplash user profiles (via access key)
- Pixabay image libraries (via API key + custom tags)

It automatically fetches your images (with caching), displays them in a responsive masonry or grid layout and includes an integrated Lightbox with clean author credits and links required by the respective platforms.

No additional plugins or external JS libraries required.  
Designed for broad theme and page builder compatibility.

=== Features ===

**Multi-platform support**

- **Adobe Stock** (contributor URL)
- **Unsplash** (username &amp; access key)
- **Pixabay** (API key + custom tag filters)

**Layouts**

- Responsive **masonry** layout
- Standard **grid** layout
- Adjustable columns, gaps and aspect ratios

**Integrated Lightbox**

- Built-in Lightbox (no external plugin required)
- Automatic photographer / author credits with backlinks
- Keyboard navigation (where supported by the browser)

**Load More + performance**

- “Load more images” button for larger portfolios
- Internal caching to reduce API calls and improve page speed
- Configurable cache lifetime

**Flexible settings**

- Number of initial images
- Columns and gaps
- Sorting (original / random)
- Language (DE / EN)
- Image aspect ratio for the grid layout (1:1, 3:2, 4:3, 16:9)
- Backlink color in the free version

**Other**

- Backend PayPal donation button
- Lightweight, stable and performance-focused
- No jQuery dependency

= Optional Pro upgrade =

LS Stock Portfolio can be upgraded with an optional **Pro license**.  
The free version already includes all core functionality. The Pro features add:

- Customizable slideshow interval for the Lightbox
- Additional Lightbox layouts: **Filmstrip**, **Carousel** and **Fullscreen**
- Extra image transition styles: **Fade** and **Slide**
- Custom styling options for the “Load more images” button (background, text, border, radius)
- Option to hide the frontend backlink to the plugin author

Licenses are managed securely via **Freemius** and are activated automatically inside the plugin account screen.

=== Shortcode Examples ===

Default portfolio (uses the platform selected in the settings):  
`[lsmsp_stock_portfolio]`

Force a specific platform:  
`[lsmsp_stock_portfolio platform="adobe"]`  
`[lsmsp_stock_portfolio platform="unsplash"]`  
`[lsmsp_stock_portfolio platform="pixabay"]`

English output:  
`[lsmsp_stock_portfolio lang="en"]`

Platform-specific helper shortcodes:  
`[lsmsp_stock_portfolio_adobe]`  
`[lsmsp_stock_portfolio_unsplash]`  
`[lsmsp_stock_portfolio_pixabay]`

All platforms (separate blocks):  
`[lsmsp_stock_portfolio_all platforms="adobe,unsplash,pixabay" order="asc"]`

All platforms (mixed grid):  
`[lsmsp_stock_portfolio_mix platforms="adobe,unsplash,pixabay" order="asc"]`

=== Installation ===

1. Download the plugin ZIP file.
2. Go to **Plugins → Add New → Upload Plugin**.
3. Select the ZIP file and install it.
4. Activate the plugin.
5. In the dashboard, open **“Stock Portfolio”**.
6. Choose your platform:
   - Adobe Stock → paste contributor URL  
   - Unsplash → enter username + access key  
   - Pixabay → enter API key + tags  
7. Configure grid, sorting and Lightbox options.
8. Insert the shortcode `[lsmsp_stock_portfolio]` into any page or post.

== Frequently Asked Questions ==

= Does the plugin require Simple Lightbox? =
No. LS Stock Portfolio now includes its **own Lightbox**, fully integrated and optimized.

= How often are images refreshed? =
By default every **6 hours**.  
The interval can be changed in the plugin settings.

= Can I embed multiple profiles at once? =
Currently no — one portfolio per site installation.  
(Multi-instance support is planned for a future update.)

= Are Unsplash / Pixabay credits included? =
Yes.  
Credits &amp; backlinks are automatically generated based on the API response — compliant with platform requirements.

== Screenshots ==

1. Plugin settings page (platform selector, API fields)
2. Example Masonry Grid (Unsplash)
3. Lightbox preview with author credits
4. Load-more button in action

== Changelog ==

= 1.1.0 =
* Added optional Pro features:
  * Customizable Lightbox slideshow interval
  * New Lightbox themes: Filmstrip, Carousel and Fullscreen
  * New Lightbox animations: Fade and Slide
  * Styling controls for the "Load more images" button
  * Option to remove the frontend backlink when Pro is active
* Improved responsive behavior and grid rendering.
* Updated documentation and internal code for the WordPress.org plugin review.

= 1.0.1 =
* Codebase cleanup and compatibility improvements for the WordPress.org review.
* Removed deprecated `[ls_stock_*]` shortcode aliases; the plugin now uses only the `lsmsp_` shortcodes.
* Updated documentation and examples to reflect the current shortcode usage.

= 1.0.0 =
* Added full **Unsplash** support (API-based)
* Added **Pixabay** support with tag filtering
* Added custom **integrated Lightbox** (replaces Simple Lightbox)
* Added automatic author credits + backlink generation
* Added masonry layout for variable image heights
* Major performance upgrade for Adobe Stock parsing
* Improved caching + platform-specific handling
* Enhanced JS rendering &amp; load-more functionality
* UI improvements in backend
* Introduced the `lsmsp_` shortcode prefix with legacy aliases for existing `[ls_stock_portfolio]` shortcodes.

= 0.6 =
* Added multilingual output
* New caching logic
* Backend PayPal button
* Branding improvements

= 0.5 =
* Initial public release  
* Adobe Stock support + shortcode

== Upgrade Notice ==

= 1.1.0 =
This update introduces optional Pro features (Lightbox themes, animations, slideshow interval and button styling) and improves overall stability. The free version continues to work as before.

= 1.0.1 =
This update removes the deprecated `[ls_stock_*]` shortcode aliases. Please make sure you are using the `lsmsp_` shortcodes (for example `[lsmsp_stock_portfolio]`) on all pages.

== Credits ==
Developed by **Lake Stylez – Mediendesign**  
Author: **Steven P. Stückler**  
Website: https://lakestylez.com  
Contact: info@lakestylez.com

== License ==
Released under the GPL-2.0-or-later license.  
You may use, modify and redistribute it freely.