You are viewing an old version of this page. View the current version.

Compare with Current View Page History

Version 1 Next »

projectdoc Toolbox

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

Name
Hide From Reader
Audience
Categories
Tags

Description

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.

Details

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

Macros that hide page elements for convenience of the user:

Hide From Anonymous User
Hides a text fragment from an anonymous user.
Hide From Reader
Hides a page fragment from a user with read-only permissions.
Hide From Viewer Macro
Hides a text fragment from a user that has no edit permissions.

  • No labels