Documentation / Install, update and choose a language

Min/Max · Development 0.12.0 · Updated 15 September 2026

Install, update and choose a language

This guide describes the current development package. The public WordPress.org listing has not been released.

Install a supplied package

  1. Use a test WordPress site with WooCommerce installed and active. Back up any existing store.
  2. In Plugins → Add New → Upload Plugin, choose the supplied HS Min/Max ZIP and install it. Do not upload the whole company Git repository or the website theme.
  3. Activate HS Min/Max Quantities for WooCommerce. Open Settings from its plugin row or HookSpark → Min/Max.
  4. Create one inactive test rule, verify the values, then enable/save and follow the pack-size test.

The development header declares PHP 8.2, WordPress 6.8 and WooCommerce 10.6 as minimums. Native installation, retained-settings and multisite-isolation checks passed at WordPress 6.8 / WooCommerce 10.6.0 and WordPress 7.1 / WooCommerce 11.1.0, on PHP 8.2.29. Use maintained patch releases and observe WooCommerce’s own WordPress requirement. Other PHP branches and every intermediate combination have not been verified. See verified environment and boundaries.

Update without losing your configuration

  1. Back up both files and database and export the rules before an update.
  2. Install the new package on a test copy and review its change notes.
  3. Confirm saved rules, messages and targeting. Test product → cart update → checkout for representative customers.
  4. Apply to the live store only after those checks pass. No license key is required by this standalone free edition.

Deactivation preserves settings and stops the plugin’s enforcement; reactivation restores the saved configuration. The current ZIP was also removed and reinstalled on an isolated site: saved rules and their enforcement were retained. Custom messages remain in the database; deleting the plugin is not a data-erasure operation. Do not depend on uninstalling as a reset method. Export/import is a configuration workflow, not a substitute for a full-site backup.

Rollback carefully

Newer rule schemas may not be readable by older code. Restore compatible code and its matching database backup. Replacing only plugin files can leave checkout blocked because the installed version cannot validate the stored rules.

English and Italian

WordPress site language controls storefront translations. Your WordPress user language controls your admin interface. The plugin includes an Italian catalog; no separate language switch is required inside Min/Max.

Product names, rule names and custom messages are saved merchant content. Translate these separately. For developers: the current text domain remains plab-minmax for compatibility; translation files are .pot (template), .po (editable language) and .mo (compiled). Do not rename the domain to match the newer brand namespace.