=== Series Grid ===
Contributors: technodrome
Tags: grid, posts, slider, responsive, gallery
Requires at least: 5.5
Tested up to: 6.9
Requires PHP: 7.4
Stable tag: 4.0.3
License: GPL2
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Display posts in responsive grid, list, or slider layouts. PRO features include animations, color themes, auto-scroll, and social sharing.

== Description ==

Series Grid is the enhanced version of our popular grid plugin, featuring advanced layouts, animations, and customization options perfect for showcasing your content beautifully.

**🚀 NEW IN 4.0.0: Multi-Instance Layout System (PRO Feature)**
* Now supports MULTIPLE LAYOUTS ON SAME PAGE - Grid, List, and Slider layouts can coexist on any WordPress page
* Joomla-like module system with instance management (PRO only)
* Backup shortcode system for enhanced flexibility

**Core Features (Free):**
* Single Layout per Page - One `[series_grid]` shortcode per page
* Basic Layout Options - Grid, List, Slider (one per page)
* Category filtering
* Customizable columns (1-6)
* Font size control
* Image extraction from posts
* Lazy loading
* Fallback images and colors

**PRO Features (License Required):**
* **Multi-Instance Manager:** Create unlimited layout instances on same page
* **Animation Effects:** Fade In, Slide Up, Zoom In, Bounce In
* **Color Themes:** Dark, Blue, Green, Red schemes
* **Advanced Hover Effects:** Color Overlay, Image Zoom, Content Slide, Card Flip
* **Force Image Shape:** Square, 4:3, 16:9, 3:2 aspect ratios
* **Auto-Scroll Slider:** With speed control and pause on hover
* **Navigation Controls:** Slider arrows and dots navigation
* **Social Sharing:** Facebook, Twitter, WhatsApp buttons
* **Custom CSS Editor:** Add your own styling
* **Custom Image Heights:** Precise control over slider dimensions

**Safe & Reliable:**
* Modern PSR-4 architecture
* Secure license validation with local fallback
* Responsive design with mobile optimization
* Accessibility features included
* Safe slider dimensions with built-in limits

== Installation ==

1. Upload the plugin files to `/wp-content/plugins/series-grid/`
2. Activate the plugin through the 'Plugins' menu
3. Go to 'Series Grid' in admin menu to configure settings
4. Use shortcode `[series_grid]` to display your grid
5. For PRO features, enter your license key in the Basic tab (visible to all users)

== Usage ==

**FREE Version - Single Layout:**
One layout per page with basic customization + PRO license field:
```php
[series_grid layout="grid" columns="3" categories="1,2,3]    // Single layout
[series_list count="6]                                        // Single layout
[series_slider auto_scroll="yes]                              // Single layout
```

**PRO Version - Multi-Instance Manager:**
Unlimited layouts on same page (requires valid PRO license):
```php
// Access in Settings → Series Grid → PRO Advanced → Multi-Instance Manager
[series_grid id="featured" layout="grid" columns="3" categories="1,2,3]
[series_grid id="trending" layout="slider" auto_scroll="yes" categories="4,5]
[series_grid id="recent" layout="list" categories="6,7]
```

**FREE Parameters:**
* `layout`: grid, list, slider (one per page)
* `columns`: 1-6 (grid only)
* `count`: number of posts
* `categories`: category IDs (comma-separated)
* `font_size`: small, medium, large
* `show_category`: yes, no
* `show_date`: yes, no
* `show_introtext`: yes, no

**PRO Parameters (requires license):**
* `id`: Unique instance ID (for multi-instance system)
* `animation_effect`: none, fade, slide, zoom, bounce
* `color_scheme`: default, dark, blue, green, red
* `hover_effect`: basic, overlay, zoom, slide, flip
* `image_aspect_ratio`: auto, 1-1, 4-3, 16-9, 3-2
* `social_sharing`: yes, no
* `auto_scroll`: yes, no (slider only)
* `scroll_speed`: slow, normal, fast
* `show_navigation`: yes, no (slider only)
* `show_dots`: yes, no (slider only)

== Screenshots ==

1. Admin settings with PRO license tabs
2. Grid layout with animation effects
3. Slider layout with auto-scroll and navigation
4. Color themes and hover effects
5. Social sharing buttons
6. Mobile responsive design

== Frequently Asked Questions ==

= How do I get a PRO license? =

Contact technodrome for licensing information. Demo keys are available for testing. Enter license key in Basic tab.

= What is the difference between FREE and PRO versions? =

FREE: One layout per page with basic customization + license field
PRO: Multi-Instance Manager + unlimited layouts per page + all PRO features (unlocked with license)

= Do PRO features work without a license? =

No, PRO features (including Multi-Instance Manager) are automatically disabled without a valid license key. You can still use all FREE features.

= Is the license validated online? =

Yes, the plugin validates licenses remotely with local fallback for reliability.

= Can I use the same license on multiple sites? =

License terms depend on your specific agreement. Check your license details.

= What happens if my license expires? =

PRO features will be disabled, but basic FREE functionality remains intact.

= Is it compatible with my theme? =

Yes, the plugin is designed to work with any properly coded WordPress theme.

= Can I customize the styling? =

Yes, PRO users can add custom CSS through the admin panel.

== Changelog ==

= 4.0.2 =
* **Fix:** Licence update 

= 4.0.0 =
* **Feature:** Added Multi-Instance Manager - Create unlimited layout instances on same page (PRO feature)
* **Change:** Moved Multi-Instance Manager from Basic to PRO Advanced tab
* **Change:** Multi-Instance functionality now requires PRO license
* **Change:** Moved PRO License field to Basic tab for better UX (visible to all users)
* **Change:** Removed separate PRO License tab (now integrated into Basic tab)
* **Fix:** Fixed CSS syntax error in font_size field causing tab issues
* **Fix:** Reconstructed field_instance_manager() function to resolve PHP fatal error
* **Improvement:** Clear separation between FREE (single layout) and PRO (multi-instance) features
* **Improvement:** Updated documentation to reflect licensing structure

= 3.1.0 =
* **Feature:** Added new horizontal layout options for the grid. You can now choose to display the image to the left or right of the text content, creating a compact, list-like appearance.
* **Improvement:** Introtext is now automatically hidden in horizontal grid layouts to maintain a clean and structured design.
* **Improvement:** The "Grid Image Position" setting in the admin panel is now context-aware and will only appear when the "Grid" layout is selected.
* **Improvement:** Added clear descriptions in the admin panel to inform users about the automatic behavior of introtext in different layouts.
* **Fix:** Completely redesigned the CSS for horizontal layouts to be more robust, compact, and mobile-friendly.
* **Fix:** Resolved CSS conflicts between the aspect-ratio system and the new horizontal layouts.

= 3.0.1 =
* **Hotfix:** Corrects the faulty 3.0.0 release which contained outdated files. This version includes the new "Introtext on Hover" feature.

= 3.0.0 =
* Added a free option in the Basic tab to show or hide the introtext globally for all layouts.
* Added a PRO feature in the Grid tab to display the introtext on hover with a smooth expand/collapse animation.
* Updated plugin version to 3.0.0 to ensure browsers load the latest CSS changes (cache busting).

= 2.0.0 =
* Complete PRO architecture implementation
* Added animation effects system
* Added color themes (dark, blue, green, red)
* Added advanced hover effects
* Added force image shape options
* Added auto-scroll slider with controls
* Added navigation arrows and dots
* Added social sharing buttons
* Added custom CSS editor
* Added safe slider dimensions system
* Enhanced mobile responsiveness
* Improved accessibility features
* Added license validation system
* Reorganized admin interface with PRO tabs

= 1.3.0 =
* Previous basic version
* Grid, list, slider layouts
* Basic customization options

== Upgrade Notice ==

= 4.0.0 =
UI improvements: License field moved to Basic tab, License tab removed, PRO features organized in specific tabs.

= 3.0.0 =
New feature added! You can now display the introtext on hover in the grid layout (PRO feature).

= 2.0.0 =
Major PRO upgrade with advanced features. Requires license key for PRO functionality. All existing features remain free.

== License Information ==

This plugin uses a dual licensing system:
* Basic features: GPL2 (free)
* PRO features: Commercial license required

Demo license keys are provided for testing purposes only.
For production use, a valid commercial license is required.

== Support ==

For support and licensing:
* Visit: https://technodrome.nasrpskom.com
* Email: support@technodrome.nasrpskom.com