{"id":29167691,"url":"https://github.com/rayrutjes/wc-order-search-admin","last_synced_at":"2025-07-01T09:39:53.510Z","repository":{"id":21159534,"uuid":"81648748","full_name":"rayrutjes/wc-order-search-admin","owner":"rayrutjes","description":"💵 Search for WooCommerce orders in the admin at the speed of thought with Algolia.","archived":false,"fork":false,"pushed_at":"2022-12-06T18:16:47.000Z","size":2308,"stargazers_count":19,"open_issues_count":19,"forks_count":6,"subscribers_count":3,"default_branch":"master","last_synced_at":"2024-04-15T07:39:22.296Z","etag":null,"topics":["autocomplete","instant-search","instantsearch","orders","search","woocommerce","woocommerce-plugin","wordpress","wordpress-plugin"],"latest_commit_sha":null,"homepage":"https://wordpress.org/plugins/wc-order-search-admin/","language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/rayrutjes.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2017-02-11T11:30:10.000Z","updated_at":"2024-02-07T15:06:26.000Z","dependencies_parsed_at":"2022-09-12T05:22:09.919Z","dependency_job_id":null,"html_url":"https://github.com/rayrutjes/wc-order-search-admin","commit_stats":null,"previous_names":[],"tags_count":28,"template":false,"template_full_name":null,"purl":"pkg:github/rayrutjes/wc-order-search-admin","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rayrutjes%2Fwc-order-search-admin","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rayrutjes%2Fwc-order-search-admin/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rayrutjes%2Fwc-order-search-admin/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rayrutjes%2Fwc-order-search-admin/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/rayrutjes","download_url":"https://codeload.github.com/rayrutjes/wc-order-search-admin/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rayrutjes%2Fwc-order-search-admin/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":262938197,"owners_count":23387755,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["autocomplete","instant-search","instantsearch","orders","search","woocommerce","woocommerce-plugin","wordpress","wordpress-plugin"],"created_at":"2025-07-01T09:39:47.742Z","updated_at":"2025-07-01T09:39:53.488Z","avatar_url":"https://github.com/rayrutjes.png","language":"PHP","funding_links":[],"categories":[],"sub_categories":[],"readme":"# WooCommerce Order Search Admin #\n**Contributors:** [rayrutjes](https://profiles.wordpress.org/rayrutjes)  \n**Tags:** search, orders, woocommerce, algolia, admin, autocomplete, orders search, search as you type, instant search, ajax search, ajax  \n**Requires at least:** 4.6  \n**Tested up to:** 5.5  \n**Requires PHP:** 5.3  \n**Stable tag:** 1.13.2  \n**License:** GPLv2 or later  \n**License URI:** http://www.gnu.org/licenses/gpl-2.0.html  \n\nSearch for WooCommerce orders in the admin at the speed of thought with Algolia.\n\n## Description ##\n\nThis plugin will power the WooCommerce orders search input with an autocompleted search field providing results as you type in milliseconds regardless of how much orders you have in your database.\n\nWhen you start having lots of orders in WooCommerce, searching for a specific order can become very slow and time-consuming.\n\nFun fact is also that the more you have orders, the more you will need to search for a specific one.\n\nWe have seen users wait for over a minute for WooCommerce to return the search results in the admin.\nAnd even after that long waiting time, given that the default search mechanism uses SQL queries, the relevancy isn't optimal and you often need to adjust your search query and wait again.\n\nBy installing this plugin, you will be able to index all your orders into Algolia and be able to find orders at the speed of thought, right from your usual orders list in the admin screen of your WordPress website.\n\nYou can find orders by typing just a few characters.\nThe search engine will search on the following fields:\n\n* Order Number (Has been tested with plugins like [WooCommerce Sequential Order Numbers](https://wordpress.org/plugins/woocommerce-sequential-order-numbers/) )\n* Customer First Name\n* Customer Last Name\n* Customer email address\n* Billing First Name\n* Billing Last Name\n* Billing email address\n* Billing Phone number\n* Billing Company\n* Billing Address 1\n* Billing Address 2\n* Billing City\n* Billing State\n* Billing Postcode\n* Billing Country\n* Shipping First Name\n* Shipping Last Name\n* Shipping Company\n* Shipping Address 1\n* Shipping Address 2\n* Shipping City\n* Shipping State\n* Shipping Postcode\n* Shipping Country\n* Product SKU contained in the order\n* Status of the order\n\nAs you start typing in the search input, you will see instant results popping up inside of a dropdown menu and you will\nbe able to find the proper order in milliseconds.\n\nAlso note that by leveraging Algolia as a search engine, in addition to super fast results as you type, you will\nalso benefit from all the other features like typo tolerance that will make sure that if you misspell for example the customer name, you will still get the relevant orders displayed as part of the results.\n\n### Automatic synchronization ###\n\nAfter you correctly provided the plugin with your Algolia credentials, the plugin will take care of making sure\nthe search index stays up to date with your WooCommerce orders.\n\nEvery time an order is added, updated, trashed or deleted, it will synchronize with Algolia.\n\n**Note, however, that when you first initialize the plugin, you need to index your existing orders.**\n\n### WP-CLI command ###\n\nThe plugin also offers a [WP-CLI](http://wp-cli.org/) command to allow you to reindex your orders directly from the\nterminal.\n\nHere is how to use it:\n\n`wp orders reindex`\n\nPlease note that at no point you are forced to use the command line tool and that the admin settings screen\nof the plugin also allows you to reindex all your orders.\n\nThe command line approach is an excellent technical alternative though if you have over 50 thousands of records and you want to speed up the indexing.\n\nNote that there is no limit to how many orders this plugin can handle, and indexing will work with both indexing methods;\npowered by the UI or by using the WP-CLI command line tool.\n\nThe only limitation of the admin UI reindexing is that you have to leave the page open during the reindexing\nprocess.\n\n### Backend Order Search ###\n\nBy default, the plugin enhances the default backend search behavior by using Algolia.\nThis ensures a consistency between results you see in the list and the ones coming from the autocomplete dropdown.\nIf for whatever reason you want to restore the default backend search behavior, you can use the `wc_osa_enable_backend_search` filter hook.\n\n\n\tfunction should_enable_backend_search( $value, WP_Query $query ) {\n\t    return false;\n\t}\n\t\n\tadd_filter( 'wc_osa_enable_backend_search', 'should_enable_backend_search', 10, 2 );\n\n\n### Configuration constants ###\n\nBy default, you can configure the plugin on the included options page, but you can also configure the plugin by using one (or more) of the following constants in your `wp-config.php`.\nWhen you use constants, the corresponding option fields will be disabled on the options page.\n\n\n\tdefine( 'WC_OSA_ALGOLIA_APPLICATION_ID', '\u003cvalue\u003e' );\n\tdefine( 'WC_OSA_ALGOLIA_SEARCH_API_KEY', '\u003cvalue\u003e' );\n\tdefine( 'WC_OSA_ALGOLIA_ADMIN_API_KEY', '\u003cvalue\u003e' );\n\tdefine( 'WC_OSA_ORDERS_INDEX_NAME', 'wc_orders' );\n\tdefine( 'WC_OSA_ORDERS_PER_BATCH', 200 );\n\n\n### About Algolia ###\n\nThis plugin relies on the Algolia service which requires you to [create an account](https://www.algolia.com/getstarted/pass?redirect=true).\nAlgolia offers its Search as a Service provider on an incremental payment program, including a free plan which includes 10,000 records \u0026 100,000 operations per month.\nBeyond that, make sure you [check out the pricing](https://www.algolia.com/pricing).\n\nThis plugin will create precisely one record per order to index. We index every order that is not flagged as trashed.\n\nAlgolia does not support this plugin.\n\nThe preferred way of submitting issues or feature requests is through the [GitHub repository](https://github.com/rayrutjes/wc-order-search-admin/issues).\n\n## Installation ##\n\nThe plugin works with WooCommerce 2.x \u0026 3.x\n\n1. Upload the plugin files to the `/wp-content/plugins/plugin-name` directory,\nor install the plugin through the WordPress plugins screen directly.\n1. Activate the plugin through the 'Plugins' screen in WordPress\n1. Hit the \"Setup\" button that will  appear at the top of every page of your admin,\nor directly access the plugin settings page under the `Settings` tab\n1. Provide the plugin with your Algolia settings, and\n[create an Algolia account](https://www.algolia.com/getstarted/pass?redirect=true) if you haven't got one yet\n1. Now click on the `re-index orders` button to start indexing your existing orders.\nWARNING: don't leave the page until the progress reaches 100%\n1. Once indexing has finished, head to `WooCommerce -\u003e Orders` and enjoy the orders appearing as you type when using the search input.\n\n## Screenshots ##\n\n### 1. The slick autocomplete search results dropdown. ###\n![The slick autocomplete search results dropdown.](https://ps.w.org/wc-order-search-admin/assets/screenshot-1.png)\n\n### 2. Setup instructions steps. ###\n![Setup instructions steps.](https://ps.w.org/wc-order-search-admin/assets/screenshot-2.png)\n\n### 3. Algolia account settings. ###\n![Algolia account settings.](https://ps.w.org/wc-order-search-admin/assets/screenshot-3.png)\n\n### 4. Indexing settings. ###\n![Indexing settings.](https://ps.w.org/wc-order-search-admin/assets/screenshot-4.png)\n\n\n## Upgrade Notice ##\n\n### 1.12.1 ###\nMake all billing and shipping fields searchable. In order to make the billing and shipping addresses searchable you need to reindex your data from `Settings -\u003e WooCommerce Order Search Admin -\u003e Re-index orders`.\n\n## Changelog ##\n\n### 1.13.1 ###\nSee: [CHANGELOG](https://github.com/rayrutjes/wc-order-search-admin/blob/master/CHANGELOG.md)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frayrutjes%2Fwc-order-search-admin","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frayrutjes%2Fwc-order-search-admin","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frayrutjes%2Fwc-order-search-admin/lists"}