Project Documentation Macros
Child pages
  • Hide From Reader

 

 

Hide From Reader

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.).



About

This site is maintained by smartics.

Imprint / Impressum

Data Privacy / Datenschutz 

End User License Agreement (EULA)


To get in touch please send us an e-mail!

smartics email

Keep up-to-date!

Read our

smartics Blog

Follow us on

Twitter YouTube Prezi

Find us on

Bitbucket GitHub Atlassian Marketplace

Powered by




© 2001-2023 smartics - Kronseder & Reiner GmbH