Upgrading Visibility add-on leads to the error @authenticated is not a valid user

Summary

In older versions of Visibility (version 4.2.2 or below), users were able to configure user = @authenticated. This will allow users to show/hide if they were authenticated. However, in the latest version (version 5.0 and above), the parameter needs changed to be special = @authenticated.

Therefore, in the latest version, there will be an error Failed to render Visibility macro due to: @authenticated not being a valid user if the configuration is user = @authenticated.


Environment

  • Visibility 5.0 and above

Cause

Macro parameters have changed.

Workaround

The workaround would be to replace username=@authenticated with special=@authenticated using an add-on called Search and Replace.

  1. Install Search and Replace
  2. Navigate to General configuration > Search and Replace
  3. Select "Search and Replace with REGEX"
  4. Enter the following text in Search (with Regex) for parameter:

    <ac:parameter ac:name="user"><ri:user ri:username="@authenticated" /></ac:parameter>
  5. Enter the following text in *Replace With* parameter

    <ac:parameter ac:name="special">@authenticated</ac:parameter>
  6. Click on Replace All

Screenshot:

Be Aware

Note: Please make sure that you have a backup from your Confluence instance as a safety measure.