Chapter 3. Tutorials

3.1. Publishing your first story

Warning

This tutorial is a work in progress and may contain inaccuracies. In particular, the screenshots have not been created, and likely won't be created until the relevant editing screens have stabilised. As of writing, this tutorial is reasonably accurate for ProsePoint 0.08.

Warning

If your ProsePoint website is not using the default theme, some pages may appear different from what's shown in the screenshots. Furthermore, the ordering of some fields may also be different.

This tutorial will lead you through a number of steps leading up to posting a news story, including creating a source node and inserting images. Many of the steps are self explanatory, so only interesting parts will be detailed.

Setup

Before you begin, please make sure you have the following available:

  • The text of your story (also known as copy).
  • An image or photo to upload, preferably between 500x500 and 1000x1000 pixels in size. This image should be available as a file stored on your local computer.

Note

If you don't have a passage of text handy, you can copy and paste the following paragraph one or more times. A lot of people do this.

Lorem ipsum dolor sit amet, consectetuer adipiscing elit. Maecenas non risus. Etiam consectetuer ipsum ac lorem. Suspendisse diam neque, dapibus non, placerat eu, feugiat sit amet, erat. Nulla facilisi. Donec vehicula. Nam sit amet metus. Suspendisse potenti. Fusce at tortor. Nullam non nisl at dolor lobortis vehicula. Fusce sit amet velit. Aliquam nulla. In turpis justo, accumsan feugiat, pharetra sed, tempus et, neque. Vivamus vitae magna quis sapien scelerisque pretium. Ut arcu ligula, condimentum vitae, cursus vel, bibendum a, quam. Phasellus quis orci. Cras ante metus, mattis eu, imperdiet ullamcorper, tincidunt a, libero. Nulla aliquet, metus id molestie egestas, metus magna tristique turpis, accumsan eleifend ligula pede ac metus. Integer tincidunt est ut dolor.

3.1.1. Creating a source

First, we will create a new source node to represent you. You don't have to do this step for every story you post, only when there is a new source or author.

Note

If you trying out this tutorial on a ProsePoint installation where you only have Staff access, you won't be able to create source nodes. In this case, you'll have to skip this step and use an already existing source.
  1. Visit the Create Source page
    • You can do this by using either the Navigation Menu or the Admin Menu.
    • If you choose to use the Navigation Menu, click on Create content, and then click on source.
    • If you choose to use the Admin Menu, select Content Management => Create content => Source.

      Note

      If you don't know what the Navigation Menu or the Admin Menu are, please have a look at Parts of a ProsePoint page.
    • You should see a page like the following:

      Screenshot: Create Source page

  2. Enter a name for the new source node.
    • You can use your own name for this.
    • For now, please ignore the other fields and values. They are all optional. You only need a name to create a source.

      Screenshot

  3. Click Save.
    • You should now see your newly created source

      Screenshot

3.1.2. Creating a story

Next, we will create the story node.

  1. Visit the Create Story page
    • Again, this can be done by using either the Navigation Menu or the Admin Menu.
    • If you choose to use the Navigation Menu, click on Create content, and then click on Story.
    • If you choose to use the Admin Menu, select Content Management => Create content => Story.
    • You should see a page like the following:

      Screenshot

  2. Enter a title and subtitle for the new story node.
  3. Leave the status as Draft.
  4. Select the channel(s) this story is to appear in. You can select more than one channel by holding down the CTRL key and clicking.

    Note

    If you are using editions for your channel, you should still select the channels for your story here.
  5. Enter a source for the new story node.
    • Enter the first letter of the name of the source you created in the previous stage. A drop down list should appear presenting the available options.
    • If you didn't create a source in the previous stage, try entering 'J' or 'M' and see what you get.

      Screenshot

      Note

      The textfield for the By field is known as an autocomplete textfield. You will encounter these a lot in ProsePoint. To use them, just enter the first few letters of what you're after, and a drop down list of available values should then automatically appear.
  6. Enter a date for the story.
    • Upon clicking in the Date textfield, a date selection calendar should appear (if javascript is enabled in your browser). You can either use the calendar to select your date, or you can enter the date in dd-mm-yyyy form yourself.

      Screenshot

  7. Enter the text of the story into the Body field.
    • You can experiment with formatting options (such as bold, underline, bullets etc.) if you wish.

      Screenshot

      Note

      Some formatting options (particularly tables and sometimes indenting) require the input format of the story to be set to Full HTML. To do this, click on Input format (just below the Body textarea) and select Full HTML.

      If you do not see Input format or a Full HTML option, then you do not have sufficient privileges to do this.

  8. Click Preview.
    • For now, please the rest of the options and scroll down to the bottom of the page to find the Preview button.
    • You should now see a preview of your story.

      Screenshot

    • Notice that the preview shows your story twice. At the top, it shows your story in teaser view. Below that, it shows your story in full view.
    • Previewing is an optional step. It is particularly useful if you find yourself clicking Save and then Edit a lot.
  9. Click Save.
    • You should now see your newly created story.

      Screenshot

3.1.3. Creating and inserting an image

Now, lets assume you forgot to insert your image, so we'll go back and edit your story to do that.

Normally, nodes in ProsePoint are created through a Create ... page. In this stage, we'll show you another way to create nodes that only applies for insertion of images and media files.

  1. Click on Edit to edit your newly created story.
  2. In the visual editor, move the cursor so it is just before the first letter of the first word of a paragraph.
    • Inserting an image causes a paragraph break ie. the surrounding text is broken into two paragraphs. Hence it is a good idea to insert at the beginning of a paragraph.
  3. In the visual editor, click on the tree icon (without the red cross).
    • This activates the image insert wizard as a popup window
  4. In the popup window, click on Upload a new image.
    • This takes you to an Upload image page. This page is very similar to the Create image, but with many extra options removed to keep things simple.
  5. In the Upload image page, enter a title, browse for your image file, and enter an optional caption.
    • These values apply to the soon-to-be-created image node.
  6. Click Save.
    • This will create your new image node and then take you to the Insert image node page.
  7. In the Insert image node page, fill in the fields as desired.
    • Image title, Caption, Size and Alignment are self explanatory.
    • Link Url is the destination web page that the image will link to. A destination value is suggested, but this is optional. If you leave this field empty, the image will not link to anything.
    • Link Target controls whether clicking on the image opens a new window for Link Url. If Link Url is empty, this setting has no effect.
    • Teaser Image specifies whether the inserted image should be shown in the teaser of the parent story. For more information, see blah.
    • The values on this page apply to the image insertion as it appears in the parent story. They do not have to be the same as the values of the image node itself.
  8. Click Insert into post.
    • This will insert your image into your story and close the popup wizard. You should now see the image in the visual editor.
    • Now you want to save your story.
  9. Click Save.
    • You should now see your story with the inserted image. (ToDo: Insert screenshot)

3.1.4. Marking as Published

After a couple of rounds of editing, your story is complete and ready for publishing. You need to mark your story as Published.

  1. Click on Edit to edit the story.
  2. In the Status drop down list, select Published.
  3. Click Save.

If your organisation's policy requires peer review of stories, then instead of marking your story as Published, you would mark it as Ready for review. Your peer, manager or editor would review the story and when all parties are satisfied, it is marked as Published.

Marking a story as Published does a number of things:

  • It allows the story to be viewed by visitors to your website (but if the story was not assigned to a channel, visitors will not be able to find it).
  • If the story was assigned to a story listings channel, the story immediately appears in the channel's story list. Congratulations, your story is now published.
  • If the story was assigned to a scheduled editions channel, the story does not immediately appear in the channel. Instead, it is now eligible for inclusion in an edition.

    When an edition's Headlines or Other Stories list is being edited, your story will now appear in the list of available stories that can be added.

    Your story needs to be added to an edition before it will appear in the channel. That is for another tutorial.