Skip to content

Install & update

Install

  1. Obtain the plugin ZIP from your Mindful Design release channel or build from GitHub.
  2. In WordPress: Plugins → Add New → Upload Plugin and choose the ZIP.
  3. Activate the plugin.
  4. Ensure WooCommerce is installed and active first.

Permissions

  • WooCommerce → Gift Aid and Gift Aid Manager require manage_woocommerce (not only manage_options).
  • CSV exports and bulk tools run in admin contexts protected by nonces—keep admin accounts secure.

Updates

  • Back up the database before major WooCommerce upgrades.
  • After updating MindfulGiftAid, verify checkout Gift Aid checkbox and a test order’s meta.

First run

  1. Open WooCommerce → Gift Aid and set organisation name and review default copy.
  2. Place a test donation with Gift Aid enabled and confirm it appears under Gift Aid Manager.

Uninstall

The plugin ships with uninstall.php; uninstall behaviour follows WordPress standards for options cleanup (confirm in your deployment if you rely on retained data).