I am changing the structure of the addon_id I use for my addons - so this version is a re-release of the functionality currently available in v1.0.1, but with a new addon_id.
Note that you cannot directly upgrade from v1.0.1 - there are additional manual steps required - please see upgrade instructions below.
If you don't yet have v1.x installed, just install v2.x as you would normally do for any addon. If upgrading from v1.x of the addon, follow the instructions below.
Upgrade instructions from v1.x of the addon (read this in full before starting!):
A) Easy upgrade from v1.x - lose cached data and option configuration
If you don't mind losing your settings and reconfiguring the addon options - you may simply uninstall the existing addon (and remove the files from the file system!) and then install this new v2.x version
B) Full upgrade from v1.x - retain cached data and option configuration
To retain all cached data and configuration settings, carefully follow these steps (
caution - doing these in the wrong order or missing a step can lead to configuration data loss!):
- back up your forums (both database and file system) before attempting to upgrade - you could lose data if you get the steps wrong!
- it is highly recommended that you close your forums before starting the upgrade process
- In your favourite database browser tool, locate the
xf_addon
table for your forum installation and then find the row with the addon_id
= LogDigest
- Change the
is_legacy
field for this row and set the value to 1
. This will mark the addon as "legacy" in the admin UI and disable the addon
- Extract the new v2.0.x addon to the file system. It won't over-write the existing addon installation because of the change in addon_id
- Refresh the addon list in the UI - the system should offer to upgrade the addon instead of installing it, having detected that the old addon is the "legacy" version
- Proceed with the upgrade - all data and option settings will be retained, the old addon will be uninstalled and show up in the admin UI as "Installable". Do NOT re-install the old addon!
- Remove the old addon files from the file system completely - these can be found in
<forum_root>/src/addons/LogDigest
- Test that the new version of the addon works - look for the test suite in the Tools section of the admin UI