Widget Tag

++QUICKTEASE:SectionSlug++
++QUICKTEASE:SubsectionSlug++

This widget uses a special syntax that includes the slug of the section or subsection for which you would like to display the quickteaser. For example, if the "Shotz Brewery" subsection of your "Laverne & Shirley" fan site has the slug shotz, the widget tag would be:

++QUICKTEASE:shotz++

What It Does

The ++QUICKTEASE:slug++ widget displays the top article(s) from the section or subsection whose slug you include in the widget tag. (The "slug" is the internal name for a section or subsection. For more on slug names, see the section slug help page). The result is a link to the main page of the section or subsection, followed by one or more links to the latest article(s) from that section or subsection.

For example, suppose your "Laverne & Shirley" fan site has a section titled "Shotz Brewery" (slug name: shotz), and the latest article in that section is titled "Life in the Bottle-Capping Division." The widget for ++QUICKTEASE:shotz++ would display as:

[In Shotz Brewery]
Life in the Bottle-Capping Division

The Markup Results

The ++QUICKTEASE:slug++ markup takes one of two forms depending on the following "Design and Layout Method" and "Page Header" settings in your site's widget settings.

• Strict HTML or XHTML, or the CSS layout option is selected. The ++QUICKTEASE:slug++ widget is a block element, enclosed in a <div> tag.
• Non-strict HTML or XHTML. With non-strict markup, the ++QUICKTEASE:slug++ widget is a block element enclosed in a <p> tag.

In both types of layout, if you have thumbnail images enabled for the type of link format used by the ++QUICKTEASE:slug++ widget (long-format or short-format, depending on your widget settings), you may encounter an alignment problem for html that follows the ++QUICKTEASE:slug++ widget.

The alignment problem occurs when the text of the last link in the list is not long enough to "clear" a right-aligned or left-aligned thumbnail image. As a result, any html following the widget will try to flow around the thumbnail image, creating an effect you may not want. To address this, it is recommended that you follow the ++QUICKTEASE:slug++ widget with a <div> block like so:

++QUICKTEASE:slug++
<div style="clear:both">&nbsp;</div>

Templates Using This Widget

You may use this widget in all of the following types of page templates:

• Homepage
• Main section page
• Subsection index page
• Article page

Customizing This Widget

Users with webmaster or administrator accounts may customize this widget in 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 ++QUICKTEASE:slug++ widget:

• Quick teasers. Number of articles in each quick teaser. This option in the "Article Counts" panel sets the number of articles to display in each section's quick teaser. For example, setting the number to 3 will display the top three articles from the section.
• Quick teasers: Don't include articles in a section's quick teaser if they are already diplayed…. Selecting any of these checkboxes in the "Article Counts" panel will prevent articles from being included in the quick teaser if their links are already included in the indicated portion of the site. These options are useful when you want to prevent duplicate links from appearing on some pages. If you use the ++QUICKTEASE:slug++ widget on the homepage, for example, you may want to prevent the quick teasers from including links that are already displayed on the homepage. For example, checking "as the homepage's spotlight article" will prevent an article from appearing in any quick teaser if the article is the homepage spotlight article. Likewise, checking "as the 'parent' section's spotlight article" will prevent the article from appear in the section's quick teaser if the article is the spotlight article on that section's main page.
• Quick teaser links (QUICKTEASE): Use long-format links. Checking this option in the "Link Formats" section tells Big Medium to use long-format links in the ++QUICKTEASE:slug++ widget. Otherwise, short-format links (just the linked headline) are used.
• Long-format links. If you use long-format links for the ++QUICKTEASE:slug++ widget, adjusting the order and content of long-format links in the "Link Formats" section will adjust the appearance of each article link in the ++QUICKTEASE:slug++ widget. See below for instructions on changing the order and content of long-format links.
• Display edit icon/link alongside links to articles. This setting in the "One-Click Editing" panel of the widget settings adds the one-click editing link to all widgets that display links to articles, including ++QUICKTEASE:slug++. The format of the link (icon, brief text, or both icon and brief text) can also be set in the "One-Click Editing" panel.

Changing the Order and Style of Long-Format Links

Users with webmaster or administrator settings may customize the appearance of long-format links in the "Link Format" section of the site's widget settings.

Long-format links are built from the elements indicated in the selection of pulldown menus listed under "Long-format links." The first pulldown menu shows the first element of a long-format link, the second pulldown menu shows the second element, and so on. You may choose any of these elements and put them in any order by changing the selections in the pulldown menus.

There are three types of selections available in these pulldown menus:

• Content. The types of content available to include in a long-format link are: headline/link, article description, publish date, byline and section.
• Separators. Separators are elements included to create space or other dividers between the content elements in a long-format link. They include: spaces, colons, periods and line breaks.
• Blanks. The first line of each pulldown menu is blank. Selecting a blank pulldown does not include anything in the link.

You can include thumbnail images as part of long-format links by selecting the "Include thumbnail image with long-format links" option and selecting the left, right or center alignment from the "Alignment of thumbnail image" setting. The height and width attributes of thumbnail images may be set in the "Image Sizes" panel of the site's widget settings.

The date format used in long-format links is selected in the "Date Formats" section of the widget settings.

Styles

The article links in the ++QUICKTEASE:slug++ widget are displayed in the "Headline Links" style. If the widget uses the long-format link presentation, the article description is presented in the "Default Body Text" style, the date is presented in the "Promo Dates" style, the byline is presented in the "Promo Bylines" style, and the section is presented in the "Section Links" style.

Need more help?

For further assistance and documentation, visit the website of Global Moxie, the developer behind Big Medium.