Difference between revisions of "Reference:Widgets"
(→Usage[edit]) |
(→Usage[edit]) |
The Widgets extension allows the creation of raw HTML pages that can be embedded (similarly to templates) in normal wiki pages. You do this by creating pages in the Widget namespace. They avoid the security problems of raw HTML in editable wiki pages because the privilege to edit in the Widget namespace is managed. Many pre-written Widgets are available.
Usage[<a href="https://www.mediawiki.org/w/index.php?title=Extension:Widgets&action=edit§ion=6" title="Edit section: Usage">edit][edit | edit source]
To add a widget to your MediaWiki installation, just create a page in the Widget: namespace and then use the {{#widget:...}} parser function to include it in the pages of the wiki.
{{#widget}} parser function[edit | edit source]
To add a defined widget to pages, users can use the {{#widget}}
parser function. The syntax is as follows:
{{#widget:WidgetName|param1=value1|param2=value2}}
Where WidgetName is a page name in the Widget namespace (e.g. Widget:WidgetName) and param=value pairs are the settable parameters, defined within the widget code.
Parameters can be expanded inside a widget using Smarty syntax, as follows:
<a id="bs_comment:@@@CMT0@@@" href="<span class=" data-bs-type="comment" data-bs-id="0"> param1 escape url "><!--{$param2|escape:'html'}--></a>
The escape
options specifies how the parameter will be 'escaped', or encoded, in the resultant Widget. See http://www.smarty.net/docsv2/en/language.modifier.escape for more information on this.
Source: mediawiki
The '''Widgets''' extension allows the creation of raw HTML pages that can be embedded (similarly to templates) in normal wiki pages. You do this by creating pages in the ''Widget'' namespace. They avoid the security problems of raw HTML in editable wiki pages because the privilege to edit in the Widget namespace is managed. Many pre-written Widgets are available. ==<span id="Usage" class="mw-headline">Usage</span><span class="mw-editsection"><span class="mw-editsection-bracket">[<a href="https://www.mediawiki.org/w/index.php?title=Extension:Widgets&action=edit§ion=6" title="Edit section: Usage">edit]</span></span>== To add a widget to your MediaWiki installation, just create a page in the Widget: namespace and then use the <nowiki>{{#widget:...}}</nowiki> parser function to include it in the pages of the wiki. ==={{#widget}} parser function=== To add a defined widget to pages, users can use the <code>{{#widget}}</code> parser function. The syntax is as follows: <pre>{{#widget:WidgetName|param1=value1|param2=value2}} </pre> Where WidgetName is a page name in the Widget namespace (e.g. Widget:WidgetName) and param=value pairs are the settable parameters, defined within the widget code. Parameters can be expanded inside a widget using [http://www.smarty.net/syntax_comparison Smarty syntax], as follows: <pre><a id="bs_comment:@@@CMT0@@@" href="<span class=" data-bs-type="comment" data-bs-id="0"> param1 escape url "><!--{$param2|escape:'html'}--></a> </pre> The <code>escape</code> options specifies how the parameter will be 'escaped', or encoded, in the resultant Widget. See [http://www.smarty.net/docsv2/en/language.modifier.escape http://www.smarty.net/docsv2/en/language.modifier.escape] for more information on this. ''''''Source: '''[https://www.mediawiki.org/wiki/Extension:Widgets mediawiki]
Line 5: | Line 5: | ||
==<span id="Usage" class="mw-headline">Usage</span><span class="mw-editsection"><span class="mw-editsection-bracket">[<a href="https://www.mediawiki.org/w/index.php?title=Extension:Widgets&action=edit§ion=6" title="Edit section: Usage">edit]</span></span>== | ==<span id="Usage" class="mw-headline">Usage</span><span class="mw-editsection"><span class="mw-editsection-bracket">[<a href="https://www.mediawiki.org/w/index.php?title=Extension:Widgets&action=edit§ion=6" title="Edit section: Usage">edit]</span></span>== | ||
To add a widget to your MediaWiki installation, just create a page in the Widget: namespace and then use the <nowiki>{{#widget:...}}</nowiki> parser function to include it in the pages of the wiki. | To add a widget to your MediaWiki installation, just create a page in the Widget: namespace and then use the <nowiki>{{#widget:...}}</nowiki> parser function to include it in the pages of the wiki. | ||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
'''Source: '''[https://www.mediawiki.org/wiki/Extension:Widgets mediawiki] | '''Source: '''[https://www.mediawiki.org/wiki/Extension:Widgets mediawiki] |