projectdoc Toolbox

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

Audience

Author, Template Author

Tags

Type

Content Organization

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.

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

Hide Macros

Macros whose main concern is to hide content.

Macro	Short Description
Hide From Anonymous User	Hides a text fragment from an anonymous user.
Hide From Viewer Macro	Hides a text fragment from a user that has no edit permissions.

Content Macros

Macros that allow their content to be hidden.

Macro	Short Description
Content Marker Macro	Marks a piece of content within a document. This content can be referenced for transclusion.
Section Macro	Renders a section, if the body is not empty. Supports authors to create content, clutter-free rendering without empty sections. Allows to transclude the content.

Free Macro

There is a non-commercial version of this macro for commercial use: Hide From Anonymous User Macro.

Space shortcuts

Page tree

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