=== Chaturbate Affiliate Cams Widget ===
Contributors: newcitymedia
Donate link: https://thepervtube.com/cbwidgetcams/
Tags: chaturbate, webcams, adult, affiliate, widget, shortcode, seo
Requires at least: 5.0
Tested up to: 6.5
Stable tag: 5.0.3
Requires PHP: 7.4
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Display Chaturbate webcams on your WordPress site with full affiliate integration, advanced filtering options, shortcodes, automatic updates, and SEO optimization.

== Description ==

A WordPress plugin to display Chaturbate webcams on your WordPress site with full affiliate integration, advanced filtering options, shortcodes for posts and pages, automatic updates from our update server, and comprehensive SEO optimization.

= SEO Features =

* **Structured Data**: Schema.org markup for better search engine understanding
* **Semantic HTML**: Proper use of headings, meta tags, and semantic elements
* **Hidden SEO Content**: Additional descriptive text readable by search engines but hidden from users
* **Accessible Links**: Title attributes and descriptive alt text for all images
* **Crawlable Content**: All performer names and room information fully accessible to search engine bots
* **Meta Information**: Hidden meta tags with performer details for enhanced indexing

= Other Features =

* **Shortcode Support**: Add cams to any post or page with flexible shortcodes
* **Auto-Updates**: Receive update notifications directly from our update server with one-click updates
* **Affiliate Integration**: Seamlessly integrate with your Chaturbate affiliate account
* **Smart Rotation**: Every 5th display uses the default affiliate ID to maximize earnings
* **Advanced Filtering**: Filter cams by gender, tags, age range, and more
* **Responsive Design**: Fully responsive grid layout with customizable columns for different devices (up to 15 columns)
* **Traditional Pagination**: Server-side pagination for shortcodes using standard WordPress URL parameters
* **Performance Optimized**: Built-in caching system with configurable duration
* **Real-time Data**: Live cam data fetched directly from Chaturbate API
* **Click Tracking**: Site-wide click counter with affiliate rotation
* **Admin Tools**: Cache management, API testing, and shortcode generator
* **Cache Plugin Compatible**: Works with caching plugins like WP Rocket with automatic cache busting

== Installation ==

= Manual Installation =

1. Download the latest plugin files
2. Upload the plugin files to your `/wp-content/plugins/` directory
3. Activate the plugin through the 'Plugins' menu in WordPress

= WordPress Admin =

1. Go to Plugins -> Add New -> Upload Plugin
2. Upload the ZIP file
3. Activate the plugin

== Configuration ==

= Affiliate Settings =

1. Go to Chaturbate Cams in the admin menu
2. Your Affiliate ID: Enter your Chaturbate affiliate ID (leave blank to use default)
3. Tracking ID: Optional tracking identifier for your links
4. Cache Duration: Set how long to cache cam data

= Widget Settings =

* Title: Custom title for the widget
* Number of Cams: How many cams to display (1-500)
* Grid Columns: Set columns for desktop, laptop, tablet, and mobile (1-15)
* Gender Filter: Filter by female, male, trans, couple, or all
* Tag Filter: Filter by specific tags (100+ available)
* Age Range: Set minimum and maximum age filters (defaults to 18-99)

= Shortcode Usage =

Use the `[chaturbate_cams]` shortcode in posts and pages:

**Basic Examples:**
`[chaturbate_cams count="12" columns_desktop="4"]`
`[chaturbate_cams count="50" gender="f" tag="teen" paginate="true" per_page="12"]`
`[chaturbate_cams count="100" columns_desktop="6" columns_laptop="4" columns_tablet="3" columns_mobile="2"]`

**Available Shortcode Attributes:**
* `count` - Number of cams to show (1-500, default: 12)
* `per_page` - Cams per page when pagination is enabled (1-500, default: 12)
* `columns_desktop` - Columns on desktop (1-15, default: 4)
* `columns_laptop` - Columns on laptop (1-15, default: 3)
* `columns_tablet` - Columns on tablet (1-15, default: 2)
* `columns_mobile` - Columns on mobile (1-15, default: 1)
* `gender` - Filter by gender (all, f, m, t, c, default: all)
* `tag` - Filter by tag (default: all)
* `age_min` - Minimum age (18-99, default: 18)
* `age_max` - Maximum age (18-99, default: 99)
* `paginate` - Enable pagination (true/false, default: false)

**Shortcode Generator:**
Use the built-in shortcode generator in the admin under Chaturbate Cams -> Shortcode Generator to easily create custom shortcodes.

== SEO Optimization ==

The plugin includes comprehensive SEO features:

* **Structured Data**: Each cam listing includes Schema.org Person markup
* **Hidden SEO Text**: Additional descriptive content readable by search engines
* **Semantic HTML**: Proper use of heading structures and meta information
* **Accessible Content**: All text content is fully accessible to screen readers and search bots
* **Image Optimization**: Descriptive alt text and proper image semantics

== Auto-Update System ==

The plugin supports automatic updates directly from our update server:

* Update Notifications: See available updates in WordPress admin
* One-Click Updates: Update directly from Plugins page
* Secure Downloads: Direct from our update server

== Affiliate Rotation System ==

The plugin features a smart affiliate rotation system:

* Every 5th display site-wide uses the default affiliate ID
* All other displays use your personal affiliate ID
* Site-wide display counter tracks all widget and shortcode displays
* Real-time stats display in admin panel

== Cache Plugin Compatibility ==

The plugin is fully compatible with caching plugins like WP Rocket:

* Automatic cache busting for affiliate links and images
* Dynamic content rotation even with page caching
* Proper headers to prevent caching of pages with cams
* Client-side cache busting for maximum compatibility

== Available Tags ==

The plugin supports 100+ tags including: 18, anal, asian, bbw, bdsm, bigtits, blonde, couple, ebony, gaming, lesbian, milf, petite, redhead, teen, trans, and many more.

== Frequently Asked Questions ==

= How do I get my Chaturbate affiliate ID? =

Register at [Chaturbate Affiliate Program](https://chaturbate.com/in/?tour=YrCr&campaign=wKWf7&track=default) to get your unique affiliate ID.

= Why is every 5th display using a different affiliate ID? =

This supports the plugin developer while ensuring you get 80% of the commissions.

= How often does the plugin check for updates? =

The plugin checks our update server every 24 hours for new releases.

= How do I use shortcodes? =

Use the Shortcode Generator in the admin panel or manually add `[chaturbate_cams]` with your desired parameters to any post or page.

= Does this work with caching plugins like WP Rocket? =

Yes! The plugin includes advanced cache-busting techniques to ensure proper rotation and fresh content even with aggressive caching.

= How does pagination work? =

Pagination uses traditional WordPress URL parameters (?cbpage=2) for reliable server-side pagination that works with all themes and properly scrolls to the top of the page.

= Is the plugin SEO friendly? =

Yes! The plugin includes structured data, semantic HTML, hidden but crawlable content, and proper meta information to ensure search engines can index all performer names and room information.

== Changelog ==

= 5.0.3 =
* NEW: Comprehensive SEO optimization with structured data
* NEW: Schema.org Person markup for each cam listing
* NEW: Hidden but crawlable SEO content for search engines
* NEW: Semantic HTML with proper meta tags
* NEW: Accessible link titles and image alt text
* IMPROVED: Better search engine visibility for all cam data

= 5.0.2 =
* FIXED: Pagination system completely rebuilt for better reliability
* FIXED: Pagination now uses traditional WordPress URL parameters instead of AJAX
* FIXED: Proper scrolling to top when navigating between pages
* REMOVED: Complex AJAX pagination system in favor of simple server-side pagination
* IMPROVED: Better compatibility with all WordPress themes and caching systems

= 5.0.1 =
* FIXED: Cache compatibility with plugins like WP Rocket
* FIXED: Pagination now appears below cams instead of above
* ADDED: per_page parameter for shortcodes to control cams per page
* IMPROVED: Better cache busting for affiliate links and images
* IMPROVED: Enhanced image error handling

= 5.0 =
* NEW: Shortcode support for posts and pages
* NEW: Shortcode generator in admin panel
* NEW: Pagination for shortcodes
* NEW: Support for up to 15 columns
* NEW: Default age range set to 18-99 for both widgets and shortcodes
* IMPROVED: Better code organization with shared rendering functions
* IMPROVED: Enhanced admin interface with shortcode generator
* UPDATED: All version numbers to 5.0

= 4.0 =
* Improved: Enhanced click tracking with atomic operations to prevent race conditions
* Improved: Better error handling and logging
* Improved: Increased maximum cams to 500 for better filtering
* Improved: More reliable affiliate rotation system
* Fixed: Various bug fixes and performance improvements

= 3.0 =
* Improved: Updated admin interface
* Improved: Better caching system
* Improved: Enhanced mobile responsiveness

= 2.3 =
* NEW: Self-hosted auto-updater with one-click updates
* NEW: Admin tools for cache management
* NEW: Site-wide click counter with real-time stats
* IMPROVED: Better error handling
* IMPROVED: Enhanced admin interface

= 2.2 =
* Updated affiliate registration link with better tracking
* Improved affiliate program accessibility

= 2.1 =
* Improved responsive design
* Enhanced caching system
* Better error handling
* Performance optimizations

= 2.0 =
* Complete code rewrite
* Advanced filtering options
* Responsive grid layout
* Admin interface overhaul

== Upgrade Notice ==

= 5.0.3 =
Important SEO update adding structured data, semantic HTML, and comprehensive search engine optimization. Recommended for all users wanting better search visibility.

= 5.0.2 =
Important update completely rebuilding the pagination system for better reliability and compatibility. Recommended for all users.

= 5.0.1 =
Important update fixing cache compatibility and pagination positioning. Recommended for all users using caching plugins.

= 5.0 =
Major update adding shortcode support, pagination, and up to 15 columns. Recommended for all users.

= 4.0 =
This update includes significant improvements to click tracking and performance. Recommended for all users.

== License ==

This plugin is licensed under the GPL2 license.

== Privacy ==

* No user data is collected or stored
* IP addresses used only for temporary click rotation
* All data comes from Chaturbate's public API
* No personal information is tracked

== Important Notice ==

You must be a Chaturbate affiliate to use this plugin with your own affiliate ID. Register as an affiliate before using your own affiliate ID.

Disclaimer: This plugin is for adults only. Users must be 18+ to view content. Ensure compliance with local laws and regulations regarding adult content. This plugin is not officially affiliated with Chaturbate.com.