Share Buttons & AI-powered Summaries — Full changelog

For each release, see the entries below. The latest version is always at the top.
The current release notes also live in readme.txt under "== Changelog ==".

= 2.7.1 =
* Improved: Analytics now uses the full width of the screen, with the AyudaWP services banner as a strip at the bottom instead of a side column, as in VigIA. The charts and the two tables have room again, and on a laptop screen the tables sit side by side. The Share Buttons and AI Summary tabs keep the banner in the side column.
* Fix: Now and then an AI summary came out in English for a post written in another language. The only language rule was a single line in English asking the AI to match the post, in a request that is otherwise in English too. The language is now named in the instructions and again in the request: the language of the post when Polylang or WPML is active, and otherwise the language the post is written in, with the site language named as the usual one unless it is English (many sites that write in another language never change the default English setting). Quotes, names and technical terms in another language no longer count. Existing summaries are not regenerated: use Regenerate on any that came out in the wrong language. Developers can set the language per post with the `ayudawp_aiss_summary_locale` filter.

= 2.7.0 =
* New: Custom content inside the summary box, below the summary. Anything fits: text, HTML or scripts, such as an ad (AdSense, Google Ad Manager or any other), a newsletter form, a map or a notice. It can also be left empty for an ad server or Google Tag Manager to fill the space, the element with id `ayudawp-aiss-custom`. It only loads the first time a reader opens the box, so nothing is requested into a folded box, and opening it fires the `ayudawp_aiss_custom_visible` event, also pushed to the dataLayer, so a tag can wait for it. Scripts that queue their work, like AdSense, Google Ad Manager or Tag Manager, work this way; scripts that rely on document.write do not. It shows only on the post's own page, never in listings or feeds, and stays out of Google snippets with the rest of the box. Optional label above it, Advertisement unless you write your own, and optional minimum and maximum heights. Only users who can publish unfiltered HTML can change the content: on a network, the super admin, not the administrator of each site, who sees it read-only. Developers can remove or change it per post with the `ayudawp_aiss_summary_custom_html` filter.
* Improved: Qwen now opens with the prompt already written, instead of copying it to the clipboard for you to paste. Checked platform by platform in October 2026: Gemini, DeepSeek and Copilot still offer no way to pre-fill the prompt from the address, so those three keep copying it.
* Improved: The block editor panel and the classic box now say when a post is too short for an automatic summary. Since 2.6.0 such a post shows no automatic summary on the site, but the editor kept showing the stored one, and you only found out when Regenerate failed. The notice also says that a summary you write by hand is shown.
* Fix: Button labels showed every word capitalized, such as Copiar Enlace or Fuente Preferida De Google, on the site and in the settings preview. They now show as written.
* Fix: On a laptop screen, Analytics put its two tables side by side in too little room, so post titles broke into several lines and column headers were cut off. They now sit side by side only when the content column has room for both, and the click columns take just the width they need.

= 2.6.0 =
* New: Google Preferred Source button. It takes readers to the Google tool where they mark your site as a preferred source, so your stories show up more for them in Top Stories, and Analytics counts the clicks per post, which Google does not tell you anywhere. It is a plain link with your domain in it, so nothing loads from Google until someone clicks. It is off until you tick it, and it can go with the social networks, in a section of its own at the end of the block with an optional title, or outside the block, where only a shortcode that names it shows it. It is not shown on a site that lives in a subfolder or asks search engines not to index it, because Google cannot list those, and the settings screen says so.
* New: The `ayudawp_aiss_content_anchors` filter prints the blocks placed before and after the content in theme actions instead of inside the content, for themes that rewrite the content after it is filtered and end up duplicating whatever plugins added to it. Settings keep deciding where the buttons and the summary go, the stylesheet still loads in the head, exclusions and the floating bar keep working, and each block is printed once per page. Without the filter nothing changes: the content comes out byte for byte as before.
* New: In Analytics, the click count of each button in the platforms table opens the posts it was clicked from, with the clicks of each, for the selected dates. For the Google Preferred Source button, that is the post readers were on when they chose to add your site, which Google does not report anywhere. The 20 posts with the most clicks are listed, and the CSV export has all of them.
* Improved: The copy of the summary settings kept inside the buttons settings since 2.3.0, when the summary got its own tab, is deleted on update, along with the code that carried it over on every save. It was only there to go back to 2.2.x without losing them, so from now on a rollback keeps the summary settings down to 2.3.0.
* Fix: Posts with very little text, such as a single image, a video or one line, got as their summary the AI answer saying there was nothing to summarize, and it was shown in the TL;DR box. A post now needs at least 50 words of text, not counting images, embeds, captions or tables, and on sites in Chinese, Japanese or another language that WordPress counts by characters, it is 50 characters. Below that no summary is generated, the visitor button does not appear and no request reaches the AI provider. Summaries already stored for those posts are no longer shown but stay in the database, so lowering the minimum with the `ayudawp_aiss_summary_min_words` filter brings them back. This also hides the good summaries some very short posts had. A summary written by hand is always shown.
* Fix: Analytics showed the Copy link and Native share buttons with their internal key, in grey, and the dashboard widget showed Meta AI, Copy link and Native share as Meta_ai, Copy_link and Web_share. Names, colours and types now come from the same list as the settings screen, so a new button can no longer be left out. A few names change to match that list: Claude AI, Mistral AI and Microsoft Copilot.
* Fix: When a theme module or a widget left another post loaded on a single post page, the position of the buttons could follow that other post type instead of the type of the post being read.
* Fix: With compact mode on phones set to a single Share button, a block with only one button hid it behind a Share toggle that opened nothing else. A block with a single button now ignores compact mode.

= 2.5.1 =
* Fix: The summary box was never actually kept out of Google snippets and AI Overviews, as the readme promised. Since 2.0.0 the `data-nosnippet` attribute sat on the `<aside>`, and Google only reads it on `div`, `span` and `section`. It now sits on a `div` that wraps everything inside the box, for both the summary and the Generate button. Classes, styles and the Schema.org microdata do not change. It takes effect the next time Google crawls each post, so if you use a page cache, clear it after updating so the new markup is the one being served.

= 2.5.0 =
* New: The settings screen is reorganised. Where the buttons appear was governed by three settings that had to agree with each other (the locations, the content types and the insertion position), two of them listing overlapping things, and nothing on screen said the condition was an AND, so ticking one of them and seeing no buttons was the usual first experience. They are now a single list with one row per destination and its own position, which also makes possible something that was not before: buttons after the content on posts and before it on pages. Your current setup is migrated to the new list, keeping what visitors were actually seeing rather than the literal settings. The rest of the screen is grouped under headings, with related settings side by side, so the two halves of the same decision are no longer twelve rows apart.
* New: The buttons you enable are shown as the real buttons, in the style you picked, and the preview repaints as you change the style, the icons or the corner shape. The AI Summary tab gets the same treatment: its thirteen settings are now four groups, and the block appearance is decided against a live sample instead of by saving and reloading.
* New: The floating bar can have its own destinations, so the inline block and the bar no longer have to appear in the same places: the block on posts and the bar on the blog home, or the other way round.
* New: Floating share bar. A new option pins the same enabled buttons, in icon form, to the left edge, the right edge or the bottom of the screen on single content. It can accompany the inline block or replace it entirely, it can use its own destinations so the two never have to coincide, it can be set to appear only while the reader scrolls down, and it can be told to stand aside on pages where the inline block is already showing. On phones it is hidden by default, and the side positions become a strip along the bottom when it is switched on, because a column pinned to the side of a small screen eats the reading area. Its CSS and JS are separate files, loaded only on pages where the bar is shown.
* New: Compact mode on phones. The buttons block can now show a single Share button that opens the rest, or a few buttons plus a More button, so a long list of platforms no longer fills the screen on mobile. The desktop layout is unchanged, and which buttons stay visible follows the order you set by dragging.
* New: Copy link button. A new platform that copies the post address to the clipboard, confirms it on screen and counts in the analytics like any other button.
* New: Native share button. Uses the browser share sheet, which reaches WhatsApp, Signal, Instagram, Messages, AirDrop and any other app installed on the device. It is only rendered where the browser supports it, so it never shows as a dead button.
* New: Optional UTM tagging. A checkbox adds utm_source (the platform), utm_medium (social, ai or share) and an optional campaign name to the shared link, so you can tell this traffic apart in your analytics.
* New: The summary now has a position per content type, like the buttons: next to them on posts and before the content on pages, which a single global position could not express. "Do not display" becomes one of those positions, so a type can still generate its summary for the shortcode or the REST API without printing it.
* Improved: The buttons you can enable are now shown in the settings as the buttons themselves, grouped into social networks, AI assistants and browser actions, each rendered with the style you picked. It replaces the row of bare icons, which said nothing about size, colour or shape.
* Improved: The default label of the summary block is now "TL;DR (AI Generated)". It says what the block is in the words readers already use, and it states plainly that a machine wrote it, which is what the EU AI Act expects of generated content shown to the public. A label you set yourself is untouched.
* Improved: Compact mode on phones is on by default for new installs, showing a single Share button that opens the rest. Updating sites keep whatever they had.
* Improved: Meta AI now opens with the prompt already written, instead of copying it to the clipboard for you to paste. Checked platform by platform in September 2026: Gemini, DeepSeek, Copilot and Qwen still offer no way to pre-fill the prompt from the address, so those four keep copying it.
* Improved: The settings screen uses the width it has. The form was capped well below what the browser offered while the promo cards ran along the bottom, where nobody scrolls; the content now sits in one column with the cards in a rail beside it that follows as you scroll, and folds underneath on narrower screens. Every field, description and heading shares one measure instead of two.
* Improved: Less weight on pages that have nothing to show. The stylesheet and the script were loaded on every singular view, archive and blog home whenever the buttons were not placed there, in case a shortcode turned up; a site with the buttons on posts was downloading 71 KB on its home page and on every archive to render nothing at all. They now load where something is actually placed, plus singular views whose content really does carry the shortcode. The list of platform names sent with the script is trimmed to the buttons you enabled.
* Improved: The front end no longer loads jQuery for the share buttons. The script was rewritten in plain JavaScript, so a block theme that does not use jQuery stops loading it (about 85 KB and one request) just to show the buttons. The same pass moved the hover effect and the mobile icon grid to the stylesheet, replaced a browser event removed from Chrome in 2024, reduced the tooltip to a single shared element instead of one per button, and sends click tracking with sendBeacon so it survives the page being replaced by the destination.
* Improved: Accessibility of the buttons block. Each group of buttons is now announced with the section title you wrote, or with a description when there is none, the keyboard focus ring no longer appears on mouse clicks, and the copy confirmation is announced by screen readers.
* Improved: Click tracking identifies the post directly from the buttons block, instead of relying on the theme marking the article in a particular way, so analytics are accurate on more themes.
* Improved: The summary, provider and content-hash post fields are sanitized on save. They are written by the plugin itself and the output was already escaped, so nothing changes on screen; it closes the gap on the way in as well.
* Fix: The Minimal and Outline styles of the summary block were indistinguishable, both drawing the same thin grey box. Minimal is now genuinely minimal, a rule above the block and nothing else, and Outline draws a real box in the accent colour with its heading to match.
* Fix: With a filled style (Brand, Dark or Custom colours), the "Generate AI summary" button that visitors see was painted as a full-width slab of colour with a small outlined button floating inside it. The colour now belongs to the button itself.
* Fix: The "fluid" button size behaved exactly like "normal" on phones. Both ended up as one full-width button per row, so choosing fluid changed nothing below 480 pixels; it now fills the row two buttons at a time, which is what it does on wider screens.
* Fix: The visitor generation limit could be bypassed on sites that trust a proxy header. Since 2.4.4 those headers are only read when the site opts in, but the address was taken from the start of the forwarding chain, which is the part the visitor writes. It now reads the end of the chain, and only when the request actually arrives from the proxy: an address declared with the new ayudawp_aiss_trusted_proxies filter, or the site own network when no list is declared.

= 2.4.4 =
* Fix: Security. The visitor-facing summary generation endpoint now only works on published, publicly readable posts. Until now it accepted any post ID, so a summary could be built and returned for a draft, a pending or private post, an item in the trash, or a password-protected post without its password. Updating is recommended if you have the frontend generation button enabled.
* Improved: Visitor-triggered summary generation is harder to abuse. The per-visitor limit is now based on the real connection address instead of forwarding headers a client can set, and a site-wide ceiling caps how many new summaries visitors can trigger per hour. Both matter because each new summary can be a paid call to your AI provider. Already generated summaries are still served from cache and are unaffected, so normal reading does not change. Sites behind a reverse proxy or CDN can declare which header to trust with the new ayudawp_aiss_trusted_proxy_header filter, and the hourly ceiling is adjustable with ayudawp_aiss_frontend_hourly_cap.

= 2.4.3 =
* Fix: Security. Post titles are now escaped for attribute position when the analytics dashboard renders the "most shared content" table, so a title containing quotes is shown as written instead of affecting the surrounding markup. As added hardening, click tracking records only published content, so titles from unpublished drafts stay out of the analytics data. Updating is recommended.

= 2.4.2 =
* Improved: Tested up to WordPress 7.1, with no changes needed. The editor sidebar panel already works inside the always-iframed post editor, and the settings screen was reviewed against the jQuery UI 1.14.2 update that ships with this release.

= 2.4.1 =
* Improved: A prompt, a custom text or any of the section titles you write yourself can now be translated from WPML String Translation or Polylang, through the multilingual configuration the plugin ships
* Fix: The AI prompt no longer gets stuck in the language of whoever saved the settings. It was written to the database on activation and again on the first save, so on a multilingual site every reader was asking the AI for a summary in that one language. It is resolved per reader again, and a stored copy of the bundled prompt is cleaned up on update. A prompt you wrote yourself is kept untouched, and an empty one still means send no instructions
* Fix: The editor sidebar panel was still titled "AI Share & Summarize", the name the plugin had before it was renamed

= 2.4.0 =
* New: Bullet-list format for the AI summary. A new "Summary format" checkbox in the AI Summary tab renders the summary as a concise bullet list instead of paragraphs: new AI summaries are generated as one key point per line, and already stored summaries are split into one item per sentence without regenerating. Works with the extractive fallback and every visual style.
* New: Separator lines setting. Two checkboxes under Share Buttons let you show or hide the thin horizontal lines above and below the buttons block, which until now could only be removed with custom CSS. Both stay on by default, keeping the previous look.
* Improved: The noindex exclusion now recognizes the Visibility SEO plugin (native-aeo-pack). Content marked noindex by Visibility — per post or through its bulk per-content-type rules with their per-post exceptions — hides the share buttons and the AI summary like with any other supported SEO plugin, and the settings screen reports it as detected.

= 2.3.0 =
* New: Dedicated "AI Summary" settings tab. The summary settings now live on their own screen with their own Save button, stored in their own option and saved independently from the share buttons settings. The former "Settings" tab is now called "Share Buttons", which is what it configures. Existing configuration is migrated automatically.
* New: Per-post "Hide AI summary on this content" control in the block editor sidebar and the classic meta box. Until now the single "Hide share buttons" checkbox silently hid the summary too; each feature now has its own independent control (posts excluded before this version keep both hidden).
* Improved: The summary content-type list is now truly independent from the share buttons. The silent fallback to the buttons' list is gone (the inherited value is migrated as-is), summaries can display on post types the buttons are not configured for, unchecking every type genuinely turns automatic summaries off, and the AI Summary tab shows a clear warning when that happens.

= 2.2.2 =
* Improved: Caches are refreshed right after an automatic summary is generated, so it shows up without waiting for a page cache to expire. New `ayudawp_aiss_summary_generated` action lets cache plugins purge the affected URLs.
* Fix: The automatic AI summary was not generated when a scheduled post went live (and could be missed on some interrupted publishes) on certain hosts. It is now generated reliably as soon as the post publishes, with self-healing on the first view and a daily rescue sweep as safety nets.
* Fix: In the classic editor, emptying the manual summary field left the content hash behind, so automatic generation never refilled it. The hash is now cleared too.

= 2.2.1 =
* Improved: the "Automatic" model setting now uses each provider's cheapest model (Haiku on Anthropic) instead of a mid-tier one, and keeps the rest of the provider's catalog as an ordered fallback chain, so summaries stay cheap and keep working when a model is unavailable.
* Fix: AI summaries could stop generating after the active provider changed its available models — a listed model that is not actually usable, or a corrupted cached model list on sites with a persistent object cache. Generation now degrades to the next model and refreshes the cached model list automatically instead of failing until the cache expires.
* Fix: corrected the summary "content types" help text, which claimed to be fully independent from the share buttons list while it actually falls back to that list when left empty.

= 2.2.0 =
* New: AI model selector for the summary. Pick the provider and model used for generation, or leave it on Automatic to use a fast, cost-effective model per provider instead of the newest, most expensive flagship.
* Improved: AI Summary generation is now a single, explicit mode selector (AI with extractive fallback / AI only / Extractive only / Disabled), replacing the two checkboxes. Extractive-only is now a real choice without removing your AI provider.
* Fix: summaries could fail when the configured provider's newest model was not available to your account (for example a limited-access flagship). Generation now defaults to a sensible model and no longer breaks in that case.
* Fix: prevented a possible fatal error during analytics cleanup on WordPress older than 6.1, so the minimum is now WordPress 6.1. The AI summary needs WordPress 7.0; on earlier versions you can still use the extractive summary.

= 2.1.1 =
* Improved: Background (cron) AI summary generation now retries transient provider errors — e.g. a malformed API response — up to 2 times with a short backoff before falling back to the extractive summarizer. Editor- and visitor-triggered generation still fails fast. The retry count is filterable via `ayudawp_aiss_ai_retry_attempts`, and the stored error now reports how many attempts were made.
* Improved: The "Settings > Connectors" link in the AI Summary settings section now opens in a new tab so you keep the plugin settings page open.
* Fix: Bare video/oEmbed URLs (YouTube, Vimeo, X...) placed on their own line or paragraph to embed a player no longer leak into the AI and extractive summaries. The content cleanup now mirrors WordPress core's autoembed detection and removes them before summarizing; linked URLs and URLs written inside a sentence are preserved. Note: already-stored summaries are not regenerated by the update — edit the post or use "Regenerate now" on affected posts.

= 2.1.0 =
* New: Summary block appearance — choose a style for the inline AI summary block and its Generate button (minimal, outline, brand, dark, or custom colors), set the background and text colors, and place the icon on the left, on the right, or hidden.
* New: Customizable summary text — set your own label for the summary block heading and for the visitor-facing "Generate AI summary" button (both translatable; leave empty to keep the defaults).
* Improved: The AI summary now renders each sentence on its own line for easier reading, for both the AI Client and the extractive providers.
* Improved: Summary accessibility — visible keyboard focus on the block toggle and the Generate button, and focus moves to the freshly generated summary so screen readers announce the new content.
* Fix: The summary in the "before content" position did not appear on sites whose theme, plugins or snippets rewrite `the_content` with `DOMDocument` (image optimizers, lazy-load, "nofollow" on image links, table-of-contents, etc.), which dropped the block when reserializing the content. The before-content summary is now injected after those filters and its critical CSS is printed in the page `<head>`, so the block survives; the share buttons keep their position.
* Fix: Hardening — the section/title tag is now built through an allowlist helper (closing the class of the 2.0.x XSS against future refactors), the activation-notice dismissal now also verifies the user capability, and a redundant `unserialize()` was removed from the SEO noindex detection.

= 2.0.4 =
* Fix: Contributor+ stored XSS through the `title_style` attribute of the `[ayudawp_share_buttons]` shortcode. The value was emitted in HTML tag-name position with only `esc_attr()`, which does not encode spaces or `=`, so a user with the `edit_posts` capability could inject arbitrary attributes and event handlers. `title_style` is now validated against an allowlist (`h2`-`h6`, `p`, `span`, `div`) at every entry point (admin save, shortcode attribute, render). Reported by Haitam Lazaar.

= 2.0.3 =
* Fix: Buttons not appearing on entries without a manual excerpt when the active theme or a third-party plugin calls `the_excerpt()` / `get_the_excerpt()` from the `<head>` to compose Open Graph, Twitter Card or similar meta descriptions. WordPress's `wp_trim_excerpt()` applies the `the_content` filter internally to auto-truncate posts without a manual excerpt — the 1.9.2+ id-match guard accepted that early invocation as legitimate, marked the post as processed and blocked the subsequent real call from the post template. The filter now early-returns and stays out of the processed-posts guard when running inside the excerpt pipeline.

= 2.0.2 =
* Fix: Buttons not appearing on entries other than the latest published post on themes/plugins that call `setup_postdata()` from a header/sidebar without a matching `wp_reset_postdata()`. The strict id-match guard added in 1.9.2 (for Divi Theme Builder, FSE and Bricks) now falls back to verifying that the filtered content belongs to the queried post when `get_the_ID()` and `get_queried_object_id()` disagree, so legitimate singular content still gets the buttons while widgets and footers running `the_content` on arbitrary text remain protected.

= 2.0.1 =
* Fix: Visitor-facing "Generate AI summary" click made the summary box look empty until the page was reloaded — the placeholder element was being replaced by the inline critical CSS `<style>` block instead of the actual `<aside>` summary. The replacement now targets the `<aside>` element explicitly.

= 2.0.0 =
* New: Inline AI summary feature — the plugin's namesake "Summarize" capability now generates a short summary of each post and shows it inline in a collapsible block alongside the share buttons
* New: Two-tier provider cascade — Level A uses the WordPress 7.0 AI Client (`wp_ai_client_prompt()`) with credentials managed centrally in Settings > Connectors (OpenAI, Anthropic, Google), so no API keys are configured in this plugin
* New: Level C PHP extractive fallback for sites on WP < 7.0 or without an AI Connector — picks the most representative sentences using token-frequency scoring with a Jaccard-similarity filter to avoid redundant sentences
* New: Dedicated "AI Summary" settings section with independent post-type selection, position, default collapsed state, sentence count (also used by the AI prompt), extractive fallback opt-out and per-feature controls
* New: Block editor sidebar panel to view the current summary, edit it manually (which locks it against auto-regeneration) and trigger a synchronous regeneration on demand
* New: Classic editor meta box equivalent — view, edit and force regeneration on next save, with admin notice showing the result or the underlying AI error
* New: Visitor-facing "Generate AI summary" button for posts without a stored summary, with admin setting to keep generation extractive-only (zero cost) or allow the AI Client (rate-limited to 1 generation per IP per minute)
* New: `[ayudawp_aiss_summary]` shortcode to render the summary outside the auto-insert flow (accepts a `post_id` attribute)
* New: REST endpoints `POST /aiss/v1/summary/regenerate` (capability `edit_post`) and `POST /aiss/v1/summary/generate` (public, rate-limited)
* New: Schema.org microdata on the summary block (`CreativeWork` + `abstract`) plus `data-nosnippet` so search engines understand it's a derived summary and don't compete it as a featured snippet against the original content
* New: Last AI Client error is persisted and surfaced in the settings page, so configuration issues are visible without enabling `WP_DEBUG`
* New: `aiss_summary` icon in `AyudaWP_AISS_Icons` for the collapsible block header
* New: Filter `ayudawp_aiss_extractive_stopwords` to extend the extractive summarizer with additional languages (ships with English and Spanish)
* New: Filter `ayudawp_aiss_extractive_weights` to tune lead bonus, title-word weight, minimum sentence length and similarity threshold of the extractive summarizer
* New: Async generation via WP-Cron (`wp_schedule_single_event`) so the editor save never blocks waiting for the AI provider; explicit user actions (sidebar "Regenerate now", classic-editor "Regenerate on next save") run synchronously for immediate feedback
* Improved: Frontend "Generate AI summary" button rewritten in vanilla JS (outside the jQuery ready cycle) so it survives aggressive defer/async optimizations from caching and performance plugins
* Improved: Critical inline CSS is now printed alongside the summary HTML so the collapsible block stays visually correct even when the main stylesheet is deferred with `rel="preload"`
* Improved: Shortcodes (`[gallery]`, `[caption]`, plugin-defined ones, etc.) are now stripped from post content before summarization so the resulting summary no longer includes raw shortcode markup
* Improved: Minimum WordPress version raised to 5.6 to use `wp_after_insert_post`, which fires after meta updates and avoids redundant regenerations

= 1.9.2 =
* Fixed: Share buttons not appearing with Divi Theme Builder (Divi 4 and Divi 5), FSE block templates and Bricks Builder — these render the post content through the `the_content` filter without a standard WP loop, so the previous `in_the_loop()` and `is_main_query()` guards blocked the auto-insertion. The singular-page path now relies on `is_singular()` plus a post-ID match between `get_the_ID()` and `get_queried_object_id()`, with a per-request "already processed" guard so the same post can never receive duplicate button blocks. Archives keep the original main-loop check

= 1.9.1 =
* Fixed: Empty space below the footer on themes that don't clip body overflow — universal tooltips were created at the end of `<body>` with no initial coordinates, extending the document scroll height by their static size

= 1.9.0 =
* Added: Optional "Dark mode adaptation" setting (Disabled by default / Auto). When set to Auto, a tiny script measures the real background luminance of the buttons container and only adapts colors when it is genuinely dark — so light pages stay untouched even if the visitor's OS prefers dark
* Added: Light border on X, Threads and Grok buttons over dark backgrounds so they stand out from the page (Auto mode)
* Added: Section and global titles now also display when using the "Icons only" button style
* Improved: Outline style shows X, Threads and Grok in white over dark backgrounds (instead of unreadable black) — Auto mode
* Improved: Minimal style text and titles use legible light colors on dark backgrounds — Auto mode
* Changed: Version history moved to a dedicated changelog.txt file served from the plugin's public SVN, keeping readme.txt focused on the current release

= 1.8.0 =
* Added: NoIndexer plugin integration for noindex content detection — uses the full priority resolution (individual meta, bulk rules, exclusions)
* Added: NoIndexer and Periscope plugins to the promotional banner rotation
* Improved: SEO integration settings now display all detected noindex providers

= 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