{"id":328568,"date":"2026-06-19T11:58:16","date_gmt":"2026-06-19T11:58:16","guid":{"rendered":"https:\/\/wordpress.org\/plugins\/telens-search-by-image-for-woocommerce\/"},"modified":"2026-06-19T12:00:02","modified_gmt":"2026-06-19T12:00:02","slug":"searchips-search-by-image-for-woocommerce","status":"publish","type":"plugin","link":"https:\/\/wordpress.org\/plugins\/searchips-search-by-image-for-woocommerce\/","author":7819527,"comment_status":"closed","ping_status":"closed","template":"","meta":{"version":"1.1.5","stable_tag":"1.1.5","tested":"7.0","requires":"5.6","requires_php":"7.4","requires_plugins":null,"header_name":"Searchips Search By Image for WooCommerce","header_author":"micromax","header_description":"Enable customers to search WooCommerce products using images powered by AI.","assets_banners_color":"ceae90","last_updated":"2026-06-19 12:00:02","external_support_url":"","external_repository_url":"","donate_link":"","header_plugin_uri":"","header_author_uri":"","rating":0,"author_block_rating":0,"active_installs":0,"downloads":30,"num_ratings":0,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":{"1.1.5":{"tag":"1.1.5","author":"micromax2","date":"2026-06-19 12:00:02"}},"upgrade_notice":[],"ratings":[],"assets_icons":{"icon-256x256.png":{"filename":"icon-256x256.png","revision":3578597,"resolution":"256x256","location":"assets","locale":"","width":256,"height":256}},"assets_banners":{"banner-1544x500.png":{"filename":"banner-1544x500.png","revision":3578597,"resolution":"1544x500","location":"assets","locale":"","width":1544,"height":500},"banner-772x250.png":{"filename":"banner-772x250.png","revision":3578597,"resolution":"772x250","location":"assets","locale":"","width":772,"height":250}},"assets_blueprints":{},"all_blocks":[],"tagged_versions":["1.1.5"],"block_files":[],"assets_screenshots":{"screenshot-1.jpg":{"filename":"screenshot-1.jpg","revision":3578597,"resolution":"1","location":"assets","locale":"","width":1466,"height":812},"screenshot-2.jpg":{"filename":"screenshot-2.jpg","revision":3578597,"resolution":"2","location":"assets","locale":"","width":1445,"height":821},"screenshot-3.jpg":{"filename":"screenshot-3.jpg","revision":3578597,"resolution":"3","location":"assets","locale":"","width":1027,"height":805},"screenshot-4.jpg":{"filename":"screenshot-4.jpg","revision":3578597,"resolution":"4","location":"assets","locale":"","width":607,"height":423},"screenshot-5.jpg":{"filename":"screenshot-5.jpg","revision":3578597,"resolution":"5","location":"assets","locale":"","width":617,"height":647}},"screenshots":[]},"plugin_section":[],"plugin_tags":[31038,944,267891,229649,286],"plugin_category":[45],"plugin_contributors":[255790],"plugin_business_model":[],"class_list":["post-328568","plugin","type-plugin","status-publish","hentry","plugin_tags-image-search","plugin_tags-search","plugin_tags-search-by-image","plugin_tags-vector-search","plugin_tags-woocommerce","plugin_category-ecommerce","plugin_contributors-micromax2","plugin_committers-micromax2"],"banners":{"banner":"https:\/\/ps.w.org\/searchips-search-by-image-for-woocommerce\/assets\/banner-772x250.png?rev=3578597","banner_2x":"https:\/\/ps.w.org\/searchips-search-by-image-for-woocommerce\/assets\/banner-1544x500.png?rev=3578597","banner_rtl":false,"banner_2x_rtl":false},"icons":{"svg":false,"icon":"https:\/\/ps.w.org\/searchips-search-by-image-for-woocommerce\/assets\/icon-256x256.png?rev=3578597","icon_2x":"https:\/\/ps.w.org\/searchips-search-by-image-for-woocommerce\/assets\/icon-256x256.png?rev=3578597","generated":false},"screenshots":[{"src":"https:\/\/ps.w.org\/searchips-search-by-image-for-woocommerce\/assets\/screenshot-1.jpg?rev=3578597","caption":""},{"src":"https:\/\/ps.w.org\/searchips-search-by-image-for-woocommerce\/assets\/screenshot-2.jpg?rev=3578597","caption":""},{"src":"https:\/\/ps.w.org\/searchips-search-by-image-for-woocommerce\/assets\/screenshot-3.jpg?rev=3578597","caption":""},{"src":"https:\/\/ps.w.org\/searchips-search-by-image-for-woocommerce\/assets\/screenshot-4.jpg?rev=3578597","caption":""},{"src":"https:\/\/ps.w.org\/searchips-search-by-image-for-woocommerce\/assets\/screenshot-5.jpg?rev=3578597","caption":""}],"raw_content":"<!--section=description-->\n<p>Searchips Search By Image for WooCommerce is a visual search tool that allows customers to search for visually similar products by uploading or taking photos directly on your shop pages.<\/p>\n\n<p>The plugin offers two search strategies:\n1. Multimodal Vector Embeddings: Matches visual features using advanced machine learning models via OpenRouter.\n2. Vision-to-Text Description Search: Analyzes images to generate descriptive keyword search queries using a vision language model.<\/p>\n\n<h3>External Services<\/h3>\n\n<p>This plugin connects to the OpenRouter API to perform image-based searches and catalog indexing using artificial intelligence models.<\/p>\n\n<ul>\n<li>What the service is and what it is used for: OpenRouter (https:\/\/openrouter.ai) is an external API service used to generate vector embeddings (for visual similarity search) or image descriptions (for vision-to-text search) from product and query images.<\/li>\n<li>What data is sent and when: Base64-encoded image data and request parameters are sent to OpenRouter's servers when a store administrator manually runs the product indexer or when products are updated (if auto-indexing is triggered), and when a customer uploads or captures an image to perform a visual search on the frontend.<\/li>\n<li>Terms of service and privacy policy: This service is provided by OpenRouter. You can read their Terms of Service at https:\/\/openrouter.ai\/terms and their Privacy Policy at https:\/\/openrouter.ai\/privacy.<\/li>\n<\/ul>\n\n<h3>Features<\/h3>\n\n<ul>\n<li><strong>Search Strategies<\/strong>: Toggle between Vector Embeddings (visual similarity) and Vision-to-Text (semantic descriptions) searches.<\/li>\n<li><strong>Camera Search Trigger<\/strong>: Automatically enqueued inside theme search forms or loaded via shortcode <code>[tsbifw_search_bar]<\/code>.<\/li>\n<li><strong>Sleek Frontend UI<\/strong>: Drag-and-drop modal uploader featuring real-time scanning animations.<\/li>\n<li><strong>Client-Side Image Cropping<\/strong>: Let users crop images before searching.<\/li>\n<li><strong>Asynchronous Indexing<\/strong>: Real-time batch processing indexer with Pause\/Stop controls.<\/li>\n<li><strong>Custom Thresholds<\/strong>: Configure similarity percentage requirements to control search strictness.<\/li>\n<li><strong>Log Viewer<\/strong>: View database logs for API requests, settings changes, and queries.<\/li>\n<li><strong>Database Logging &amp; Retention<\/strong>: Automated cleanups of diagnostic logs.<\/li>\n<li><strong>Automatic Re-indexing<\/strong>: Triggers background re-indexing when featured or gallery images change.<\/li>\n<\/ul>\n\n<h3>How-To and Setup<\/h3>\n\n<h4>1. Setting Up the API Connection<\/h4>\n\n<p>Go to WooCommerce -&gt; Search by Image. Paste your OpenRouter API Key in the field. You can use the visibility toggle to confirm the key is input correctly without trailing spaces.<\/p>\n\n<h4>2. Running the Product Indexer<\/h4>\n\n<p>Navigate to the \"Product Indexer\" tab. Choose whether to index featured images, gallery images, or both. Click \"Start Indexing\". You can pause or stop the process at any time.<\/p>\n\n<h4>3. Adding the Search Bar via Shortcode<\/h4>\n\n<p>Insert the shortcode <code>[tsbifw_search_bar]<\/code> in any post, page, or widget template to display the camera trigger search bar.<\/p>\n\n<h4>4. Customizing Trigger Styles<\/h4>\n\n<p>Use the \"Styling\" settings tab to configure position properties, size, and background colors using the WordPress color picker UI.<\/p>\n\n<h3>Help and Support<\/h3>\n\n<ul>\n<li><strong>API Authentication Issues<\/strong>: Ensure your API key is correct and active on OpenRouter.<\/li>\n<li><strong>Skipped Products<\/strong>: Products with missing or zero-byte image files are skipped to avoid database error loops.<\/li>\n<li><strong>Cron Indexing<\/strong>: Enable background cron indexing to process product updates automatically in the background.<\/li>\n<\/ul>\n\n<!--section=installation-->\n<ol>\n<li>Upload the plugin files to the <code>\/wp-content\/plugins\/searchips-search-by-image-for-woocommerce<\/code> directory, or install the plugin through the WordPress plugins screen.<\/li>\n<li>Activate the plugin through the 'Plugins' screen in WordPress.<\/li>\n<li>Configure your settings under WooCommerce -&gt; Search by Image.<\/li>\n<li>Run the Product Indexer to process product images.<\/li>\n<\/ol>\n\n<!--section=faq-->\n<dl>\n<dt id=\"do%20i%20need%20an%20openrouter%20account%3F\"><h3>Do I need an OpenRouter account?<\/h3><\/dt>\n<dd><p>Yes, a valid OpenRouter API key is required to connect to embedding and description models.<\/p><\/dd>\n<dt id=\"which%20search%20strategy%20should%20i%20choose%3F\"><h3>Which search strategy should I choose?<\/h3><\/dt>\n<dd><ul>\n<li>Multimodal Vector Embeddings (Strategy 1) offers advanced visual feature matching by measuring the similarity of the product image vectors directly.<\/li>\n<li>Vision-to-Text Description Search (Strategy 2) converts uploaded images to keyword descriptions and searches your store database using regular text search.<\/li>\n<\/ul><\/dd>\n<dt id=\"are%20empty%20or%20zero-byte%20images%20processed%3F\"><h3>Are empty or zero-byte images processed?<\/h3><\/dt>\n<dd><p>No, the indexer automatically skips empty or missing image files to prevent API error cycles.<\/p><\/dd>\n<dt id=\"how%20do%20i%20trigger%20indexing%20automatically%3F\"><h3>How do I trigger indexing automatically?<\/h3><\/dt>\n<dd><p>Ensure that \"Background Cron Indexing\" is enabled in your General Settings, or simply update a product's featured\/gallery image to automatically queue it for re-indexing.<\/p><\/dd>\n\n<\/dl>\n\n<!--section=changelog-->\n<h4>1.1.5<\/h4>\n\n<ul>\n<li>Fixed frontend REST API \"Forbidden: invalid security token\" authorization issue for logged-in users.<\/li>\n<\/ul>\n\n<h4>1.1.4<\/h4>\n\n<ul>\n<li>Adjusted crop selection area to cover exactly 90% of the loaded image instead of 90% of the canvas.<\/li>\n<\/ul>\n\n<h4>1.1.3<\/h4>\n\n<ul>\n<li>Upgraded Cropper.js library to the latest stable v2.1.1 Web Component release.<\/li>\n<li>Added detailed privacy and terms of service documentation for OpenRouter.<\/li>\n<li>Fixed settings page sanitization callback for logging and indexing checkboxes.<\/li>\n<li>Implemented strict permission_callback checks for the frontend search REST endpoint.<\/li>\n<\/ul>\n\n<h4>1.1.2<\/h4>\n\n<ul>\n<li>Hardened input settings sanitization using custom CSS layout, color, and size callbacks.<\/li>\n<li>Authenticated the REST API sandbox search route using nonces and capability checks.<\/li>\n<li>Removed obsolete\/unused frontend variables and dead callback functions to unbloat code.<\/li>\n<li>Enhanced query performance using WordPress object caching memory wrappers.<\/li>\n<li>Hardened uninstall database cleanup by ensuring all option keys and transients are deleted.<\/li>\n<\/ul>\n\n<h4>1.1.1<\/h4>\n\n<ul>\n<li>Added a search cache expiry setting to database transients.<\/li>\n<li>Added frontend similarity percentage badges on default archive pages.<\/li>\n<li>Enhanced the frontend search popup uploader with modern UI effects.<\/li>\n<\/ul>\n\n<h4>1.1.0<\/h4>\n\n<ul>\n<li>Suppressed standard SQL keyword clauses when image search tokens are active to prevent search conflicts.<\/li>\n<\/ul>\n\n<h4>1.0.9<\/h4>\n\n<ul>\n<li>Configured visual search results to load using theme default archive page layouts.<\/li>\n<\/ul>\n\n<h4>1.0.8<\/h4>\n\n<ul>\n<li>Added API key show\/hide password toggle to prevent key corruption.<\/li>\n<\/ul>\n\n<h4>1.0.7<\/h4>\n\n<ul>\n<li>Added styling option to configure the camera search trigger icon size.<\/li>\n<\/ul>\n\n<h4>1.0.6<\/h4>\n\n<ul>\n<li>Separated styling and general options to resolve validation errors.<\/li>\n<\/ul>\n\n<h4>1.0.5<\/h4>\n\n<ul>\n<li>Implemented standard WordPress wp-color-picker component.<\/li>\n<\/ul>\n\n<h4>1.0.0<\/h4>\n\n<ul>\n<li>Initial release.<\/li>\n<\/ul>","raw_excerpt":"Enable customers to search WooCommerce products using images powered by AI.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/328568","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=328568"}],"author":[{"embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/micromax2"}],"wp:attachment":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=328568"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=328568"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=328568"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=328568"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=328568"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=328568"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}