=== Similo: AI Related Posts ===
Contributors: reyplot
Tags: related posts, AI, semantic, embeddings, law, legal
Requires at least: 6.0
Tested up to: 7.0
Requires PHP: 8.0
Stable tag: 0.1.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

AI-powered related posts for content-heavy WordPress blogs. Connects articles by meaning, not just tags.

== Description ==

Similo uses AI embeddings to find and display semantically related posts — articles that are actually about the same topic, even if they don't share tags or categories.

Built for professional blogs with hundreds of posts: law firms, consultancies, academic publishers, and anyone whose readers deserve better content discovery.

**How it works**

* When a post is published, Similo generates an AI embedding of its content
* When a reader views a post, Similo compares embeddings to find the most similar articles
* The most relevant posts are displayed as "Further Reading" at the bottom of each article

**Why it's different**

Most related post plugins match by tags or categories. Similo understands meaning — so a post about GDPR enforcement and a post about data privacy fines will be connected, even if they were never tagged the same way.

**Requirements**

* No API key needed — embeddings are handled via Similo's external service.

== Installation ==

1. Upload the plugin folder to `/wp-content/plugins/`
2. Activate the plugin through the Plugins menu in WordPress
3. Go to **Tools → Similo** and click **Generate All Embeddings** to index your existing posts.
4. Further Reading will automatically appear at the bottom of each post.

== Frequently Asked Questions ==

= Which AI model does Similo use? =
Similo uses OpenAI's `text-embedding-3-small` — a fast, affordable embedding model.

= Does it slow down my site? =
No. Embeddings are generated once when a post is saved, not on every page load.

= What similarity threshold does Similo use? =
Posts with a cosine similarity score above 0.7 are shown. This keeps results relevant and avoids noise.

= How many related posts are shown? =
Up to 5 by default.

= I just installed the plugin but no related posts appear. =
Go to **Tools → Similo** and click **Generate All Embeddings** to index your existing posts.

== Changelog ==

= 0.1.0 =
* Initial release

== Upgrade Notice ==

= 0.1.0 =
Initial release.

== External Services ==

This plugin sends post content to an external server to generate AI embeddings for related post detection.

**What data is sent:** Post title and content (text only)
**When:** When a post is published or updated
**Service:** lecto-server.fly.dev

- [Terms of Service](https://lecto-server.fly.dev/terms)
- [Privacy Policy](https://lecto-server.fly.dev/privacy)