Hides a page fragment from a user with read-only permissions.

Audience: Author
Iteration: Production
Category: Confluence Content
Since: 1.3
projectdoc Toolbox Version: Hide From Reader Macro

This is a simple macro that will reveal it's body content only to users that have permissions to write.

If you provide controls for creating new pages from templates, set these controls in the body of the macro.

The Content is not secure!

Please note that this is only a convenience for the user. The content of the box is for example still indexed by Lucene or will be displayed, e.g. if the user has access to the page's source code or there is a preview function on a page.

Therefore do not add confidential information!

The hiding mechanism is therefore to be considered on the same level as hiding HTML fragments by means of CSS or client-side JavaScript. The user has access to the information.

Especially do not use this macro for property values with the Document Properties Marker Macro! Use this macro in document bodies only.

Note on using confidential information: If allowed by your information policy, put confidential information on a separate page (using page restrictions to control access) and use the Transclusion Macro to render it on a page.

Properties

Replacement

The text to show instead of the hidden page fragment.

Inline

If checked, the replacement element is rendered inline, otherwise as a block.

Since 1.3

This parameter is supported since version 1.3.

Example

To hide the Create from Template macro from users with read-only permissions, use the following:

Example: Hide from Anonymous User with Create From Template Macro

<ac:structured-macro ac:name="projectdoc-hide-from-reader">
  <ac:parameter ac:name="atlassian-macro-output-type">BLOCK</ac:parameter>
    <ac:rich-text-body>
      <p>
        <ac:structured-macro ac:name="create-from-template">
        <ac:parameter ac:name="buttonLabel">Create New</ac:parameter>
        <ac:parameter ac:name="spaceKey">
          <ri:space ri:space-key="MYSPACE"/>
        </ac:parameter>
        ...
      </ac:structured-macro>
    </p>
  </ac:rich-text-body>
</ac:structured-macro>

Related macros

projectdoc Toolbox

The Hide From Reader Macro is part of the commercial The projectdoc Toolbox for Atlassian Confluence plugin with the same features

This is not a security tool! The information is still stored in plain text on the server. The content is simply not rendered for the users lacking access permissions. But it will eventually be displayed for users who try to reveal it (e.g. through searches, previews, source code, history, etc.).

Child pages

Docs

Support

Free Blueprints

Tooling for Blueprints

Free Extensions

Spaces

Plugins for Maven

Incubator

Libraries for Java

Incubator

Add-ons for Confluence

Tools

Support

Team

Legal

Properties

Replacement

Inline

Example

Related macros

projectdoc Toolbox

About

Keep up-to-date!

Powered by