Help:WidgetTag

From Wikia Help

This is a new feature on Wikia! It may be under further development. Please leave feedback on the Central Wikia forum!

Most Widgets can be embedded on any page using the <widget> WidgetID </widget> tags.

Widgets are self-contained tools which provide information or navigation to users. In the past they could only be displayed on your sidebar or on your Special:WidgetDashboard page, but now they can be displayed anywhere.

With the "Wiki page in Widget" widget, you can also point it at any article and have that show up on the page, too.

Many widgets can be customized by changing the value of certain default preferences (a.k.a. parameters). WidgetTag allows you to customize the parameters of a widget just like the widget editor does.

Contents 1 How do I embed a widget? 2 Can I float the widget? 2.1 Example 3 Parameters

How do I embed a widget?

Put the widget "Community" in our article by placing the widget's name between opening and closing <widget> tags:

<widget>Community</widget>

It will render as:

If a widget has a parameter or preference that would normally be customized via that widget's editor then you can also specify a value for a parameter just as you would for an attribute in any standard HTML tag. viz.

<widget param1=value1 param2=value2>WidgetID</widget>

<widget limit="5">RecentChanges</widget>

Read more about widget parameters below.

Can I float the widget?

The widget can be floated to left or right so that other page text flows around it:

<div style="float:right; margin:0 5px">'''Recent changes'''<widget limit="25">RecentChanges</widget></div>
<div style="float:left; margin:0 5px">'''Top Users'''<widget>TopUsers</widget></div>

Example

The Recent Changes widget is floated to the right and the Top Users widget is floated to the left of the following text:

Lorem ipsum qwerty foo bar qwerty foo bar qwerty foo bar qwerty foo bar qwerty foo bar qwerty foo bar qwerty foo bar qwerty foo bar qwerty foo bar qwerty foo bar qwerty foo bar qwerty foo bar qwerty foo bar qwerty foo bar qwerty foo bar qwerty foo bar qwerty foo bar qwerty foo bar qwerty foo bar qwerty foo bar qwerty foo bar qwerty foo bar qwerty foo bar qwerty foo bar qwerty foo bar qwerty foo bar qwerty foo bar qwerty foo bar qwerty foo bar qwerty foo bar qwerty foo bar qwerty foo bar qwerty foo bar qwerty foo bar qwerty foo bar qwerty foo bar qwerty foo bar qwerty foo bar qwerty foo bar qwerty foo bar qwerty foo bar qwerty foo bar qwerty foo bar qwerty foo bar qwerty foo bar qwerty foo bar.

Parameters

Most widgets have a few parameters that you can use with the <widget> tag to adjust how the widget looks and acts on the page. These are the same options that you can personally customize when its in your sidebar but, in the case of in-page widgets these settings will be seen by anyone viewing that page.

All of these parameters have a default value, so you don't need to worry about setting anything if you don't want to. All of them also have a fall back "safe" value, in case your input is too small, or too large, so you don't have to worry about breaking anything, so feel free to experiment and try them out.