Magic words and Parser functions are a way to empower the wiki text (the specific language through which pages of all wikis are written, thus one can also use Visual editor where available) with some programmatic feature, for instance the ability to add the current date to a page (which will update during subsequent access) or to trigger whatever other function available in the wiki on the server side. They are both completely comparable to templates, with the difference that the second ones are always called with a parameter, and that the logics behind them is not placed within a template or module (so that it can be accessed on the wiki) but is coded server side.
Here is a list of the additional magic words provided by our platform (as usual they are prefixed with the string "CI_" to distinguish them easily from other Mediawiki magic words and parser functions)
| name | what it does |
|---|---|
| CI_userAffiliatedTo | shows the organization to which the logged in user is affiliated |
| CI_userRealName | shows the real name of logged in user (by contrast to the username) |
| CI_isSysop | returns 1 if the logged in user is an admin ("sysop") |
| CI_loggedIn | returns 1 if the page's visitor is logged in |
| CI_visitorIsoCode | returns the iso code of country of the visitor |
| CI_visitorCountry | returns the country name of the visitor |
and parser functions:
| name | what it does |
|---|---|
| CI_editors_realnames | returns the real names from a list of usernames |
| CI_editors_attribution | taking an ask query returning the editors of a page as input, returns the page creator or editors of a given page, and the the affiliated organization for each of them, passing to the function a pattern like "created by [name], affiliated to [organization]" |
| CI_subpages | returns the list of sub-pages ("kids" only) of a given page within only 1 depth level, without duplicates |
| CI_format_title | returns the actual page title given a path; e.g. "Presepe /1" from "Centro Italiano Barcellona/Posts/Presepe /1" |
| CI_noparse_isHTML | prevents Mediawiki from html encoding output |
| name | return value | example | result |
|---|---|---|---|
| CI_userAffiliatedTo | logged in user affiliation | {{CI_userAffiliatedTo}} | |
| CI_userRealName | logged in user real name | {{CI_userRealName}} | |
| CI_isSysop | whether the logged in user is an administrator or not | {{CI_isSysop}} | |
| CI_loggedIn | whether the user is logged in or not | {{CI_loggedIn}} | |
| CI_visitorIsoCode | country code of user (based on the ip) | {{CI_visitorIsoCode}} | RO |
| CI_visitorCountry | country of user (based on the ip) | {{CI_visitorCountry}} | Romania |
| function | return value | parameter |
|---|---|---|
| CI_editors_realnames | comma separated real names | list |
| CI_editors_attribution | wiki-text unordered list with links, in the form [[complete path|page name]] followed by the real name of page creator or editor, and the affiliated organization | list, delimiter, kind of output (ul or comma separated values), pattern with editor and related organization, and "fallback" pattern (optionally) |
| CI_subpages | wiki-text unordered list with links, in the form [[/kid page title]] | none |
| CI_format_title | raw text | complete page title |
CI_editors_attribution
{{#CI_editors_attribution: {{#ask:
[[Category:Reading suggestions]]
|format=array
|?Page creator
|?Creation date
|limit=5
|sep=##
}}|##|ul|created by [name], affiliated to [[[organization]]]| by [name] }}
will create the following list:
Where it can be noted the following:
CI_editors_realnames
{{#CI_editors_realnames: {{#ask:
[[{{PAGENAME}}]]
|?Page creator
|?Page author
|format=array
|mainlabel=-
|sep=##
}}
}}
will produce the following output:
Redazione
Likewise as above, the output produced by the ask query, will be a list of usernames separated by the key-word '<MANY>', with properties separated by the '<PROP>' key-word, and the "CI_editors_attribution" parser function will retrieve the related real names and will concatenate them by commas.