 | Redirection Notice This page should redirect to http://www.adaptavist.com/display/Plugins/Page+Family+Tag+Cloud. |
| Java 1.6 required Confluence needs to be running on a 1.6 JVM for this plugin to work. |
Overview
The page family tag cloud macro creates a tag cloud from labels attached to pages for specific page hierachy.
Usage
pagefamily-tagcloud
Parameters
| Parameter | Default | Notes |
|---|---|---|
| rootPage | current page (if applicable) | The page used as the root page of the search for labels to show in the tag cloud. You can provide just a title, or use the <spacekey>:<title> format. |
| includeRootPage | true | Should the labels on the root page be included in the tag cloud or only the labels on the descendant pages. |
| sort | label | The sorting to use for the displayed labels
|
| reverse | false | Reverse the order of the sorting |
| max | 25 | the maximum number of labels to display |
| labelLink | /label/%label% | Custom url that will be used as the link behind each label. The token %label% will be replaced by the url encoded label. |
Comments (21)
Feb 27, 2009
Steeve Cayla says:
Thanks for this new plugin. I had some problems to install it ... didn't have j...Thanks for this new plugin.
I had some problems to install it ... didn't have java 1.6.
Now it works, but I'd like to give you some feedback :
The fact that only labels from one space maximum (by specifying the rootPage to the space's homepage) is a little bit frustrating, we can get the same results with the popular-labels macro.
I understand that this plugin is intended to list only labels within particular pages starting from a particular root page. As so, we can get a summary of the labels used by a page and its children without having the parent's page labels.
Specifying a list of many rootpages fails. (I wanted to test with more than one space/page)
Do you think updating this plugin to a plugin which retrieves label from a list of spaces (space labels, team labels, and page labels) would be difficult using this new plugin as a basis ?
Used in conjunction with the forum (CB), it would be really useful to get tags from particulars (common) sections of a forum.
I'd like to add something else :
The output of this plugin is formatted just like popular-labels Atlassian plugin. This means you cannot customize the look of the tagcloud as all the styles are defined inline. A simple class on the ul and li elements could make it really customizable (see the modified popular-labels from the Schirmacher site to get an example).
Anyway, thanks Shannon for this plugin !
Mar 04, 2009
Shannon Krebs says:
Do you think updating this plugin to a plugin which retrieves label from a list...The way its implemented currently is very simplistic, I would probably look to improving the way the labels are counted from the index first so the page objects don't have to be loaded from the DB. Once that was done it would be relatively simple to make any number of queries to get the label information from any number of root pages.
Good point. Ultimately this is an open source plugin, so you are welcome to release a patched version of your own if you want, we'd try to include any updates in the next release. We do try to enhance the open source plugins here intermittently as a service to the community, but our work is mostly influenced by what clients are willing to pay for.
Mar 04, 2009
Steeve Cayla says:
Thanks Shannon for your answer. When I wrote my comment, the source wasn't ava...Thanks Shannon for your answer.
When I wrote my comment, the source wasn't available yet.
Do I need particular rights to commit on your svn ? Or something else ?
Anyway, I modified the file PageFamilyTagcloud.vm, just removed the inline style for the ul : now it's just <ul class="tagcloud">, and modified the li just like this : <li class="importance$labelCount.count" >. This way, the style fits the schirmacher styles, so everyone using the schirmacher popular-macro plugin can use your plugin without having to modify any more styles.
I perfectly understand. This is totally not a priority and I just wanted to give you feedback in order to improve this new-born plugin.
HTH
Steeve
Mar 04, 2009
Shannon Krebs says:
The source is in the Atlassian contrib repo so if you have commit access to ther...The source is in the Atlassian contrib repo so if you have commit access to there you are welcome to create a branch. For a plugin I'd prefer to see it include some default css that it needs rather then rely on people updating the Confluence css as well, merely from an ease of use point of view. But that could get a bit complicated providing the default stylesheet inline in the macro as well as allowing it to be overridden by the global css settings.
Oct 29, 2009
Dan Goren says:
I do think this is an improvement on Popular Labels however it would be really u...I do think this is an improvement on Popular Labels however it would be really useful to have the ability to exclude certain labels (e.g those implemented in order to invoke certain layouts, rather than actual content).
Nov 12, 2009
Mia Louise Rydahl Due says:
Hi Is it possible to add a tagcloud that only search within the pagefamily? Th...Hi
Is it possible to add a tagcloud that only search within the pagefamily?
That is, when I click one of the labels in the tag cloud, I will only get the results from the pagefamily, not results from the whole wiki!
Nov 12, 2009
Dan Goren says:
Does rootPage not do this for you?Does rootPage not do this for you?
Nov 12, 2009
Mia Louise Rydahl Due says:
No, when I click on a label in the tag cloud, I am suggested pages from the whol...No, when I click on a label in the tag cloud, I am suggested pages from the whole wiki.
My aim is to only see page results from within the page family in the space that I created the tag cloud.
Nov 12, 2009
Dan Goren says:
This is how I've done it: {pagefamily-tagcloud:rootPage=Parent Page Title} with ...This is how I've done it:
{pagefamily-tagcloud:rootPage=Parent Page Title} with Parent Page Title being the top parent in the page family.
Nov 12, 2009
Mia Louise Rydahl Due says:
I'm not sure if we agree on my challenge :-/ The above codes are perfect for sh...I'm not sure if we agree on my challenge :-/
The above codes are perfect for showing the tag cloud with labels coming only from the page family. The problem appears when I click one of the labels in the tag cloud.
Normally you would want page results from the whole wiki to appear when you click a tag in the tag cloud. But I just want page results from within this page family to appear when I click a tag in the tag cloud.
Is that possible?
Nov 12, 2009
Shannon Krebs says:
This should be possible now that confluence has then ancestor id field in the in...This should be possible now that confluence has then ancestor id field in the index by default but would require an update to the plugin.
Dec 16, 2010
Klaus Feldmann says:
It is long time ago, but it is still an actual demand that pagefamily-tagcloud f...It is long time ago, but it is still an actual demand that pagefamily-tagcloud follows the rule that it calls up only pages after a click on a label which are in the scope of the ancestor of the rootpage instead to show up all wiki pages again, that contain that label.
As far as someone srews into a space/pagetree it should exclude more and more content.
As it is now I end up with the whole Wicki again.
It has been mentioned that this plugin will get an update to meet those new confluence capabilities.
Did that happen and what parameter to use?
Jan 05, 2011
Keith Brophy says:
Hi Klaus, I have raised this issue on our internal tracking system, noting your...Hi Klaus,
I have raised this issue on our internal tracking system, noting your comments. When next we are looking at modifying the plugin, we shall review this improvement also.
Regards,
Keith
Jan 05, 2011
Klaus Feldmann says:
thanks Keith. You may raise an collection box for new feature requests for all ...thanks Keith. You may raise an collection box for new feature requests for all the guys who benefit from using Adaptavist plugins - I just think this would help to speed up developement as your guys dont earn money with freeware. What do you think about it – is that stupid?
Jan 06, 2011
Guy Fraser says:
Hi Klaus, We used to have 'donate' links on all our plugins but over a 5 year p...Hi Klaus,
We used to have 'donate' links on all our plugins but over a 5 year period we only received $13 USD of donations which as you can imagine wasn't sufficient to even cover the time of maintaining the 'donate' link :s
Jan 06, 2011
Klaus Feldmann says:
Ups… thats just a pizza and a burger in 5 years – so we learn at least out of it...Ups… thats just a pizza and a burger in 5 years – so we learn at least out of it that there are lots of people who take without exchange – which is for sure not rue for all mankind.
We could discuss this further, but this thread does not belong to this space and page.
Feb 11, 2010
Ole Kristensen says:
When will this be compatible with Confluence 3.1 that have been out for some ime...When will this be compatible with Confluence 3.1 that have been out for some ime now?
Feb 11, 2010
Shannon Krebs says:
If you are interested in testing it, please try the plugin in 3.1 (via a manual ...If you are interested in testing it, please try the plugin in 3.1 (via a manual upload) and let us know what problems, if any you find. We may just need to update the plugin meta-data on the repository rather then any code fixes.
We haven't had any time (or clients that wish to pay for the time) to test the compatibility of the plugin with Confluence 3.1 yet.
Feb 17, 2010
Ole Kristensen says:
After manual installation we just get this on Confl. 3.1: Error formatting ma...After manual installation we just get this on Confl. 3.1:
Feb 18, 2010
Chris Attewell says:
Hi, We've also tried this on 3.1.1 and are getting the same error message as Ol...Hi,
We've also tried this on 3.1.1 and are getting the same error message as Ole.
Cheers,
Chris.
May 11, 2010
Michael Kimber says:
Any news on when this plug-in will be supported in Confluence 3.1? I'm still get...Any news on when this plug-in will be supported in Confluence 3.1? I'm still getting the "Error formatting macro: pagefamily-tagcloud: java.lang.AbstractMethodError" error