Cache results and optionally enable background AI re-ranking through the WordPress AI Client.<\/li>\n<\/ul>\n\nAI is optional and disabled by default. Category and tag matching works without an AI provider or API key.<\/p>\n\n
Backwards compatibility:\n- Existing installations retain the legacy shortcodes [smart_related_posts]<\/code> and [kreativ_related_articles]<\/code> when those names are not already registered by another plugin.\n- Sites previously using direct OpenAI must configure a WordPress AI provider and explicitly re-enable AI re-ranking. Older WordPress versions continue to display taxonomy-based recommendations.<\/p>\n\nSource Code<\/h3>\n\n
All plugin source files, including the block editor JavaScript and CSS, are included in the plugin. No build step is required. The maintained source is available at https:\/\/github.com\/aolaru\/kreativ-smart-related-posts.<\/p>\n\n
External Services<\/h3>\n\n
When you enable AI re-ranking, source post titles and excerpts and candidate IDs, titles and excerpts are sent through the WordPress AI Client to the provider configured for your site. Consult that provider's privacy policy and terms before enabling it. This requires WordPress 7.0 or later, a configured text-generation provider, and caching. Requests run in a scheduled background task for published posts. No external AI request is made by default.<\/p>\n\n\n
\n- In your WordPress dashboard, go to Plugins > Add New Plugin<\/strong> and search for Kreativ Smart Related Posts<\/strong>.<\/li>\n
- Install and activate the plugin. Alternatively, upload its ZIP through Plugins > Add New Plugin > Upload Plugin<\/strong>.<\/li>\n
- Open Settings > Kreativ Smart Related Posts<\/strong> to choose a layout, number of posts, and display options.<\/li>\n
- Automatic insertion is enabled by default for single posts. To place recommendations manually instead, turn it off in the settings and add the Kreativ Smart Related Posts<\/strong> block or
[kreasmre_related_posts]<\/code> shortcode to a post.<\/li>\n- To customize recommendations for an individual post, use its manual include and exclude controls in the post editor.<\/li>\n<\/ol>\n\n
Optional AI re-ranking requires WordPress 7.0 or later, a configured WordPress AI Client text-generation provider, and caching. Review your provider's privacy policy before enabling it.<\/p>\n\n\n
\nDoes this plugin require AI?<\/h3><\/dt>\nNo. Core related-post matching works without AI. Optional AI re-ranking requires WordPress 7.0 or later and a configured text-generation provider for the WordPress AI Client.<\/p><\/dd>\n
What data is sent to the configured AI provider?<\/h3><\/dt>\nOnly when AI re-ranking is enabled and a provider is configured, the plugin sends:\n- Source post title and excerpt\n- Candidate post IDs, titles, and excerpts<\/p><\/dd>\n
Does the plugin cache results?<\/h3><\/dt>\nYes. Related post results are cached with WordPress transients to reduce repeated database lookups and API calls. Cache duration is configurable, and caches are cleared when posts or category\/tag assignments change.<\/p><\/dd>\n
Does AI ranking slow down page loads?<\/h3><\/dt>\nVisitors receive taxonomy-based recommendations immediately. When enabled, AI ranking refreshes in the background through WP-Cron, and later visits use the cached AI results. Caching must be enabled for background AI ranking; with caching disabled, only taxonomy-based results are used. Sites with WP-Cron disabled need a server cron job to process scheduled WordPress events.<\/p><\/dd>\n
What happens when a post has no related category or tag matches?<\/h3><\/dt>\nYou can choose to show nothing, latest posts, or posts from the same author.<\/p><\/dd>\n
Does the plugin create custom database tables?<\/h3><\/dt>\nNo.<\/p><\/dd>\n\n<\/dl>\n\n\n
1.2.3<\/h4>\n\n\n- Removed the direct OpenAI integration. AI re-ranking now uses the WordPress AI Client only.<\/li>\n
- Existing direct OpenAI users must configure a WordPress AI provider and explicitly re-enable AI re-ranking.<\/li>\n<\/ul>\n\n
1.2.2<\/h4>\n\n\n- Added distinctive prefixes and backwards-compatible migration of existing settings and overrides.<\/li>\n
- Added optional WordPress AI Client integration on WordPress 7.0 and later.<\/li>\n
- Provided readable block editor CSS and documented the public source repository.<\/li>\n
- Corrected the WordPress.org contributor username.<\/li>\n<\/ul>\n\n
1.2.1<\/h4>\n\n\n- Restricted post search to published posts and protected saved unpublished selections with per-post permission checks.<\/li>\n
- Fixed cache invalidation for persistent object caches and rechecked publication status on cache hits.<\/li>\n
- Shared block attribute defaults between PHP and JavaScript using block.json.<\/li>\n
- Added block API v3 support for current editors, with v2 compatibility for older WordPress versions.<\/li>\n
- Moved AI ranking to WP-Cron with a worker lock, retry cooldown, and stale-job protection.<\/li>\n
- Prevented duplicate auto-insertion alongside a shortcode or block and excluded secondary content loops.<\/li>\n
- Ranked all taxonomy matches by relevance before applying the candidate limit.<\/li>\n
- Limited block and shortcode output to 12 posts and cleaned up background tasks on deactivation.<\/li>\n
- Improved output escaping and translator guidance for submission checks.<\/li>\n<\/ul>\n\n
1.2.0<\/h4>\n\n\n- Added searchable manual include\/exclude post picker in the post editor.<\/li>\n
- Added display controls for accent color, thumbnails, image ratio, grid columns, and card border radius.<\/li>\n
- Added fallback modes for posts with no category\/tag matches.<\/li>\n
- Added display options for link target, date, category, and heading tag.<\/li>\n
- Improved block editor preview to show styled grid\/list\/minimal previews.<\/li>\n
- Extended shortcode and block attributes for the new display options.<\/li>\n<\/ul>\n\n
1.1.0<\/h4>\n\n\n- Rebranded to Kreativ Smart Related Posts for broad public use.<\/li>\n
- Added strict option sanitization.<\/li>\n
- Added external services disclosure in settings\/readme.<\/li>\n
- Added dynamic block namespace update.<\/li>\n
- Added uninstall cleanup for options and transients.<\/li>\n
- Added readable block editor script file instead of inline compressed block code.<\/li>\n
- Added cache invalidation when posts or terms change.<\/li>\n
- Improved AI re-ranking fallback to preserve the requested number of posts.<\/li>\n
- Added translation bootstrap for PHP and block editor strings.<\/li>\n
- Added backward-compatible shortcode alias.<\/li>\n<\/ul>\n\n
1.0.0<\/h4>\n\n\n- Initial release.<\/li>\n<\/ul>","raw_excerpt":"Help readers discover more with related posts based on shared categories and tags.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/397222","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=397222"}],"author":[{"embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/anolaru"}],"wp:attachment":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=397222"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=397222"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=397222"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=397222"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=397222"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=397222"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}