Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...


Knowledge Base

...

width10%

...

width65%

Search below articles:

Live Search
spaceKeyKB
sizelarge
additionalpage excerpt
placeholderSearch
typepage
labelssubspace,navigation,general

SubSpace Navigation for Confluence

Regarding versions starting with 3.0

Filter by label (Content by label)
showLabelsfalse
max50
spacesKB
showSpacefalse
sortmodified
reversetrue
typepage
cqllabel = "subspace-navigation" and type = "page" and space = "KB"
labelsaccessibility add-on confluence

SubSpace Plugin

Regarding versions 1.1 through 2.2.2

Filter by label (Content by label)
showLabelsfalse
spacesKB
showSpacefalse
sortmodified
reversetrue
typepage
cqllabel = "subspace" and type = "page" and space = "KB"
labelsaccessibility add-on confluence

General

Filter by label (Content by label)
showLabelsfalse
spacesKB
showSpacefalse
sortmodified
reversetrue
typepage
cqllabel = "general" and type = "page" and space = "KB"
labelslog-file add-on confluence

How do we support you

Info

If you have further questions please do not hesitate to add a comment with your question or to create a support request.

Column
width20%

Image Removed

...

width5%

130 Comments 

Jan 28, 2010

The {subspaces_tree} macro appear to be missing from the new 1.5 version of the Subspace-plugin. After installing it through the plugin repository the spaces-view on my dashboard at least it gave that error. Is this a bug or have the plugin changed so we are supposed to be using {subspace} with some parameters instead? In that case you should really say so in the documentation. I'm running Confluence 3.0.2.

Feb 01, 2010

Hi Svein-Magnus,
with release 1.5 the macro {subspaces_tree} was removed. But you can easily reproduce it by using the subspaces macro: {subspaces:style=list|sort=title}.
I updated the documentation to point this out more clearly. Sorry for any inconveniences.

Jan 28, 2010

I really like this plugin, partly because it is so simple to use and is understandable for users who may be daunted by the metadata2 plugin.

But we would really like to see one additional option: the ability to limit the displayed tree to a (user set) number of levels below the dashboard (ie below the spaces where parent = dashboard)

For our company, showing 3 levels below the dashboard is good. 

Showing 4 levels below the dashboard is not good, because some of the 3rd level subspaces contain hundreds of further subspaces.

We want:  dashboard>Level 1>Level 2>Level 3  and no further. 

We have valid reasons for the existence of subspaces below Level 3. We just dont want to display those subspaces in the subspaces tree.

If this is possible now, please tell me how   

Thanks,

Sean

Feb 01, 2010

Hi Sean,
thanks a lot for your feedback. Unfortunately the feature you are requesting is not supported at the moment. We will discuss it internally but I can't promise that it will make it into the next release.

Regards
Tino

Jul 13, 2010

We really needed this feature, so we solved it by using the following css hack

...

ul.treenode > li > ul > li > ul > li {
    display: none;
}

It's ugly, but it works in our case.

Feb 03, 2010

Is it possible to limit the output to a specific team?

...

we're using the refinedwiki theme which allows for categories and we'd like to limit the list to show only spaces in that category.

Thanks,

Matthew

Mar 03, 2010

Hi Matthew,

what do you mean by "team"? A category from the refinedwiki theme?

Nov 08, 2010

I do follow up this question as I like to get this answered too.

Its meant that Confluence spaces could get team labels under space admin and the above mentioned ""rw_category_wiki" is just team label name used by refined wiki.
What has been asked is to create a new parameter in subspaces that allows to include team as it is used on standard confluence dashboard, to show just a spacetree of a specific team – simply sayed: instead of "key" to get specific spaces use "team" to get specific spaces of a team.

Cheers

Nov 08, 2010

That would be a fantastic feature for Subspaces, especially in wikis which have hundreds of spaces.

Sean

Nov 22, 2010

We just created an Issue to your request. please see (https://studio.plugins.atlassian.com/browse/CSSP-38) .

Feb 03, 2010

I am using the Subspaces plugin, newest version 1.5. I've added #requireResource("de.communardo.confluence.plugins.subspace:subspace-resource") 
and

...

$helper.renderConfluenceMacro("{subspaces:addlink=true}")

...

...

$helper.renderConfluenceMacro("{subspaces:addlink=true}")

...

I added

{subspaces:key=DEV|addlink=true|sort=title|style=menue}

...

Why do I have to have the macro in the page to get the menu at the top to work? Also, when you edit a page the menu at the top 
changes to a plain list style at the top and doesn't stay as a menu like it should.

I would also like the main space to show in the breadcrumbs for the subspaces. How is this possible? This plug-in is extremely useful and I 
wonder why it is developed more?

Mar 03, 2010

hi - I have the same problem, is there any resolution?

Mar 03, 2010

Hi Robert,
Corey already created an issue for this problem. You can follow its progress here: https://studio.plugins.atlassian.com/browse/CSSP-2

Mar 03, 2010

Hi Corey,

about your question concerning the breadcrumbs: I created an isse for this feature at https://studio.plugins.atlassian.com/browse/CSSP-3. Does this cover your request?

Mar 04, 2010

Hi,

subspaces plugin with confluence 3.1.1 cant be embedded as described in the manual on this page.

The string $helper…does not exist in the customizable page layout. It has maybe been changed to a different macro to include teams in list view.

The subspaces macro works at any place, but you dont get it into the column on right hand of the dashboard.

Within RefinedWiki with subspaces just shows the same as the standard confluence macros without the structure of subspaces in list view.

The subspaces manual has to be updated to be able to use the plug in.

It could be also the case that the installation of RefinedWiki overwrites the preexisting templates.

I upgrade to 3.1.2 to see if this behavior is still the case.

Edit: 4. March 2010

Within 3.1.2 its the same behavior on confluence themes.

The subspaces plugin works in RefinedWiki, if embedded in the general theme layouts, but it does not show the sorted tag and it does show the hideen rw_categrie_(categorie tag label).

Subspaces plugin needs to be updated and the manual needs to explain how to get it now visible in dashboard.

Cheers,

Klaus

Apr 05, 2010

The menu bar worked great on all pages in 3.1x, by editing global layout exactly as per the instructions:

...

\#requireResource("de.communardo.confluence.plugins.subspace:subspace-resource")

and

...

$helper.renderConfluenceMacro("{subspaces:addlink=true\|sort=title}")

In 3.2, it only works on the dashboard.

It isnt visible on any other pages.

Reason?

Thanks,

Sean

CORRECTION: my mistake - I forgot that I had previously edited the main.vmd file for each theme to ensure the subspaces menu works properly. Once I did this to the (now bundled) doctheme 1.07, all was well.  :)

Jul 29, 2010

Hi Sean, you mean you made same changes that is described on "Navigation bar on every page" section to main.vmd file(s) on the server (so there is no confluence page to do these from GUI, I guess). I can see the menu within the pages seen with Global look and feel but not with for instance Documentation Theme. When i use "locate main.vmd" on the server, I can only find one main.vmd file under decorators/ folder.

Maybe that is the base file for main layout, which is source for every theme (? this is a guess actually, so main.vmd file on server but not the customized code that we make on confluence admin) and also the state which you will return to default from customized main layout.

This may be Confluence issue, I am customizing Main layout with Confluence admin but it is not applied to all themes (this is another guess)

Thanks,

seckin

Apr 19, 2010

Hello, I really like this plugin. But I have one problem when I want to specify a space key. I want the parent space to be displayed in the menu too (like if I dont define a key), not only his subspaces. Is that possible? Is it also possible to define more then one key? This would be reallly important.

Thanks

Jun 03, 2010

Hi Susan,

the feautures you are requesting are currently not supported by the plugin.

I created an issue at https://studio.plugins.atlassian.com/browse/CSSP-18 for your request about the display of the parent space.

Currently we are nor planning to support more than one space key, as this would make the use of the macro unnecessarily complex. Could you give a usage scenario that explains why you need this funtionality?

Apr 20, 2010

Hello,

I've now started using this SubSpace plugin, but I can't get correct dashboard rendering when using Internet Explorer 7 ou 8.

Not using Internet Explorer is not an option.

Any thoughts on this?

Thanks in advance.

Dec 21, 2012

Hi - do you know if this IE 7 and 8 issue was ever solved?

Also, what do you mean by 'dashboard' ?

Apr 21, 2010

I've installed the plugin, arranged some of my spaces, and modified the global template with the subspaces macro reference.

If I'm logged on the dashboard shows what I expect.  If I'm not logged on, the dashboard only shows the Demonstration space.  However the spaces that are missing are accessible without being logged on.  What am I missing here?

May 25, 2010

Hi!  I've installed SubSpace 1.5 on my test system here, running 2.10.4.  When I edit the global layout to read "subspaces:style=list|sort=title", I end up with a display issues on my dashboard.  It has the text "#htmlSafe()" above the Recently Updated section, and the links in that section no longer appear.  When I revert the line back to just "spaces", it appears fine.  Is there  another change I am missing?  Thanks!

Jun 03, 2010

Hi Tara,
could you provide a screenshot of this issue?

Jun 24, 2010

Hi, I've installed the SupSpace plugin version 1.5. On confluence admin, Supspace Configuration page you can define only one parent... Would it be possible to add multiple parents for a supspace? Maybe a workaround that I can apply myself?

reason is also related this discussion:

http://confluence.atlassian.com/display/DISC/Nested+Spaces

http://jira.atlassian.com/browse/CONF-1095

Thanks,

Seckin

Jul 22, 2010

Maybe I am just not able to find this feature, but is it possible to change existing spaces from being a "normal" space to being a sub-space? I have a lot of spaces in my wiki, and would like to restructure it by using this plugin.

Thanks,

Christian

Jul 22, 2010

@Christian: login to the Adminstration section of Confluence. Within that page, look for the Subpace Configuration menu on the left hand side. That's where you define the hierarchy. The suspaces menus/trees respect that hierarchy.

Jul 22, 2010

Hi Sean,

thank you for supporting Chrisian and helping us ;)

Judith

Jul 22, 2010

Thanks Sean,

I was looking in the space configuration, but not in the site configuration. Your hint helped.

Christian

Jul 22, 2010

Hi Judith and Tino,

My company would like to pay you to customise the SubSpaces plugin for our needs:

1. Instead of the greyed out "No Permission" message in the menus/trees, we need the space to not appear at all in the menu/tree. In other words, users will not see menu/tree items at all unless they have read permissions. I know this can cause issues if a user has permission to view a space in a lower heirarchy than a space the user cannot view, but that is the fault of the wiki admin - it's not the plugin's fault. So we cant identify a need for showing "No Permision" - our users come from different companies which all use the same parent spaces, but different subspaces. We dont want one company to see another companies sub spaces, even if they are greyed out as "No Permission".

2. As per my post above from 28 January, we need one additional option: the ability to limit the displayed tree to a (user set) number of levels below the dashboard (ie below the spaces where parent = dashboard). For our company, showing 3 levels below the dashboard is good. Showing 4 levels below the dashboard is not good, because some of the 3rd level subspaces contain hundreds of further subspaces.We want:  dashboard>Level 1>Level 2>Level 3  and no further. We have valid reasons for the existence of subspaces below Level 3. We just dont want to display those subspaces in the subspaces tree.

Assuming the cost is fair, we are willing to pay for this development work....and we wont mind if it is then made available to the Confluence community for free.

I sent an email about this to Tino yesterday.

Thanks,

Sean

.

Aug 02, 2010

Is there any way to set the order of sub-spaces in the same level?

Currently, I have the following sup-spaces in the following order:

6.x

7.x

Archives

_________________________

I want them in this order:

7.x

6.x

Archives

Aug 19, 2010

Hi Robbie,

thank you for your comment. There is no possibility to order the sub-spaces manually at the moment. There exists an issue targeting this problem. (https://studio.plugins.atlassian.com/browse/CSSP-12)
Besides, the spaces can be displayed ordered by "creationdate", "modificationdate" or "title". To show the spaces in your desired order it would be the best to edit the space details accordingly and to display the spaces with a macro like {subspace:sort=modification}

Best regards,
Bill

Aug 24, 2010

Thanks for replying! I've voted for that issue. I found the {subspace:sort=title/modification/creation} macro under Confluence Admin > Layouts > Global Layout. However, that affects all spaces. Should I be adding this somewhere else? The only place I can find that talks about Space Details is under the Space Admin, which doesn't provide anywhere to edit/add the macro.

Aug 04, 2010

Hi,

I've found a small bug. You a referring to a help-file that does not exist.

By opening the notation guide you can find the following error in the log-file:

org.apache.velocity.exception.ResourceNotFoundException: Unable to find resource 'communardo_plugins/displaysubspace/displayspacehierarchie_navbar/subspaceslistmacro-help.vm'

Best regards,

Michael

Aug 19, 2010

Hi Michael,
thank you for your comment. The resource 'subspaceslistmacro-help.vm' is missing.
I created an issue (https://studio.plugins.atlassian.com/browse/CSSP-19) for your request.

Best regards,
Bill

Oct 25, 2010

Recently I got some support requests concerning the plugin. Below you find my answers, maybe this helps people who have similar questions.

Q: What happens if we upgrade Confluence and the plugin stops working?
A: It is not likely that you upgrade Confluence and the plugin stops working. We are testing the compatibility of our plugin for each version of confluence. If it is not working with a confluence version we are providing a new version of the plugin that fixes this issue.

Q: What happens to the sub spaces if we decide to remove the plugin at some point in the future?
A: The plugin provides functionality to organize spaces hierarchically in spaces and sub-spaces. The relationship between the spaces is rather lose, since the plugins focus is on structuring a wiki and its spaces. Since the sub spaces are normal spaces the plugin can be removed without any problems. The (sub) spaces will be listed like all other spaces on the dashboard.

Q: How do I get the relationship between a space and subspace in the confluence db. What tables do I query to get this information?

Confluence stores that information in a table named "os_propertyentry". This table stores arbitrary properties for all confluence content objects e.g.: pages, comments and spacedescriptions. To store the parent relationship for a space, its an entry for its space description is stored in this table.
So if you want to know which space description objects have parent spaces just query the database table os_propertyentry for entries with the entity_key 'metadata.Parent':

SELECT o.entity_id, o.entity_key , o.text_val
FROM os_propertyentry o
WHERE o.entity_key = 'metadata.Parent' ;

The relation between spaces and space descriptions is stored in the table "content" which contains information about all confluence content objects. Finally the table "spaces" contains information about the spaces in confluence like their name and their spacekey. The following example MySQL query hopefully explains those relations:

SELECT s.SPACEID, s.SPACEKEY, c.CONTENTID, c.CONTENTTYPE, o.entity_key , o.text_val
FROM content c
JOIN os_propertyentry o ON (c.CONTENTID = o.entity_id)
JOIN spaces s ON (s.SPACEID = c.SPACEID)
WHERE
c.CONTENTTYPE = 'SPACEDESCRIPTION'
AND
o.entity_key = 'metadata.Parent';

(The "entity_key" column of the result contains the "metadata.Parent"-key and the "text_val" column the parent spacekey string.)

Nov 03, 2010

Hello,

just installed that plugin into confluence3.3.3 and using doc-theme.

I wrote a user-macro to get the current spacekey to include all subspaces of the current space.

usermacro is:

{subspaces:addlink=true|style=plain|key=$space.key|maxDepth=1|sort=title|displayEmptyMessage=false}

Edited the global left-navigation panel of doc-theme with:

{usermacroforspace}

What i get in a space is:

script type="text/javascript" language="JavaScript">     var contextPath = '';

After that message, the subspaces are shown.

What to do to solve that issue?

Nov 08, 2010

Hello,

thanks for your detailed description. There is an Documentation-Theme-Issue that descripes this behavior (https://studio.plugins.atlassian.com/browse/DOC-21). It seems that the Documetation Theme not allows inline javascript. To help you out, please see https://studio.plugins.atlassian.com/browse/CSSP-35. This should work for you.

Nov 12, 2010

Hello,
I am currently using the basic Confluence Theme and I installed the Subspace Plugin in order to add space hierarchy and use the wonderful menu bar implemented by the plugin. But with the version 1.6, it doesn't display a menu bar for spaces/subspaces anymore. Furthermore, the subspaces macro, in its list display modes, adds bullet points to the formatting.

To quote your warning:

The HTML structure and CSS of the subspaces menu, generated via

{subspaces:style=menue}

has been changed in the current release 1.6. This may have effects on customized themes.

How can we achieve the same result as the previous release of your plugin? Is there a fix in the works?

Thank you,
Karim

Nov 19, 2010

Hello Karim El Alaili,

to reproduce the behavior of your confluence we need the version number of your confluence installation. Which browser do you use?

Nov 16, 2010

Hi everyone,

Just beginning testing this plugin. Seems really promising!

I have one question: is it possible to toggle on/off the main space that has sub spaces ?

This option will merely be accessible through the admin panel to permit toggle on/off of selected main space.

Thanks for the help

Michael

Nov 22, 2010

Hello michael regelin,

ich hope i understand you in the right way. You want to have a little switch in the subspaces administration to decide what space will be shown. Unfortunatelly, there is no such function in subspaces plugin right now. But we will discuss your suggestion.

Nov 22, 2010

Hi Sandro,

Yes, you're right.

The idea is to have a personal token to toggle /on/off a whole space branch. This is usefull when you have more than 100 spaces. This should not be the same as preffered or team space regroupment.

Sincerly,

Michael

Dec 15, 2010

Hi, thanks for providing this plugin, very useful. I had a question though: :)

I've been struggling since some time to retrieve the information "what is the parent space of this parent". I'd need it to build custom navigation display depending on the space "family".

(in short, I build  documentation for products, each one having an "overview" space then one child space per development version).

I peeked at the code and saw that you built a SpaceHierarchy class. Although I didn't understand much more, as I'm not a developer.

Would there be any way to access this class and its methods through Velocity? (Although I don't know how to build a plugin, I'm now familiar with calling objets/methods in Velocity through Confluence API).

   Thanks in advance for your help!

     Best regards,

       Laurent Lacôte

Jan 05, 2011

Hello Laurent Lacôte,

Currently there is no way for you to access the the space hierarchy by velocity. But if you only want to do some styling on the resulting html, you can use the classes at the "li" elements.

Example:

Each "li"in the menu should look like this.

<li style="..." class="space-testspace1">

With this you can define a Style sheet to specify an other style for the childrens of this "li" element.

li.space-testspace1 > ul {
    backround-color: black;
}

Jan 18, 2011

Hi Sandro,

thank you for your reply. Unfortunately, it's not the styling which I want (I already do what you proposed in fact ^^), but I'd like to get my hands on your custom property "space-parent" (one use-case for us is retrieving the "siblings" of a given space).

Well, you confirmed that it wasn't accessible in Velocity for now.

Fortunately, I could ask for help from a colleague. We'll try together to read your code and develop a plugin that would retrieve the wanted value from your classes.

When we manage to do so, we'll try to expose it in Velocity. In case you find this interesting, we'll be glad to share our code.

  Anyways, until then, keep up the good work!

    Best regards,

      Laurent Lacôte

Jan 13, 2011

I'm a System administrator, but when I try to move a space to have a new parent space I receive the following message:

"You are not permitted to perform this operation."

Does anyone know why this might be happening?

Feb 14, 2011

Hello,

It seems there is a Bug in Permissions checking during parent space changing. 
A bug regarding this issue has been created (https://studio.plugins.atlassian.com/browse/CSSP-45). Meanwhile, it should help assign you to the confluence-administrators group.
Thanks for your help.

Jan 20, 2011

Hi all, 

Is there a way to list all the pages under a subspace using the subspace macro? I want to put this on every home page of the parent space.

For example, for a space called Book i want to have the following on Book's home page

- SubSpace1
|_ page 1
|_ page 2
|_ page 3

- SubSpace2
|_ page 1
|_ page 2
|_ page 3

etc.

I used the subspace macro to do this, but looks like it can only list out subspaces under a space and not pages in the subpaces.

Any help is appreciated.

Thanks

Srizzel

Feb 14, 2011

Hello,

yes you are right, the subspaces macro can only show the hierarchy of spaces. 
Currently, we don't have plans to support pages in the space tree because you can add the pagetree itself as a more detailed level at the home-page of each space.

Kind regards Sandro

Feb 11, 2011

Is there any way to clone permissions from parent when creating a subspace ?

Feb 15, 2011

Hello Benjamin DUPUIS,

cloning the permisssion during the subspace creation isn't supported, because the spaces itself are logical independent from each other. 
With subspaces you only give them a hierarchically relationship.

Kind regards Sandro

Mar 23, 2011

Hi,

i installed the macro and works fine for us. But currently i have one problem. I added 

$helper.renderConfluenceMacro("{subspaces:addlink=true|currentSpace=$spaceKey}")

to the main layout. But now, i only see the bar on the dashboard and on spaces with "Easy Reader Design". When we use "Documentation Theme" the bar is hidden. Any ideas?

Regards

Frank

Mar 24, 2011

Hello Frank,

the "Default Theme" and the "Easy Ready Design" using the same decorator files you have edited to have the menu on every page. The Documentation Theme using its own internal decorator Files with some placeholders in it. The "Documentation Theme" Configuration Page allows you to enter wiki code for the "header", "navigation" and the  "footer" area. So if you enter the wiki code "{subspaces:addlink=true|currentSpace=$spaceKey}" in the "header" area you have a menu on every page. Unfortunately, you don't have the menu on the dashboard.

An other solution is to write your own confluence Theme based on the documentation Theme sources. In this case you have the free choise where you want to insert the subspace menu.

Kind regards,

Sandro

Mar 24, 2011

When I add you wiki text in my header I do get a very nice menu, but just above it I see the following text:

script type="text/javascript" language="JavaScript"> var contextPath = '';

Any idea why that is happening? I do love the menu!

Mar 24, 2011

Never mind! I found your fix. Works great, thanks :-)

Mar 24, 2011

Hi,

the answer is simple, but you couldn't know before trying. :)

When you are on the dashboard, Confluence parses the "main.vmd" file that is on the filesystem and that you modified.

However, the Documentation Theme uses its own vmd files, embedded in the plugin. As for me, I had the same need as you (both Documentation's sidebar and Subspaces plugins).

I found two solutions for a non-technical, either :

1. Follow tutorials on the net to build a template, similar to the Documentation Theme. See for example Atlassian doc, http://confluence.atlassian.com/display/DOC/Adding+a+Navigation+Sidebar

  + reasonably easy to set up, nice tutorial

  + navigation sidebar with freely customizable content

  - lacks other features of Documentation theme (hideable sidebar with button, resize sidebar, add page-specific header and footer).

2. Download the Documentation Theme plugin, extract it, retrieve the templates (main.vmd, page.vmd and css) and adapt them as you wish (you must be using the "Default Theme" to customize templates).

  + Build your visuals on solid base

  + Benefit from all Documentation Theme features (resizeable, non-table based template, etc...)

  - Requires permanent access to Documentation THeme resources >> must stay installed and enabled

  - Requires copy of Documentation Theme images in a dedicated folder on filesystem, and adaptation of css to point to them.

  - VERY DIRTY WAY to do (although it's the one I chose... for now) : you don't have control on "dependencies", and your theme could break on upgrading.

The very best way to achieve what you want, would be to build a Confluence plugin, taking inspiration from the Documentation Theme.

  Anyways, hope this will help you.

    Have a nice day!

      Laurent Lacôte

Mar 29, 2011

Thanks for your reply, Laurent. I added the menu and for now it's on all pages except the dashboard. I think I can live with that. I'd like to stick with the default documentation theme if possible, so I don't have to worry about breaking it with updates, etc.

I am considering creating a new dashboard page as a workaround...but I'm going to wait until after upgrading to 3.5. The space categories feature looks sweet, and combined with subspaces will be very helpful for people who are less familiar with wiki structure.

Jul 07, 2011

Laurent, thanks for the options. I'm trying to implement 2, but I don't quite understand the concepts. Are you saying you replaced the default "main.vmd" and "page.vmd" with the code of the same files from the Documentation Theme? I've pulled up the "main.vmd" in a file comparison tool and they seem pretty different. Do you have a blog or write-up with more specifics anywhere?

Apr 07, 2011

Hi there.

Is there a possibility to DENY the space administrators the creation of subspaces?

I couldn´t findy any hint about this, only the info that space administrators can (always) create subspaces under their space. This even works if the person explizitely is not allow over the confluence admin panel to create spaces

Does anybody have any infos or tipps in this matter?

Kind regards

Sascha

Apr 07, 2011

Hi,

currently you are not able to deny the creation of subspaces for space admins. But a new ticket CSSP-55 has been created to change this behavior in future releases.

Apr 08, 2011

Thank you very much for your quick response.

I´ll watch the ticket than.

Kind regards

Sascha

Apr 18, 2011

I had the same issue and found the following solution :

In the file ..\confluence\template\includes\menu-macros.vm, locate the macro "menuMacros_renderLeftNavMenu" and add the 2 lines starting with ">>"

#foreach ($item in $displayableItems)
            #set ($itemRenderedUrl = $item.link.getDisplayableUrl($req, $action.webInterfaceContext))
            #set ($itemLabel = $item.label.getDisplayableLabel($req, $action.webInterfaceContext))
>>          #if ($itemLabel != "Create a sub-space")
            <li #if($item.key == $selection) class="active"#end>
                [ ... ]
            </li>
>>          #end
            #end

Apr 19, 2011

Thank you very much.

This is a suitable workaround for me.

Regards

Sascha

Apr 08, 2011

Hi

What exactly are unique per subspace. It seems that labels are unique per sub-space - it is therefore possible to use the label "usability" in sub-space A and in sub-space B - and the labels are two separate labels - which is great. I have tried however to add a page - and then got an error saying that the page name already exists in the space - it seems therefore that page names are not unique per sub-space - which in unexpected. Are we doing something wrong or is this the way it is?

Apr 11, 2011

Hi Chris,

the subspace plugin only tells each space if there is a parent space where it belongs to. That means a subspace simply is a normal confleunce space. And in confleunce a page have to be unique in a space. that means you are able to create a page named "test" in each space. 

Kind regards Sandro

Apr 11, 2011

Thanks. Problem solved - we were creating a page in what we thought was a sub-space - but it wasn't actually

May 31, 2011

I want to see space structure in breadcrumbs in spaces, using documentation theme. So i added 

The Subspace menu works perfectly, but i don't see anything in breadcrumbs. 

Any hints?

Jun 01, 2011

Hello,

the issue you descripe has already been recorded (CSSP-56). I think we get it fixed in one of the next versions.
Anyway, thanks for your description.

Kind regards,
Sandro

Jun 16, 2011

Hello,

I use Confluence 3.5 and Subspace plugin 1.7.1.

I made all the changes explained above in Global and Main layout files. I use Documentation theme.

When I search after a text that appears in many pages ( so the pagination area appears in search result page) I cannot see the search result from second page.

Is something that I missing or is a bug?

This is the link from search result page ( the first one):

http://IP/communardo_plugins/quicksearch/dosearchsite.action?queryString=api&where=%24spaceKey&includeSubspaces=true

and this is the link from second page ( when press on "2" link in pagination area):

http://IP/communardo_plugins/quicksearch/dosearchsite.action?queryString=api&where=%24spaceKey&startIndex=10

Everything works fine with a link like this:

http://IP/communardo_plugins/quicksearch/dosearchsite.action?queryString=api&where=%24spaceKey&startIndex=10&includeSubspaces=true

Sorry for my English.

Many thanks, Cristina

Jun 20, 2011

Hello Cristina,

you are right, we can reproduce this. the subspace search is loosing some parameters during the pagination process. We have created anissue for this bug. Many thanks for your description.

Kind regards,

Sandro

Jun 28, 2011

Hello, thank you for the plugin.

Is there any way possible for a page in a parent space to display recently updated items (pages, comments, etc) for subspaces?  The recently-updated plugin only shows items for the parent space.

Jun 29, 2011

Jun 29, 2011

Thankyou for the response Klaus,

Sorry for my poor wording.  What we are looking for is a way to display recently updated items for subspaces without having to neccessarily specify a list of spaces.  It should be automatically derived from the space heriarchy.

Jun 29, 2011

supspace has no effect on recently-updated-macro. To achieve that what you want, you need to derive of the breadcrumb a comma separated list of the spaces and inject this list into the recently-updated-macro which cold be achieved with replace-and-render. I now did not investigate what way would give a comma separated list of spaces to you, maybe you could derive it using reporting-plugin. But I am sure you will find a way to manage this on your own.

Jul 04, 2011

Since we upgraded the subspace plugin on our Confluence 3.2 installation there have been a steady increase in the velocity errors, until we took a look at the updated documentation here and noticed changes.

When replacing

$!sitemeshPage.getProperty("page.breadcrumbs")

with

$helper.renderConfluenceMacro("{subspace_breadcrumbs:currentSpace=$spaceKey}")
$!sitemeshPage.getProperty("page.breadcrumbs")

It displays the breadcrumbs including the space hierarchy like it is supposed to again without errors.

However, we are using a space called DASHBOARD as a custom dashboard, and now it displays both  the original dashboard link followed by the custom dashboard. How do I tell the breadcrumb renderer to omit the original dashboard?

Jul 04, 2011

Hello Youri,

do you want to omit the original Dashboard link in every space or only in your DASHBOARD space?

Kind Regards,

Sandro

Jul 04, 2011

In every (or at least in the ones using the default theme).

With the old plugin we used this in main layout to display the space breadcrumbs without the original dashboard being listed

...

#if($sitemeshPage.getProperty("page.spacekey"))
      $helper.renderConfluenceMacro("{space-breadcrumbs:$spaceKey:$title}")
    #else
      $!sitemeshPage.getProperty("page.breadcrumbs")
    #end

But that does not work reliably any more with the new plugin.

Jul 04, 2011

OK Youri,

here are the results of my lunch break brainstorming. To render the breadcrumbs, subspaces is using the javascript function modifyConfluenceBreadCrums. This function will be called if the page has finished loading. So what we can do is to owerwrite this function with our own little modified function during the page rendering.

To do this go to you Confluence Administration to the "Custom HTML"-Section and insert the following code into the "At the and of the Body"-part. 

<script type="text/javascript">
 
 function modifyConfluenceBreadCrums() {
 
    if( typeof( window[ 'subspaceBreadCrumPath' ] ) != "undefined" && subspaceBreadCrumPath.length > 0) {
        if(jQuery('#breadcrumbs').children()[1]) {
            jQuery(jQuery('#breadcrumbs').children()[1]).remove();
        }
 
 
        var contextPath = jQuery('#confluence-context-path').attr('content');
        for ( var pathCount = subspaceBreadCrumPath.length-1; pathCount >= 0; pathCount--) {
 
                        // to prevent the first subspace from having the little arrow as background image.... we add the "first" css class
                        var className = "";
                        if(pathCount == 0) {
                            className = "first";
                        }
 
            jQuery('#breadcrumbs').children(':first').after("<li class='"+ className +"'><a href='"+contextPath+subspaceBreadCrumPath[pathCount][1]+"'>"+subspaceBreadCrumPath[pathCount][0]+'</a></li>');
 
                        //here we hide the first element (the dashboard Link)
                        jQuery('#breadcrumbs').children(':first').css("display", "none");
        }
    }
}
 
 
</script>

This should remove the first Dashboard link. I have testet this code with a Confluence 3.2. I hope it works at your Confleunce, too.

Kind Regards,

Sandro 

Jul 04, 2011

Many thanks Sandro,

This appears to be working wonderfully.

If I remember correctly the old plugin version had three ways for constructing the breadcrumbs:

  1. complete with original dashboard and space home page
  2. without the original dashboard
  3. without the space home page (only when visiting the space home page)

Might be some useful checkboxes to add to the subspace configuration page for a next release?

Jul 04, 2011

Youri,

I think the macro you descripe is the space-bradcrumbs macro. This macro is part of the metadata plugin. The subspace_breadcrumbs macro which is part of our subspace plugin does not have this parameter features. This is why we had to do this code stuff to remove the first breadcrumb part.

Cheers,

Sandro 

Jul 04, 2011

Indeed! I knew I left some comments about this somewhere, lol. It's sometimes hard remembering exactly what I coded more than a year ago :S

There is now quite a bit more of an overlap with regards to the space-hierarchy implementation between this plugin and metadata 2, that got me confused.

An improvement as far as I'm concerned, it is much more logical to have the breadcrumbs generated by this plugin as it also manages the hierarchy. Would be neat to replicate the functionality of construction as well in a future release, if possible without custom html additions (should I create an issue for this so people can vote on it?)

Right now we still use the {parent-space} blocks in the space Home pages and the overview in the subspace configuration page gives a similar functionality. I think this may cause some of our errors as well, as only the one that changed as last seems to affect the hierarchy. Are the {parent-space} blocks still necessary in the space Home pages?

Jul 04, 2011

Yes, please create an issue and descripe your requirements for the breadcrumbs macro in it. Maybe we can get it into one of the next releases.

To your second question, The "parent-space" is also not part of the subspaces plugin. You only need to configure the Subspace tree in the Confluence Administration. No further configurations on the pages is needed (except the subspace_bradcrumb macro insertion in your main.vmd).

Kind regards,

Sandro

Jul 04, 2011

Many thanks for all your help Sandro. I have created a request for the space_breadcrumbs construction options: CSSP-61 (anybody is welcome to vote on that)

And I will be cleaning up the parent-space blocks out of all home pages this week as they no longer have any use.

Kind regards,
Youri

Jul 05, 2011

Does anyone have experience with using the subspaces plugin under the "Documentation Theme"? I have that working now by putting the menu macro in the "Header" area of the Documentation Theme Config screen. The only problem is that the menus do not appear on the Dashboard, Admin and Browse pages.

It seems that applying the Doc Theme precludes access to the layouts, so the GUI editor is no help. I've tried to find the base files on the server as well but can only find one "main.vmd" and changes to it don't seem to affect anything. Any advice?

Jul 05, 2011

Hi Gabriel,

there was a similar question some weeks ago. Maybe Laurents comment will help you.

Cheers,

Sandro

Jul 07, 2011

Hi,

I really like the the menue style of the top navigation bar, but oddly i only see empty squares when setting showSpaceIcons to true. Any idea why? Is this an issue with our explorer settings?

Cheers,

Paul

Aug 06, 2011

Hello,

I want to know, if it’s possible to minimize/expand the structure of the space hierarchy,

like in a filexplorers with folders/files

example:

expanded

space_1

  -space_1.1

     --space_1.1.1

     --space_1.1.2

  -space_1.2

    --space_1.2.1

minimize space_1.1:

space_1

  +space_1.1

  -space_1.2

    --space_1.2.1

Thanks in advance

Aug 15, 2011

Hello Benjamin,

we already have a ticket that matches you description (CSSP-63). You can vote on it to increase the priority. 

Kind Regards,

Sandro

Aug 15, 2011

Thanks a lot^^

Sep 20, 2011

The latest version of the plugin claims to show subspaces in breadcrumbs when usung the documentation theme, but I can't seem to get it to work.  Works fine in the non-ducmentation subspaces.  Any thoughts?  I follwoed the instructions in the documentation for implementing the subspace breadcrumbs feature. 

Sep 20, 2011

Hello John,

only to get sure that we both doing the same steps to get the subspace breadcrumbs working in documentation theme.

  • Go to Confluence global Administration 
  • Go to section "Themes" and choose the "Documentation Theme" 
  • The Documentation Theme itself has a link "Configure theme" -> click it
  • Insert the the macro code "{subspace_breadcrumbs}" in the "Header" Textarea
  • Save the Configuration

Thats it!

This works for me.

Sep 20, 2011

Thanks Sandro!  Works great!

Feb 03, 2012

Never mind comment -- cant seem to delete it.

Sep 20, 2011

It was brought to my attention today that 1.7.2 of the Subspace plugin causes the Adaptivist plugin Toggle-cloak Macro to fail.  I confirmed this by reverting bakc to 1.7.1 of the subspace plugin.  Anyone experienced this.  The symptom is that the additional text on the toggle cloak will not display. 

Sep 20, 2011

Hello John,

thanks for the report. We will Track this with the issue CSSP-68. Pleae see the comments there.

Kind Regards,

Sandro 

Sep 21, 2011

Thank you.  I have added myself as a watcher on that issue.

Oct 02, 2011

Hi

I've just installed a Confluence 4.0 wiki with Subspace 1.7.2 and I can't get the dashboard hierarchical space navigation to work. I can get the drop down navigation toolbar to work but when I go to the General layout for Confluence 4.0 it appears that the way the dashboard is now generated has changed since 3.6.

The instructions say to replace

$helper.renderConfluenceMacro("{spaces}")

however this is no longer in the General layout in Confluence 4.0

The new general layout appears to be

#dashboard_renderGlobalActions("dashboardActionsId", ["system.dashboard"] )
 
#foreach ($webPanel in $webInterfaceManager.getDisplayableWebPanels("atl.dashboard.left", {}))
    <div class="dashboard-item">
         $!webPanel.getHtml($req.getParameterMap())
    </div>
#end

Are there updated instructions on how to get hierarchical subspaces in Confluence 4.0

Thanks

Mathew

Oct 10, 2011

Hello Mathew Archibald,

thanks for your hint about the missing Confluence 4 dashboard description. Now there is a description for Confluence 4 available at the "Example: Hierarchical space structure" -part.

Kind Regards,

Sandro

Oct 11, 2011

Hi Sandro,

works great! ... but now the "Add new space" link is gone :-( ... any workaround for this? Thanks in advance.

Kind regards,

Andreas

Oct 24, 2011

Hi Andreas de Pretis,

thanks for your hint about the missing "Add space" link. I created an issue for your problem. Please look at https://studio.plugins.atlassian.com/browse/CSSP-73.

You can use the following link: http://<confluence>/spaces/createspace-start.action to create a new space.

Kind regards,

Bill

Nov 28, 2011

Hi,

I'm using the subspace navigation bar. When I select a parent space the menu item has the css class "active". But I also want the parent space menu item to be set to active when I select a child space. <li class="active-parent"> would really help.

Kind regards

susan

Nov 28, 2011

Hi Susan,

each li element above the current selected space should have the class "hasChildInContext". This is your "active-parent". 

Kind Regards,

Sandro

Nov 28, 2011

Hi Sandro,

thanks. I set "maxDepth=0". In this case the class "hasChildInContext" is not showing up. So I removed "maxDepth=0" and will hide the childen in the menu via css.

Nov 28, 2011

I have another question: Instead of the little house icon for the home menu item I want to have some text like "home" to show up. Is there a easy way to achieve this?

Thanks again.

Nov 28, 2011

This is not configurable with the macro. But maybe you can use the CSS "content" Attribute or a little bit of javascript to achive this.

Nov 30, 2011

We are running 4.0 and the subspace plugin -- really like the plugin. We are running into two issues which I assume are related to the plugin. With the navigation bar showing, it covers up parts of the confluence pull-downs under Browse and User Name. The other issue is when the nav bar wraps (when the browser window is sized smaller than the nav bar width) while editing a page, the last few lines of the page are clipped in the editor window when scrolled to the bottom (even the scroll-bar is clipped). If a user resizes the browser window to larger than the full width of the nav bar, the issue goes away.

I wanted to know if anyone else is seeing this issue.

Thanks,

Dec 02, 2011

Hello Bill,

please create an issue regarding this behavior. Furthermore, attach some screenshots and add the used browsers to the description.

Thanks,

Sandro

Dec 20, 2011

Hello Sandro,

I have another question :-)

I'm using

{subspaces:style=list|displayEmptyMessage=false|key=$space.key|showRoot=true}

...

Thanks

susan

Dec 20, 2011

Hello Susan,

your requirement is not part of the default subspace functionality. But I created a Requirement Task for this (https://studio.plugins.atlassian.com/browse/CSSP-77). So you can vote for it to give it a higher priority for one of the next releases.

Sandro

Jan 02, 2012

Does anyone know anything about support for Confluence 4.1? The docs are currently showing it to be incompatible.

Jan 03, 2012

The 4.1 release should be available in the next days. Currently, there are some compatibility tests in progress.

Jan 19, 2012

Does the subspace plugin actually change the file locations? We are using WebDAV to access Confluence attachments as shown in:http://confluence.atlassian.com/display/DOC/Configuring+a+WebDAV+client+for+Confluence. Does subspace actually move the files so that when we access a space as a virtual folder we will see the subspaces below it? Or are all the spaces still going to be shown at once on the WebDAV share?

Thanks in advance for the help!

-Daniel

Feb 08, 2012

Hello,

I'm very interested in using this plugin but my requirements are that the plugin must be:

  • Supported
  • Stable state
  • have a BSD license

The plugin information at the top of the page currently lists this as Unsupported and yet the latest release supports Confluence 4.1 and there have been recent updates/bug fixes.

Can you please confirm if this plugin is being supported? If so, then I can move forward to use this plugin.

Thanks!

Feb 10, 2012

Hello Ajay,

thanks for your interest in our plugin. 
We are trying to keep our subspace plugin as compatible as possible to the latest version of confluence. 
The reason why we still have the "Unsupported" state is that we can not guarantee to answer all the support questions whithin a very short time. 
Furthermore we do not fix every little bug as soon as it was posted, espacially if there is a workarround.

It is our compromise for a non commercial plugin.

Kind Regards,
Sandro

Feb 10, 2012

Thanks for the explanation Sandro!

Due to your continued effort to keep the plugin up-to-date with the latest version of Confluence, I will move ahead with implementation.

Regards,

Ajay

Feb 22, 2012

Hello Sandro,

is there any chance I can remove or hide the "new" tab (for new spaces) when I use:

$helper.renderConfluenceMacro("{subspaces:style=list}")

? is there some kind of workaround?

thanks

susan

May 22, 2012

Confluence 4 .... how do I hide all the subspaces from the list of spaces on the dashboard.action page ??

Jul 09, 2012

Found a funny little bug...

I use a Subspaces macro at the top of the page. When I save, the Tools menu becomes inactive when it overlaps the subspaces macro. So, I can select the first few items on the menu (Attachments through Restrictions). The rest of the items are visible, but I can't select them.

  • This only happens when I use the macro with Style=Plain.
  • This is in Confluence 4.4.2 with Subspace plugin version 1.7.3 with the Atlassian Documentation theme.
  • This problem is consistent across Firefox, Chrome and Safari on both PC and Mac.

Jul 10, 2012

Hi Eliane,

it sounds a little bit like the ticket [https://studio.plugins.atlassian.com/browse/CSSP-83|]. Have you tried to aktivate the "Confluence 3.4 Standard Theme Integration" subspace plugin Modul? 

Jul 11, 2012

The Confluence 3.4 Standard Theme Integration module is already active :-(

Jul 11, 2012

OK,

please create a ticket for this issue and attach some screenshots to it. I think we should have a closer look to this.

Aug 20, 2012

After updating to the latest version of the plugin (v1.7.4), personal spaces now show up in the subspaces list (i.e. $helper.renderConfluenceMacro("{subspaces:style=list|sort=title}")). How can I remove them so it displays just the non-personal spaces?

We're using Confluence v3.5.16.

Thanks!

Aug 20, 2012

FWIW, we also had some other really strange style issues (links not clickable, menus showing up behind other text) that went away when we downgraded to v1.7.3.

Aug 22, 2012

We are also having the problem where personal spaces are showing up on the dashboard.  We are using the latest version of the plugin (v1.74) and Confluence v4.0.

Is there any way we can prevent the personal spaces from being displayed in the subspaces list?

Thanks,

Kerrin

Aug 29, 2012

Same here, using v1.74 & Confluence 4.2.3.

Aug 29, 2012

Hi Kerrin and Ron,

we already have a jira issue for this behaviour. The current workarround is to go back to 1.7.3.

Cheers,

Sandro 

Sep 28, 2012

We're using Confluence 4.3 and would love to start using the SubSpace hierarchical space structure but it only shows Space Favorites in the Favorites list -- is there any way to add a tab for Page Favorites?

Thanks!

Neha

Oct 01, 2012

Hi Neha,

showing up the page favorites is not part of the default subspace plugin. But you can definitely add such a tab to the Subspace macro. All you need for this is the CUTE Plugin. There are already a CUTE Extension which goes in the same direction. Maybe you can do some changes to the extension to match your requirement.

CUTE Plugin: https://marketplace.atlassian.com/plugins/de.communardo.atlassian.plugins.cute

Cheers,
Sandro

Oct 01, 2012

Thanks for the tip, Sandro! I'd like to avoid purchasing a new plugin for the time being so I'm going to see if there is a way to add Favourite Pages in a separate section on the dashboard.

...

Tip

Visit our knowledge base to find answers to your questions!

Support

If you have further questions please do not hesitate to create a support request.


Image Added