youngmon/atlassian-qna huggingface dataset:
Display email on Confluence page
Asked by Ana Crisan:

Hi,

Is it possible to display a filtered list of emails from the mail archive associated to the space on a Confluence page?

I've been looking at the reporting macros from CustomWare, but I could not find an example on how to use them for emails...

Thanks in advance.


Answers:
author: Remo Siegwart
body: Here is an example on how to create a list of mails with the [reporting plugin](http://wiki.customware.net/repository/display/AtlassianPlugins/Reporting+Plugin):

```
{report-table}  {content-reporter:spaces=yourSpaceKey|type=mail}    {date-sort:mail:sent date|order=descending}  {content-reporter}  {report-column:title=Sent Date}{report-info:mail:sent date}{report-column}   {report-column:title=Subject}{report-info:mail:subject|link=true}{report-column}  {report-empty}    _No mails found_  {report-empty} {report-table}
```

Wasn't sure how exactly your report should look like, but it should give you a good overview of how to use the macros. Find more information about the [Mail Supplier here](http://wiki.customware.net/repository/display/AtlassianPlugins/Mail+Supplier).


Tags: archive

email
Migrating from confluence to sharepoint 2010
Asked by Syed Faizullah Ghori:

How to migrate from confluence wiki to sharepoint 2010 wiki.


Answers:
author: Gerald Tombs
body: You might like to know Clearvision has developed several tools to migrate from Sharepoint to Confluence. Presently we offer this as a consulting service. As from September 2012 we will have a download licensed tool on offer. If you are interested, contact [sales@clearvision-cm.com](mailto:sales@clearvision-cm.com)

Gerry


author: Nic Brough -Adaptavist-
body: Um, you can't really do this. Confluence is a wiki. Sharepoint is a document repository and handling system, not a wiki.

If you want to switch from one to the other, then you need to go through a proper planning and training process - decide what you're aiming for, then look at what you've got now. Your migration plan will depend entirely upon that.


author: Jim Bethancourt
body: :-(


author: Fabian Lopez
body: Syded, I tested the wiki in Sharepoint and I found limited functionalities, Have you considered the use of Sharepoint connector, you get the potential of confluence in the sharepoint environment


Tags: sharepoint
Remove search from the navigation sidebar
Asked by Lloyd Kinsella:

Hello,

Currently our spaces are set up so that we have a sidebar with page navigation, however this shows a search box. Now reading up I've found that {pagetree} can be configured to turn this off, however I can't find where this page layout is stored, can someone point me in the right direction?


Answers:
author: Lloyd Kinsella
body: NM figured it, seems I have to do it on all the spaces as well!


author: Barbara Green
body: Not only that, but if you copy a space (using the Copy Space plugin), you have to redo the navigation for the new copy as well. I'm not sure why Copy Space does not include the theme customizations. I think it should.  


author: Lloyd Kinsella
body: As a site note, I tried Configure Theme, turned off Page Tree in Navigation then entered {pagetree:...}, however I now end up with two pagetree's, the original plus the one without search.
trouble with creating a link on a column
Asked by HASSAN GHYAS:

i have a table with a column of JIRA project ID's - i need to keep adding new project ID's, therefore adding new rows in my table. Is it possible to automatically hyperlink the JIRA ref by simply editing and adding the project ref?

I hope thats clear! Essentially, when I save my table down, i want ech project ref to appear as a link, which i can then click on to open into the project page.


Answers:
author: Kevin Buchs
body: Yes. Just copy/paste the link down in the next row and edit what has changed (project, your label).
Is there a way to tag the certain versions of all pages under a given Space
Asked by Ozgur Yuksel:

Hi,

I am trying Confluence to see if we can use it for our product documentation. I know Confluence comes with change history support. But what I need is to mark a certain version (or current versions at a given day) of all the pages with the Product Version which is released at that day. This is more or less how we work with source code of the product as well (there we use branching for future changes). Main idea is to see what is changed between Version A of the Product and Version B.

Ozgur


Answers:
author: Bob Swift (personal)
body: One way is to update the page with an update comment that specifies the version. This shows up in the page history. People could do a diff after selecting the 2 page versions that matched the product versions they were interested in. The page update could be automated by using the [Confluence Command Line Interface](https://studio.plugins.atlassian.com/wiki/display/CSOAP) .

Example: confluence --action storePage --space myspacekey --title "My page" --comment "Version 1"

However, be aware the Confluence can ignore an update if it is not a change. Seems to occur even if an update comment is provided. This happens on the UI or via remote API. While I like a null update not creating a new version, I think it is a bug that an update comment provided with an update doesn't create a version :(. It seems that if the author of the change is different than the last update author, a new version will be created. You can make a significant update by adding a blank to the end of the page, but this requires something like:

confluence --action getPageSource --space myspacekey --title "My page" --file page.txt

confluence --action storePage --space myspacekey --title "My page" --comment "Version 1" --file page.txt --content2 " "

comments: author: Ozgur Yuksel
body: It is good to know we can easily add this functionality using some scripting based on our versioning and there is enough support from application side.

Thanks for the quick response.

Ozgur
Is there a way to render the details of a single JIRA issue on a Confluence page ?
Asked by Nikolaus.Rumm@cellent.at:

We would like to display the details of a single JIRA issue (id, title, state, ) including custom fields on a Confluence page.

We found the jira-issues macro, which generates a list of issues, but this is not what we want.

Furthermore there's the 'insert JIRA-issue' macro, which just renders a link to JIRA, but no details of that issue.

Is there any way to achieve this ?

In previous versions we used the 'Jira/Confluence Issue Macro', but it's not compatible with Confluence 4.0 and development seems to be halted on that.


Answers:
author: Nikolaus.Rumm@cellent.at
body: Finally we wrote our own macros for that purpose, which took about two days for a Confluence/JIRA novice.


author: Matt
body: If you are running Confluence 4.1 you can find the Issue using JQL in JIRA and copy and paste the permalink to the search into the Confluence editor. See: <http://screencast.com/t/AJAM72iiTBow>


author: NielsJ
body: Hi Nikolaus,

if you are familiar with XSL-T you could request Issue details via RSS at the JIRA instance and render the result with XSL-T into Html. I tried that successfully some time. Additionally you could use the cache-Makro to avoid XSL-T rendering on every single page hit.

It gets a little more complicated if your Issue is not in a public JIRA project. Then you could create an own user macro which automatically appends username and password to the Url (os_username, os_password). So only the Confluence administrator has access to these values.

Regards,  
Niels


Tags: issue

jira

macro
Confluence home directory backup: What directories are safe to exclude?
Asked by Petros Demetriades:

By reading the atlassian confluence administration pages and several answers here, I understand that the best practice confluence backup is to:

1. Backup the database using a native DB backup tool (e.g. pg_dump for postgreSQL);
2. Backup the home directory separately.

The atlassian backup pages refer to "backing up the entire confluence home directory". However over time this directory accumulates lots of stuff that seem unnecessary to backup (e.g. temp, backups, index, plugins-cache, etc.) which needlessly increase backup size.

From what I've read I gather that most of the stuff in the excluded directories gets re-created when confluence is restarted (e.g. the plugin-related folders) and the indexes and thumbnails can be recreated on demand via the administration UI).

Could someone please confirm that it is safe to exclude the following directories from the confluence backup directory? (I couldn't find a definitive answer anywhere hence the question)

* (home directory path)/**attachments**: INCLUDE
* (home directory path)/backups: EXCLUDE
* (home directory path)/bundled-plugins: EXCLUDE
* (home directory path)/**config**: INCLUDE
* (home directory path)/**confluence.cfg.xml**: INCLUDE
* (home directory path)/index: EXCLUDE
* (home directory path)/logs: EXCLUDE
* (home directory path)/plugins-cache: EXCLUDE
* (home directory path)/plugins-osgi-cache: EXCLUDE
* (home directory path)/plugins-temp: EXCLUDE
* (home directory path)/restore: EXCLUDE
* (home directory path)/temp: EXCLUDE
* (home directory path)/thumbnails: EXCLUDE
* (home directory path)/viewfile: EXCLUDE

Thanks in advance.


Answers:
author: Bob Swift (personal)
body: As mentioned on [Backuping Confluence](/questions/17109/backuping-confluence/17133) - I exclude \['logs', 'backups', 'restore', 'temp', 'viewfile', 'oscache', 'plugin-cache', 'plugins-temp'\] and I know that works. I would guess bundled-plugins could be excluded. Index can be rebuilt, but it takes time - so that is a tradeoff. I would guess thumbnails would be regenerated too.

comments: author: Petros Demetriades
body: Thanks Bob. Much appreciated.
How can I create a multievel heirarchy directory listing of Spaces on the Dashboard
Asked by Rodney Hughes:

I have a system which will have potentially hundreds of Spaces, perhaps more so I need a directory structure to the Spaces on the Dashboard where I can drill down using "+" buttons (like in List pages view or a Windows Browser window)

I see i can add Labels to Spaces to then show them in a Category view using Browse Spaces but this could still end up with seevral dozens in one Category as it is a single level label

I was hoping there was some way of having a directory drill down - ideally allowing one Space to appear in different areas depending on which way I came in

eg

1. Country1
   1. Site1
      1. Department1
      2. Department2
   2. Site2  
      1. Department1 ...
2. Country2
   1. .....

but that I could also access by say Site or Department

1. Department1
   1. Country1
      1. Site1
      2. Site2
   2. Country 2
2. Department2
   1. Country1
      1. .....


Answers:
author: Rodney Hughes
body: anyone got any suggestions?

I'm sure others must have lots of Spaces to manage in a heirarchy.

I found this but it is "Unsupported"

<https://studio.plugins.atlassian.com/wiki/display/CSSP/Confluence+SubSpace+plugin>  

comments: author: Rodney Hughes
body: Wondering if anyone has found a good solution yet?


author: Barbara Green
body: Thanks for a good question! I will be watching this one for sure. I would also like more control over the default dashboard view my users see. I know it's probably built automatically, but some layout options (ala JIRA dashboard, for example, or a nested view as described above) would be useful.


author: Remo Siegwart
body: You may also want to take a look at the [Spacetree plugin](https://marketplace.atlassian.com/plugins/com.simplenia.confluence.plugins.spacetree). It allows you to create lists of spaces grouped by space category.

Disclaimer: I'm the author of the plugin


author: Adolfo Casari
body: I have sucessfully used SubSpace Plugin in Confluence 3.5., don't know if this is supported for 4.X


author: Barbara Green
body: Thanks for a good question! I will be watching this one for sure. I would also like more control over the default dashboard view my users see. I know it's probably built automatically, but some layout options (ala JIRA dashboard, for example, or a nested view as described above) would be useful.
Workflow for making private changes then going public?
Asked by Thomas Summerall:

I have a published confluence wiki. I'd like to make a number of edits to existing pages over the next couple of weeks, as well as add some pages, but not have the changes available to the general public until I'm finished with all of them.

<br />

What's the best workflow for this?

One I can think of is cloning the space, making the edits to the privat eclone, then somehow replacing the original with the clone. Is something like that possible?


Answers:
author: Roberto Dominguez
body: Hi!

[Ad hoc Workflows](http://www.adhocworkflows.com) allows you to collaborate before making pages public.

You can define a workflow on a page or for all the pages on a space, which would make the page only visible to you (or a predefined group), and once is approved it (publish) it becomes available to all the users.

The plugin comes with a set of predefined workflows, but they can be customized using our workflow markup.

We have a new version coming out very soon for Confluence 3.5 and 4.0, have a look at what you can do at <http://coma.la/awp32>

More complex publishing also is possible (from one space to another, and from one instance of confluence to another) in combination with the Content Publishing Plugin.

Give [Ad hoc Workflows](http://www.adhocworkflows.com) a try and feel free to contact us if you have any question.

Roberto


author: Thomas Summerall
body: I see on [this page](http://blogs.atlassian.com/news/2010/10/confluence-technical-writing-publishing-process.html) from October 2010 that the way Atlssian does it is copy an existing page, restrict it, edit the new copy, then, when finished, manually paste the new version contents into the old version. Really?

There has to be a better way!


Tags: permission

workflow
How / where can we have internal discussion about a page?
Asked by Robert Lauriston:

We're evaluating building a customer-facing wiki with Confluence 4.0. I'm looking for some way to attach internal discussions to a page so that customers won't see them.

Visibility controls for comments a la Jira is the obvious way but CONF-5639 has only a few votes.

I guess I could create a child page and make it visible only to the Internal group.

Is there a macro / plugin for visibility-controlled inline comments?

Any more elegant suggestions?


Answers:
author: SarahA
body: Hallo Robert

Have you seen the Spartez Kwik Sticky Notes plugin?

<https://plugins.atlassian.com/plugin/details/37075>

I don't know if you can make the notes visible to a group, but you can make them "private" i.e. visible to a user. It's a neat plugin, and it may be worth asking the developers how much work it would be to support groups, if they don't already do so.

Cheers, Sarah


Tags: group

permission
What Plugin does Atlassian use for the Confluence Master Plugin list?
Asked by Rhyne Armstrong:

I need functionality like this, but I can't find what might do what they have there. I need to be able to filter, sort, and list pages in a given space.

Thank you!


Answers:
author: vchoy
body: Hi Rhyne,

Confluence does have a similar functionality to [sort and list pages of a given space](http://confluence.atlassian.com/display/DOC/Viewing+Pages+Alphabetically).

**To view the pages in your space alphabetically:**

1. Choose **Browse** \>**Pages**.
2. Click on **Alphabetical View**.
3. Click on a letter to display all the pages beginning with that letter. Clicking on a page link will take you to that page.

comments: author: Rhyne Armstrong
body: Thanks Vincent, but that's not exactly what I need. I figured out my issue by using the Advanced Search Plugin.
Backuping Confluence
Asked by ket.pjwstk:

Hi,

We're considering strategy for backuping Confluence (content+configuration) running with PostgreSQL DB. Our idea is to involve simple file copy for Confluence files and pg_dump for DB. I guess pg_dump is good approach for PGSQL, but I am not sure about the Confluence. We've made a lot of customization in Confluence, and we want to keep it all for restoring (plugins, settings, etc.). What do you think?

Regards


Answers:
author: Bob Swift (personal)
body: Yes, you are on the right track. Do the DB backup and also save most of the home directory. We backup the attachments directory separately and then the home directory with the following excludes:

\['attachments', 'logs', 'backups', 'restore', 'temp', 'viewfile', 'oscache', 'plugin-cache', 'plugins-temp'\]

comments: author: Nic Brough -Adaptavist-
body: We follow much the same pattern as Bob. We backup overnight, every night, but don't take it offline.


author: ket.pjwstk
body: Thanks a lot for help. However I have two more question. Do you shutdown confluence before backuping? How often do you backup confluence? Once a day? Once a week?


author: ket.pjwstk
body: Thanks a lot.


Tags: backup
confluence: restore Error
Asked by SungJin Woo:

Error message

A space with the key 'ds' already exists. Please delete it before restoring a space with the same key.

but i can't find DS space.

so how can i delete Key "ds"?


Answers:
author: Colin Goudie
body: ds is the Demonstration Space. Can you see that in the dashboard?

comments: author: SungJin Woo
body: No i can't see that.


author: Lars Maehlmann
body: If you can't find the space in the space directory or in the DB

```
SELECT * FROM spaces WHERE ?spacekey= 'DS' ORDER BY spacename;
```

and everything else works You can try to rebuild the index from scratch.  
Here is description :  

[How to Rebuild the Content Indexes From Scratch on Confluence Serve](https://confluence.atlassian.com/confkb/how-to-rebuild-the-content-indexes-from-scratch-on-confluence-server-110035351.html "Rebuild the Content Index")[r](https://confluence.atlassian.com/confkb/how-to-rebuild-the-content-indexes-from-scratch-on-confluence-server-110035351.html "Rebuild the Content Index")

I hope it helps
pagetree always collapses
Asked by Mark Krueger:

I have found that when using pagetree (or the left panel navigation tree - perhaps one and the same), if I expand the tree to navigate down to a page I want to see, click on the page, and then return, the tree is collapsed. This can be very annoying when you are trying to view more than one page at a lower level. Is there a setting which controls this behavior? Unfortunately, Windows Explorer has trained me to expect the tree to remain expanded. It feels like I spend a lot of time expanding the tree, and then re-expanding the tree, and then... You probably get the idea.


Answers:
author: Mark Krueger
body: Adding the startDepth parameter to the macro does help to a certain extent, but I don't think I'd want to go past the value of 2 as then the tree would start to become to unwieldy (depending of course on how many pages are in your space). I think the navigation behavior is just a weak spot that perhaps could be addressed down the road.


author: Terence McGhee
body: This might not be **exactly** what you're looking for, but you sure can "lessen" this effect by specifying a start depth for your pagegree (<http://confluence.atlassian.com/display/CONF32/Pagetree+Macro>)

For example, in the Navigation section for my space's theme, I have the following code : {pagetree:startDepth=2}
How to restrict space permissions by LDAP group when authing through Crowd with OpenLDAP?
Asked by Kimberly McKinnis:

I want to restrict Confluence space permissions by group. I'm authenticating through Crowd, which uses a directory to our OpenLDAP with Posix. Currently, Crowd is set up to only allow my team (group: sd) to authenticate to the Confluence application, this works. However, it's like this group isn't passed along to Confluence. When I ask it to restrict access to a space, it doesn't see any of the LDAP Posix groups, including the one it just allowed me to authenticate through. Is there a nice way to do this?


Answers:
author: Bruna Griebeler
body: This might happen since you are not importing the group itself but its content.

What you can do is to import all the groups but set just a few users to be imported inside confluence-users groups. The confluence-users group (by default) will determine which users will be able to login into Confluence and it's a good way to filter that!

Cheers
How do I find out what links to a page?
Asked by Dee Elling:

I need to know what page or pages link to a particular page. In Mediawiki it's called "what links here". Any ideas? I cannot find anything about this in docs or forums.

thank you! -Dee


Answers:
author: Dee Elling
body: Hi, I found that by default refinedwiki disables the View-\>Info link.

You have to log in as Admin, go to the Confluence Administration-\>Menus and Tabs, click the Content "Tools" Menu Items then Secondary, and enable the View Info Link item. Click Save Changes at the bottom of the Menus and Tabs page. Log out and log in again. Voila! the Info link is there, and the Info page shows the incoming and outgoing links.

Thanks to Joseph for helping me figure this out! -Dee


author: Joe Clark
body: On the "Tools" menu of a page, if you click on the "Info" link you will get a page that includes information about other wiki pages that link to this page.

![](http://content.screencast.com/users/jlclark/folders/Jing/media/0e9343ce-d692-4838-8f95-6bff3f1726b5/info_link.png.png)

![](http://content.screencast.com/users/jlclark/folders/Jing/media/99ea1354-8718-4bcc-898e-c5b39ec24c40/incoming_links.png.png)

comments: author: Dee Elling
body: Hi Joseph, thanks! I do not see that option on my pages (even as Admin). Is this a 4.0-only feature?


author: Joe Clark
body: What version of Confluence are you running, and do you have any custom themes in use?


author: Dee Elling
body: Hi Joseph,

It's Confluence 3.5.1 with the refinedwiki theme

-Dee


author: Joe Clark
body: Ah, well I guess the refinedwiki theme perhaps hides this information or moves it somewhere else. I'm not an expert on refinedwiki, so maybe someone else here will be able to help you. :-)


author: Elizabeth Moffatt
body: View the **Page Information** for the page. This is available in the top right "**..."** menu.


author: Jan Vervecken
body: You could consider giving feedback in JIRA issue <https://jira.atlassian.com/browse/CONF-35218>.


Tags: link

refined-wiki

theme
Lost admin permission in spaces despite my global access
Asked by Rian Rian:

Suddenly I can't get to the Space Admin tab for most spaces. I have global access, so when I am in a space I can select "confluence Admin" from the "Browse" menu, but not "Space Admin". No one has been setting permissions on the space level in any space (it's a test server and no one gets on it).

Any ideas? Thanks, R.M.


Answers:
author: Jobin Kuruvilla [Adaptavist]
body: Which one of these permissions do you have? <http://confluence.atlassian.com/display/DOC/Global+Permissions+Overview#GlobalPermissionsOverview-supergroup>

comments: author: Rian Rian
body: That did it! I was able to add myself (back) to the confluence-administrators group, then everything worked. Thanks, Jobin.


Tags: administration

permission

space