Upgrading from SmoothFunctions’s Boomerang 1.0 to 1.1

SmoothFunction has just released it’s latest version of Boomerang which now allows you to use all of Expression Engine’s template variables in your email templates. I did find however that just replacing the files from version 1.0 with the 1.1 update caused my templates to stop working all together. So instead I decided to document the process of uninstalling Boomerang 1.0 and doing a clean 1.1 install. If you’ve come across the same problem then hopefully this will help you out.

1. Delete your /system/modules/boomerang folder using an FTP client

2. Using a DB manager like PHPMyAdmin open up your EE database and open the “exp_modules” table

3. Delete the record which specifies Boomerang 1.0

4. Now go back to the top level where you can select multiple tables

5. Select all the tables with “exp_boomerang” in their name

6. Drop all these tables

7. Now upload your Boomerang 1.1 files (both the language and module folders)

8. Log in to Expression Engine, click on Modules and Enable Boomerang 1.1

9. Jump over to Templates and create a new template group and hidden template (e.g. email/newsletter) edit it and make sure you save it as a file.

10. Go back to Modules and select Boomerang. Complete the initial settings page. If you see the License Key field and the Email Template field it means that you should now be set to go!