Difference between revisions of "Reference:Widgets"
(Created page with "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 '...") |
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
Error in widget ...: Unable to load template 'wiki:...'
parser function to include it in the pages of the wiki.
<span id="{{ #widge }}_parser_function" class="mw-headline">{{#widget}} parser function[<a href="https://www.mediawiki.org/w/index.php?title=Extension:Widgets&action=edit§ion=7" title="Edit section: {{#widget}} parser function">edit][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="<!--{$param1|escape:'url'}--><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 <code>{{#widget:...}}</code> parser function to include it in the pages of the wiki. ===<span id=".7B.7B.23widget.7D.7D_parser_function"></span><span id="<span id="{{#widget}}_parser_function" class="mw-headline"class=" data-bs-name="#widge" data-bs-type="template" data-bs-id="1">{{#widget}} parser function</span> #widge }}</span>_parser_function" class="mw-headline">{{#widget}} parser function<span class="mw-editsection"><span class="mw-editsection-bracket">[<a href="https://www.mediawiki.org/w/index.php?title=Extension:Widgets&action=edit§ion=7" title="Edit section: {{#widget}} parser function">edit]</span></span>=== 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 href="<!--{$param1|escape:'url'}-->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 1: | Line 1: | ||
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. | 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. | ||
+ | |||
Line 5: | Line 6: | ||
To add a widget to your MediaWiki installation, just create a page in the Widget: namespace and then use the <code>{{#widget:...}}</code> 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 <code>{{#widget:...}}</code> parser function to include it in the pages of the wiki. | ||
− | ===<span id=".7B.7B.23widget.7D.7D_parser_function"></span><span id="{{# | + | ===<span id=".7B.7B.23widget.7D.7D_parser_function"></span><span id="<span class=" data-bs-name="#widge" data-bs-type="template" data-bs-id="1">{{ #widge }}</span>_parser_function" class="mw-headline">{{#widget}} parser function<span class="mw-editsection"><span class="mw-editsection-bracket">[<a href="https://www.mediawiki.org/w/index.php?title=Extension:Widgets&action=edit§ion=7" title="Edit section: {{#widget}} parser function">edit]</span></span>=== |
To add a defined widget to pages, users can use the <code>{{#widget}}</code> parser function. The syntax is as follows: | To add a defined widget to pages, users can use the <code>{{#widget}}</code> parser function. The syntax is as follows: | ||
Line 14: | Line 15: | ||
Parameters can be expanded inside a widget using [http://www.smarty.net/syntax_comparison Smarty syntax], as follows: | Parameters can be expanded inside a widget using [http://www.smarty.net/syntax_comparison Smarty syntax], as follows: | ||
− | <pre><a href="< | + | <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> | </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. | 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. |