Install & update¶
Install¶
- Obtain the plugin ZIP from your Mindful Design release channel or build from GitHub.
- In WordPress: Plugins → Add New → Upload Plugin and choose the ZIP.
- Activate the plugin.
- Ensure WooCommerce is installed and active first.
Permissions¶
- WooCommerce → Gift Aid and Gift Aid Manager require
manage_woocommerce(not onlymanage_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¶
- Open WooCommerce → Gift Aid and set organisation name and review default copy.
- 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).