Authors occasionally need to have a look at a page as if they where in the role of a reader. The pretend-being-a user space property supports switching roles. With the use of the Web API Extension and the Bookmarklets Extension switching roles is now really easy!
The projectdoc Toolbox provides additional visuals for writers. For instance, every transclusion renders a box to make it obvious that information is transcluded from another page. There are also additional buttons for editing and - if you are using fragments caching - reloading caches manually.
If a author wants to have the page rendered as if she was a reader, the Pretend Being A property in the user space needs to be set to the value reader. Once set, the fragment of a page shown above renders link this:
The box with the extra widgets is no longer visible.
This short tip explains how the projectdoc Toolbox, the Web API Extension, and the Bookmarklets Extension support users to switch roles quickly using the pretend-being-a user space property.
This tip requires
| Add-on on the Atlassian Marketplace | Version | License |
|---|---|---|
| projectdoc Toolbox | 1.14+ | commercial |
| Web API Extension | 1.2+ | free |
| Bookmarklets Extension | 1.0+ | free |
User Space Properties
Each projectdoc document provides document properties by the use of the Document Properties Marker Macro. If properties are defined on the homepage of a space, these properties become space properties. While space properties may be set in any space, there are some properties whose definition is only allowed in a user's space.
The pretend-being-a space property is such a user space property.
To create a projectdoc homepage in your private space, add the Document Properties Marker Macro.
The properties Name and Doctype is mandatory for projectdoc documents. To turn your homepage into a projectdoc homepage add the Document Properties Marker Macro like this:
Using the bookmarklets will add the pretend-being-a property to the table of this page.
Pretend being a ...
The following roles are defined by the projectdoc Toolbox:
To pretend holding a role, you may edit the homepage of your user space and add the pretend-being-a property with a value of the desired role.
But
- changing to your homepage,
- switching to edit mode,
- changing the value,
- and then saving the page
is quite cumbersome.
Let's try to apply these changes with a simple REST call!
Bookmarklets
What would be most productive is an entry to the page menu provided by Confluence. But if not everyone needs switching roles, this menu will soon be cluttered. What would be more convenient is the option for each user to compile her own menu according to her specific needs.
Bookmarklets allow to create menus in the browser. These menus are personalized and may be exported from and imported into different environments. Typically browsers also allow to sync them.
So how will it look like to create a pretender bookmarklet? First of all: it is already provided once you install the Bookmarklets Extension. The bookmarklet is called Pretender.
The Bookmarklet Extension provides a Bookmarklet Editor. This is a simple Confluence page with some macros attached.
Simply select the bookmarklet you want to install to your browser and then drag and drop it to your browser's menubar.
Organize your Bookmarklets
Organize all your bookmarklets and projectdoc related links in your browser's toolbar.
