Widget Tag
++TOOLPANEL++
What It Does
The ++TOOLPANEL++ widget displays a kind of control panel to allow users to manipulate an article or get additional information.
Depending on your widget settings, the widget displays any or all of the following three elements. They always appear in this order:
- The main article image and caption (if any)
- The tool links: "E-mail this page" and "Printer-friendly page"
- Related links (if any)
This widget is similar to the ++BOTTOMTOOLS++ widget, although that widget does not include the main article image. To display only the main article image, see the ++MAINIMAGE++ and ++MAINIMAGETEXT++ widgets.
The ++TOOLPANEL++ widget is commonly used at the top of article pages, displaying the main article image before the visitor has to scroll down and also providing e-mail and print links if the visitor would like to review the article later.
The Markup Results
The ++TOOLPANEL++ markup is a block element that is displayed in one of two formats, depending upon your widget settings:
-
CSS2 Markup. This method is used if you have selected the "Use cascading style sheets (CSS) instead of tables" option in the site's widget settings. The widget is contained in a
<div>tag. -
Table Markup. This method is used if you have not selected the "Use cascading style sheets (CSS) instead of tables" option in the site's widget settings. The widget is contained in a
<table>tag.
Templates Using This Widget
You may use this widget only in article page templates.
Customizing This Widget
Users with webmaster or administrator accounts may customize this widget in the "Article Page Format" panel of the site's widget editor. To get there, click the "Widget Settings" link in the left-column menu of the Big Medium control panel. The following settings affect the ++TOOLPANEL++ widget:
- "E-mail this page" link leader This setting determines the character or icon (if any) that is displayed to the left of the "E-mail this page" link.
- "Printer-friendly page" link leader. This setting determines the character or icon (if any) that is displayed to the left of the "Printer-friendly page" link.
- Width of tool table (TOOLPANEL). This setting determines the tool panel width in either pixels or percentage.
- Alignment of TOOLPANEL widget. This setting in the "Article Page format" panel indicates whether the article should be aligned left, right or center.
- Include main article image in TOOLPANEL widget. Checking this option includes the main article image.
- Include e-mail and print links in TOOLPANEL widget. Checking this option includes the "E-mail this page" and "Printer-friend page" links.
- Include related links in TOOLPANEL widget. Checking this option includes the related article links.
- Main article image. These options set the height, width and maximum file size for the main article image.
- New windows: Open related links in new windows. Selecting this option in the "Link Formats" panel causes related links to open in a new browser window.
- Also include the edit icon in these article-page widgets... TOOLPANEL. Selecting this option in the "One-Click Editing" panel adds the one-click editing link to the
++TOOLPANEL++output. For more information, see the help pages for the++EDITPAGE++widget and for One-Click Editing.
Styles
The caption of the main article image is displayed in the "Image Captions" style. The e-mail and print links are displayed in the "Tool Links" style. Related links are displayed in the "Related Info" style.
Need more help?
For further assistance and documentation, visit the website of Global Moxie, the developer behind Big Medium.