2.4. Content types

Here we will explain the different content types found in ProsePoint, what they are used for, and how they relate to each other. We will begin roughly from the bottom up and provide a conceptual overview of each content type. The details of creating, editing and deleting each content type will be provided in the next section.

2.4.1. Page

A page node is used to store written content for a basic web page on ProsePoint. By default, a page node does not show authorship, date information or have comments, so it is best suited for content which rarely changes.

A very common use of page nodes is to show an "About Us" page.

If you are posting written content which does not need to be credited to an author, should not be dated, and/or should not have accept comments, then you are probably looking to create a page node.

2.4.2. Story

A story node is very similar to a page node but has additional features. A story node should be used to store written content when any of the following are desired:

  • Attribution of an author or source
  • A date
  • Comments (although comments can be enabled or disabled on an individual node basis)

A story node can display any of these optional elements.

If you are posting a news story, a blog post, or something similar, you are probably looking to create a story node.

Warning

If you are posting a news story or article, you must use a story node.

2.4.3. Image

An image node is used to store images such as photographs, figures, diagrams, and so on. Image nodes can be inserted into pages or stories.

ProsePoint has native support for images. What does this mean? When people think of images, they tend to think only of an image file. ProsePoint goes beyond this and treats images as nodes. This means you manage your images the same way you manage all your other content. Furthermore, image nodes have additional features which would not be possible if it were just an image file.

  • Image nodes have a title (which is distinct from the image filename)
  • Image nodes have a descriptive caption, and can be dated or show authorship (if your administrator has configured ProsePoint to do so).
  • Image nodes can be shown in different sizes ie. thumbnail, small, medium, large. These are automatically generated.
  • Image nodes can unpublished.

The power of natively managing images as nodes becomes more apparent when image nodes are inserted into pages and stories. Any updates or edits to an image node also affects any page or story ("the parent") which displays that image ("the child").

  • If you edit the child image node and use a different photo, that photo (or whatever size version you chose) will be updated in the parent page or story
  • If you delete the child image node, it will disappear from the parent page or story.
  • If you unpublish the child image node, it will also disappear from the parent page or story.
  • If you later republish the child image node, it will reappear in the parent page or story.

In all these instances, you do not have to edit the parent page or story. ProsePoint will take care of the changes for you.

2.4.3.1. Image file restrictions

Image files to be uploaded must be in jpeg, png, or gif format [1].

2.4.4. Source

A source node represents:

  • A person who is the writer of a news story, or
  • A source of a news story.

For the first case, a distinction needs to made between a writer of a news story, and an author of a story content item.

In ProsePoint, whenever a user creates a node or content item, whether that is a story, image or something else, that user is the author of that node. An author of a node can also be thought of as the owner of that node.

For newspapers, the source of a news story and the author of a news story may not be the same person. For example, Bob is the editor of a ProsePoint newspaper website, and Jane is a journalist in another city covering a particular news story. Jane composes her report and emails it to Bob. Bob then uploads the news story to his ProsePoint site.

For this news story:

  • Bob is the author because he created the node. The story is his node.
  • Jane is the source because she wrote the story. She deserves the credit for producing the story.

Furthermore, Jane may not even have a ProsePoint user account.

By distinguishing between the author and the source of a news story, ProsePoint accommodates for such a situation easily. It's just unfortunate that it may cause some initial confusion for a new ProsePoint user.

There are also some side benefits to this approach. Pseudonyms and fictitous writers can be handled. For example, you might have a journalist Jane who produces regular news stories, but also writes a weekly health column as Doctor Dorothy. For Jane's normal stories, the source would be Jane Surname. For her health stories, the source would be Doctor Dorothy.

And then when Jane goes on holidays, you can assign another journalist Mary to cover for Jane. Mary would create news stories with Doctor Dorothy as the source.

If your newspaper or magazine obtains news stories from a third party, you can create a source to represent them. For example, you might have a source node called Google News, or Associated Press, or even Guest Writer.

Note

Prior to ProsePoint 0.04, this content type was known as writer. For ProsePoint 0.04, writer was renamed to the more intuitive source.

2.4.5. Edition

An edition node is used to group selected stories into editions or issues of a publication.

Editions are identified by date, week, month, yearly quarter, or whatever label you wish to use.

Here are some examples. The edition identifier is bracketed.

  • MyLocal News (25th September 2008)
  • MyLocal News (22nd-28th September 2008)
  • MyLocal News (Christmas Eve 2008)

or

  • Cats (September 2008)
  • Cats (Vol 1, Issue 2)
  • Cats (Winter 2008)

The title of an edition should always be the same as the title of the associated publication. The only way to distinguish between editions of the same publication (aside from looking inside the contents of each edition) is by looking at the edition identifier.

An edition is associated with a publication series through a channel. This is explained in a later section.

2.4.5.1. Editions contain stories

An edition contains lists of story nodes, which are the stories to be published in that edition.

There are currently two lists in each edition, and they differ only in how they are displayed.

Headlines

This list contains stories which are more important and are presented with more prominence when the edition is shown.

If an edition is displayed in full view, Headlines stories are shown as a teaser with photo (if there is a photo).

If an edition is displayed in shortened teaser view, Headlines stories are listed by title.

Other Stories

This list contains stories which are less important and are presented with less prominence when the edition is shown.

If an edition is displayed in full view, Other Stories stories are listed by title.

If an edition is displayed in shortened teaser view, Other Stories stories do not appear at all.



[1] Future versions of ProsePoint may handle more image file types.