My Mirrors

Shortcodes

Shortcode: Mutable

A Mutable Shortcode acts like an Embed Shortcode if its Mirror ID resolves to the same Server Site as [mirror-0]; acts like a Link Shortcode otherwise.

[[my_mutable mirror=???; url=???; {alias=???;} {list=???; } {pri=???; } {sec=???; } {ter=???; }]] Some user supplied text [[/my_link]]

—  —or—  —

[[my_mutable mirror=???;  id=???; {alias=???;} {list=???; } {pri=???; } {sec=???; } {ter=???; }]] Some user supplied text [[/my_link]]

—  —or—  —

[[my_mutable mirror=???; url=???; {alias=???;} {list=???; } {pri=???; } {sec=???; } {ter=???; } {prefix=”some user text”; } {link=”more user text”; } {postfix=”final user text”; }]] 

—  —or—  —

[[my_mutable mirror=???;  id=???; {alias=???;} {list=???; } {pri=???; } {sec=???; } {ter=???; } {prefix=”some user text”; } {link=”more user text”; } {postfix=”final user text”; }]] 

Mandatory:

  • mirror – The Mirror number or Mirror name.  For example, either “3” or “mirror‑3”.
  • Either of –
    • id    – The Resource ID. If the Resource ID does not exist, an error is generated.
    • url  – The Nominal URL.  Will be resolved to a Resource ID in accordance with the Filex associated with this mirror.  If the Resource ID does not exist, it will be created. If there is no entry for this Resource ID at this Mirror, an entry will be created associating this Resource ID with the Resource Name using the Resource Name Filex for this Mirror.
  • Either of –
    • link    – The text which will appear in the link.  No following text and closing shortcode allowed.
    • After the shortcode, the text which will appear in the link, followed by a closing shortcode. The prefix, link, and postfix options are not allowed.

Optional:

  • Either or neither of –
    • alias – Resource Name.  If present, this overrides any Resource Name association elsewhere, such as in an Alias List associated with the Mirror.
    • list    – An Alias List.  If present, this overrides any Alias List association elsewhere, such as an Alias List associated with the Mirror.
  • Any or all or none of –
    • pri – A Primary Branch name or a slash-terminated Primary Branch string.  If present, this overrides any Primary Branch association elsewhere, such as a Primary Branch associated with the Mirror.
    • sec – A Secondary Branch name or a slash-terminated Secondary Branch string.  If present, this overrides any Secondary Branch association elsewhere, such as a Secondary Branch associated with the Mirror.
    • ter – A Tertiary Branch name or a slash-terminated Tertiary Branch string.  If present, this overrides any Tertiary Branch association elsewhere, such as a Tertiary Branch associated with the Mirror.
    • Only if link is present,  either or neither of –
      • prefix   – Text which will appear before the link, in the same line.
      • postfix  – Text which will appear after the link, in the same line.

 

Section 9-4