Blog

You will require this information when you would like to create a blog section and populate it with blog posts.

Step-by-step guide to create a Blog section

  1. Navigate to the home page of your website (make sure that you are logged in, and that you have the appropriate editing privileges).
  2. Use the 'Add new' menu to add a new 'Section'.
  3. Name the section, and save the form.
  4. Once you have saved the section, you will be looking at your new section.
  5. Using the dropdown menu from your account name, in the top right of the page, on the edit bar, select 'Manage behaviours'
  6. You will now see a page with a list of available behaviours in a dropdown field, select 'Blog section'
  7. Scroll down and click 'Save' - the page will reload, and a notice will appear at the top confirming that the changes have saved, you can now navigate back to the newly created section, to begin adding content.


Step-by-step guide to defining the view of a Blog section

  1. Navigate to the Blog section, ensuring that you are logged in with the relevant editing rights and click 'Edit' on the edit bar at the top of the page
  2. You will see a form with eight tabs:
    1.  Content
      1. 'Title' - this is to give the section a title
      2. 'Short title' - this is to define a short title for the item that will show in navigation and define how the URL of the content is constructed
      3. 'Summary' - this is used as a description of what the section contains. This will be used in item listings and search results, as well as being displayed at the top of the section in certain display views
    2.  'Settings'
      1. 'Exclude from navigation' - if selected, this item will not appear in the navigation tree
      2. 'Hide the title' - if selected, the title will not be shown at the top of the page.
      3. 'Dropdown navigation' - if you are using the section for the top-level navigation on your Haiku site, you can use this field to define which items of content within the section are listed in a dropdown menu from the section tab. To show items, move them from the left box to the right box. You can also reorder them using the up and down arrow. Note: Make sure you select items before moving them across or up and down.
    3. 'Section'
    4. 'Media' - the documentation for the 'Media' functionality can be seen here
    5. 'Categorization'
      1. 'Categories' - use this field to add categories to the section for it to be reused across your Haiku site. You will first need to add the categories that you want to use in the Taxonomy. You can see the documentation for the Taxonomy here.
      2. 'Type' - use this field to add a type to the section for it to be reused across your Haiku site. You will first need to add the types that you want to use in the Taxonomy. You can see the documentation for the Taxonomy here.
    6. 'View'
      1. 'Blog path' - select path blog posts are looking in. By default, posts are taken from the current section only. Enter '/' for site-wide searching.
      2. 'Show images' - check this box to show the images for each item on the listing page
      3. 'Images position' - use this field to define where on the listing the images show in relation to the title and description
      4. 'Images ratio' - use this field to define which ratio of the images should be used in the Blog listing
      5. 'Default image' - use this field to define a default image that will be shown for items that do not have an image associated with them
      6. 'Listing item extra info' - use this field to define which information related to each item will be shown on the Blog listing page
      7. 'Select visible blog categories' - use this field to define which blogs are listed on the section listing using the categories that they are tagged with
      8. 'Select visible blog types' - use this field to define which blogs are listed on the section listing using the types that they are tagged with
      9. 'Select visible listing filters' - use this field to define which filters are available for users to filter and search the blog posts in the section
      10. 'Select listing filters position' - use this field to define where on the page the filters will display
      11. 'Show load more button' - if you do not use the load more button, pagination will be used after the number of items to load limit has been reached
      12. 'Show number of blog posts per tab/row' - if this field is checked it will show the user how many items there are int eh section/tab
      13. 'Enter the number of items to load' - enter the number of items to load at once or per tab. The minimum is 1, maximum is 50.
    7. 'Promoted
      1. 'Title for promoted section' - input a title that will show at the top of the promoted items
      2. 'Promoted blog posts' - use this field to search for and select the blog items that you would like to promote at the top of the section listing
      3. 'Listing: item extra info' select the attributes of the Blog posts that you would like to show in the 'Promoted' section
      4. 'Show images' - check this box if you would like to show the images related to the promoted items
  3. Don't forget to save your changes.


Step-by-step guide to portlets in a Blog section

Other than the usual portlets that you may wish to use in the blog section, there are three that are more likely to be used:

  1. Archive portlet
    1. To add a protlet that will show an archive of the blog posts, broken down by month and year, firstly navigate to your blog section landing page.
    2. Using the dropdown menu from your account name on the edit bar, select 'Manage portlets'
    3. Portlets on the blog section are 'Primary portlets'
    4. Using the 'Primary portlets' 'Add new' drop down, select 'Archive'
    5. Once you have selected the 'Archive' , it will take you to a page where the only field that you can edit, is the title of the portlet. Set this to what you would like it to be, and save the form.
    6. The archive portelt will now be added to the blog section. Note - it will only display once you have some blog posts in the section.
  2. 'Categories' portlet
    1. To add a protlet that will show a categories filter of the blog posts, firstly navigate to your blog section landing page.
    2. Using the dropdown menu from your account name on the edit bar, select 'Manage portlets'
    3. Portlets on the blog section are 'Primary portlets'
    4. Using the 'Primary portlets' 'Add new' drop down, select 'Categories'
    5. You will be taken to an edit form with the following fields:
      1. 'Title' - this is the title of the categories portlet.
      2. 'Display type' - this will default to 'Primary', this is picked up from where the portlet will be located, and should not be changed.
      3. 'Categories selector' - Using the drop down change this to 'Category type'
      4. 'Categories type' - Using the drop down, change this to 'Blog post'
      5. 'Request variable' - This will default to category, and should be left as it is.
      6. 'Results URL' - Leave this balank, unless you would like a user to be taken to a different page for the results of the search.
      7. 'Root path' - This should be left blank, unless you have more than one blog section. If you have more than one section, and you only want to display the categories that blog posts in this individual section are tagged with, you will need to provide the absolute URL of the section you are currently adding the portlet to.
      8. Once you have completed this edit form, save it, and the new portlet will be added to your blog section.
  3. 'Blog posts' portlet
    1. To add a protlet that will show a some of the blog posts, by popularity, in chronological order, or selected blog posts, firstly navigate to your blog section landing page.
    2. Using the dropdown menu from your account name on the edit bar, select 'Manage portlets'
    3. Portlets on the blog section are 'Primary portlets'
    4. Using the 'Primary portlets' 'Add new' drop down, select 'Blog posts'
    5. You will be taken to an edit form with the following fields:
      1. 'Title' - this is the title of the blog posts portlet.
      2. 'Posts' - if you want to show only some specific posts in this portlet, simply select them in this field, and shift them from the left box to the right box You can reorder them to show them as you wish.
      3. 'Visible fields' - you can use this field to select which fields related to a blog psot, show in the portlet.
      4. 'Categories' - you can define which blog posts show by selecting specific categories, by moving the ones that you would like to display form the left box to the right box. If no categories are moved to the right box, all categories of blog post will display.
      5. 'Limit' - this field allows you to define the maximum number of blog posts that will be displayed in the portlet at one time.
      6. 'Sort on' - this field allows you to choose from three different ways of sorting the blog posts:
        1. 'Date' - this will display the blog posts in chronological order.
        2. 'Popularity' - this will display the most viewed blog post at the top and the lesser viewed blog posts in order beneath.
        3. 'Selection order' - you will need to select this option if you have chosen which blog posts you are wishing to display on this page.

Step-by-step guide to create a blog post

  1. Navigate to your blog section (make sure that you are logged in, and that you have the appropriate editing privileges).
  2. Using the 'Add new' dropdown menu on the edit bar, select 'Blog post' - you will be taken to the edit interface for the blog post that you are creating.
  3. There are three tabs on the blog post edit interface. 'Default', 'Analytics', and 'Media'.
    1. Using the 'Default' tab:

      1. Body content fields

          1. This is a title that will be located at the top of the page, and in content listings. This will also define the URL of the item.

        1. 'Summary'

          1. This field is for plain text, that will show in search results and listings. This should be populated with a to the point description of what content the blog post contains. Use keywords to get better search results from search engines, and don't make it too long.

        2. 'Text'

          1. Enter text into the 'Text' box. You can then use the formatting options to present the text as you would like to, adding images, and other media as well, to create a well structured blog post.

        3. 'Authors'
          1. Use this multi selection box to select as many authors as you would like, to attribute the blog post to the author. If you select one author, their name and picture will appear, and will create a link to their profile. If you are attributing more than one author to a blog post, only the first person named will have their picture showing, but links will be made from all of the authors names, to their individual profiles. You can use the up and down arrows on the right side of the multi selection box, to manipulate who is the lead author.
        4. 'Related posts'
          1. This multi select box will only be populated, if you already have some blog posts in your blog section. If you don't already have some posts, it will be empty. The function of this selection box, is to allow you to display one or more posts that you would either like to direct the user to after they have read this blog post, or that you think they may find interesting if they enjoyed this blog post. Selecting a related post, will make sure that the selected post is shown in a highlighted box, under the main content of the blog post that you are creating.
        5. 'Categories'
          1. In this multi selection field, you will see the tags that you have created for the blogs posts on the website, in the taxonomy. You can select as many or as few tags as you like by highlighting them and moving them from the left side to the right side. The tags will show on the blog post, as well as enabling a user to search the blog posts by selecting a category from the list, on the section landing page.
    2. Using the 'Analytics' tab:

      1. The analytics tab is available for two reasons:
        1. This will tell you exactly how many times the blog post has been visited. This counter will show every single page visit, including logged in and logged out visits. If you would like to see pure external page views, to be able to accurately judge how blog post is performing to your stakeholders, we suggest that you use your Google Analytics account.
        2. When you are using the 'Blog posts' portlet, you are able to define whether the portlet lists the posts by date (showing the most recent X number of portlets), or by popularity (number of hits the page has received). The popularity sort order is taken from the number in this section of the edit form. Please note, you are able to change the number in this field. You have the ability to do this, so that you can either reset the counter for any reason you may wish to do so, or you can increase the number in this field, if you want to manipulate the results of the popularity listing.
    3. Using the 'Media' tab:

      1. Use the media tab to add a primary and or listing image/media to your blog post.


Step-by-step guide to allowing commenting on Blog posts

  1. Navigate to the commenting management interface in the site set up. Go to 'Site setup' in the editors bar, in the drop down menu under your name in the top right.
  2. In the 'Add-on Configuration' section click on the 'Commenting' button.
  3. You will be taken to a page titled 'Discussion settings', where you will see XXXXXX fields:
    1. 'Globally enable comments'
      1. This will be checked by default, and is required to be checked, if you want to be able to use commenting anywhere on your website.
    2. 'Enable anonymous comments'
      1. You will need to have this checked, if you want people who are not logged into your website, to be able to comment on content.
    3. 'Enable comment moderation'
      1. You will need to have this checked, if you want to approve all comments before they go live on your website.
    4. 'Enable editing of comments'
      1. You will need to have this checked, if you would like to be able to edit comments made by others. You may find this useful, if you want to edit a comment with a minor error, rather than just deleting it.
    5. 'Comment text transform'
      1. By default, this field will be set to 'Plain text'. We would recommend leaving it like this, as it is the most simple input form.
    6. 'Captcha'
      1. This field will determine if users are required to fill in a field that is only able to be filled by a human, not a computer, and therefore cutting out spam posts. To turn on the captcha, use the drop down menu to select 'Norobots'. Documentation on how to use the Norobots captcha functionality, can be found here. Note - this field will only display for external/logged out users.
    7. 'Show commenter image'
      1. If checked, a user who has a profile image associated with their account, will display this image next tho their comment.
    8. 'Enable moderator email notification' 
      1. If checked, every time there is a comment added to any post on your website, the specified email address/es, will get a message telling them there are new comments to moderate.
    9. 'Moderator email address'
      1. Populate this field with an email address, or multiple email addresses separated by a comma, that you would like to receive an email when a new comment is added.
    10. 'Enable user email notification'
      1. If selected, users can choose to be notified about new comments on the post that they have commented on. Note - they will have to provide their email address when commenting.
    11. 'Enable anonymous email field'
      1. You will need to have this selected, if you are using the 'Enable user email notification' functionality. Note - this field will only display for external/logged out users.
  4. Once you have configured the commenting set up, you need to activate it on your new blog section. To do this, navigate to your blog section, click 'Edit' on the edit bar, and on the 'Edit section' page, you will need to click on the 'Settings' tab. You will see the field 'Allow discussion', using the dropdown menu, select 'Yes' and save the changes.
  5. Commenting is now set up on your blog.

Moderating commenting on Blog posts

  1. Navigate to your blog section.
  2. If you have comment moderation on, no comments will ever display on a post, until they have been approved. There are two ways to manage the comments on the blog posts:
    1. Using the comment moderation interface.
      1. Click on your name in the top right of the edit bar, to show the dropdown menu.
      2. Select 'Moderate comments'
      3. You will be taken to a page where you can approve or delete individual posts, or be taken to the comment on a specific blog post. You will also be able to carry out bulk operations on comments:
    2. Moderation on individual blog posts.
      1. Navigate to an individual blog post.
      2. At the bottom of the blog content, you will see the comment. You have four options here; Reply, Delete, Edit, or approve.
        1. Replying will let you reply to the post, and this will be displayed underneath this comment slightly indented, to show that it is a reply.
        2. Deleting the comment will fully remove it from the site.
        3. Editing the comment will allow you to edit any of the comment.
        4. Approving the comment will add it immediately to the bottom of the blog post.