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.
Section 9-7