=== Content Publicity - Social Share Buttons, Click to Tweet & Super Suggest to Google News Sites === Contributors: Sitetrail Tags: share buttons, social share, click to tweet, whatsapp share, floating share bar Requires at least: 6.0 Tested up to: 7.0 Stable tag: 1.2.0 Requires PHP: 8.0 License: GPLv2 or later License URI: https://www.gnu.org/licenses/gpl-2.0.html Social share buttons + click-to-tweet quote blocks + floating share bar + WhatsApp, X, LinkedIn, Facebook, Pinterest, Bluesky & more — plus unique "Super Suggest" feature for Google News sites. == Description == **Turn your content into a visibility machine.** Content Publicity is a lightweight, privacy-friendly social sharing plugin that adds clean share buttons, a floating share bar, click-to-tweet pull-quote blocks, and an optional share counter to your WordPress posts — plus the unique "Super Suggest" feature that lets readers recommend your content to editors at Google News-approved publications. = Features = * **Social share buttons** — clean, modern in-content share button with multiple display styles * **Floating share bar** — optional vertical sticky bar on the left side of single posts * **Click-to-Share quote blocks** — Gutenberg block (and `[cp_quote]` shortcode) that turns a quotable sentence into one-click share moments for X, LinkedIn, WhatsApp, Facebook, Bluesky and more — the modern click-to-tweet experience for every network * **Wide network support** — LinkedIn, X (Twitter), Facebook, WhatsApp, Pinterest, Bluesky, Threads, Mastodon, Reddit, Telegram, Email, Copy Link * **Privacy-friendly share counter** — optional aggregate share counts stored in your own database, no cookies, no third-party trackers * **Super Suggest** — readers can recommend your article to editors at Newstrail.com, a Google News-approved publication, for potential editorial citation * **Embed code generator** — produces clean blockquote-style embed code with proper attribution and backlinks * **Post-type targeting and per-post exclusion** for fine-grained control * **WhatsApp share, Pinterest "Pin It", Bluesky, Threads and Mastodon sharing** for modern social audiences * **Copy link to clipboard** for the silent shares (DMs, messaging apps) that traditional share buttons miss * **Native Web Share-friendly markup** that plays nicely with mobile sharing * **Translation-ready** with full i18n support and a `content-publicity` text domain * **Lightweight** — no external dependencies, no external scripts, no jQuery for new code paths = The "Super Suggest" Feature = The unique Super Suggest button lets your engaged readers nominate your article to editors at **Google News-approved publications**. When a reader finds your content valuable, one click sends your article URL to editors at Newstrail.com for editorial review. If your content aligns with their coverage areas, they may cite it, feature it, or follow up — creating opportunities for high-authority backlinks and press mentions. = Click-to-Share Quote Blocks = Add the **Click-to-Share Quote** block in the Gutenberg editor, type or paste a quotable sentence, and pick which networks to expose. Each rendered quote becomes a one-click share moment for X, LinkedIn, WhatsApp, Facebook, Bluesky, Threads, Mastodon, Reddit, Telegram, Email, or Copy Link. This is the modernized click-to-tweet pattern — every quote, every network, one click. For Classic Editor users, the shortcode works too: `[cp_quote networks="twitter,linkedin,whatsapp"]Your quotable sentence here.[/cp_quote]` = Privacy & Compliance = Content Publicity is built for privacy from the ground up: * **No user tracking, no cookies, no IP collection** * **No external scripts or third-party trackers** * **No data sent to external servers** — every share link is a direct user-initiated link to the destination platform * **Share counter (when enabled) stores aggregate counts in your own WordPress database as post meta only** — no personal information, no IP addresses, no cookies are collected or stored * **Fully GDPR-compatible** out of the box * **Accessibility (WCAG)-friendly markup** with ARIA labels, keyboard navigation, and screen-reader support * **No remote loading of code, fonts, or icons** — all SVG brand glyphs ship inside the plugin = Compatibility = Content Publicity is tested with the latest WordPress release (7.0) and is fully compatible with PHP 8.0, 8.1, 8.2, 8.3, and 8.4. New code added in 1.2.0 uses modern, vanilla-PHP idioms throughout — no `eval()`, no `create_function()`, no deprecated APIs. The plugin works on every actively-supported PHP version and gracefully handles older WordPress installs down to the declared 6.0 minimum. = External Service Disclosure = The Super Suggest button is a standard `` link that the user clicks to open Newstrail.com (operated by Sitetrail). No data is automatically transmitted by the plugin — the user explicitly clicks the link to navigate to that site in a new tab. Newstrail's own privacy policy applies once the user lands there. Disabling the Super Suggest toggle removes the button entirely. = About Sitetrail = Content Publicity is developed by **Sitetrail**, a content marketing and news distribution company. We specialize in connecting quality content with major media outlets and helping businesses achieve meaningful press coverage through strategic digital marketing and online PR. **Our Mission:** Make professional-grade content marketing, media outreach, and news distribution accessible to businesses of all sizes. **Learn More:** Visit [Sitetrail.com](https://www.sitetrail.com/) to discover our complete suite of content marketing, digital PR, and news distribution services. **More from Sitetrail:** The plugin's settings page also links to [Sitetrail Newspass](https://www.sitetrail.com/newspass/) (premium news-distribution service), and two sister WordPress plugins from the same team — [AI Live Chat PRO](https://www.sitetrail.com/plugins/ai-live-chat-pro/) (AI chatbot for WordPress + WooCommerce) and [Woo Toolbox](https://www.sitetrail.com/plugins/woo-toolbox/) (WooCommerce utility suite). These links appear only on the plugin's own settings page and a single entry in the row meta on the Plugins admin screen — never on the WordPress dashboard, never as admin notices, never on the front-end. No tracking parameters are appended to any URL. --- *Transform your content marketing strategy today. Install Content Publicity and start building the media relationships, sharing opportunities, and systematic growth that drive real business results.* == Installation == 1. From your WordPress admin, go to **Plugins → Add New** 2. Search for **"Content Publicity"** and click **Install Now**, then **Activate** 3. Go to **Content Publicity** in the admin menu 4. Configure your social networks, enable the floating share bar if desired, and toggle the Super Suggest button 5. Optionally enable the share counter and front-end count display under "Share Counter & Social Proof" 6. To add a Click-to-Share quote block to any post, open the block editor and search for "Click-to-Share Quote" == Frequently Asked Questions == = Is this plugin GDPR compliant? = Yes. Content Publicity sets no cookies, makes no third-party HTTP requests, and does not collect or transmit any personal data. The optional share counter stores aggregate counts (an integer per post per network) in your own WordPress database only — no IP addresses, no user IDs, no referrers are stored. = Does it slow down my site? = No. The plugin uses no external scripts, no external CSS, and no remote fonts. New 1.2 code paths use vanilla JavaScript (no jQuery). All SVG icons are bundled inline. = How does Super Suggest work? = When a reader clicks the red heart Super Suggest button, their browser opens Newstrail.com in a new tab with your article URL passed as a parameter. Editors at Newstrail (a Google News-approved publication) review the suggestion and may cite, feature, or follow up on your article. The plugin itself never transmits anything — the action only happens when the user clicks the link. = Can I disable the Super Suggest feature? = Yes. Open the plugin settings and switch the "Enable Super Suggest Feature" toggle off. The button will be removed from both the share modal and the floating bar. = Where does the share counter store its data? = Exclusively in your WordPress database as `post_meta` entries (keys prefixed with `_cp_share_count_`). Nothing is sent anywhere else. When you delete the plugin, all share-count meta is removed automatically by the bundled uninstall handler. = Can I display the share count on the front end? = Yes, but it's off by default. Enable "Show counts on the front-end" in the Share Counter & Social Proof card. Counts only appear next to a button after that button has been clicked at least once. = What networks are supported? = LinkedIn, X (Twitter), Facebook, WhatsApp, Pinterest, Bluesky, Threads, Mastodon, Reddit, Telegram, Email, and Copy Link. Each network can be independently enabled or disabled in the settings. = How does Mastodon sharing work? = Mastodon URLs are instance-specific. When a reader clicks the Mastodon share button, the plugin prompts them for their instance domain (e.g. `mastodon.social`), then opens the share-compose page on that instance. The plugin remembers their last instance in their browser's `localStorage` so they don't have to type it again. = How does Copy Link work? = It uses the browser's `navigator.clipboard` API (with a `document.execCommand('copy')` fallback for older browsers). A brief "Copied!" affordance confirms success. No data is sent anywhere — the copy stays on the user's clipboard. = How can I add a click-to-tweet style quote block? = In the Gutenberg block editor, click the "+" to add a block, search for "Click-to-Share Quote", and add it. Type your quote in the block and pick the networks you want from the sidebar. For Classic Editor, use the `[cp_quote]` shortcode shown in the description above. = What about Mastodon brand assets, Bluesky logos, etc.? = All brand-glyph SVG icons bundled with the plugin are derived from Simple Icons (https://simpleicons.org/), which is CC0-licensed (public-domain equivalent and GPL-compatible). See `LICENSE-ICONS.txt` in the plugin root for full attribution. Brand names and logos are used nominatively to identify share destinations only; no endorsement or affiliation is claimed. = Will share buttons appear on my custom post types? = You can choose exactly which post types display the share features under General Settings → Enable on Post Types. = Can I use both the in-content button and the floating bar together? = Yes. They're independent toggles. Many sites enable both — the in-content button catches end-of-article shares, the floating bar provides persistent access while reading. = Does it work with page builders (Elementor, Divi, Beaver, Bricks)? = Yes, in two ways: * The in-content share button hooks into `the_content` filter, which most page builders honor for post body content * The `[cp_quote]` shortcode works inside any builder that supports shortcodes * The Gutenberg block works wherever the block editor is available = Can I exclude specific posts? = Yes — paste a comma-separated list of post IDs in the "Exclude by Post/Page IDs" field. == Screenshots == 1. The in-content share button with the share/embed modal open, showing the red heart Super Suggest button, the expanded network list, and the embed code section. 2. The floating share bar on the left edge of a single post, with the Super Suggest red heart and brand-glyph SVG icons for every enabled network. 3. The Click-to-Share quote block in the Gutenberg editor — type your quotable line, pick the networks, done. 4. The Click-to-Share quote block rendered on the front-end with circular share buttons. 5. The modern admin settings interface with iOS-style toggles, the new Share Counter & Social Proof card, and the Click-to-Share Quote Blocks card. 6. The "Privacy promise" card in the settings, clearly stating that no data leaves the site. 7. The expanded social-networks grid showing every supported share destination including WhatsApp, Bluesky, Threads, Mastodon, Pinterest, and Copy Link. 8. Mobile responsive view of the share modal with stacked, full-width buttons. == Changelog == = 1.2.0 - 2026-06-03 = **MAJOR FEATURE RELEASE — Click-to-Share Quote Blocks, Network Expansion, Share Counter** **New features:** * **Click-to-Share Quote Blocks:** Gutenberg block and `[cp_quote]` shortcode that turn a quotable sentence into one-click share moments — the modernized click-to-tweet pattern for every supported network. * **Network expansion:** Added WhatsApp, Pinterest, Bluesky, Threads, Mastodon, Reddit, Telegram, and Copy Link share destinations alongside the existing LinkedIn, X, Facebook, and Email. * **Privacy-friendly share counter:** Optional aggregate share counts stored in your own database as post meta. No cookies, no IP collection, no third-party services. Off by default for front-end display; on by default for storage so you start collecting from day one if you ever want to display later. * **Mastodon instance prompt:** Smart per-device prompt that remembers the user's chosen instance via `localStorage` so they only type it once. * **Copy Link button:** First-class share destination using the modern Clipboard API with `execCommand` fallback for older browsers — captures the silent shares (DMs, messaging apps) that traditional share buttons miss. **Compatibility:** * **Tested up to WordPress 7.0** and verified on PHP 8.0, 8.1, 8.2, 8.3, and 8.4. * **Minimum requirements bumped** to WordPress 6.0 and PHP 8.0 — both are reasonable modern floors that match what the WordPress core team itself recommends. The plugin's existing code already worked on these versions; this is a declaration update, not a behavior change. **Settings page additions:** * New **"Discover more from Sitetrail"** section on the plugin's own settings page. The existing Sitetrail Newspass card remains the featured pitch (it's the paid extension of the Super Suggest feature) and is joined by two sister WordPress plugins from the same team: **AI Live Chat PRO** (AI chatbot for WordPress + WooCommerce) and **Woo Toolbox** (WooCommerce utility suite). No tracking parameters in any URL. * New **"More plugins by Sitetrail"** link in the row meta on the Plugins admin screen — a single, discreet entry pointing to the Sitetrail plugin hub, using the standard `plugin_row_meta` filter. **Technical improvements:** * New `CP_Social_Networks` registry centralizes share-URL builders and self-hosted inline SVG icons for every brand glyph. * New REST endpoint `content-publicity/v1/share` (POST, with WP REST nonce CSRF protection, strict server-side validation of post ID + network slug allow-list) for share-count increments. * New `CP_Share_Counter` and `CP_Quote_Block` classes with full PHPDoc. * New `uninstall.php` cleans up both the option row and every share-count post-meta key on plugin deletion (multisite-aware). * New `phpcs.xml` ruleset for WordPress Coding Standards verification on every release. * All new JavaScript is vanilla (no jQuery dependency). * Settings auto-migrate on upgrade — new toggles get their default values automatically without losing your existing configuration. * All brand SVG icons are CC0-licensed from Simple Icons; see `LICENSE-ICONS.txt`. **Privacy & compliance:** * Strengthened the no-tracking promise: explicit disclosure in the readme that share counts are stored exclusively in your own database with no external transmission. * No cookies set by any 1.2.0 feature. * `localStorage` used only for two purposes: per-device dedup of share-count increments and remembering a reader's Mastodon instance — both client-side only. * All cross-promotional links are contained to the plugin's own settings page and the standard `plugin_row_meta` slot — no admin notices, no dashboard widgets, no tracking parameters. = 1.1.1 - 2025-06-09 = * Design & UX improvements — red heart (❤️) for accessibility contrast, iOS-style admin toggles, white/silver floating bar redesign, improved messaging. = 1.1.0 - 2025-06-09 = * Added Super Suggest feature, floating share bar, and the modernized admin interface. = 1.0.4 - 2025-05-16 = * WordPress.org compliance refactor, improved escaping, i18n fixes, compatibility through WP 6.8. = 1.0.3 - 2025-05-07 = * Default black & white button theme for stronger contrast. = 1.0.2 - 2025-05-07 = * Switched to Dashicons for consistent icon styling. = 1.0.1 - 2025-05-07 = * Added Email share with mailto support. = 1.0.0 - 2025-05-07 = * Initial release — share button, embed code generator, admin settings. == Upgrade Notice == = 1.2.0 = Major feature update: Click-to-Share quote blocks (Gutenberg + shortcode), WhatsApp / Pinterest / Bluesky / Threads / Mastodon / Reddit / Telegram / Copy Link share destinations, an optional privacy-friendly share counter (stored locally, no third-party trackers), tested with WordPress 7.0 and PHP 8.4. Minimum requirements bumped to WP 6.0 / PHP 8.0. All existing settings are preserved on upgrade. = 1.1.1 = UX update: red heart for better accessibility contrast, iOS-style admin toggles. = 1.1.0 = Major update introducing the Super Suggest feature and floating share bar.