I am writing a user guide for an application developed by my company. At the top of each page, I have used a status lozenge to indicate which roles in the application the page content applies to.
I thought this was a colorful and attractive way to do this.
Now, I want to create a Documentation by Role page (or set of child pages - 1 for each role). where a Patient Liaison, for example, can go and see all of the pages in the user guide space that apply to their role.
I am looking for something like the Child pages macro, where I could set the Parent page to the top page of the space and display the pages in a tree format, so the user can see where the pages fall in relation to their parent topics. The only thing that's missing is my ability to specify that I only want pages that have this specific Status on them.
I'm hoping someone here can help me out with this, so I don't have to go build a bulleted list for each role by hand. Is there some nice macro that I am not aware of or some other approach that you can think of?
I'm trying to avoid paying for a 3rd-party app (since I'm fairly sure my boss will go for the more cost-effective method of doing it by hand).
Thank you!
EDIT: Forgot to mention that I tried the Content by Status macro. For some reason, this returned only my 2 template files, rather than all the other pages I've used the Status I tested on. Also, this just gives you a straight list, rather than a tree with the structure.
Our cheap app can list pages with a selected page root. It is called Advanced Content Navigator for Confluence.
Here you can overview page statuses, overview whats changed and insert multiple macros if needed:
Give it a try, and contact me if you have extra needs we could deliver! :)
BR,
Balazs
Thank you for your response, @Balázs Szakál [META-INF]. My user document is not organized by user role, but by task, with a list at the top of the roles the page applies to (using a Status macro for display purposes).
If I could order the Content by Label macro output to be sorted by the order of my page tree (with child pages nested under parent pages), I would take the effort to go add the labels to each page.
I'm thinking that it will take less time for me to simply manually add a list of links to the applicable pages on each role page.
You must be a registered user to add a comment. If you've already registered, sign in. Otherwise, register and sign in.
Hey,
Filtering our page tree based on some data (status or label) is something we already considering. Can you verify my understanding, if there would be an option to show pages in the tree with specific label/status, that would solve your problem, after you would label you pages properly?
Would whitelisting be enough (name the labels you WANT to show), or blacklisting should be useful as well (list what you DONT WANT to show)?
Thanks in advance!
You must be a registered user to add a comment. If you've already registered, sign in. Otherwise, register and sign in.
I want to be able to show a page tree where the page contains one specific Status—Accounting Officer list shows a tree with all pages that contain the ACCOUNTING OFFICER Status. Basically, the Child Pages macro with an Include pages with Status parameter.
If a Label parameter is easier to program, I could add labels for each of the statuses on the page, but I don't actually want to show labels on the pages or give other users the ability to add labels that might affect the output of the macro.
You must be a registered user to add a comment. If you've already registered, sign in. Otherwise, register and sign in.
I found this Jira ticket about adding the Page Status to macros and added my use case for additional statuses on the page in a comment: https://jira.atlassian.com/browse/CONFCLOUD-74397
You must be a registered user to add a comment. If you've already registered, sign in. Otherwise, register and sign in.
What about Content by Label + Excerpt
Aggregate page:
Individual page (has all the right labels)
You must be a registered user to add a comment. If you've already registered, sign in. Otherwise, register and sign in.
Thanks, @Kristian Klima . In my edit, I should have said that I tried the Content by Label, not Content by Status. (I had already deleted this attempt from my page, but reverted and saw the correct macro name.) This only returned my templates, which makes me think that I included labels on the templates way back when I created them and only have the statuses on my regular pages (no labels).
Content by Label also gives a list that is sorted alphabetically or by created or modified date. I am looking for the tree structure to give readers a context for what topics the pages are related to.
You must be a registered user to add a comment. If you've already registered, sign in. Otherwise, register and sign in.
You must be a registered user to add a comment. If you've already registered, sign in. Otherwise, register and sign in.