Plugin Blog


blog_48.png

Plugin Blog
This extension provides a new type of site to create blogs

Authors

Anyware Services

Most recent version

1.1.0

Tracking issues

https://issues.ametys.org/browse/BLOG

Download

Latest version 

  1. Presentation
  2. Screenshots

Presentation

This plug-in provides a new type of site "blog" to creates personal or communautary blogs

Features :

  • Main area with articles listed chronologically
  • User profile
  • Archives based on dates or on categories
  • Commentable posts
  • A list of links to other related sites
  • RSS feeds

Screenshots

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 :

Page name

Path

Description

Home

en/index.html

This is the main page of your blog

About the author

en/about.html

This page contains the complete profil of author(s)

Search

en/search.html

Page for search in posts

Years

en/years.html

Empty page. It brings the virtual tree of posts classified by year

Tags

en/tags.html

Empty page. It brings the virtual tree of posts classified by categories

Posts

en/posts.html

Empty page. It brings the virtual tree of posts

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.


Edit_Profile.PNG


4_About_Me.PNG

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 :

Field

Type

Description

Mandatory

title

text

title of the post

yes

subtitle

text

the subtitle of the post

no

post date

date / time

the date and hour of the post

yes

illustration picture

image

ilustration of the post, uploaded from your hard drive
or picked up from resource explorer

no

illustration text

text

alternative text for the illustration

no

content

rich text

the post's content

yes

tags

list of tags

a list of tags to categorize the post

no

enable comments

boolean

check box to allow comments on the post

no

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.

The archives' list allows to find
posts by year or month


Archives_Bloc.PNG

The categories' list allows to find
posts by theme or tag.


Tags_Bloc.PNG

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

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:

 

  • Edit the WEB-INF/params/workflows.xml file to add reference to new workflow name:
<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

Plugin version

1.0.x

1.1.x

Ametys 3.3.x


tick_16.png

 
Ametys 3.4.x 


tick_16.png