Contents

Article List

Introduction

The Article List WYSIWYG Plugin is extremely flexible and powerful.  It is designed to allow the creation of dynamic lists of articles, which update automatically upon the creation of new Article Pages.  Article Pages include the following page types:

  • Article
  • Media
  • Wiki

 Note: When using Media pages in an Article List, the RSS feed becomes a Podcast RSS feed.

Follow Along with These Video Tutorials

 Overview

Use Cases

Editing

To insert an Article List, edit the draft of any page type, then use the PluginInsert button in the WYSIWYG menu; select the Article List Plugin from the list of available plugins.

List Settings

In the “List Settings” box, you have the opportunity to set your Topic/Bucket Page. If you select a page other than the current page, the page you are adding the list to will impersonate the page you select, and any settings for the list will be based on the selected page, not the current page.

The Article List List Settings default is the current page, and you can choose to make the list type a list of the Children and Featured articles (setting an article as a Featured article is done by an Administrator in the “Featured” tab), or you can list “Children”, or the pages nested under the current page, “Featured” or only the featured articles under the current page, or “All children”, which will list all the child pages of the current page as well as any nested pages of the child pages.

Popular Pages

The Popular Pages setting, when enabled, will prioritize by number of views the pages that appear in the list; this would be a useful tool for a “Most viewed” list to direct users to pages popular with other views. This setting can be sorted by audience, creating lists based on views by all people looking at the site, only the public, only non-members, only members, and only CMS users. By holding down CTRL you can select multiple audiences.

 

Filters

 

The Filters setting allows you to determine what will be in your list. You can use Web Experience settings on pages to generate lists based on Web Experiences, targeting your list to specific audiences. You can also use Web Topic and Web Segment to target specific topics or specific segments of the web population viewing your site. If a page is tagged with a specific Web Experience, Topic, or Segment, the page will appear in your list.

Selecting any of the “Prioritize by Web Experience instead of excluding non-matches” means that pages with the particular Web Experience you selected will appear first on the list, but pages without that web experience that still fall under the list parameters (such as a child page of the topic/Bucket Page), will be shown. The pages with the selected Web Experience will be shown first. This works the same for Web Topic and Web Segment.

Selecting Group by Web Topic will organize your list in groups by the Web Topics you've selected (this works for a single topic, but provides much more utility if multiple topics are selected). It will show the topics in your list, and then the pages listed under the topics. Also, if an article is selected under multiple Web Topics, and “Group by Web Topic” is selected, it will appear under the first web topic it is listed under.

Superseding Keywords, when entered, will generate a list that uses the Superseding keywords feature in the “General” tab in the WYSIWYG editor; these keywords set that page to be the highest priority for those keywords in a search or list, and so the list will be created using only pages with the entered keyword in their “General” tab.

When “Show Collection Article Pages” is selected, the list will show a collection page as well as the articles under the collection; since a collection page is merely a collection of articles with a list on the page, this may be useful for more direct navigation.

 
 

Display Settings

The Display Settings determine what the Article List will actually look like; you can sort by Date, by page (order in which the pages appear under the parent page), or by alphabetical listing. The dates of the articles can be displayed, and the article content can be used as a summary in the summary list. If this is checked, the entire article contents will be shown; for longer articles this may be impractical, but for short news updates it could be useful. If no articles are found, a text message may be selected to be displayed.

You can also set image width and height for any Page Icons used for the articles in the list. If the width and height are set to 0, no Page Icons will appear for the article list (this is a way to avoid the "No Image Available" placeholder for an article with no Page Icon).


The Display settings now support custom "title" HTML that appears when there are contents displayed for the list - this can be used to add a title to a list, while not displaying a title when the list is empty, in order to effectively hide the list when there is no content to display.

List Settings

The List Settings can be used to determine the structure of the initial page of the list. 

Do you want to show a summary of each event after the article title? Would you prefer a headline list, where only the title is shown? A mixed list will show the summary of some events, then headlines for the remainder. A box list will show up as a box with an even number of items that are separated by a border. Checking “show numbers” will number the articles. Mixed Rows is for the Mixed list; it determines how many rows will show up as summary rows in a mixed list, before the rows start showing up as headline lists.   if “Impersonate Article layout” is selected, the list will mimic the layout settings of the article, including headings and summaries.

 

Archive Layout

For the Archive layout, if the Navigation Settings are set to show links, a user can move from the initial list of pages in the Article List to the archive list of pages.  The layout settings function identically to the layout settings of the Initial Layout.  There is also the option of an Outer and Inner CSS ID, which are CSS identifiers for styling on the website; these can be left blank unless a specific style is desired for the list.


Navigation Settings

Navigation settings allow you to move between the initial list and the archive list. If "Show Links" is selected, navigation will be allowed to and from the archive list.  You can alter the text for the “More”, “Next Page”, “Previous Page” and “Return to List” links.

RSS Settings

The Article List plugin can also tie into the RSS portion of your Association's site, or make the Article List its own RSS feed. Clicking the Enable RSS Feed box will make the list its own RSS feed. You can name and describe your RSS feed, and determine where the RSS icon will be displayed, above or below your list. The RSS category drop-down allows you to tie your Article List into a pre-existing RSS category. An Administrator will have to enable the Article List in the RSS channel using the CMS, and once that is enabled it will show up in the specified RSS channel.

You also have the option of adding a Channel XML or an Item XML for more advanced formatting, but these are not required.


 

Saving

Make sure to save your list when you finish.  You can also preview the articles that will appear in your list by using the Preview button in the Plugin editor.

Website Output

Below are some examples of website output for article listings:

Summary List

Mixed List

Box List

Headline List (within a Callout)

Headline List grouped by Web Topic

Conclusion

The Article List plugin is a powerful tool for automatically displaying new content on the website and in RSS feeds.  It is particularly useful for article archives, on homepages, and in complex HTML scenarios, where non-technical users might otherwise malform code.

Contact this Author: < Nicholas Bott > nick@brycegroup.com