=== AI Share & Summarize ===
Contributors: fernandot,ayudawp
Tags: claude, chatgpt, social share, ai, perplexity
Requires at least: 5.0
Tested up to: 7.0
Stable tag: 1.7.4
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, Copilot, Qwen)

== 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, Mastodon, Threads, Pinterest
* **Artificial intelligences**: Claude, ChatGPT, Google AI, Gemini, Grok, Perplexity, DeepSeek, Mistral AI, Microsoft Copilot, Qwen, Meta AI
* **Official brand icons**: High-quality SVG icons sourced from Simple Icons for accurate brand representation
* **Visual customization**: 6 button styles, 4 sizes, custom colors via color picker, and configurable button order
* **Section titles**: Optional separate headings for AI and Social button groups
* **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
* **Period comparison**: Compare analytics with previous period, same period last year, or custom dates
* **CSV export**: Download analytics data or timeline summaries as CSV files for analysis in Excel or Google Sheets
* **Dashboard widget**: Quick stats overview with 7-day sparkline directly on the WordPress dashboard
* **[VigIA](https://wordpress.org/plugins/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
* **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
* **6 visual styles**: Minimal, brand colors, outline, dark backgrounds, custom colors, and icons-only
* **4 button sizes**: Compact, normal, large, and fluid (fills available width)
* **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 with drag & drop reordering within each group
* **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
* **Mastodon support**: Configurable instance field for federated sharing
* **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, Mastodon, and Threads brings access to diverse communities
9. **Fine control**: Exclude specific pages or noindex content automatically
10. **Brand consistency**: Custom colors and official brand icons match any site design

= 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
* **Section titles**: Set separate headings for AI and Social button groups
* **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
* **Mastodon instance**: Set your Mastodon server for federated sharing
* **Custom additional text**: Add personalized text to AI prompts
* **Visual styles**: 6 predefined styles including outline and custom colors
* **Button sizes**: Compact, normal, large, or fluid width
* **Custom colors**: Background and text color picker for full brand control
* **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, with drag & drop reordering within each group
* **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
* **Period comparison**: Compare current data with the previous period, same period last year, or a custom date range
* **Comparison indicators**: Stat cards show percentage change with color-coded arrows when comparison is active
* **Comparison chart**: Timeline switches to total view with a dashed overlay line and a detailed two-column tooltip
* **Platform breakdown table**: Ranked list of platforms by total clicks with paginated navigation
* **Content performance table**: Ranked list of posts and pages by total clicks with direct links and paginated navigation
* **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 dropdown**: Export the full dataset (current period) or a daily timeline summary, with comparison columns when active
* **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 =

* **Official brand icons**: Accurate SVG paths from Simple Icons for recognizable platform representation
* **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 11 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
* **Qwen integration**: Copies prompt to clipboard and opens Alibaba's AI assistant
* **Meta AI integration**: Copies prompt to clipboard and opens Meta's AI assistant
* **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. **Set section titles**: Optionally set separate titles for AI and Social groups
8. **Configure X mentions**: Add your X (Twitter) handle for automatic mentions
9. **Set Mastodon instance**: Enter your Mastodon server domain if using Mastodon
10. **Choose visual style**: Minimal, brand colors, outline, dark, custom colors, or icons-only
11. **Set button size**: Compact, normal, large, or fluid
12. **Pick custom colors**: Use the color picker when "Custom colors" style is selected
13. **Configure icons**: Enable icons for text styles or use pure icons-only mode
14. **Set icon shape**: Choose circular or square corners for icons-only buttons
15. **Set button order**: Social first, AI first, or mixed — drag & drop to reorder within each group
16. **Configure SEO settings**: Choose between links with nofollow or button elements
17. **Configure data retention**: Set retention period and optionally delete all data when plugin is uninstalled
18. **Save changes**

**Manual insertion with shortcode:**
- Basic: `[ayudawp_share_buttons]`
- Specific buttons: `[ayudawp_share_buttons buttons="claude,twitter,linkedin,deepseek,mastodon"]`
- 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"]`
- Section titles: `[ayudawp_share_buttons ai_title="Summarize with AI" social_title="Share on social media"]`
- Button size: `[ayudawp_share_buttons size="compact"]`
- Outline style: `[ayudawp_share_buttons style="outline" show_icons="true"]`

**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), compare with a previous period, the same period last year, or custom dates, and view data in timeline charts, platform tables, and content performance tables. Stat cards show percentage changes when comparison is active. You can download data as CSV files from the export dropdown. 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 to open the export menu. Choose "Current period" for a full breakdown (date, platform, type, post title, URL, clicks) or "Timeline summary" for a daily totals export. When period comparison is active, the timeline export automatically includes comparison columns (date, clicks, comparison date, comparison clicks, difference, change percentage). Files download immediately and can be opened in Excel, Google Sheets, or any spreadsheet application.

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

[VigIA](https://wordpress.org/plugins/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.

= How do the section titles work? =

You can set separate headings for the AI and Social button groups. When either section title is filled in, the general title disappears and each group gets its own heading. If both section titles are left empty, the general title works as before. When using the "Mixed" button order, the general title is always displayed regardless of section titles, since both groups are interleaved. You can also set section titles via shortcode: `[ayudawp_share_buttons ai_title="Summarize" social_title="Share"]`

= How does Mastodon sharing work? =

Since Mastodon is a federated network, the share link needs to point to your specific instance. Set your Mastodon server domain (e.g. mastodon.social, fosstodon.org) in the plugin settings. The share button will then open the compose screen on your instance with the post title and URL pre-filled.

= Can I customize the visual appearance? =

Yes, you can choose from 6 predefined styles:
- **Minimal (default)**: Clean transparent design with borders
- **Brand**: Each platform's characteristic colors
- **Outline**: Brand-colored borders with transparent background, fills on hover
- **Dark**: Optimized for dark backgrounds
- **Custom colors**: Pick your own background and text colors with a color picker
- **Icons-only**: Modern style showing only platform icons

= Can I change the button size? =

Yes, four sizes are available:
- **Compact**: Smaller buttons for tight layouts
- **Normal**: Standard size (default)
- **Large**: Bigger buttons for more prominent display
- **Fluid**: Buttons expand to fill available container width

= How do the icons work? =

The icon system uses official brand SVG paths from Simple Icons where available, ensuring accurate and recognizable platform logos. Options include:
- **Icons with text**: Add icons to the left of button text in any style
- **Icons-only**: Show only icons in circular or square buttons
- **Smart tooltips**: Platform names appear when hovering over any button
- **Responsive**: Icons automatically adapt to screen size

= 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
- Set separate titles for AI and Social groups

= 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,mastodon,threads"]`

= 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, Copilot, Qwen, and Meta AI work? =

DeepSeek, Copilot, Qwen, and Meta AI 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. Period comparison with timeline overlay and stat card indicators
9. Dashboard widget with sparkline and top platforms

== Changelog ==

= 1.7.4 =
* Fixed: Block editor sidebar panel translations now load correctly via wp_localize_script() instead of relying on JSON translation files

= 1.7.3 =
* Improved: Block editor now uses a native sidebar panel (PluginDocumentSettingPanel) instead of a classic meta box for the post exclusion checkbox
* Improved: Compatible with WordPress 7.0 real-time collaboration (RTC) — the classic meta box no longer disables collaborative editing
* Improved: Sidebar panel includes plugin dashicon for better visual identification
* Improved: Fallback to classic meta box in the block editor if the sidebar script is missing

= 1.7.2 =
* Fixed: Buttons appearing in footer or sidebar on themes that apply the_content filter outside the main loop
* Fixed: Missing styles when using shortcodes with page builders that process content after asset enqueue (Bricks Builder, etc.)
* Fixed: Mastodon instance and title text were stored as default values on new installations instead of being placeholder-only
* Improved: Frontend asset enqueue logic centralised in a single helper function shared by auto-insert and shortcode modes

= 1.7.1 =
* Fixed: Admin CSS specificity issues with WordPress 7.0 new button and dashicon styles
* Fixed: Export CSV button icon alignment broken by WP core .button .dashicons override
* Fixed: Promotional banner buttons forced to 40px height by WP core min-height reset
* Fixed: AI/Social type badges now have consistent height across all platforms
* Fixed: Data retention row vertical alignment improved for mixed-height controls
* Added: New service recommendation in promotional banner rotation
* Tested up to WordPress 7.0

= 1.7.0 =
* Added: Period comparison for analytics — compare with previous period, same period last year, or a custom date range
* Added: Comparison indicators on stat cards showing percentage change with color-coded arrows
* Added: Timeline chart automatically switches to total view with dashed comparison line when comparison is active
* Added: Two-column HTML tooltip on comparison chart showing both periods with change percentage and difference
* Added: Export CSV dropdown with two options: "Current period" (full data) and "Timeline summary" (daily breakdown)
* Added: Timeline export includes comparison columns automatically when comparison is active
* Added: Client-side paginated navigation with arrow buttons replacing "Load more" on both analytics tables
* Added: Top and bottom paginators on platforms and content tables, synced and only visible when more than 10 rows
* Added: Dashicon before plugin name on analytics and settings page titles
* Added: REST API endpoints: stats/compare, timeline/compare, export/timeline
* Added: Database method for zero-filled timeline data (used for comparison alignment by index)
* Fixed: Platform type labels (AI/Social) in the top platforms table are now translatable
* Improved: Tables load all results in a single request for faster client-side pagination

= 1.6.2 =
* Fix: Prevent button text wrapping on themes with larger font sizes or narrower button widths

= 1.6.1 =
* Fixed: Settings link in plugins screen now correctly points to the Settings tab instead of the default Analytics tab
* Fixed: Mastodon instance field now uses placeholder instead of a pre-filled default value
* Fixed: Global title field now uses placeholder instead of a pre-filled default value, consistent with section title fields

= 1.6.0 =
* Added: Mastodon support with configurable instance field for federated sharing
* Added: Threads (Meta) social sharing button
* Added: Pinterest social sharing button
* Added: Qwen (Alibaba) AI platform integration with copy-to-clipboard behavior
* Added: Meta AI platform integration with copy-to-clipboard behavior
* Added: Official brand SVG icons from Simple Icons library for all supported platforms
* Added: Outline button style (brand-colored borders, transparent background, fills on hover)
* Added: Custom colors button style with built-in color picker (wp_color_picker)
* Added: 4 button size presets: compact, normal, large, and fluid
* Added: Optional section titles for separate AI and Social group headings
* Added: Drag & drop reordering within AI and Social groups in settings
* Added: Shortcode attributes: ai_title, social_title, size
* Changed: X (Twitter) brand color updated from blue (#1da1f2) to black (#000000)
* Changed: Default and Minimal styles merged into a single "Minimal (default)" style
* Changed: All platform brand colors updated to match current official guidelines
* Changed: SEO button type setting simplified to clean radio buttons with a single description
* Improved: CSS fully refactored using CSS custom properties, no more !important overrides
* Improved: Brand and icons-only styles now use a single hover rule (brightness filter) instead of per-platform hover declarations
* Improved: Centralized platform color definitions in functions-helpers.php for consistency across CSS, JS, and admin
* Improved: Icon rendering switched from stroke-based to fill-based SVG for sharper brand representation
* Improved: Mixed button order correctly displays the general title even when section titles are configured
* Improved: Mastodon, Threads, Pinterest, Qwen, and Meta AI added to analytics platform maps

= 1.5.5 =
* Improved: New plugin suggestion added.

= 1.5.4 =
* Fixed: Links from the Analytics and Settings plugins page now take you to the correct tabs. 

= 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.7.3 =
WordPress 7.0 real-time collaboration compatibility! Block editor exclusion checkbox now uses a native sidebar panel instead of a classic meta box. Classic editor fully unchanged. Recommended update for all users.

= 1.7.1 =
WordPress 7.0 compatibility! Fixes admin CSS specificity issues with export button icons, promo banner buttons, and type badges. Also works fine with WP 6.9.x.

= 1.7.0 =
Analytics upgrade! Period comparison (previous, last year, custom), comparison indicators on stat cards, timeline overlay chart with detailed tooltip, export dropdown with timeline summary, paginated tables replacing Load more. Fully backward compatible.

= 1.6.2 =
Minor CSS change in buttons.

= 1.6.1 =
Minor fixes: Settings link now points to the correct tab, Mastodon instance and global title fields now use proper placeholders.

= 1.6.0 =
Visual overhaul! Official brand icons, 5 new platforms (Mastodon, Threads, Pinterest, Qwen, Meta AI), outline style, color picker, drag & drop ordering, 4 button sizes, section titles, and CSS refactoring. Default/Minimal merged. X updated to black. Backward compatible.

= 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.

== 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,mastodon"]`
- Available: twitter, linkedin, facebook, telegram, whatsapp, email, raindrop, reddit, bluesky, line, mastodon, threads, pinterest, claude, chatgpt, google_ai, gemini, grok, perplexity, deepseek, mistral, copilot, qwen, meta_ai

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

**size**: Button size preset
- Example: `[ayudawp_share_buttons size="compact"]`
- Options: compact, normal, large, fluid

**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

**ai_title**: Section title for AI buttons group
- Example: `[ayudawp_share_buttons ai_title="Summarize with AI"]`

**social_title**: Section title for social buttons group
- Example: `[ayudawp_share_buttons social_title="Share on social media"]`

**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 ai_title="Summarize with AI" social_title="Share" style="outline" show_icons="true"]`

`[ayudawp_share_buttons buttons="chatgpt,qwen,meta_ai,mastodon,threads" size="compact" style="brand"]`

`[ayudawp_share_buttons style="icons-only" icon_style="square" size="large"]`

`[ayudawp_share_buttons size="fluid" style="outline" show_icons="true"]`

= CSS Customization Guide =

Since version 1.6.0, the plugin uses CSS custom properties for all brand colors. You can override these in your theme to change any platform color globally:

**Override platform colors:**
`.ayudawp-share-buttons {
    --ayudawp-claude: #ff0000;
    --ayudawp-chatgpt: #00ff00;
}`

**Main container classes:**
- `.ayudawp-share-buttons` - Main wrapper container
- `.ayudawp-buttons-container` - Direct container for all buttons
- `.ayudawp-title` - Title element before buttons
- `.ayudawp-section-title` - Section title with extra top margin
- `.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
- `.outline` - Outline style (brand-colored borders)
- `.minimal` - Minimal style
- `.dark` - Dark background style
- `.custom` - Custom colors style
- `.icons-only` - Icons-only mode
- `.with-icons` - Text buttons with icons
- `.circular` - Circular icon buttons
- `.square` - Square icon buttons

**Size modifier classes:**
- `.size-compact` - Compact button size
- `.size-large` - Large button size
- `.size-fluid` - Fluid width buttons

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

**Example: Change Claude button color:**
`.ayudawp-share-buttons {
    --ayudawp-claude: #your-color;
}`

**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;
}`

**Customize or remove separator lines:**
The main container has top and bottom border lines. You can hide or replace them:

`.ayudawp-share-buttons {
    border-top: none;
    border-bottom: none;
}`

Hide only the top separator:

`.ayudawp-share-buttons {
    border-top: none;
}`

Replace with your own style:

`.ayudawp-share-buttons {
    border-top: 2px dashed #ccc;
    border-bottom: 2px dashed #ccc;
}`

**Important notes:**
- Since v1.6.0, `!important` is no longer needed for most overrides
- Use CSS custom properties to change brand colors cleanly
- Test on both desktop and mobile viewports
- Icons-only buttons have fixed dimensions (44px default, 36px compact, 54px large)

== 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 with custom properties and minimal specificity
* 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 using Simple Icons
* Translation ready
* Comprehensive shortcode API
* SEO-friendly markup options
* Post meta for individual exclusions
* Centralized platform color definitions


== 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.