Changes for page Blog Application

Last modified by Gabriela Anechitoaei on 2017/11/27 15:29

From version 94.1
edited by Mohamed Boussaa
on 2017/06/02 18:29
To version 95.1
edited by Denis Gervalle
on 2017/06/06 10:20
Change comment: There is no comment for this version

Summary

Details

Page properties
Author
... ... @@ -1,1 +1,1 @@
1 -xwiki:XWiki.mouhb
1 +xwiki:XWiki.dgervalle
ExtensionCode.ExtensionClass[0]
Description
... ... @@ -29,6 +29,7 @@
29 29  == Creating a new Blog Post ==
30 30  
31 31  There are currently 2 ways of creating a blog post:
32 +
32 32  1. By going to the Blog's homepage and using the "Create a new post" input where you enter the post title and hit the "Create" button:(((
33 33  {{image reference="createBlogPostUI.png"/}}
34 34  )))
... ... @@ -37,46 +37,54 @@
37 37  )))
38 38  
39 39  == Post image thumbnail ==
41 +
40 40  {{info}}Since 9.4{{/info}}, an image thumbnail was added to blog posts in order to allow a more visual and appealing display of blogs posts and list of blog posts.
41 41  {{image reference="imageThumbnail.png"/}}
42 42  //Blog post image thumbnail//
43 43  
44 44  == Useful Macros ==
47 +
45 45  {{info}}Since 9.4{{/info}}, Blog Post List macro, post layout macros and Blog Post Create Macro are available, these macros can be used to query and display blog posts anywhere on the wiki.
46 46  
47 47  === Blog Post List Macro ===
51 +
48 48  The Blog Post List Macro is used to query and display blog posts anywhere on the wiki, based on some parameters, the results can be displayed using customizable post layouts.
49 49  
50 -====Usage====
54 +==== Usage ====
51 51  
52 -{{code}}{{blogpostlist blog="Blog.WebHome" category="Blog.News" published="yes" layout="full" layoutParams="displayTitle=false" limit="10" /}}{{/code}}
56 +{{code}}
57 +{{blogpostlist blog="Blog.WebHome" category="Blog.News" published="yes" layout="full" layoutParams="displayTitle=false" limit="10" /}}
58 +{{/code}}
53 53  
54 54  **Parameters definition**
55 55  
56 56  |=Name|=Optional|=Allowed values|=Default value|=Description
57 -|blog|yes|a document reference| |The  descriptor document of a blog (It should contain a document with a Blog.BlogClass object)
58 -|category|yes|a document reference||Either a given category or a category space (not mandatory, at least blog or category mandatory)
63 +|blog|yes|a document reference| |The descriptor document of a blog (It should contain a document with a Blog.BlogClass object)
64 +|category|yes|a document reference| |Either a given category or a category space (not mandatory, at least blog or category mandatory)
59 59  |published|yes|yes, no, all|yes|Limit results to published posts
60 60  |hidden|yes|yes, no, all|no|Limit results to hidden posts
61 -|fromDate|yes|string date||Limit posts to posts published starting from a given date. The format of the date is yyyy-mm-dd.
62 -|toDate|yes|string date||Limit posts to posts published before a given date. The format of the date is yyyy-mm-dd.
67 +|fromDate|yes|string date| |Limit posts to posts published starting from a given date. The format of the date is yyyy-mm-dd.
68 +|toDate|yes|string date| |Limit posts to posts published before a given date. The format of the date is yyyy-mm-dd.
63 63  |limit|yes|integer|10|Number of posts to display
64 64  |layout|yes|link,full,image|link|The name of the post layout macro that will be used to display the posts. The naming convention for the layout macros is: "BlogPostLayout${LayoutNameWithFirstLetterCapitalized}"
65 -|layoutParams|yes|string||Additional parameters of the blog post layout
71 +|layoutParams|yes|string| |Additional parameters of the blog post layout
66 66  |paginated|yes|yes,no|if the limit parameter is not provided the itemsPerPage is extracted from the blog descriptor|Used to enble/disable the pagination of the the blogPostList macro results
67 67  
68 68  === Blog Post Layout Macros ===
75 +
69 69  Blog post layouts are wiki macros created in order to customize the layout of blog posts. Currently 3 blog post layout macros are available: blogPostLayoutLink, blogPostLayoutFull and blogPostLayoutImage.
70 70  
71 71  ==== Usage ====
72 72  
73 -{{code}}{{blogPostLayoutFull reference="Blog.MyFirstPost" params="displayTitle=true|useSummary=true"}}{{/code}}
80 +{{code}}
81 +{{blogPostLayoutFull reference="Blog.MyFirstPost" params="displayTitle=true|useSummary=true"}}
82 +{{/code}}
74 74  
75 75  **Parameters definition**
76 76  
77 77  |=Name|=Optional|=Allowed values|=Default value|=Description
78 78  |reference|no|a document reference| |The document reference of the blog post
79 -|params|yes|string||Additional parameters of the blog post layout
88 +|params|yes|string| |Additional parameters of the blog post layout
80 80  
81 81  ==== Examples of post layouts ====
82 82  
... ... @@ -90,6 +90,7 @@
90 90  //The image post layout(BlogPostLayoutImage macro)//
91 91  
92 92  ==== How to configure a new blog post layout? ====
102 +
93 93  * Create the blog post layout using this naming convention: "BlogPostLayout${LayoutNameWithFirstLetterCapitalized}"
94 94  eg: SomePage.BlogPostLayoutMyLayout
95 95  * Configure a given blog to use the new layout
... ... @@ -96,7 +96,8 @@
96 96  ** Edit the Blog.BlogClass, and for the field postsLayout, add the new layout name to the static list (|myLayout=My layout)
97 97  ** Edit the descriptor of your blog, and in the BlogClass object, change the layout to the new one.
98 98  
99 -=== Blog Post Create Macro ==
109 +=== Blog Post Create Macro ===
110 +
100 100  The Blog Post Create macro is used to insert a post creation form anywhere on the wiki. The macro takes a blog descriptor document as parameter. The new blog posts will belongs to the blog specified in the parameter.
101 101  
102 102  {{image reference="blogPostCreate.png"/}}
... ... @@ -106,7 +106,9 @@
106 106  
107 107  In order to display the RSS Feed icon on your blog you have to add this line:
108 108  
109 -{{code language="none"}}<link rel="alternate" type="application/rss+xml" title="Blog RSS Feed" href="$xwiki.getURL('Blog.BlogRss', 'view', 'xpage=plain')" />{{/code}}
120 +{{code language="none"}}
121 +<link rel="alternate" type="application/rss+xml" title="Blog RSS Feed" href="$xwiki.getURL('Blog.BlogRss', 'view', 'xpage=plain')" />
122 +{{/code}}
110 110  
111 111  to the **Blog's Presentation HTTP Meta Information** text area. You can reach that by clicking on **Administration -> Administer Space: 'Blog Space Name' -> Page Elements**.
112 112  
... ... @@ -118,19 +118,19 @@
118 118  
119 119  It is also possible to customize the Blog application for specific purposes. You will need some Velocity knowledge to do this, so please check the [[Developer's Guide>>platform:DevGuide.WebHome]] for more information.
120 120  
121 -You can add / change blog categories on the http:~//<server>/xwiki/bin/view/Blog/ManageCategories page.
134 +You can add / change blog categories on the http:~/~/<server>/xwiki/bin/view/Blog/ManageCategories page.
122 122  
123 -A panel that lists all blog categories is also available. You can find it on the http:~//<server>/xwiki/bin/view/Blog/CategoriesPanel page of your XWiki.
136 +A panel that lists all blog categories is also available. You can find it on the http:~/~/<server>/xwiki/bin/view/Blog/CategoriesPanel page of your XWiki.
124 124  
125 125  == Screenshots ==
126 126  
127 -{{image reference="BlogPanel.png" /}}
140 +{{image reference="BlogPanel.png"/}}
128 128  //The Blog Categories Panel//
129 129  
130 -{{image reference="BlogArticle.png" /}}
143 +{{image reference="BlogArticle.png"/}}
131 131  //A Blog Article//
132 132  
133 -{{image reference="XWikiBlog.png" /}}
146 +{{image reference="XWikiBlog.png"/}}
134 134  //A Blog Main Page//
135 135  
136 136  {{info}}Since 9.4{{/info}}, Blogs panel is proposed to display all blogs sharing a same set of categories
... ... @@ -142,11 +142,11 @@
142 142  
143 143  {{info}}Since 9.2{{/info}}, users can observe the Blog Application in their notifications preferences:
144 144  
145 -{{image reference="NotificationSettings.png" /}}
158 +{{image reference="NotificationSettings.png"/}}
146 146  
147 147  Then, when a blog post is published, a notification is displayed on the top menu.
148 148  
149 -{{image reference="Notification.png" /}}
162 +{{image reference="Notification.png"/}}
150 150  
151 151  
152 152  
ExtensionCode.ExtensionVersionClass[103]
Release Notes
ExtensionCode.ExtensionVersionClass[104]
Release Notes
... ... @@ -1,0 +1,3 @@
1 +{{jira url="https://jira.xwiki.org" style="list" source="jql"}}
2 +project = BLOG and fixVersion = "9.4"
3 +{{/jira}}

Get Connected