A Define Shortcode has no Mirror ID. A Define Shortcode instantiates nothing in the Post rendering of itself; its only purpose is to update the database, creating a new Alias in an Alias List.
A Define Shortcode will do nothing unless under an Admin login, or the login has my_mirror_define privilege.
A Define Shortcode will do nothing if its Resource ID is already represented in the Alias List, unless the login has my_mirror_redefine privilege.
(my_mirror_redefine privilege, if it implemented, exists only for use in a special login for correcting errors.)
The Define Shortcode exists only to provide a convenient shorthand for the creation of aliases via the copy and paste of a URL while in the Edit Page, without needing to go to the Admin Pages.
[[my_define list=???; id=???; url=???; ]]
— or —
[[my_define list=???; id=???; alias=???; ]]
Mandatory:
- list – An Alias List
- id – The Resource ID. If the Resource ID does not exist, an error is generated.
- Either of:
- url – The Nominal URL. Will be resolved to a Resource Name in accordance with the Filex associated with this mirror. If there is no entry for this Resource ID in this List, an entry will be created associating this Resource ID with the Resource Name using the Resource Name Filex for this Mirror.
- alias – Resource Name. If there is no entry for this Resource ID in this List, an entry will be created associating this Resource ID with the Resource Name using the Resource Name Filex for this Mirror.
We only edit these list one entry at a time; they can easily become huge, with hundreds of entries. For bulk editing, we provide CSV file export and import.
Select an Alias List to View or Edit
Selection Filter Regexes
|
Alias Value Filter (text) |
|
|
Select an Alias to View or Edit
View, Modify or Add an Alias
|
Alias Value (display/test) |
|
|
|
Export – Import CSV Alias Lists
Export all to file.
Import from CSV file.
|
IMPORT CSV OVERWRITE or ADD
|
|
|
|
Composite Parameters appear in a Composite Shortcode definition with a prefixed “at-sign”, and in a Composite Shortcode instantiation without the “at-sign”.
There is one list of user defined Composite Parameters shared by all Composite Shortcodes defined. However, not every Composite Parameter need be used by every Composite Shortcode.
In the calling convention, Composite Parameters share the namespace of the Post metadata (postmeta). Therefore, Custom Parameter names must be unique with respect to all WordPress Post metadata names and with respect to all Post metadata names defined in any plugin currently in installed. In the WordPress database, Composite Parameters share the namespace of the Blog metadata (options) in a “single Blog” or “Blog 1” installation, and with the MultiSite Network metadata (sitemeta) for a MultiSite Network installation. Therefore, Custom Parameter names must also be unique with respect to all these WordPress metadata names and with respect to all these metadata names defined in any plugin currently in installed.
Enter all of the user-defined parameters (without their “at sign”) as a comma-separated list.
List of Parameters (text) |
Composite Parameter Default Values
A default value must be specified as null
for the absence of a parameter in the Composite Shortcode instantiation to have the unique effect of an absent parameter in the included shortcode.
Default values may be:
null
- Integer
- “Quoted String”
- @Automatic_String
- @@Custom_Field
- @@Post_Meta_Data
- @@Blog_Meta_Data
- @@Site_Meta_Data
Parameter Name |
Parameter Default Value |
(button) |
Parameter (display) |
Value (text) |
|
Parameter (display) |
Value (text) |
|
Parameter (display) |
Value (text) |
|
Parameter (display) |
Value (text) |
|
Parameter (display) |
Value (text) |
|
Parameter (display) |
Value (text) |
|
Parameter (display) |
Value (text) |
|
Add New Composite Shortcode
New Shortcode Name (text) |
|
|
Edit Composite Shortcode Definition
Existing Shortcode Name (select) |
|
|
A Composite Shortcode is comprised of from one to nine Link, Embed, Auto and/or ProForma shortcodes. These shortcodes are instantiated successively according to their definitions (below), with parameters derived from:
- the calling parameters of the Composite Shortcode instantiation
- Automatic Strings
- user defined Composite Parameters
- Post metadata
Parameters are defined in the Composite Parameters page.
enable |
shortcodes |
|
A Link, Embed, Auto or ProForma shortcode (text) |
|
|
A Link, Embed, Auto or ProForma shortcode (text) |
|
|
A Link, Embed, Auto or ProForma shortcode (text) |
|
|
A Link, Embed, Auto or ProForma shortcode (text) |
|
|
A Link, Embed, Auto or ProForma shortcode (text) |
|
|
A Link, Embed, Auto or ProForma shortcode (text) |
|
|
A Link, Embed, Auto or ProForma shortcode (text) |
|
|
A Link, Embed, Auto or ProForma shortcode (text) |
|
|
A Link, Embed, Auto or ProForma shortcode (text) |
|
Instantiation Parameters
The following predefined parameters will auto-generate text from the parameter list of the shortcode instantiation.
- @id
- @url
- @alias
- @list
- @pri
- @sec
- @ter
- @prefix
- @link
- @postfix
- @proforma
Mirrors Parameter
With the expression mirrors=”comma separated integer list” in the instantiation of the Composite Shortcode, the order of mirror instantiation may be reorganized, including skips. If present. it must contain at least as many integers as needed for this Composite Shortcode definition.
The value of “@mirror” will be the successive values of this list if mirrors is in the instantiation, and the successive integers 1-9 if it is not.
The value of “@alternate” will be the successive values of this list if mirrors is in the instantiation, and the successive integers 1-9 if it is not, except that if the mirror resolves to the same as mirror_0, this shortcode within the Composite Shortcode is not instantiated.
Thus a typical Composite Shortcode definition might set mirror=0 for the first Embed Shortcode, and mirror=@alternate for each succeeding Link Shortcode.
The successive values of these parameters increment with each instantiation of a shortcode for which they are a legal parameter, whether a @mirror or @alternate is specified or not. The values do not increment for any shortcode which cannot take a @mirror parameter.
Automatic Strings
The following predefined parameters will auto-generate text from the context of the shortcode instantiation.
- @resource_id
- @resource_name
- @mirror_name
- @mirror_number
- @virtual_name
- @server_name
In addition, all of the Composite Parameters (defined in the Composite Parameters page) which will appear in the Composite Shortcode instantiation may be used.
A Composite Shortcode combines one or more shortcodes into one call.
[[my_composite url=???; composite=???; {zero or more parameters }]]
— —or— —
[[my_composite id=???; composite=???; {zero or more parameters }]]
Allowing a Composite Shortcode to be a single shortcode allows its use to extend a shortcode with custom data.
Mandatory:
- composite – The Composite Definition name.
- 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.
Optional:
- The parameters are defined in the Composite Definition and the Composite Parameters admin pages. Just as the shortcode parameters, Composite Parameters (if specified) appear in the Composite Shortcode instantiation in the form:
ParameterName=???
where ??? is either:
-
- an integer
- a “Quoted String”
- an @Automatic_String
- an item of @@Post_Meta_Data
- a @@Custom_Field
- an item of @@Blog_Meta_Data
- an item of @@Site_Meta_Data
(The database is queried in the order shown; the first match is used.)
Any Composite Parameter defined used in the Composite Shortcode definition and not present in the Composite Shortcode instantiation will be represented by the predefined default value.
An Auto Shortcode acts like an Embed Shortcode if its Mirror ID resolves to the same Server Site as [mirror‑0
]; acts like a ProForma Shortcode otherwise.
[[my_auto mirror=???; url=???; {alias=???;} {list=???; } {proforma=???; }]]
— —or— —
[[my_auto mirror=???; id=???; {alias=???;} {list=???; }{proforma=???; }]]
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.
- proforma – The ID of an existing ProForma specification.
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.
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.
ProForma Name
ProForma Friendly Name (display) |
ProForma Prefix Text
ProForma Prefix Text (display) |
ProForma Link Text
ProForma Link Text (display) |
ProForma Postfix Text
ProForma Postfix Text (display) |
Automatic Strings
The following strings will auto-generate text.
- @resource_id
- @resource_name
- @mirror_name
- @mirror_number
- @virtual_name
- @server_name
The Proforma shortcode will insert a text link to the mirror into your blog.
[[my_proforma mirror=???; url=???; {alias=???;} {list=???; } {proforma=???; }]]
— —or— —
[[my_proforma mirror=???; id=???; {alias=???;} {list=???; }{proforma=???; }]]
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.
- proforma – The ID of an existing ProForma specification.
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.