=== Sightkick ===
Contributors: fabiobergmann
Tags: seo, publishing, articles, ai search, content
Requires at least: 6.5
Tested up to: 7.1
Stable tag: 1.3.0
Requires PHP: 7.4
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Publishes articles written in Sightkick into this site: images in your media library, SEO meta in Yoast, Rank Math or AIOSEO, posts updated in place.

== Description ==

[Sightkick](https://sightkick.so) is a hosted SEO and AI-search service that researches, writes, scores and publishes articles for your site, then keeps them current. This plugin is the WordPress side of that connection.

**What the plugin does**

* Creates each article as a native block post – headings, lists, tables, quotes and images as real Gutenberg blocks you can edit.
* Publishes comparison, alternatives, integration and use-case pages in their own subfolders of your site (/vs/, /alternatives/, /integrations/, /use-cases/ by default), each a post type of its own with an archive page at its subfolder. You rename them and move them in Sightkick, and add destinations of your own beside the blog, such as Guides at /guides/, each with articles in its own subfolder. Block themes get a clean single-page template for them; classic themes use their usual single template.
* Downloads every image into **your** media library, sets the alt text and the featured image. No hot-linking.
* Writes the SEO title, meta description, focus keyphrase and social image into **Yoast SEO, Rank Math, All in One SEO, SEOPress or The SEO Framework** when one is active. Without an SEO plugin it renders the title, description, Open Graph tags and structured data itself.
* Updates a published article or page in place when Sightkick refreshes it – same post, same URL.
* Takes a page down when you retire it in Sightkick: it goes back to a draft, never deleted.
* Serves your IndexNow key file so search engines are told about new and updated URLs.
* Writes only to the posts and pages it created, with one exception you control: when your Sightkick settings allow it, it improves the SEO title and meta description of your other posts and pages, one change at a time, each one undoable from Sightkick. Nothing else on those pages changes: not the text, the post title, the address or any other setting.

**How it connects**

Install and activate the plugin, then open *Settings → Sightkick* and copy the token. In Sightkick, go to *Settings → Integrations → WordPress*, paste the token and your site address, pick a default author and category, and connect. The plugin never contacts sightkick.so on its own; Sightkick calls the plugin's authenticated REST endpoint (`/wp-json/sightkick/v1/`) when it publishes or updates an article.

**Service disclosure**

This plugin is a connector for the Sightkick service (https://sightkick.so), which requires an account. Sightkick sends article content (text, image URLs, metadata) to your site and reads back the list of posts it created. When your Sightkick settings allow it, it also reads the SEO title and meta description of a page by its address and sends a new title and description for it. Nothing else is transmitted. Terms of service: https://sightkick.so/terms · Privacy policy: https://sightkick.so/privacy

== Installation ==

1. Install and activate the plugin from the WordPress plugin directory.
2. Open *Settings → Sightkick* and copy the token.
3. In Sightkick, open *Settings → Integrations*, choose WordPress, paste the token and your site address, and connect.

== Frequently Asked Questions ==

= Does the plugin change my existing posts? =

Only their SEO title and meta description, and only when your Sightkick settings allow it. Sightkick changes one page at a time and keeps the old title and description first, so every change can be undone from Sightkick. If you edit a title or description yourself afterwards, Sightkick leaves your version as it is. The text, post title, address and every other field of your existing posts and pages are never touched. Everything else the plugin writes goes to the posts and pages it created (they carry a hidden Sightkick article id).

= Where do comparison and alternatives pages appear? =

At their own addresses: example.com/vs/rival/, example.com/alternatives/rival/, example.com/integrations/tool/ and example.com/use-cases/who/ by default. You change their names and folders in Sightkick under Settings → Publishing, and the plugin updates its addresses on the next publish. In WordPress they sit under Posts as Comparisons, Alternatives pages, Integrations and Use cases, or under the names you gave them.

= Can I publish to folders of my own? =

Yes. Add a destination in Sightkick under Settings → Publishing, such as Guides at /guides/ or Resources at /resources/library/. Its articles go to that folder, with an archive page there, and sit under Posts with its name. Blog posts stay where they are. A folder one of your own pages already lives at, or your blog's own, stays yours: Sightkick's pages there use plain addresses until you pick another folder. When you remove a destination in Sightkick, the plugin keeps it in WordPress for as long as it still holds pages, so their addresses keep working.

= Will it work with Yoast SEO / Rank Math / AIOSEO? =

Yes. The plugin detects the active SEO plugin and writes the SEO title, meta description, focus keyphrase and social image into its fields. Their own structured data stays in charge; Sightkick adds only FAQ and list schema on top.

= What if I use a page builder? =

Articles are created as standard block posts. If your builder's theme templates control single posts, they will render the post content as usual.

= Is the token a secret? =

Yes — anyone holding it can publish to your site. You can regenerate it under *Settings → Sightkick*, which disconnects Sightkick until you paste the new one.

= Does the plugin send data to Sightkick? =

No. All requests are inbound from the service, and the plugin only responds to them. Uninstalling removes the plugin's settings and leaves your posts and media in place. SEO titles and descriptions Sightkick changed in your SEO plugin stay as they are. Without an SEO plugin, the ones the Sightkick plugin printed itself go with it.

== Screenshots ==

1. Settings → Sightkick: the token and connection status.
2. An article published from Sightkick, as native blocks in the editor.

== Changelog ==

= 1.3.0 =
* Destinations: publish pages to your own folders beside the blog, and rename the page types' folders as you named them in Sightkick.
* Each destination you add in Sightkick (Guides at /guides/, say) gets its own place under Posts, its own folder with an archive page, and the same clean template on block themes. Blog posts stay where they are.
* Comparison, alternatives, integration and use-case pages carry the names you give them in Sightkick, in the admin menu and their screens.
* Two destinations never share a folder, and a folder your own page or your blog already lives at stays yours.
* A destination you remove in Sightkick stays in WordPress while it still holds pages, so they keep their addresses.
* Uninstalling also removes the list of destinations. Your pages stay.

= 1.2.0 =
* Sightkick can now improve the SEO title and meta description of posts and pages it didn't write, when your Sightkick settings allow it. It changes nothing else on those pages: not the text, the post title, the address or any other setting.
* One change at a time, written into your SEO plugin (Yoast SEO, Rank Math, All in One SEO, SEOPress or The SEO Framework). Without one, the plugin prints the new title and description itself, on the changed pages only, and skips the description when it sees one already printed in the page's head by your theme or another plugin.
* The old title and description are kept on your site before every change, and every change can be undone from Sightkick: the plugin puts back what it kept itself. If you edit a title or description yourself afterwards, even at the same moment, Sightkick leaves it as you set it.
* Password-protected posts and pages are never changed, and what Sightkick sets is always plain text, never one of your SEO plugin's variables.
* A comparison, alternatives, integration or use-case folder that one of your own pages already lives at (an Integrations page at /integrations/, say) stays your page's: Sightkick's pages of that kind use plain addresses until you pick another folder in Sightkick.
* Uninstalling leaves the SEO titles and descriptions in your SEO plugin as they are.

= 1.1.0 =
* Comparison, alternatives, integration and use-case pages: each a post type of its own, published in its own subfolder (/vs/, /alternatives/, /integrations/, /use-cases/ by default, set in Sightkick), with an archive page at the subfolder.
* Block themes (WordPress 6.7 and later) get a clean single-page template for these pages.
* Retiring an article or page in Sightkick takes it down whatever its type (back to a draft, never deleted).
* The settings page shows where each kind of page lives.

= 1.0.0 =
* First release: publish and update in place, media-library images, SEO meta for Yoast / Rank Math / AIOSEO / SEOPress / The SEO Framework, structured data, IndexNow key file.

== Upgrade Notice ==

= 1.3.0 =
Destinations: publish pages to your own folders beside the blog, and rename the page types' folders as you named them in Sightkick.

= 1.2.0 =
Lets Sightkick improve the SEO title and meta description of your other pages when your Sightkick settings allow it, each change undoable. Also brings the comparison and alternatives pages from 1.1.0.

= 1.1.0 =
Adds comparison, alternatives, integration and use-case pages in their own subfolders. Needed before Sightkick can publish them to this site.

= 1.0.0 =
First release.
