Widget reference

Although the main meat of any page will be in the main content area, it’s often the page extras in other areas like photos that add visual interest to the page. A set of Wingfinger Widgets allows you to insert page extras in these other editable regions of the page.

This is the technical reference page for available widgets, giving the information you need to be able to deploy them on site pages. If this all looks a bit daunting, see Using posts as page extras for a gentle introduction to the subject.

Widgets used on this site

Changing some of the parameters of widgets may necessitate further styling work from Wingfinger. Our cheaper web packages usually include limited styles for just one or two page regions.

Wingfinger Widgets are all controlled in the same way, using the Custom Fields area below the main Editing panel or as shortcode in the main edit panel. (If custom fields are not visible, you may need to turn it on in the Screen Options panel just below the Admin Bar.)

Custom Fields

To insert a widget anywhere other than the main editable text area of a page, the standard method is to create a Custom Field with the appropriate name (eg: left-1-post) and enter the required parameters as a set of name-value pairs, such as…

ids=205
pic_size=medium

The order of the pairs doesn’t matter. The main thing to note is that each name-value pair should be on a new line. For each widget, details of the parameters are listed on a separate page.

The first bit of the Custom Field name (left) specifies whereabouts on the page the widget should be inserted (left or right). The second bit (the number) is used to specify the order in which the widgets appear in that particular page region (lowest numbers first). The last bit (post) specifies the type of widget to insert.

To swap the order of widgets, you will need to change the numbers used in the custom field name.

Shortcodes

To insert a post or widget into the main content area (if the particular widget allows for this), instead of a custom field you use a shortcode. The format is very similar to the custom field version, but this time the whole thing is on one line and enclosed in square brackets (which I can’t show here without WordPress executing the shortcode!)…

shortcode_post ids=205 show_title=true style=loud

Warning: One thing that shortcodes can’t cope with is a value string containing spaces. So if you try to specify something like…

heading=Latest newsthis won’t work.

Instead, you need to replace all the spaces with underscores…

heading=Latest_news – and this will work.

Page regions