PishTop Content Suggestion with AI

Changelog

1.6.7

• Remove all Gutenberg block registration and code references.

1.6.6

• Remove custom style tag allowance in templates sanitization to prevent reviewer rejection.

1.6.5

• Add an on-demand “Update Models” button next to the Embedding Model and LLM Re-ranking Model dropdown selects to clear local transients and fetch the fresh list from OpenRouter.

1.6.4

• Update the default registered settings prompt template defined in the plugin options initialization block inside the admin class.

1.6.3

• Update the “Reset to Default” prompt template inside the javascript settings dashboard to match the new default instructions template.

1.6.2

• Skip clearing and purging the transient recommendation cache when the only setting modified is the enable_cache toggle.

1.6.1

• Fix active recommendations count parsing in admin settings controller to support version-prefixed transient keys, resolving false zero indicator readings.

1.6.0

• Fix background ranking worker transient version prefix check and key resolution, resolving worker execution block.
• Enforce that LLM re-ranking (both via cron ranking worker and frontend matching cache misses) is executed only after database vector embedding indexing reaches 100% completion, falling back to local vector similarity matching during the indexing phase.
• Allow real-time frontend matching on cache misses to suggest posts immediately from the subset of already-indexed candidates.

1.5.0

• Implement cache transient key versioning (pishtop_rec_v{version}_) to guarantee cache invalidation on external object caches (like Redis or Memcached).
• Resolve query crashes on MySQL strict ONLY_FULL_GROUP_BY SQL mode.
• Update taxonomy queries to use tt_ids (term taxonomy IDs) for strict relationship matching.
• Remove third-party Google Fonts imports and styling to comply with GDPR privacy guidelines and WordPress.org directory policies.
• Bypass nonce check on the public suggestions AJAX endpoint to prevent page-cached guest visitor requests from breaking.
• Add key character filters on Template ID settings input fields to prevent template mismatch errors.
• Update default LLM re-ranking prompt templates with priority criteria, security rules, and JSON output contracts.

1.4.0

• Add LLM Shortfall Behavior option to let users choose between filling empty slots with similarity results or hiding them.
• Reorganize settings screen layout: rename OpenRouter Integration section to General, move Enable Caching before Cache Expiry (TTL), move Default Thumbnail Size after Final Output Sorting, and configure settings-dependent toggling fields.
• Auto-clear transient recommendations caches when saving settings to immediately show updated recommendations to visitors.
• Clear outdated embedding vector cache instantly on post updates.
• Improve log descriptiveness by adding context such as post ID, embedding model, API codes, and reasons.

1.3.1

• Remove Custom CSS styling from display templates and backend dashboard to comply with WordPress.org security policies regarding arbitrary code/styling insertion.
• Remove the shortcode alias [ai_related_posts] completely to enforce proper prefixing standards and simplify usage.
• Add dedicated External Services section to readme documenting integration, data transfer details, terms, and privacy policy links for OpenRouter.ai API services.

1.2.0

• Introduce Embedding-Only matching phase to completely bypass the OpenRouter LLM re-ranking step, saving on API costs and server overhead.
• Implement a configurable Similarity Threshold (0-100%) setting to filter out low-relevance candidate recommendations.
• Update settings in-app documentation and help tabs to cover the new features.

1.1.0

• Bypass database embedding storage and retrieval for WooCommerce dynamic pages (Cart, Checkout, and Thank You) to prevent different users from receiving mixed-up cart recommendations.

1.0.9

• Wrap all key AJAX endpoints, shortcode rendering, and background cron callbacks in defensive try-catch blocks to prevent HTTP 500 server errors.

1.0.8

• Guard WooCommerce cart access to prevent PHP fatal errors when WooCommerce cart is uninitialized.
• Resolve query crash by checking if taxonomy terms is WP_Error.
• Filter LLM-ranked IDs against candidates to drop prose numbers.
• Query configured post types in sorting logic to support hidden types.
• Prepare transient timeout LIKE query placeholder in database.

1.0.7

• Fix cron reschedule loop during direct hits to wp-cron.php (prevents worker execution blocking).
• Prevent PHP type errors on post saving hook when post is null.
• Add weekly custom cron interval schedule registration.
• Optimize database queries in ranking worker by checking active transients timeout option first.
• Guard against SQL syntax errors in cron queries when allowed post types is empty.
• Clear background indexing cron single events on deactivation and uninstall.

1.0.6

• Add template fields validation: enforces non-empty Wrapper HTML and Item HTML, and verifies Wrapper HTML contains {{items}} prior to submission.
• Add conditional metadata placeholders: supports single or fallback placeholders like {{meta:custom_key | {{title}} }} evaluating recursively from outside-in.

1.0.5

• Remove Native Category/Tag matching from default fallback options.
• Update Recent posts fallback to target the template’s Target Post Type Filter.

1.0.4

• Move background ranking fallback checks to the cache miss stage to ensure pre-cached suggestions are correctly served from transients when background worker is active.
• Implement robust multi-stage fallback queries: if the category matching fallback returns fewer posts than requested, the plugin automatically fills up the remaining spots using recent posts of the same post type.

1.0.3

• Bypass transient cache lookups entirely during active background indexing or ranking runs to always serve fresh native fallback posts.

1.0.2

• Enforce native fallback rendering during active background indexing or ranking runs.

1.0.1

• Expand in-app Help and Documentation tab with comprehensive user guidelines.
• Add shortcut Settings link on Plugins list screen.
• Support {{id}} template layout placeholder.

1.0.0

• Initial release. Expose all parameters, timeouts, logging rates, delays, and customization options to the administrator dashboard.