Skip to end of metadata
Go to start of metadata

Overview

The my-favourite-pages macro lists the most recent favourite pages for a given user. In table format the user who owns the favourites also has the option to remove any of the pages listed.

Usage

{my-favourite-pages}
{my-favourite-pages:@self}

Parameters

Parameter

Required

Default

Notes

Bubbles Version

default

(error)

@creator

The username of the person whose favourites are to be displayed.

  • @creator - The creator of the page
  • @self - The currently logged in user
  • @owner - The user that created the space (useful for personal spaces)
  • username - A user name

1.0

spaceKey

(error)

 

Display the favourite pages from only the space specified. The following meta params can also be used:

  • @current - The current space
  • @personal - The personal space of the currently logged in user.

1.6

output

(error)

table

The output mode, table or list

1.0

showImg

(error)

true

Show images for the content, only relevant to table output mode.

1.0

count

(error)

 

Limit the number of pages displayed.

1.0

includePages

(error)

true

set to false to exclude normal pages from the list of favourite pages.

1.4

includeBlogs

(error)

true

set to false to exclude blog posts form the list of favourite pages.

1.4

includeTopics

(error)

true

set to false to exclude forum topics from the list of favourite pages.

1.4

none

(error)

 

The text to display if there is no favourite pages.

1.0

How do I mark pages as favourite?

Page favourites are a standard feature of Confluence - just click the (star) on a page to add or remove it from your favourites list as applicable.

Administrators can use the Page and News Favourites action to add and remove users page favourites.

If you're using Theme Builder, you can use the builder-favicon macro, menuitem macro and compound-menuitem macro to toggle the favourite status of pages.

See Also