Filters: Shortcodes
This plugins allows users to use shortcodes in content throughout Moodle to inject or modify content with ease. The shortcodes are provided by other Moodle plugins.
Usage
A shortcode is constituted of a word between square brackets. There are two types of shortcodes: the ones that wrap content, and the ones that do not. Those that do wrap content MUST have a closing tag. Here is an example using [useremail
] which prints the current user's email, and [toupper]
which wraps content and makes it uppercase.
Your registered email address is: [useremail].
[toupper]This text will be uppercased[/toupper].
You can also nest the shortcodes, let's make the user's email address uppercase.
Your registered email address is: [toupper][useremail][/toupper].
Some shortcodes support arguments. Those are declared in the same manner as HTML attributes. Here is an example of a shortcode that would add a collapsible section with a height of 100, and which would be collapsed by default:
[section height="100" collapsed]
Attribute values do not require to be wrapped between double quotes, but it is recommended. When the attribute does not have a value, it is considered to be true
. Single quotes cannot be used in lieu of double quotes.
List of shortcodes
Once the plugin is installed, the list of all available shortcodes and documentation on how to use them will be available at the URL: http://your-moodle-site/filter/shortcodes/index.php. By default this page is available to all logged in users, though this can be changed using the permission filter/shortcodes:viewlist.
Plugins supporting shortcodes
Your plugin supports shortcodes? Let us know!
For developers
Developers can easily add support shortcodes in their plugin. See the documentation for more information.
But unfortunately the shortcodes list (http://your-moodle-site/filter/shortcodes/index.php) is only showing [firstname], [fullname] and [off] .
The shortcodes I've seen in the description above ( [useremail], [toupper], [section height="100" collapsed]... they look very promising. But they're not there.
How can I add them to the list and use?
Are there any other shortcodes ready or use?
This plugin does not come with a list of shortcodes by default, except for the 3 that you found. We created this plugin to allow other developers to add shortcodes to their own plugins. Keeping the built-in shortcodes to a minimum was very important to keep the performance impact to its minimum unless new features are needed. There are tons of shortcodes we could be adding, if you are looking for a plugin that provides a similar functionality but comes with a lot of pre-defined shortcodes, please search for "filtercodes".
Any plans on updating for 3.8 since 3.8 is Long Term Support? Thanks for sharing your great work with teachers around the world to help gamify their courses to make it more engaging and fun for students!