Versions Compared

Old Version 11

changes.mady.by.user Tim Jones

Saved on

compared with

New Version 12

changes.mady.by.user Tim Jones

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

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, check the box next to 'Blog section behaviour'
  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.

        2. '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.

        3. '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.

        4. '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.
        5. '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.
        6. '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:

...