=== AI Share & Summarize ===
Contributors: fernandot,ayudawp
Tags: claude, chatgpt, google ai, perplexity, grok
Requires at least: 5.0
Tested up to: 6.9
Stable tag: 1.2.1
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 all the top AIs (Claude, ChatGPT, Google AI, Gemini, Grok, Perplexity)

== 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
* **Artificial intelligences**: Claude, ChatGPT, Google AI, Gemini, Grok, Perplexity
* **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
* **Smart automatic insertion**: Configure exactly where and on which content types to display buttons
* **Granular 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 cleanup control**: Optional automatic data deletion when plugin is uninstalled
* **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

= New in version 1.2.0 =

* **Google AI Mode support**: Direct integration with Google's AI Mode (available in most countries)

= 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

= 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
* **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**: Control whether plugin data is deleted 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

= 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 in icons-only mode
* **Flexible shapes**: Choose between circular or square corners for icons-only buttons

= Special AI features =

* **Gemini integration**: Automatically copies prompt to clipboard and opens Gemini
* **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

= 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

== 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. **Customize AI prompt**: Modify the default text if desired (excellent default included)
5. **Configure title**: Change the text before buttons and choose heading style
6. **Configure X mentions**: Add your Twitter/X handle for automatic mentions
7. **Choose visual style**: Default, brand colors, minimal, dark backgrounds, or icons-only
8. **Configure icons**: Enable icons for text styles or use pure icons-only mode
9. **Set icon shape**: Choose circular or square corners for icons-only buttons
10. **Set button order**: Social first, AI first, or mixed arrangement
11. **Configure SEO settings**: Choose between links with nofollow or button elements
12. **Configure data cleanup**: Optionally delete all data when plugin is uninstalled
13. **Save changes**

**Manual insertion with shortcode:**
- Basic: `[ayudawp_share_buttons]`
- Specific buttons: `[ayudawp_share_buttons buttons="claude,twitter,linkedin"]`
- 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"]`

== Frequently Asked Questions ==

= Is this plugin completely free? =

Yes, AI Share & Summarize is 100% free with all features included, including the new SEO optimization options.

= Will it slow down my website? =

No. The plugin is ultra-optimized with a modular structure and lightweight SVG icons that load instantly.

= 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 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 icons-only buttons
- **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 granular control per content type

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

= Can I use only specific buttons? =

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

= Is it GDPR compliant? =

Yes, the plugin doesn't collect any personal user data, making it GDPR compliant by default.

= 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

= 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

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

== Screenshots ==

1. Share and AI summarize buttons in action on a post
2. Responsive view on mobile devices
3. Complete plugin settings page
4. Prompt opened in ChatGPT

== Changelog ==

= 1.2.1 =
* Tested up to WordPress 6.9

= 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 "Twitter (X)"

= 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.2.1 =
Plugin tested with WordPress 6.9 (and it works)

= 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,google_ai,twitter,linkedin"]`
- Available: twitter, linkedin, facebook, telegram, whatsapp, email, raindrop, claude, chatgpt, google_ai, gemini, grok, perplexity

**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,google_ai,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,google_ai,gemini" 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"]`

= Custom CSS =

**You can customize the appearance using these CSS classes:**
- Main container - `.ayudawp-share-buttons`
- Individual buttons (works for both `<a>` and `<button>`): `.ayudawp-share-btn`
- Buttons container: `.ayudawp-buttons-container`
- Title element: `.ayudawp-title`
- Icon container: `.ayudawp-icon-wrapper`
- Alignment modifier: `.ayudawp-aiss-centered`
- Button text (when used with icons): `.ayudawp-button-text`
- Style modifiers: `.brand`, `.minimal`, `.dark`, `.icons-only`, `.with-icons`, `.circular`, `.square`
- Platform-specific: `.google-ai`, `.gemini`

= Icon customization =

**Icons are SVG-based and can be styled with CSS:**
- Icons inherit the current text color with `stroke: currentColor`
- Icons-only buttons are 40px by default (36px on mobile)
- Text+icon buttons use 16px icons
- Circular icons use `border-radius: 50%`
- Square icons use `border-radius: 4px`

= SEO customization =

**Control how buttons affect your SEO:**
- Use `<a>` elements for better user experience and traditional sharing
- Use `<button>` elements to reduce link count and save crawl budget
- Both options prevent PageRank transfer with proper attributes
- Configure globally in settings or per-page with shortcodes

== Technical Details ==

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

= Performance features =
* Modular file structure for maximum efficiency
* Conditional loading of resources
* No external dependencies
* Optimized CSS and JavaScript
* Lightweight SVG icons (under 1KB each)
* Minimal database impact
* Smart responsive layouts

= 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

= New in 1.2.0 architecture =
* Added Google AI button configuration
* Enhanced button generation system for dual Google options
* Updated icon system with new Google AI icon
* Improved platform detection in frontend JavaScript
* Better tooltip handling for multiple Google platforms

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