Findborg for WordPress

=== Findborg for WordPress === Contributors: findborg Tags: findborg, share, hive, social, gutenberg Requires at least: 6.3 Tested up to: 6.8 Stable tag: 0.1.0 Requires PHP: 8.0 License: GPL-2.0-or-later License URI: https://www.gnu.org/licenses/gpl-2.0.html

Connect your WordPress site to the Findborg Find Engine — share any post to the Hive social feed with one click.

== Description ==

Findborg for WordPress is the official plugin for connecting your WordPress site to Findborg — a Find Engine built on truth.

= Share to Hive =

Place the Share to Hive block (Gutenberg) or the [findborg_share] shortcode (Classic Editor, page builders) anywhere on your site. Readers who are logged into Findborg can share the page to the Hive social feed with one click — growing the Findborg index and sending traffic back to your site.

Features:

• Gutenberg block — drag-and-drop from the block inserter.
• Classic Editor / page builder shortcode: [findborg_share]
• Customisable button label.
• Optional post excerpt pre-filled in the share dialog.
• Thumbnail image attached to the Hive post when available.
• Zero tracking on your site — no cookies, no analytics scripts added.
• Lightweight: one CSS file, one JS file, only loaded on pages with the block.

= Getting started =

1. Install and activate the plugin.
2. Go to Settings → Findborg and paste your free API key.
3. Add the Share to Hive block to any post or page.

A free API key is required. Get one instantly at findborg.com/api-key — no payment information needed.

= External Services =

This plugin makes outbound HTTPS requests to https://www.findborg.com/apis/ in two cases:

1. When a reader clicks Share — the share payload (page URL, title, optional excerpt, optional thumbnail URL, and the reader's message) is sent to the Findborg Hive ingestion endpoint (/apis/buddypress/post-activity.php). This call is authenticated with the site owner's API key (sent in a server-side HTTP header; the key is never exposed to the browser). No data is transmitted unless the reader actively clicks Share.

2. Key validation — the plugin format-checks the stored API key locally; it does not make a separate validation request on every page load.

By installing and activating this plugin you agree to the Findborg Terms of Service and Privacy Policy.

== Installation ==

1. Upload the plugin folder to /wp-content/plugins/, or install via Plugins → Add New Plugin and search for "Findborg".
2. Activate the plugin through the Plugins menu.
3. Go to Settings → Findborg and enter your free API key (get one at findborg.com/api-key).
4. Edit any post or page and insert the Share to Hive block from the block inserter, or add [findborg_share] in Classic Editor / a shortcode widget.
5. Publish. The Share button will appear on the frontend for logged-in Findborg users.

== Frequently Asked Questions ==

= Do I need a Findborg account? =

Yes. A free Findborg account and API key are required for the site owner to activate the plugin. Readers who click Share must also be logged into Findborg to post to the Hive.

= Is this plugin free? =

Yes. The plugin is free and open source (GPL-2.0-or-later). A free Findborg API key covers typical sharing volume for most sites.

= Does it work with the Classic Editor? =

Yes. Use the [findborg_share] shortcode anywhere the Classic Editor accepts shortcodes — post content, text widgets, page builders that support shortcodes, etc.

= Can I customise the button label? =

Yes. In the block editor use the Inspector Controls panel ("Button Options") to change the label. In the shortcode use the label attribute: [findborg_share label="Share this article"].

= Does it slow down my site? =

No. The CSS and JS assets are registered but only enqueued on pages that actually contain the block or shortcode. No assets are loaded site-wide.

= What data is sent to Findborg? =

Only when a reader clicks Share: the page URL, page title, the reader's optional message, and the featured image URL (if one exists). No visitor personal data is collected or stored by this plugin.

= Is the API key stored securely? =

The API key is stored in wp_options (standard WordPress settings storage). It is transmitted from the server to Findborg over TLS and is never sent to the browser. Always use HTTPS for your WordPress site.

== Screenshots ==

1. Settings page — enter your free API key to activate the plugin.
2. Share to Hive block — as it appears in the Gutenberg editor.
3. Share modal — what readers see when they click the Share button.

== Changelog ==

= 0.1.0 =

• First release — Share to Hive Gutenberg block and [findborg_share] shortcode.
• Admin settings page for API key configuration.
• Server-side API key validation and per-key rate limiting.

== Upgrade Notice ==

= 0.1.0 = Initial release. Install, add your free API key, and start sharing to the Hive.