News Item Form Content Managed Webpage Area Login

Contents

  1. Prerequisites
  2. Area Overview
  3. Area Formats
  4. Area Settings
  5. Dependent Configurations
  6. Recommendations

This document describes how a News Item Form area works when being displayed on a content managed web page within the TOTECS platform. This area allows users to create a News/Blog item and post it up to the server where it is assigned to a designated news/blog group. Additionally it allows users to modify an existing news/blog item that they had previously created.

Prerequisites

Please ensure that you have read and understand the following topic links before reading on.

Area Overview

The News Item Form area allows logged in users who are assigned to a content managed web site to have the ability to create a new News/Blog Item and save it to a designated News/Blog Group. Additionally they can modify existing items to update its content.

Using this area it allows users to post information up onto a content managed webpage, that could then be displayed to other users, or not at all.

The area displays a form with the heading, body, and spare fields that the user can set against a news/blog item. Once the user has submitted the form a news/blog item will be created, and it will be assigned to either the news/blog group defined in the area's setting, or based on the news/blog group ID that is set in the web page's URL that the area is displayed within.

After the news/blog item has been created an Email will be sent out to notify an administrator user that the item has been posted. This allows administrators to view the details of the new item, then optionally moderate and inactivate the item through the Administration Centre's News/Blogs interface if it is deemed unacceptable.

If the area is loaded on web page that contains the News/Blog item ID in the URL, and the user created the news/blog item, then the area will display and prefill the form fields with the values previously set for the news/blog item. This then allows users to modify the item and save its details upon posting the form again.

When the news/blog item's heading, body and spare fields are uploaded, the characters in the fields will be HTML escaped. This ensures that if the item is displayed on a web page that other users can see, that the posting user cannot inject malicious code into the web page and do nasty things like steal peoples data, or cause the web page to not display as it should.

Area Formats

The area contains the following formats:

News/Blog Item Post Form

This format displays once within the area if a news/blog group is assigned to the area, or a news/blog group ID exists in the URL. Additionally the group must be allowed to have users upload items to it. This format contains hooks that allow users to set the news/blog item heading, body, and/or spare field. If a field is omitted from the format, then the field will be set empty once the item has been created.

Layout of Formats:

News/Blog Post Form Format

Area Settings

Below are the following settings that can be configured through the area's editor when modifying the area in the Web Page Editor, within the Administration Centre.

Setting Label Description
Select News Group to Save Items to: Set a news/blog group that the new news/blog items are saved to when the item is created. If this setting is set to "Any News Group" then the news/blog item will be posted to the news/blog group based on its ID being set in the URL of the web page that the area is displayed on.
Select Page to display news items to: Set the content managed web page that users will be redirected to after the news/blog item has been successfully created. If the web page is set as the same web page that the area lives on, then any News/Blog Item or News/Blog Group Item Listing areas will dynamically redraw in page to allow the new news/blog item to be shown.

Dependent Configurations

In order for the the area to display news/blog item data the following configurations are required to be set up:

  • In order for the news/blog item to be posted against a news/blog group, the group must have the setting "Users Can Create News/Blog Items" set to Yes. This setting is available within the News/Blogs interface under the Marketing menu in the Administration Centre.
  • The Email address that the administrator notifications are sent to once an item has been posted is configured within the Administration Centre, under Online Store, in Organisation Settings page, in the setting labelled "Feedback and Enquiries Email".

Recommendations

  • Link this area with the News/Blog Group Item Listing area to allow users to navigate from news/blog groups to a form where they can add an item to the group. This allows community based forums, or discussions to take place on content managed web pages, which help boost traffic, benefits search engine optimisation, and so on.
  • Be careful to make sure that users can only post news/blog items to news/blog groups that they are allowed to, otherwise you could have users posting sensitive items infront of other users who should not be able to communicate.