Set Products Per Page for WooCommerce

Free 0.1.2 and Pro 0.1.2 documentation.

Set Products Per Page chooses how many products WooCommerce shows before native pagination on the standard shop and product taxonomy archives. Free stores one global number from 4 to 96. Pro adds up to twenty-five category-specific values. It does not add a visitor dropdown, cookies, a show-all mode, a replacement paginator, or a catalog query builder.

Requirements

Choose the Free product count

1. Install and activate WooCommerce.
2. Install the supplied Free 0.1.2 ZIP. After WordPress.org approves the listing, the same Free plugin can be installed from the directory.
3. Open WooCommerce > Products Per Page.
4. Turn on the setting and choose a number from 4 to 96.
5. Save, then open the native shop page while signed out.

Verify the result

1. Count the products shown before pagination on the native shop page.
2. Open one product category and confirm the same global count.
3. Confirm page links and result totals still come from WooCommerce.
4. Turn the plugin off and confirm the theme or WooCommerce native count returns.
5. Confirm admin product lists, feeds, REST, blocks, shortcodes, and builder grids are unchanged.

What Free changes

Free stores one local option, sfk_ppp_settings, with an enabled state and an integer from 4 to 96. It returns that integer through WooCommerce's native loop_shop_per_page filter only for verified front-end shop and product taxonomy archives.

For admin, REST, feeds, unsupported requests, malformed settings, values outside the boundary, or missing WooCommerce, Free returns the incoming native value exactly.

What Pro adds

Pro lets a store owner choose at most twenty-five product categories and assign each a number from 4 to 96. Every other archive keeps the valid global Free number.

The interface uses a category chooser, a plain number field, and editable saved rules. It does not ask for term IDs or expressions such as 12=36. If Pro or licensing is unavailable, the global Free number continues locally.

Start the 14-day Pro trial

1. Open the Set Products Per Page product page.
2. Select Start 14-day trial. No card is required to begin.
3. Stripe returns to StoreFixKit after checkout, and a signed webhook creates a product-bound license.
4. Copy the license key and download the Pro 0.1.2 ZIP.
5. Keep Free active, upload and activate Pro, then activate its license.
6. Add a payment method before day 14 only if you want the $39/year subscription to continue. Without one, Stripe cancels it at trial end.

Compatibility boundary

This release changes only the bounded value WooCommerce requests for standard front-end shop and product taxonomy archives. It does not replace the query, count results, rewrite pagination HTML, or store a visitor preference.

Blocks, page builders, custom shortcodes, widgets, feeds, REST requests, admin tables, and custom product queries may use their own count. They stay native by design.

StoreFixKit does not provide a customer dropdown, show-all option, column setting, infinite scroll, AJAX loader, pagination template, builder adapter, or general query editor.

Privacy, security, and resource use

• Settings writes require manage_woocommerce and WordPress's settings nonce.
• Every saved count is bounded from 4 to 96.
• Pro accepts at most twenty-five category rules.
• Each request reads at most two owned options and returns one integer.
• Products, categories, queries, templates, carts, orders, customers, and cookies are never written.
• The storefront performs no StoreFixKit or third-party HTTP request and stores no personal data.
• There is no custom table, cron, Action Scheduler job, queue, telemetry, JavaScript, or stylesheet.

Troubleshooting

The shop count did not change

Confirm the setting is enabled and the saved value is between 4 and 96. Test the native shop page while signed out and clear full-page cache.

A block or page-builder grid kept another count

That is the supported boundary. The plugin changes WooCommerce's standard archive count only and does not rewrite custom queries.

Pagination looks unchanged

Pagination markup is intentionally native. The number of pages should change only when the number of products before pagination changes.

One category uses a different number

Check the Pro category choices. A saved category-specific value overrides the global Free count on that category archive only.

Pro choices do not apply

Confirm Free and Pro 0.1.2 are active, the license belongs to this product, and the category rule is saved. Free remains authoritative everywhere without a valid Pro rule.

Rollback and uninstall

1. Back up the database and keep the deterministic 0.1.2 Free and Pro ZIPs.
2. Deactivate Pro and confirm the global Free count still applies.
3. Deactivate Free and confirm the native archive count returns immediately.
4. Install the previous deterministic ZIP if needed, reactivate, and repeat the native shop count check.
5. Verify products, categories, orders, and pagination templates are unchanged.

The verified release drill updated, downgraded, rolled forward, deactivated, reactivated, and exercised both uninstall modes while preserving WooCommerce product and order data.

Normal uninstall preserves settings and the license for accidental recovery. Define STOREFIXKIT_DELETE_DATA as true before deletion only when you deliberately want Free to remove sfk_ppp_settings and Pro to remove sfk_ppp_pro_settings plus its license option. WooCommerce products, categories, orders, and templates are never deleted.

StoreFixKit Support

Use StoreFixKit Support and include the affected shop or category URL, expected and actual count, whether the page is native or builder-made, saved global and category numbers, theme, cache/CDN status, Free and Pro versions, WordPress and WooCommerce versions, and redacted desktop/mobile screenshots. Never send credentials, customer or order data, API keys, payment details, or a complete license key.

For feedback, describe the shortest repeatable setup and whether the count works on the native shop page. After resolution, support will provide the correct WordPress.org review link once the official listing exists.