=== AI Share & Summarize ===
Contributors: fernandot,ayudawp
Tags: claude, chatgpt, social share, ai, perplexity
Requires at least: 5.0
Tested up to: 6.9
Stable tag: 1.5.3
Requires PHP: 7.4
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Share on social media and generate summaries with citations from leading AIs (Claude, ChatGPT, Gemini, Grok, Perplexity, DeepSeek, Mistral, Copilot)

== Description ==

**AI Share & Summarize** is the first free plugin published in WordPress.org that combines traditional social media sharing with the innovative functionality of generating summaries while citing the source in the top artificial intelligences.

= Main features =

* **Social networks**: X (Twitter), LinkedIn, Facebook, Telegram, WhatsApp, Email, Raindrop, Reddit, Bluesky, LINE
* **Artificial intelligences**: Claude, ChatGPT, Google AI, Gemini, Grok, Perplexity, DeepSeek, Mistral AI, Microsoft Copilot
* **Individual exclusion**: Hide buttons on specific posts or pages using a simple meta box
* **Click analytics dashboard**: Track button clicks by platform and content with timeline charts
* **CSV export**: Download your analytics data as a CSV file for analysis in Excel or Google Sheets
* **Dashboard widget**: Quick stats overview with 7-day sparkline directly on the WordPress dashboard
* **VigIA integration**: Cross-reference click data with AI crawler visits when VigIA plugin is active
* **SEO plugin integration**: Automatically exclude noindex content (Yoast, Rank Math, All in One SEO, SEOPress, The SEO Framework)
* **SEO optimization options**: Choose between `<a>` links with nofollow or `<button>` elements to optimize your link profile
* **Modern icon support**: Beautiful SVG icons with icons-only mode for a sleek, modern look
* **Universal tooltips**: Helpful tooltips on ALL buttons for better user experience
* **Smart automatic insertion**: Configure exactly where and on which content types to display buttons
* **Detailed control by content type**: Choose specific post types (posts, pages, products, etc.)
* **Customizable AI prompt**: Configure the message sent to AIs for better summaries
* **Customizable title**: Change the text before buttons and choose heading style (h3-h6 or span)
* **Multiple insertion modes**: Before content, after content, both positions, or shortcode only
* **5 visual styles**: Default, brand colors, minimal, dark backgrounds, and icons-only
* **Flexible icon options**: Add icons to any style or use pure icons-only mode with circular/square shapes
* **Button ordering**: Social first, AI first, or mixed arrangement
* **Button alignment**: Choose between left-aligned (default) or centered layout for title and buttons
* **Data retention control**: Configurable retention period with automatic daily purge and manual data deletion
* **Fully responsive**: Adapts to any device and theme with smart mobile layouts
* **SEO optimized**: Nofollow links and target="_blank" by default, or use button elements
* **Lightweight**: Optimized modular structure with ultra-fast loading SVG icons
* **Accessible**: Complies with web accessibility standards with enhanced tooltips
* **Consistent design**: Same size and behavior for both link and button elements


= Why use this plugin? =

This plugin helps you:

1. **Generate natural backlinks**: When users summarize your content with AI, they cite your source
2. **Increase your reach**: Combine traditional social sharing with AI power
3. **Build authority**: Your content becomes a reference source for future queries
4. **Boost engagement**: Users can interact with your content in multiple ways
5. **Optimize SEO**: Choose the HTML element type that best fits your SEO strategy
6. **Stay ahead**: Be among the first to leverage AI for content distribution
7. **Modern appearance**: Icons-only mode provides a sleek, professional look
8. **Global reach**: Support for LINE brings access to Asian markets
9. **Fine control**: Exclude specific pages or noindex content automatically

= Advanced configuration =

* **Smart automatic insertion**: Choose exactly where to insert buttons (before, after, both, or disabled)
* **Content type control**: Select specific post types from all registered in your WordPress
* **Individual exclusion**: Hide buttons on any post or page using a meta box checkbox
* **SEO integration**: Automatically hide buttons on noindex content
* **Custom AI prompt**: Optimize the message sent to AIs for better summaries with citation
* **Custom title text**: Configure the text shown before buttons or hide it completely
* **Title style control**: Choose between h3, h4, h5, h6 or span for the title element
* **SEO optimization**: Choose between traditional links or button elements for better link profile control
* **X (Twitter) mentions**: Configure your profile for automatic mentions in shares
* **Custom additional text**: Add personalized text to AI prompts
* **Visual styles**: 5 predefined styles adaptable to any theme
* **Advanced icon system**: Show icons with text, icons-only mode, circular or square icons
* **Button ordering**: Organize buttons as social first, AI first, or mixed
* **Button alignment**: Choose left or centered alignment for a cleaner design
* **Data management**: Configure retention period (1 month to forever), manual data deletion, and optional cleanup on uninstall
* **Shortcode flexibility**: Use `[ayudawp_share_buttons]` anywhere with extensive parameters

= SEO features =

* **Link element control**: Choose between `<a>` links with nofollow or `<button>` elements
* **No PageRank leakage**: All links include rel="nofollow noopener" by default
* **Crawl budget optimization**: Button elements are not crawled by search engines
* **Clean link profile**: Reduce the total number of outbound links on your pages
* **Semantic markup**: Button elements are semantically correct for action triggers
* **Flexible configuration**: Set different options for different pages using shortcodes
* **Noindex exclusion**: Automatically hide buttons on content marked as noindex

= Analytics features =

* **Click tracking**: Every button click is recorded with platform, post, and date
* **Timeline chart**: Visualize total clicks over time with a daily breakdown
* **Per-platform timeline**: See each platform's performance in the same chart with brand colors and interactive legend
* **Platform breakdown table**: Ranked list of platforms by total clicks with percentage share
* **Content performance table**: Ranked list of posts and pages by total clicks with direct links
* **Platform type badges**: Visual distinction between Social and AI platforms in all tables
* **Date range filters**: Filter data by 7, 15, 30, 90, 180, 365 days or a custom date range
* **CSV export**: Download the full filtered dataset as a CSV file ready for Excel or Google Sheets
* **Dashboard widget**: 7-day sparkline chart and top platforms summary on the WordPress admin homepage
* **VigIA integration**: When VigIA plugin is active, cross-reference your share clicks with AI crawler visits
* **Cached queries**: Analytics queries are cached for 5 minutes and compatible with Redis and Memcached
* **REST API**: Lightweight endpoints power all analytics views without full page reloads

= Icon system features =

* **Icons-only style**: Modern button design showing only platform icons
* **Icons with text**: Add recognizable icons to the left of button text in any style
* **Responsive design**: Icons automatically adapt size and layout for mobile devices
* **Lightweight SVG**: Ultra-optimized icons for minimal performance impact
* **Smart tooltips**: Platform names appear on hover for ALL buttons
* **Flexible shapes**: Choose between circular or square corners for icons-only buttons
* **Consistent sizing**: Same dimensions for both link and button elements

= Special AI features =

* **Multiple AI platforms**: Support for 9 different AI services
* **Gemini integration**: Automatically copies prompt to clipboard and opens Gemini
* **DeepSeek integration**: Automatically copies prompt to clipboard and opens DeepSeek
* **Copilot integration**: Automatically copies prompt to clipboard and opens Copilot
* **Optimized prompts**: Pre-configured messages for best summary results with citation
* **Direct links**: Each AI opens with the complete prompt ready to process
* **Source citation**: All prompts automatically include your content URL as source
* **Language support**: Configure prompts to request responses in any language

= Compatibility =

* Supports any WordPress theme following standards
* Works with Custom Post Types automatically  
* Optimized for WooCommerce products
* Compatible with page builders (Elementor, Gutenberg, etc.)
* Multi-language ready with automatic translations
* No external dependencies or conflicts
* Compatible with major SEO plugins

== Installation ==

= Automatic installation =

1. Go to Plugins > Add New in your WordPress admin
2. Search for "AI Share & Summarize"
3. Click "Install Now" and then "Activate"
4. Go to Settings > AI Share & Summarize to configure

= Manual installation =

1. Download the plugin ZIP file
2. Go to Plugins > Add New > Upload Plugin
3. Select the ZIP file and click "Install Now"
4. Activate the plugin
5. Configure in Settings > AI Share & Summarize

= Complete setup =

1. **Go to Settings > AI Share & Summarize**
2. **Select enabled buttons**: Choose which social networks and AIs to display
3. **Configure automatic insertion**:
   - Choose position: Before content, after, both, or disabled (shortcode only)
   - Select content types: Posts, pages, products, or any Custom Post Type
4. **Configure SEO integration**: Enable/disable automatic exclusion of noindex content
5. **Customize AI prompt**: Modify the default text if desired (excellent default included)
6. **Configure title**: Change the text before buttons and choose heading style
7. **Configure X mentions**: Add your X (Twitter) handle for automatic mentions
8. **Choose visual style**: Default, brand colors, minimal, dark backgrounds, or icons-only
9. **Configure icons**: Enable icons for text styles or use pure icons-only mode
10. **Set icon shape**: Choose circular or square corners for icons-only buttons
11. **Set button order**: Social first, AI first, or mixed arrangement
12. **Configure SEO settings**: Choose between links with nofollow or button elements
13. **Configure data retention**: Set retention period and optionally delete all data when plugin is uninstalled
14. **Save changes**

**Manual insertion with shortcode:**
- Basic: `[ayudawp_share_buttons]`
- Specific buttons: `[ayudawp_share_buttons buttons="claude,twitter,linkedin,deepseek"]`
- Custom style: `[ayudawp_share_buttons style="minimal" show_title="false"]`
- With icons: `[ayudawp_share_buttons show_icons="true" style="brand"]`
- Icons only: `[ayudawp_share_buttons style="icons-only"]`
- Circular icons: `[ayudawp_share_buttons style="icons-only" icon_style="circular"]`
- Custom title: `[ayudawp_share_buttons title_text="Share or Summarize" title_style="h3"]`

**Individual exclusion:**
- Edit any post or page
- Find the "AI Share & Summarize" meta box in the sidebar
- Check "Hide share buttons on this content" to exclude that specific content

== Frequently Asked Questions ==

= Is this plugin completely free? =

Yes, AI Share & Summarize is 100% free with all features included, including support for all social networks, AI platforms, and the full analytics dashboard with CSV export.

= How does the analytics dashboard work? =

The analytics dashboard tracks every button click on your site, showing you which platforms are most popular and which content gets the most engagement. You can filter by date range (7 to 365 days or custom dates), view data in timeline charts, platform tables, and content performance tables, and download everything as a CSV file. A dashboard widget provides a quick 7-day summary right on your WordPress admin homepage.

= How do I export analytics data? =

In the Analytics tab, use the date filter to select the period you want, then click the "Export CSV" button. The file downloads immediately to your computer and can be opened directly in Excel, Google Sheets, or any spreadsheet application. The export includes date, platform, platform type (Social or AI), post title, post URL, and click count for each row.

= What is VigIA and how does the integration work? =

VigIA is a free WordPress plugin by AyudaWP that monitors AI crawler visits to your site — tracking bots like GPTBot (ChatGPT), ClaudeBot, PerplexityBot and 50+ more. When VigIA is active alongside AI Share & Summarize, the analytics dashboard shows an additional panel where you can cross-reference your share button clicks with AI crawler activity. This lets you see, for example, whether a spike in Claude clicks correlates with increased ClaudeBot crawling of that content. You can install VigIA directly from the plugin screen.

= Will it slow down my website? =

No. The plugin is ultra-optimized with a modular structure and lightweight SVG icons that load instantly. Frontend CSS and JavaScript only load on pages where share buttons are actually displayed — posts with buttons disabled via the meta box do not load any plugin assets.

= How do I hide buttons on specific pages? =

Edit the post or page where you want to hide buttons, find the "AI Share & Summarize" meta box in the sidebar, and check "Hide share buttons on this content". This works with both the classic editor and the block editor.

= Can I automatically hide buttons on noindex content? =

Yes! The plugin integrates with major SEO plugins (Yoast, Rank Math, All in One SEO, SEOPress, The SEO Framework). Enable the "Exclude noindex content" option in settings to automatically hide buttons on content marked as noindex.

= What's the difference between Google AI and Gemini buttons? =

**Google AI** uses the new AI Mode available in most countries, launching the AI response automatically with your prompt. **Gemini** uses the traditional method (copy prompt and open Gemini) which still works everywhere. Choose based on availability in your region or user preference.

= Should I use links or buttons for SEO? =

Both options are valid:
- **Links with nofollow (default)**: Better user experience, allows right-click to copy link, works without JavaScript
- **Button elements**: Not counted as links by search engines, cleaner link profile, reduces crawl budget usage

The nofollow attribute already prevents PageRank transfer, so the SEO impact is minimal. Choose based on your specific needs.

= Can I customize the visual appearance? =

Yes, you can choose from 5 predefined styles:
- **Default**: Clean design with white backgrounds
- **Brand**: Each platform's characteristic colors
- **Minimal**: Transparent with borders only
- **Dark**: Optimized for dark backgrounds
- **Icons-only**: Modern style showing only platform icons

= How do the tooltips work? =

All buttons now have tooltips that show on hover, displaying the platform name. This helps users identify buttons, especially in icons-only mode. Tooltips are lightweight and accessible, improving the overall user experience.

= How do the icons work? =

The icon system offers flexible options:
- **Icons with text**: Add beautiful icons to the left of button text in any style
- **Icons-only**: Show only icons in circular or square buttons for a modern look
- **Smart tooltips**: Platform names appear when hovering over any button
- **Responsive**: Icons automatically adapt to screen size and device

= Can I control the icon appearance? =

Yes, you have full control:
- Enable/disable icons for text-based styles
- Choose icons-only mode for a minimalist approach
- Select circular or square corners for icons-only buttons
- Icons automatically use appropriate sizes (20px for icons-only, 16px with text)

= Can I change the title before the buttons? =

Yes, you can:
- Change the text to anything you want
- Choose the HTML element: h3, h4, h5, h6, or span
- Hide the title completely by leaving the text field empty

= How does automatic insertion work? =

You have complete control:
- **Before content**: Buttons appear before the post text
- **After content**: Buttons appear after the post text  
- **Both positions**: Buttons in both locations
- **Disabled**: Use only shortcode `[ayudawp_share_buttons]`

Plus, you choose exactly which content types display buttons.

= Can I control which content types show buttons? =

Absolutely. You can select from all post types registered in your WordPress:
- Posts, pages, WooCommerce products
- Custom Post Types (portfolios, testimonials, etc.)
- Complete per content type control

= How do I customize the AI prompt? =

In Settings > AI Share & Summarize you'll find:
- **Default prompt**: Pre-optimized for best results with citation
- **Custom text field**: Add personalized text to all AI prompts
- **X handle**: Configure automatic mentions in social shares
- The plugin automatically adds your content URL as source

= What happens if an AI changes its URL? =

We continuously monitor and update all AI links to ensure they work correctly. The plugin receives regular updates to maintain compatibility.

= Can I use only specific buttons? =

Yes, with the shortcode you can display only the buttons you want:
`[ayudawp_share_buttons buttons="claude,chatgpt,deepseek,twitter,reddit"]`

= Is it GDPR compliant? =

Yes. The plugin does not collect any personal user data. The analytics system only records anonymous click events — platform name, post ID, and date — with no user identification, IP address, or session data stored at any point. Analytics data is retained in your own database for as long as you keep the plugin active. If you uninstall the plugin with the "Delete all plugin data" option enabled, all analytics records are permanently removed along with the rest of the plugin data.

= How does Google AI integration work? =

Google AI has direct integration:
- Clicking the button opens Google's AI Mode with your prompt
- The AI automatically processes the prompt and shows results
- Works in most countries where AI Mode is available

= How does LINE integration work? =

LINE is extremely popular in Asian markets (Japan, Taiwan, Thailand). The plugin allows sharing your content directly to LINE, helping you reach millions of users in these regions.

= Why does Google AI respond in English even though my site is in another language? =

Google AI Mode has a default behavior of responding in English regardless of browser or site language. To get responses in your preferred language, add a custom instruction in the plugin settings.

Go to Settings > AI Share & Summarize > "Custom text in prompts" and add:
`Deliver the response in Spanish` (or your preferred language)

This instruction will be added to all AI prompts, ensuring responses match your language preference.

= How does Gemini integration work? =

Gemini has a special behavior:
- Clicking the button automatically copies the prompt to clipboard
- Opens Gemini in a new tab
- User can paste the prompt directly and get the summary

= How do DeepSeek and Copilot work? =

DeepSeek and Copilot work the same way as Gemini:
- Clicking the button automatically copies the prompt to clipboard
- A notification appears confirming the copy
- The platform opens in a new tab
- User can paste the prompt with Ctrl+V and get the summary

This approach is used because these platforms don't support URL parameters for prompts.

= Does it work with page builders? =

Yes, it's compatible with:
- Gutenberg (WordPress block editor)
- Elementor, Beaver Builder, Divi
- Any page builder that respects WordPress hooks
- Manual insertion via shortcode works everywhere

= Can I disable automatic insertion completely? =

Yes, set automatic insertion to "Disabled" in settings and use only the shortcode `[ayudawp_share_buttons]` where you want buttons to appear.

= What happens to my settings when I uninstall the plugin? =

By default, your settings are preserved even after uninstalling. However, you can enable the "Delete all plugin data when plugin is deleted" option in the Data cleanup section if you want automatic cleanup. This will also delete all analytics data stored in the database.

= Which SEO plugins are compatible? =

The plugin detects and integrates with:
- Yoast SEO
- Rank Math
- All in One SEO
- SEOPress
- The SEO Framework

When enabled, buttons will automatically be hidden on content marked as noindex in any of these plugins.

== Screenshots ==

1. Share and AI summarize buttons in action on a post
2. Mobile responsive view
3. Complete plugin settings page
4. Prompt opened on ChatGPT
5. Meta box for individual exclusion
6. SEO integration setting with detected SEO plugin
7. Analytics dashboard with timeline chart and platform breakdown
8. Dashboard widget with sparkline and top platforms

== Changelog ==

= 1.5.3 =
* Changed: Analytics tab is now the default tab when opening the plugin settings page

= 1.5.2 =
* Added: Data retention settings with configurable period (1 month, 3 months, 6 months, 1 year, or forever)
* Added: Automatic daily purge of analytics data older than the configured retention period
* Added: "Delete all data" button for manual one-click analytics data removal
* Changed: "Data cleanup" setting renamed to "Data retention" with improved layout
* Improved: Retention period, uninstall cleanup, and manual deletion grouped in a single settings row

= 1.5.1 =
* Fixed: Click tracking now works correctly with full-page caching plugins (SiteGround Speed Optimizer, WP Super Cache, etc.)
* Fixed: Analytics REST API responses no longer cached by server-side caching plugins
* Improved: Dashboard widget uses transient cache to reduce database queries on admin homepage
* Improved: Removed aggressive cache invalidation on every click insert for better performance under load

= 1.5.0 =
* Added: Click analytics dashboard with timeline charts, platform breakdown, and content performance tables
* Added: Per-platform breakdown in timeline chart with brand colors and interactive legend
* Added: CSV export for analytics data (date, platform, type, post title, post URL, clicks)
* Added: REST API endpoints for analytics data (stats, timeline, timeline-by-platform, platforms, content, export)
* Added: Dashboard widget with 7-day sparkline chart and top platforms summary
* Added: VigIA integration - cross-reference share clicks with AI crawler visits
* Added: Dynamic promotional banner with AyudaWP plugin catalog rotation
* Added: Tabbed admin interface (Settings / Analytics)
* Added: Direct Analytics link in plugin row on the plugins screen
* Added: Platform type badges (Social / AI) in analytics tables
* Improved: Frontend CSS/JS only load on pages where buttons are actually displayed
* Improved: Posts with buttons disabled via meta box no longer load plugin assets
* Improved: Admin styles moved to external CSS file following WordPress coding standards
* Fixed: Export CSV button icon vertical alignment
* Fixed: Analytics dashboard failing to load due to incomplete localized data

= 1.4.1 =
* Fixed: Minor edits to the text on the settings page

= 1.4.0 =
* Added: Individual post/page exclusion via meta box (works with both classic and block editors)
* Added: SEO plugin integration to automatically exclude noindex content
* Added: Support for Yoast SEO, Rank Math, All in One SEO, SEOPress, and The SEO Framework
* Changed: LINE icon updated to be more distinctive (smiley face in speech bubble)
* Changed: Simplified settings page info box with link to plugin page for shortcode examples
* Changed: Promotional section redesigned with 3-column layout and plugin install modals
* Improved: Clean separation of includes in organized file structure
* Improved: Better defaults for new installations

= 1.3.1 =
* Fixed: DeepSeek button now works correctly using copy-to-clipboard method (web interface doesn't support URL parameters)
* Fixed: Microsoft Copilot button now works correctly using copy-to-clipboard method (?q= parameter no longer supported)
* Improved: DeepSeek and Copilot now use the same reliable approach as Gemini
* Improved: Added specific tooltips for DeepSeek and Copilot indicating copy-to-clipboard behavior
* Improved: Unified handling for all platforms that require copy-to-clipboard (Gemini, DeepSeek, Copilot)

= 1.3.0 =
* Added: Support for Reddit, Bluesky, and LINE social networks
* Added: Integration with DeepSeek, Mistral AI, and Microsoft Copilot
* Added: Universal tooltip system for ALL buttons (not just icons-only)
* Fixed: Inconsistent sizing between link and button elements
* Fixed: Hover effects now work uniformly across all button types
* Improved: Better tooltip positioning and styling
* Improved: Consistent 44px size for icons-only mode (both links and buttons)
* Improved: JavaScript event handling for better compatibility
* Improved: CSS transitions and animations for smoother interactions
* Improved: Mobile responsiveness for new platforms
* Updated: Icon set with new platform graphics
* Updated: Documentation with new platform information

= 1.2.0 =
* Added: Google AI button with direct integration to Google AI Mode
* Added: Support for Google's new AI Mode (udm=50) for direct AI responses
* Improved: Renamed "Google AI (Gemini)" to just "Gemini" for clarity
* Improved: Users can now choose between Google AI (automatic) or Gemini (copy & paste)
* Improved: Better support for regions where Google AI Mode is available
* Fixed: Links mode (`<a>` elements) now work correctly with added data attributes for JavaScript handling
* Updated: Frontend JavaScript to handle both Google AI and Gemini buttons
* Updated: Icon system with new Google AI icon (search with sparkle)
* Updated: CSS with styles for both Google AI and Gemini buttons
* Updated: Documentation with information about both Google AI options

= 1.1.4 =
* Added: Button alignment option (left/centered) for better design control
* Improved: All buttons now have uniform width (180px) for consistent appearance
* Improved: Buttons stack vertically on mobile (480px and below) preventing text overflow
* Improved: Icons-only mode properly centered when alignment is set to centered
* Improved: Better responsive behavior with optimized button widths across all screen sizes
* Fixed: Text wrapping issues in buttons with longer labels like "X (Twitter)"

= 1.1.3 =
* Fixed: Resolved JavaScript event handler conflicts that prevented buttons from working on some sites when logged in
* Improved: Better event handling with capture phase to prevent interference from other plugins
* Improved: More elegant centered notification for Google AI prompt copying
* Improved: Enhanced compatibility with themes and plugins that modify JavaScript execution
* Fixed: Resolved button functionality issues in WordPress admin environment

= 1.1.2 =
* Improved: Removed more unnecessary colours and icons in plugin settings page

= 1.1.1 =
* Improved: Removed all unnecessary colours and icons in plugin settings page

= 1.1.0 =
* Added: SEO settings section with option to choose between `<a>` links or `<button>` elements
* Added: Full support for button elements as an alternative to links
* Added: Detailed explanations of SEO implications for each option
* Improved: JavaScript to handle both link and button elements seamlessly
* Improved: CSS to ensure consistent styling for both element types
* Improved: Admin interface with new SEO section and better organization
* Fixed: Better accessibility for button elements
* Updated: Documentation to explain SEO benefits of each approach

= 1.0.9 =
* Fixed: Added missed translations for tooltips

= 1.0.8 =
* Added: Icons-only button style for modern, minimalist design
* Added: Option to show icons alongside text in any existing style
* Added: Icon style selection (circular or square corners for icons-only mode)
* Added: Enhanced tooltips for icons-only buttons showing platform names
* Added: Responsive grid layout for icons-only mode on mobile devices
* Added: Data cleanup control - optional automatic data deletion on plugin uninstall
* Added: Improved icon system with lightweight SVG graphics
* Improved: Complete code restructuring with modular architecture for better performance
* Improved: Separated functionality into individual class files in /includes folder
* Improved: Enhanced mobile responsiveness for all button styles
* Improved: Better default values (AIs first, brand colors, span titles, circular icons)
* Improved: Enhanced admin interface with icon previews and danger zone styling
* Fixed: Better CSS specificity to prevent theme conflicts
* Updated: All icon graphics for better platform recognition

== Upgrade Notice ==

= 1.5.3 =
Analytics tab is now the default view when opening plugin settings.

= 1.5.2 =
New data retention controls! Configure automatic cleanup of analytics data (1 month to forever) and manually delete all data with one click. Better organized data settings.

= 1.5.1 =
Full-page caching compatibility fix! Click tracking and analytics now work correctly with SiteGround Speed Optimizer and other caching plugins. Dashboard widget optimized for faster admin loading.

= 1.5.0 =
New analytics dashboard! Track button clicks by platform and content, with timeline charts, CSV export, and a dashboard widget. VigIA integration for AI crawler cross-referencing. Improved performance with selective asset loading.

= 1.4.1 =
Minor text changes on the settings page.

= 1.4.0 =
New features! Individual post/page exclusion and automatic SEO plugin integration. Hide buttons on specific content or automatically exclude noindex pages. Updated LINE icon and improved settings page.

= 1.3.1 =
Bugfix release! Fixes DeepSeek and Microsoft Copilot buttons that weren't delivering prompts. Both now use copy-to-clipboard method like Gemini. Recommended update for all users.

= 1.3.0 =
Major update! Added support for Reddit, Bluesky, LINE, DeepSeek, Mistral AI, and Microsoft Copilot. Enhanced tooltip system now works on all buttons. Fixed sizing consistency issues between link and button elements.

= 1.2.0 =
New Google AI Mode support! Choose between direct Google AI integration or traditional Gemini method. Both options available for maximum flexibility and regional compatibility.

= 1.1.4 =
Visual improvements update! New button alignment option, uniform button widths, and enhanced mobile responsive behavior for a professional appearance across all devices.

= 1.1.3 =
Important compatibility fix! Resolves JavaScript conflicts that prevented buttons from working when logged in on some sites. Recommended update for all users.

= 1.1.0 =
New SEO optimization features! Choose between traditional links or button elements to optimize your site's link profile. Full backward compatibility maintained with links as default option.

= 1.0.8 =
Major update with modern icon support! New icons-only style, icons with text option, data cleanup control, and complete code restructuring for better performance. Highly recommended update for enhanced visual options and improved maintainability.

== Advanced Usage ==

= Shortcode parameters =

The `[ayudawp_share_buttons]` shortcode accepts several parameters:

**buttons**: Comma-separated list of buttons to display
- Example: `[ayudawp_share_buttons buttons="claude,chatgpt,deepseek,twitter,reddit"]`
- Available: twitter, linkedin, facebook, telegram, whatsapp, email, raindrop, reddit, bluesky, line, claude, chatgpt, google_ai, gemini, grok, perplexity, deepseek, mistral, copilot

**style**: Visual style to use
- Example: `[ayudawp_share_buttons style="icons-only"]`
- Options: default, brand, minimal, dark, icons-only

**show_icons**: Show icons with text (for non-icons-only styles)
- Example: `[ayudawp_share_buttons show_icons="true" style="brand"]`
- Options: true, false

**icon_style**: Icon corner style (for icons-only mode)
- Example: `[ayudawp_share_buttons style="icons-only" icon_style="circular"]`
- Options: circular, square

**alignment**: Button alignment
- Example: `[ayudawp_share_buttons alignment="center"]`
- Options: left, center

**show_title**: Show or hide the section title
- Example: `[ayudawp_share_buttons show_title="false"]`
- Options: true, false

**title_text**: Custom title text
- Example: `[ayudawp_share_buttons title_text="Share this content"]`

**title_style**: Title HTML element
- Example: `[ayudawp_share_buttons title_style="h3"]`
- Options: h3, h4, h5, h6, span

**Combined examples:**

`[ayudawp_share_buttons buttons="claude,deepseek,twitter" style="brand" show_icons="true"]`

`[ayudawp_share_buttons style="icons-only" icon_style="circular"]`

`[ayudawp_share_buttons show_title="true" title_text="Share or Summarize" title_style="h3"]`

`[ayudawp_share_buttons buttons="chatgpt,mistral,copilot" style="icons-only" icon_style="square" show_title="false"]`

`[ayudawp_share_buttons alignment="center" style="brand" show_icons="true"]`

`[ayudawp_share_buttons alignment="center" style="icons-only" icon_style="circular"]`

= CSS Customization Guide =

If you need to customize button colors or styles before a future design customization feature is available, here are the CSS classes and selectors you can use:

**Main container classes:**
- `.ayudawp-share-buttons` - Main wrapper container
- `.ayudawp-buttons-container` - Direct container for all buttons
- `.ayudawp-title` - Title element before buttons
- `.ayudawp-aiss-centered` - Applied when centered alignment is enabled

**Button classes:**
- `.ayudawp-share-btn` - Base class for all buttons (both `<a>` and `<button>` elements)
- `.ayudawp-icon-wrapper` - Container for button icons
- `.ayudawp-button-text` - Text label inside buttons
- `.ayudawp-icon` - SVG icon element

**Style modifier classes:**
- `.brand` - Brand colors style
- `.minimal` - Minimal style
- `.dark` - Dark background style
- `.icons-only` - Icons-only mode
- `.with-icons` - Text buttons with icons
- `.circular` - Circular icon buttons
- `.square` - Square icon buttons

**Platform-specific classes (on buttons):**
- `.twitter`, `.linkedin`, `.facebook`, `.telegram`, `.whatsapp`
- `.email`, `.raindrop`, `.reddit`, `.bluesky`, `.line`
- `.claude`, `.chatgpt`, `.google-ai`, `.gemini`, `.grok`
- `.perplexity`, `.deepseek`, `.mistral`, `.copilot`
- `.ai` - Applied to all AI platform buttons

**Example: Change Claude button color:**
`.ayudawp-share-buttons.brand .ayudawp-share-btn.claude {
    background: #your-color !important;
    border-color: #your-color !important;
}`

**Example: Change all AI buttons background:**
`.ayudawp-share-buttons .ayudawp-share-btn.ai {
    background: #f0f0f0;
}`

**Example: Hide specific button:**
`.ayudawp-share-btn.facebook {
    display: none !important;
}`

**Example: Change button width:**
`.ayudawp-share-btn {
    width: 200px !important;
}`

**Important notes:**
- Use `!important` when overriding brand colors due to high specificity
- Test on both desktop and mobile viewports
- Icons-only buttons have fixed 44px dimensions
- Consider using browser developer tools to inspect elements

== Technical Details ==

= System requirements =
* WordPress 5.0 or higher
* PHP 7.4 or higher (compatible up to PHP 8.4)
* Theme compatible with wp_head() and wp_footer()

= Performance features =
* Modular file structure for maximum efficiency
* Selective loading of resources (CSS/JS only where buttons display)
* No external dependencies
* Optimized CSS and JavaScript
* Lightweight SVG icons (under 1KB each)
* Minimal database impact: analytics queries are cached (5 min) and compatible with persistent object cache (Redis, Memcached)
* Smart responsive layouts
* REST API for lightweight analytics data retrieval

= Developer features =
* Clean, documented code
* WordPress coding standards compliant
* Hook-based architecture
* Modular class structure in /includes folder
* Extensible icon system
* Translation ready
* Comprehensive shortcode API
* SEO-friendly markup options
* Post meta for individual exclusions


== Support ==

= Need help or have suggestions? =
* [Official website](https://servicios.ayudawp.com/)
* [WordPress support forum](https://wordpress.org/support/plugin/ai-share-summarize/)
* [YouTube channel](https://www.youtube.com/AyudaWordPressES)
* [Documentation and tutorials](https://ayudawp.com/)

**Love the plugin?** Please leave us a 5-star review and help spread the word!

== About AyudaWP ==

We are specialists in WordPress security, SEO, and performance optimization plugins. We create tools that solve real problems for WordPress site owners while maintaining the highest coding standards and accessibility requirements.