Filter WC Orders adds a filter dropdown to the WooCommerce orders screen in the WordPress administration area. Store administrators and shop managers can use it to find orders by payment gateway or customer type without changing the existing order workflow.
- WordPress 6.5 or later
- WooCommerce
- PHP 7.4 or later
- WooCommerce orders managed through either the standard order screen or High-Performance Order Storage (HPOS)
From the plugin directory, install the PHP development dependencies and the npm development dependencies:
composer install
npm installThe Composer dependencies provide PHP_CodeSniffer, WordPress Coding Standards, WooCommerce Coding Standards, and PHP compatibility checks. The npm dependencies provide ESLint, Stylelint, Prettier integrations, and the packaging helpers used by this project.
The package also includes these equivalent npm scripts:
npm run composer_install
npm run npm_installnpm run npm_install removes package-lock.json before installing packages and is intended for refreshing the repository's npm dependency state. Use npm install when you want to preserve the existing lockfile.
PHP files are checked with the rules in phpcs.xml. The configured rules include WordPress Core, WordPress Extra, WordPress Docs, WooCommerce, PHPCompatibility, internationalization, security, naming, and file-format checks.
Run the configured PHP_CodeSniffer command with:
npm run phpcsThe script writes an XML report to phpcs-results/. It expects the repository's shared Composer installation to be available through the VAR environment variable and $VAR/.config/composer/vendor/. For example, when that shared installation is in /home/developer:
VAR=/home/developer npm run phpcsTo automatically apply fixes supported by PHP_CodeSniffer, run:
VAR=/home/developer npm run phpcbfThere are no project-specific JavaScript or CSS source files at present, but the repository retains ESLint and Stylelint configuration for future assets. The JavaScript rules extend eslint-config-wordpress, and the CSS rules extend stylelint-config-wordpress with ordered properties.
After installing dependencies and ensuring the WordPress CLI (wp) is available, create a distributable archive with:
npm run zipThis command regenerates languages/filter-wc-orders.pot, copies the plugin files into a temporary filter-wc-orders directory, creates filter-wc-orders.zip, and removes the temporary directory. The archive includes the admin code, translations, index.php, readme.txt, and the main plugin file.
filter-wc-orders/
|- admin/
| `- class-dkfwco-admin.php # Admin dropdown and order-query filters
|- languages/
| `- filter-wc-orders.pot # Translation template
|- filter-wc-orders.php # Plugin bootstrap and shared constants
|- index.php # Prevents directory listing access
|- readme.txt # WordPress.org plugin readme
|- README.md # Project and developer documentation
|- composer.json # PHP development dependencies
|- package.json # npm scripts and frontend tooling
`- phpcs.xml # PHP coding-standard rules
The main plugin file loads the text domain, defines plugin constants, and initializes the admin class after WordPress loads. The admin class:
- Adds the filter dropdown to the traditional WooCommerce order list and the HPOS order list.
- Populates payment-method choices from the payment gateways registered by WooCommerce.
- Adds a query condition for payment methods or customer types when a filter is selected.
- Uses the legacy post query for traditional orders and WooCommerce order-list query arguments when HPOS is enabled.
The plugin does not create a settings page or store additional plugin options. Filtering is performed using the existing WooCommerce order data.
The plugin lists the payment gateways installed on the site in the By Payment Method group. Select a gateway to display orders that were processed through that payment method.
The available payment methods are generated from the gateways currently registered by WooCommerce, so the list reflects the payment configuration of each site.
The By User Types group provides filters for:
- Guest Users - orders placed without a registered customer account
- Logged in Users - orders associated with a registered customer account
The order filter is available on the WooCommerce orders screen and supports sites using the traditional order data store or HPOS. The plugin adds its filter alongside the existing WooCommerce administration controls.
- Upload the
filter-wc-ordersdirectory to/wp-content/plugins/, or install the plugin through the WordPress admin plugin installer. - In WordPress, open Plugins and activate Filter WC Orders.
- Open WooCommerce > Orders in the WordPress admin dashboard.
- Open the Filter WC Orders dropdown, choose a payment method or customer type, and apply the filter.
- Select No filter to return to the complete order list.
After activation, the new dropdown appears on the WooCommerce orders administration screen. Choose one of the available options and apply the standard WordPress or WooCommerce list filter. The selected option remains active while viewing the filtered results.
Payment gateway options use the payment method names configured by WooCommerce. If a gateway is installed or removed, the available options are updated automatically.
Administrators and shop managers can filter orders by any payment gateway installed on the site, or by customer type: guest users and logged-in users.
Go to WooCommerce > Orders in the WordPress admin dashboard. The filter is displayed with the other order-list controls.
No. The plugin works directly on the WooCommerce orders screen and does not require a separate settings page.
Yes. Filter WC Orders includes support for WooCommerce's High-Performance Order Storage order list as well as the traditional order screen.
-
Filter Location - The Filter WC Orders dropdown on the WooCommerce orders screen.
screenshot-1.png
- Updated the coding structure according to PHPCS 3.8.0.
- Updated the coding structure according to PHPCS 3.8.0.
- Tested up to WordPress 6.3.
- Tested up to WordPress 6.0.
- Initial release of the plugin.
Filter WC Orders is licensed under the GPLv3 or later. See the GNU General Public License for details.