Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Table of Contents
maxlevel2
minlevel2
typeflat
separatorpipe

...

Specify how the output is treatedheight
Macro editor labelDefaultDescriptionMacro parameterFormathtml
Data source
Data source

Specify the source of the HTML content to be rendered. The options available are

as follows:
  • html - data is entered as standard HTML directly in the macro body
  • xhtml - data is treated as XHTML and rendered with the Confluence XHTML renderer prior to display
  • wiki - data is surrounded by a noformat macro. This is a very special case.
Profile

:

  • HTML embed code: Enter HTML code to display content. If this option is selected, a code block section appears where you can enter customized HTML code to be displayed. 
  • URLShow HTML content as referenced with the given URL. If this option is selected, a URL parameter is displayed. Enter the URL of the required source from which the HTML content is to be displayed on the page.
  • ProfileSelect a profile to access the required source and display relevant content. Enter the profile name to be transformed. Refer to this link to know more about profiles. Contact your Confluence administrator for further information
about

Enter the location of data. If specified, the included data follows the body data (if any).

  • #http... - Data is read from URL. May require the user and password parameters as well.
  • ^attachment -
    • about the profiles available in your instance.
    profile nameLocation of HTML datamacro body
    • Attachment: Specify the attachment whose content is to be rendered. By default, attachments from the current page are displayed. If this option is selected, the following parameters are shown:
      • SpaceData is read from an attachment to the
    current
      • page name provided in the space indicated.
    page^attachment -
      • PageData is read from an attachment to the page name provided.
    space
      • Attachment:
    page^attachment -
      •  Data is read from an attachment to the
    page name provided in the space indicated.script
      • current page.
    Note

    Once you specify the data source, click anywhere to see the Preview.


    Layout
    Height of iframe (in px)

    Enter the minimum height (in px or em) to be used for the rendered content.

    If you do not specify, the height is auto-rendered according to the HTML content.
    If you specify the height, the HTML content fits within the specified height. If the content exceeds the specified height, a scroll bar is displayed that allows you to scroll through the content.

    Example: 500px or 1.5em 

    Anchor
    htmlCld150_html_macSecParams
    htmlCld150_html_macSecParams

    Settings
    Formathtml

    Specify how the output is treated. The options are as follows:

    • html - data is entered as standard HTML directly in the macro body
    • xhtml - data is treated as XHTML and rendered with the Confluence XHTML renderer prior to display
    • wiki - data is surrounded by a noformat macro. This is a very special case.
    Find regex patterns

    Enter a comma separated list of regex patterns to use to post-process the output HTML with find and replace logic. Example: (href=)(/display)

    find
    Replacement strings

    Enter a comma separated list corresponding to find patterns via index position in list. If a comma is a part of an entry, use single quotes around it. Example: $1$base_url$2

    replaceFile encodingsystem defaultSpecify the encoding for an external file, if different from the system default handling. Example: UTF-8.encoding

    Timeout in milliseconds
    Enter time in milliseconds such that URL connections do not timeout before getting data. Use this to increase time needed for slow connections. Note that if a zero is given the connection may wait infinitely.timeout
    File encodingsystem defaultSpecify the encoding for an external file, if different from the system default handling. Example: UTF-8.
    User id for URL connection (Removed)

    Enter the user name for URL access via basic authentication.

    Warning
    titleRemoval notice

    Please note that the URL user and URL user password parameters were removed (see Deprecation notice: URL user and URL user password parameters). We recommend using profiles to access external data.

    user


    Password for URL connection (Removed)

    Enter the password for URL access via basic authentication. 

    Warning
    titleRemoval notice

    Please note that the URL user and URL user password parameters were removed (see Deprecation notice: URL user and URL user password parameters). We recommend using profiles to access external data.

    passwordHeight of rendered contentauto calculated

    Enter the minimum height (in px or em) to be used for the rendered content.

    If you do not specify, the height is auto-rendered according to the HTML content.
    If you specify the height, the HTML content fits within the specified height. If the content exceeds the specified height, a scroll bar is displayed that allows you to scroll through the content

    .

    Example: 500px or 1.5em 
    Anchor
    htmlCld150_html_macSecParamshtmlCld150_html_macSecParams


    Allow same originOff

    Enable the page viewing user to execute scripts to access cookies and Confluence APIs based on the app's Macro security configuration

    Info

    If the Allow JavaScript global configuration is enabled, the page viewing user can execute scripts to access cookies and Confluence APIs. Please verify that appropriate macro security options and equivalent page restrictions are set for this user/page/app.


    Allow script executionOff

    Enable to allow scripts to be executed based on the app's Macro security configuration

    Info

    If the Allow JavaScript global configuration is enabled, execution of scripts in the HTML macro is always allowed regardless of the Allow script execution parameter status. Please verify that appropriate macro security options and equivalent page restrictions are set for this user/page/app.


    ...