Parameter is used to control options so that you can format and output macros. Parameter name used in the storage format or Confluence Wiki markup (wikimarkup) with the label name used in the macro browser is different, in the following we will be listed in parentheses ( example）.
| Content type displayed (Content Type to Display) (content) |
No |
titles |
Available values:
- the titles - display the title only in the blog page.
- Excerpts - short summary is displayed as the United States blog. If you have a blog that contains macros summary, then the macro will display the contents of the blog page blog summary. If the blog does not digest the macro, then the blog page will show the first few sentences of the blog.
- Entire - for each blog to display the full content.
|
Frame time (Time Frame)
( time) |
No |
Unlimited |
Find Confluence specified time range in the blog.
Available values:
m - minutesh - hours, if you specified as ' 12h', then add the latest blog will show 12 hours of.d - day, if you specified as ' 7d', then the blog will display the latest seven-day blog.w - Zhou |
Label limit (the Restrict to THESE Labels)
(label ) |
No |
None |
Through the label over the results. Macro will only display the specified label contains your blog, in other words, filter by label.
You can specify one or more tags by comma separator.
- If you want to extend the matching content labels, you can add a dash in front of the tag name (-). For example: If you specify a name for the label
-badpage you will find all the pages are not marked as 'badpage' label.
- If you want a particular page must contain a certain tag value, you need to add a tag value before the plus sign (+). For example: If you specify a label
+superpage，+goodpage you will find the page that contains at least two labels, and label these pages are included characters 'superpage' and 'goodpage'.
|
|
(author)
|
No |
None |
The results returned by filtration author. Blog page to your macro will only specify the author of the blog displayed. |
|
(spaces)
|
No |
@self For example, in the macro display space contains pages. |
This parameter allows you to filter content through space. If this parameter is used, it will display the blog page you specify space.
You can specify a delimiter by commas or more spaces.
- If you do not want to include a certain space, you can add a dash in front of the name space (-). For example: If you do not want to include a space BADSPACE, then you can use -BADSPACE definition.
- If you want your results must be from a certain space inside, then you can add a plus sign in front of the name space (+). For example: If you specify a name for the space
+GOODSPACE , you will get only come from GOODSPACE content. (Note: This feature is not necessary, because each blog have to belong to a space if the plus sign in front of a name space but also in other spaces in front of the name, then the mark will be ignored.).
Special value:
@self - Current Space@personal - All personal space@global - All sites space@favorite - all the space you marked attention@favourite - is the same as above @favorite@all - all the space Confluence site* — 与上面 @all 是一样的 当你指定一个个人空间的时候，请记住在个人空间名字前加一个波浪符（~）例如 ~jblogs 或者 ~jbloggs@example.com 。 |
|
(max)
|
No |
15 |
指定可以显示的的最大结果数量。请注意，在结果显示的时候，首先会对结果进行排序，然后在对结果输出的数量进行限制。 |
排序方式（Sort By）
(sort) |
No |
creation |
指定结果如何被排序。如果这个参数没有被指定的话，那么将会按照内容的创建时间采用降序的方式进行排序（最新的在前面）。
值：
- title — 按照标题字母排序
- creation — 按照内容被添加的时间进行排序
- modified — 按照内容被最后修改的时间进行排序
|
反向排序（Reverse Sort）
(reverse) |
No |
false |
选择将排序从降序切换到升序（最老的在前面）。与参数 排序方式（Sort By）结合使用，如果你不指定排序方式的话，这个参数将会被忽略。 在存储格式和 Wiki 格式中，可以使用边栏 true 来激活排序方式。 |
Wiki markup example
宏名称： blog-posts
宏内容：None
{blog-posts:content=titles|spaces=
@self
,ds|author=jsmith|time=4w|reverse=
true
|sort=creation|max=
10
|label=chocolate,cookies}
|
https://www.cwiki.us/display/CONF6ZH/Blog+Posts+Macro