WC Sort by Stock
A simple woo commerce plugin to sort the product catalog by available stock
Install
No release zip yet. The repository archive installs, but the folder name will carry the branch suffix and updates will not flow:
wp plugin install https://github.com/arananet/wc_sort_by_stock/archive/refs/heads/main.zipWooCommerce plugin that orders the product catalog so in-stock products are shown first and out-of-stock products are pushed to the end of the list.
Quick start
# 1. Copy (or symlink) this plugin into your WordPress install
cp -r wc_sort_by_stock /path/to/wordpress/wp-content/plugins/wc-sort-by-stock
# 2. Activate it
wp plugin activate wc-sort-by-stock
# or: WP Admin → Plugins → activate "WC Sort by Stock"Requires WordPress, WooCommerce 4.0+, and PHP 7.4+.
How it works
The plugin hooks into woocommerce_product_query, which WooCommerce runs
for the shop page, product category/tag archives, and product
shortcodes/widgets. It adds a LEFT JOIN on the _stock_status product
meta and sorts by it (instock → onbackorder → outofstock) as the
primary sort, while preserving whatever ordering was already selected
(price, popularity, date, menu order, etc.) as the secondary sort.
Settings
Go to WooCommerce → Settings → Stock Sorting to enable or disable the feature. It is enabled by default.
Contributing
This project uses OpenSpec for spec-driven development — every
feature or bugfix has a spec file under .openspec/specs/.
scripts/openspec scaffold "<name>" [--type bugfix] # create a spec
scripts/openspec check # validate spec coverageIn Claude Code, use /openspec-scaffold, /openspec-implement, and
/openspec-check instead. See .openspec/onboarding.yaml to (re)run the
setup interview.
License
Author
Eduardo Arana