Print

sdMacros has the following commands:

The above commands may also contain flags to control command processing.

sdInclude Syntax:

{sdInclude articleId/}

{sdInclude ["]articleName["]/}

 

 

sdDefine Syntax:

{sdDefine name [argName1] [argName2] ...}macro definition{/sdDefine}

 

 

sdMacro Syntax:

{sdMacro name [arg1] ["][arg2]["] ...}[macro value]{/sdMacro}

 

 

sdArg Syntax:

{sdArg name/}

 

 

sdValue Syntax:

{sdValue/}

 

 

sdStyle Syntax:

{sdStyle/}

 

 

sdComment Syntax:

{sdComment}some text{/sdComment}

 

 

sdEcho Syntax:

{sdEcho/}some text{/sdEcho}

 

 

sdEnable Syntax:

{sdEnable 0,1,true,false/}

 

 

Command Flag Syntax:

{command[:flag][:flag]... [arguments]/}

childTagsOnly When processing a command, ingnore anything except the results of any sdMacro commands. This is typically used when an article is inteded to contain only various sdMacro commands. If the article is created in a typical Joomla! text editor it may also contain invisible HTML such as paragraph tags (<p>) around the commands. This can be correct by only editing the article in Joomla!'s "No - editor" editor, or being careful to only use the HTML modes of other editors. Or, it is often easier to use the childTagsOnly flag which removes this extra HTML allowing any of the Joomla! editors to be used.
noProcessCommands Do not process any commands, leave them as is. This will cause the commands to be visible as normal text. It is typically only in something like a tutorial where the contents of a macro is supposed to be displayed, not executed.

preserveArgHTML

Do not convert HTML entities in articles back to HTML. Many of the Joomla! editors will convert certain characters like quotes (" or '), and angle brackets (< or >) into HTML entities (<, >, etc.). The editors do this so the browser isn't confused and interpret them as HTML. But, this translation can cause problems for sdMacros cc, for example a command with a quoted argument such as {sdMacro test "Hello World!"/} because the quotes will be translated to &quote; and sdMacros won't see them. To prevent this sdMacros converts HTML entities back to HTML before processing. But, there are cases where this translation is desired
displayHTML Convert any HTML to entities so that the HTML will be visible as text instead of being rendered by the browser. Again this is typically only needed where the contents of a macro is supposed to be displayed, not executed
removeHTML Completely remove any HTML. This flag may be useful in cases l like that described above for the childTagsOnly flag where undesired HTML is added by the Joomla! editors.
loggedIn Valid only for the sdComment command. The loggedIn flag will cause the contents of the sdComment flag to be displayed only if a user is currently logged in.
loggedOut Valid only for the sdComment command. The loggedOut flag will cause the contents of the sdComment flag to be displayed only if no user is currently logged in.