Plugin Blog

User manual

Create a new web blog

1. Go to sites configuration screen

2. Click on "Create new site"

3. Enter a name for you blog and clic on "Next" button

Create_Blog_1.PNG

4. Select "Blog" site type, and then click "ok"

Create_Blog_2.PNG

5. You are redirect on configuration screen. Fill and save configuration.

Sitemap generated automatically

On blog creation, a sitemap for each language is generated automatically.
The sitemap contains 5 root pages :

Name and path of pages depend on blog language.

Home page organization

The Home page is the main page of your blog. It is automatically composed of 4 areas

1. A central area with a resume of all published posts listed in reverse chronological order, with pagination
   By default, this element is inserted in the "default" area of your "blog" template.
2. An "about" area : a resume of author(s) 's profile.
   By default, this element is inserted in the "about" area of your "blog" template.
3. An "archive" area : a navigation on posts by dates
   By default, this element is inserted in the "aside" area of your "blog" template.
4. An "tags" area : a navigation on posts by tags or labels
   By default, this element is inserted in the "aside" area of your "blog" template.

The position of theses elements depends on your template.

Those elements can be moved or deleted by you.

Be careful, your modification will be applied to all posts pages. There is no way to simply reverse your changes, you will have to do it manually.

Home_Areas.PNG

Author's profile

The author's profile is a type of content.

Open the "About the author" page, and select the content in main area to edit it.

Create a new post

1. Click on New post button on Home tab or on Page tab to create a new post

New_Post_Button.png

2. Complete dialog

New_Post_Dialog.PNG

3. Edit your post.

Post_Edition.PNG

A post is composed by the following fields :

Tags can be added directly in content edition :

Tags.PNG

Virtual tree

The virtual tree is completed on each post creation. The pages associated to a post take place in sitemap according to the post's date and post's tags.

Virtual_Tree.PNG

Archives and categories

There is two way to navigate on blog posts :

• archives based on dates
• archives based on categories

In the "aside" area of your "blog" template, the archives and categories are automatically added.

Syndication

RSS feeds allow yours readers to be aware of new contents posted on your blog.

Two RSS feeds are available :

• feeds for last posts : http://\[server_url\]/plugins/blog/\[siteName\]/\[lang\]/rss/posts.xml"
• feeds for last comments : http://\[server_url\]/plugins/blog/\[siteName\]/\[lang\]/rss/comments.xml"

Syndicate.PNG

Favorites links

Use the content type "Links list" to add a list of your favorite web sites to your blog.
Such a content can be placed in the "aside" area (same area of archives and categories)

Bookmark.PNG

Comments

Comments is an interactive feature which allows users to comment posts.

A comment can be leaved by visitors on the page of a post, thanks to a form protected by captcha :

3_Comments_Form.PNG

Comments moderation

A site configuration parameter allow to choose the moderation policy on comments :

• Automatic approval : the comment is immediately online after form submission. You always have the possibility to edit or delete it.
• Needs approval : this policy allows you to prevent comments from appearing on your blog without your approval.

The CMS provides a tool to see and moderate comments of a post.

Select a post and click on View comments button to open the comments tool. From this tool you can edit, approve, reject or delete the comments.

Comments.PNG

Installation and download

Download

• Download JAR 
• Download Sources  

Installation

• Add the plugin JAR in the WEB-INF/lib directory of your Ametys application

• Blog is a new type of site, as such, it has a personalized ribbon, list of services, list of content types and workflow.

  In your WEB-INF/params directory of your CMS application, add the following files:

  • cms-ribbon-blog.xml : list of available controls in ribbon for blog sites
  • cms-uitools-blog.xml
  • content-types-blog.xml : list of available content types for blog sites
  • services-blog.xml : list of available services for blog sites
  • workflow-blog.xml : a simplified workflow for blog posts

• Edit the WEB-INF/params/workflows.xml file to add reference to new workflow name:

<workflow name="blog" type="file" location="workflow-blog.xml">

<workflow name="blog" type="file" location="workflow-blog.xml">

<workflow name="blog" type="file" location="workflow-blog.xml">

• Restart the server

Integration

Create a template "blog"

This extension needs that yours skins used by blogs provide a template named "blog" with three mandatory zones :

• a main zone named "default"
• a zone named "about"
• a zone named "aside"

You can download here a sample of blog template directory for Ametys demo skin (to be copied in templates directory of the demo skin)

Compatibility