Working with the news module

Updated on 20-October-2016 at 10:16 AM

Business Catalyst End of life announcement - find out more details.

Using this module you can display in either a list view or a calendar view news items you create the the Admin console. When a visitor clicks an individual item, the news item or announcement is displayed on a separate page.

The workflow consists of the following steps:

  • Add the content of news items to the News module.
  • Insert links to the items in a page.

Business Catalyst automatically updates the list of links on the page when you add or remove items in the News module.

Add content to the News module

The News module acts as a container for news items.

  1. Select Modules > News, and click Add News.
  2. Enter the content of your news item or announcement.
    For details, see the tool tips next to the options.
  3. Click Save.

Display the news items on a page - the list and calendar views

The news items can be displayed in two modes, either as a list (which is controlled by the news list layout ) or in a calendar format. The calendar view does not have a specific layout, it is formatted as a basic table you can style using CSS.

To insert the list of news items on a page open the page in editing mode by selecting Site Manager > Pages and clicking the page in the tree view. If you have a large number of news items, consider creating a page for them.

  1. Place the cursor in the content editor where you want links to the news items to appear on the page.
  2. In the Modules tab of the Toolbox found on the right of the editor, select News > List of News
  3. Select what filter to apply using the Display Criteria drop down and then click Insert.
    Business Catalyst inserts a placeholder tag representing the news module. When you publish the page, links to the news items replace the placeholder tag.
  4. Click Publish or Save Draft.

To insert the news items using the calendar format you will need to:

  1. Place the cursor in the content editor where you want links to the news items to appear on the page.
  2. In the Modules tab of the Toolbox found on the right of the editor, select News > Calendar Format Items
  3. In the Select Display type you can choose to add only News, only Events or both News and Events to your calendar (see Let site visitors sign up for an event for more info about events) and then click Insert.
  4. Click Publish or Save Draft

Display the news items on a page - the AJAX enabled view

A neat feature you can use is the AJAX view. When you insert the news item list into a page using this view clicking an item in the list will not take the site visitor to the detail view of the item, instead, the system will load the item's body on the same page. Let's take a look at an example:

  1. insert the list of news items using the AJAX effect like so:
  2. the listing will look like this on the page:
  3. when you click an individual item, instead of being taken to the item's URL the system loads the entire body of the news item without leaving the page:

The news detail view

If you insert the news listing without the AJAX effect or using the calendar view after a site visitor clicks the item the detail view of the news item opens up. This view can be customised using the news detail layout .