I'm planning for an upgrade to Confluence 4 and have decided to sunset some plugins which are no longer useful to us (and have turned from open source to commercial...but that's another story).
The impetus for stripping out these old markup tags is because Confluence attempts to wrap these in wiki markup blocks. Worst case is users will have to copy and paste from the wiki block into the outside block.
Does anyone have any tricks or tips on how to best remove them en-masse? The solution that I'm thinking of involves database search/replace with regex pattern replace. I think this will be much easier to do before the upgrade and conversion into XHTML.
One technique would be to create user macros for each macro offered by the plugin you're withdrawing. The user macro would be given the same name as a withdrawn macro. If the original macro was wrapping text or other content then you'll need to output that from the user macro. $body should do the trick. If there was no content wrapped by the macro then the macro doesn't need to do anything. You'll find an option when you define a user macro to prevent the macro appearing in the macro browser, except for admin users. This will help ensure that the users don't carry on using the macros by mistake.
You might say that this approach doesn't fully address the issue because the pages haven't been cleaned up. However the page authors could tackle this over time as pages are edited and updated in the normal run of things. You could track progress of this with careful use of the Confluence search and so remove the user macros when they're no longer required (see http://ffeathers.wordpress.com/2011/11/04/how-to-search-confluence-for-usage-of-a-macro/).
A database search/replace is certainly possible, but riskier I think. Let us know which solution you go for. It's an interesting challenge you've got there.
Do you use templates with Confluence? Take part in a remote 1-hr workshop. You'll receive USD $100 for your time! We're looking for people to participate in a remote 1-hr workshop...
Connect with like-minded Atlassian users at free events near you!Find a group
Connect with like-minded Atlassian users at free events near you!
Unfortunately there are no AUG chapters near you at the moment.Start an AUG
You're one step closer to meeting fellow Atlassian users at your local meet up. Learn more about AUGs