youngmon/atlassian-qna huggingface dataset:
Auto-format a Confluence link in a template
Asked by David Corlette:

Hi there,

I'm having a devil of a time getting a specific piece of functionality to work in the Confluence templating system. I wonder if folks can suggest some ways this can be done?

Essentially what I want to do is to create a template that has a bunch of parametrized fields that are filled in when the page is created, and from that construct a page that has all sorts of nice URLs and macros pointing to useful resources. This is to create a project dashboard for a particular release that is managed in JIRA and also Bugzilla.

So let's say I have a JIRA project called 'SDK' and I'm working on release '1.0' of the SDK; that's reflected into Bugzilla with a component name of 'My SDK'. What I'm trying to do is define a template with form-fill fields so the user can type in the project name, version, and bugzilla ID, and the resulting page will have the right title, text, and links. I've tried to use the standard @VAR@ syntax, but that does not appear to work in many cases:

Template markup like this:

\[http://jira:8080/browse/@JIRAPROJECT@\]

appears to completely ignore the defined variable. Also

\[@JIRAPROJECT@ @VERSION@ Requirements\] - I want that to create a link to a new Confluence page that holds requirements for this project.

I'm also trying to do something like this in the template markup:

{gadget:url=<http://jira:8080/rest/gadgets/1.0/g/com.pyxis.greenhopper.jira:greenhopper-gadget-project-dashboard/gadgets/greenhopper-project-dashboard.xml>\|width=600}  
selectedProjectId=filter-@VersionID@\&showLabels=false\&showLegend=true\&selectedBoardId=\&contextName=\&chartType=\&startDate=\&endDate=\&fieldId=\&forMaster=false\&isConfigured=true\&refresh=false  
{gadget}

Leaving aside the problem that this forces a user to go look up the internal version ID in JIRA, this doesn't work either (the variable is ignored).

So I think the root of this problem is that @VAR@ variables in the template markup should be recognized anywhere, even if not preceded by a space or embedded in a link.

Note that one thing I tried to do was just add a bunch of spaces in the URLs and remove the starting brackets, figuring the page editor could just simply edit out the spaces, pre-pend a square bracket, and Bob's your uncle, they'd have a proper link. But of course the RTF editor makes that impossible because you can't just edit the link target using the text on the page.

That's definitely one feature request I'd have, short of restoring full wiki text support - allow people to edit specific types of content, like link aliases and targets, without forcing them to pop up a separate editor.


Answers:
author: Jeremy Largman
body: It's acting funky for me too. This is a known issue in Confluence 4 - it's buggy. You can weigh in with use cases here:

<https://jira.atlassian.com/browse/CONF-11744>
View contributers in Confluence
Asked by epohl:

Is there a way to view a list of Confluence users who have contributed content?

* Added a page
* Edited a page
* Added a comment

We've been running Confluence for three years, but are just now implementing Jira. We want to share the user database, but want to implement a new naming convention for users. This mean we'll need to edit Confluence usernames (I guess in this way: <http://confluence.atlassian.com/display/DOC/Changing+Usernames)> for existing users, but we'd like to only have to do this for users that have actually contributed content, not all 1000 users.


Answers:
author: epohl
body: The contributers macro met my needs.


author: Bob Swift (personal)
body: [Site Statistics](http://confluence.atlassian.com/display/DISC/Site+Statistics) might be helpful.

comments: author: epohl
body: Ended up using the contributers macro. It crashed the wiki, but not before I got my list. Thanks.
Need to track pugin/macro usage over whole wiki service
Asked by Arthur Wilson:

We are upgrading from 2.10 to 3.5 and we need to know what plugins/macros out users are currently using. We had to turn off logging as it had an advers effect on the service.

Can anyone suggest the best way to do this? If we use google analytics, how would we track plugin/macro usage?

Arthur Wilson

University Of Edinburgh


Answers:
author: hsuhailah
body: Yes, Macro Usage Stats Plugin would be helpful in this case. If you still wanted to use Google Analytics, you can try out [Google Analytics for Confluence by AppFusions](https://plugins.atlassian.com/plugin/details/16722?versionId=648695).


author: Remo Siegwart
body: You might want to take a look at the [Macro Usage Stats Plugin](https://plugins.atlassian.com/plugin/details/268).

Hope this helps

comments: author: Fabian Lopez
body: Is there a new version available for Confluence 5.4?


author: Stephen Deutsch
body: If there's a particular macro you're looking for, you can just search for it.

To find all usages of the user profile macro, for example, search for:

macroName: profile\*

(note: the spaces in between : and the name of the macro is important!)
Problems with upgrading plugins after Confluence upgrade to 4.1.2?
Asked by Elvir Hadzic:

Hello everybody,

I upgraded from Confluence 4.0 to 4.1.2 on our test environment. Everything worked fine with 4.0.

Now, when I go to "Plugins--\>Upgrade" to check if newer versions of the plugins are available I get the following error message:

> This version of Confluence is unknown to the plugin information server. It may be too new to appear, or it may be some type of non-standard build. No plugins can be found for unknown product versions.

Is this a known problem (I couldn't find anything helpful)? Did anyone else experience it and was maybe even able to resolve it?

Thanks in advance!


Answers:
author: Joe Clark
body: This error can happen if the information about the parent product version (in this case, Confluence 4.1.2) is not updated on plugins.atlassian.com. Since we literally released Confluence 4.1.2 about 12 hours ago, it's possible PAC doesn't know about this version of Confluence yet. :-)

**EDIT:** I've just checked the information on [plugins.atlassian.com](http://plugins.atlassian.com) and Confluence 4.1.2 is now listed. The plugin manager's Upgrade tab should be working OK now.


author: Fabian Lopez
body: Please consider also, that you will see only those plugins that are already updated to that version of Confluence. Some of them are listed as 4.0.5 compabible and they won't be considered on the upgrade panel. (I uploaded them manually on my testing environment and they works ok with 4.1)


author: Andrew Frayling
body: Hi,

Try manually upgrading the Universal Plugin Manager to the latest version (1.6.3) available at <https://plugins.atlassian.com/plugin/details/23915?versionId=841450> and restarting Confluence.

I was getting the same error message with the version of UPM (version 1.5.2) that ships with Confluence 4.1.2, but upgrading to version 1.6.3 of the UPM and restarting Confluence fixed the problem.

Hope that helps,

Andrew.


Tags: confluence-app

upgrade
How it possible to print a tree of all pages
Asked by Stas Oskin:

Hi.

We are keeping our project specs in nice flat-tree as below:

\* Specs is the root

\* Epic categories (themes?) are the 1st level

\* Epics are the 2nd level

\* Stories are listed within Epics as linked Jira items

We looking for a way to print this structure, including the Jira items names, in a tree like structure to present it to management.

Is this possible, and how we can do this?

Thanks.


Answers:
author: hsuhailah
body: How about accessing the project space, then click on Browse \> Pages \> View: Tree

<br />

This will display the pages in Tree View. The Space name can be seen at the top of the page (breadcrumb) and print the page for presentation.

comments: author: Stas Oskin
body: Thanks, but this prints only the pages - we need the ticket names as well.


author: Renjith Pillai
body: Link Heirarchy Plugin? <https://plugins.atlassian.com/plugin/details/5003>

And I guess Greenhopper has the setting to specify which Linktype to you.

comments: author: Stas Oskin
body: What we need is linking between Confluence and Jira issues, to make a tree that will have branches both for sections and for ticket names. I'm not sure this plugin helps.


Tags: print
Confluence with AtlassianOnDemand from Google App Market
Asked by Sandro Rehder:

Hi there,

We are doing a trial with AtlassianOnDemand which we got via the Google App Market.

JIRA and SVN are fine, but I can't find Confluence anywhere.

Any idea on how I can get it activated?

Regards,

Sandro


Answers:
author: Sandro Rehder
body: All good now thanks to Melanie Wright from Atlassian.

The issue was that I typed my e-mail address wrong when I initialised my AtlassianOnDemand first time... So there was a mismatch between my google e-mail and the one on Atlassian!


author: DouglasA
body: You can [enter your email address here](https://my.atlassian.com/password/index) to reset your password if you've forgotten it. The form will let you know if it's unable to locate your email address, in which case you can [sign up for an account here](https://my.atlassian.com/signup/index).

If you need further assistance, please contact our Customer Advocates team at sales \[at\] [atlassian.com](http://atlassian.com), or on +1 415 701 1110.


author: Matt
body: You can activate Confluence by logging into your My Atlassian account at <http://my.atlassian.com>

comments: author: Sandro Rehder
body: I am not sure if it is because I got AtlassianOnDemand from Google Apps, but <http://my.atlassian.com> is not recognising my e-mail address.


Tags: cloud

confluence-cloud
How to modify list results for personal labels?
Asked by MarkW:

Does anyone know how to increase the visible limit for the personal labels page? By default it shows 10 favourites on a page and you must select the paged link to view the rest. I have 6 paged links, so I have to go through each to find what I want.

The page I am speaking of can be accessed here: "Your-confluence-url/viewmylabels.action"


Answers:
author: Remo Siegwart
body: As far as I know it's not possible, because the page size (10) is hardcoded in the action and we can't override it with parameters.

To list your favourite pages, there is the [Favourite Pages Macro](http://confluence.atlassian.com/x/ZUQC), but it only lists the 5 most recent pages. But you could use the [Content by Label Macro](http://confluence.atlassian.com/x/njgC) which has a maximum parameter available. Just use the label **my:favourite** to list only your favourite pages:

```
{contentbylabel:labels=my:favourite}
```

Hope this helps
The basics of the scaffolding plugin
Asked by Emily Johnson:

Can anyone direct me to a basic overview of what the scaffolding plugin does? I can't find this anywhere. I can find the fields that each macro in the plugin allows, but am missing the big picture here.

I know it's a way to create templates, but can't you do that via an innate Confluence templating option?

Thanks!

Emily


Answers:
author: NielsJ
body: The Scaffolding plugin allows you to define a form that represents a page.

Imagine a page that always has the same structure: title, something left, something right and a list of users at the bottom. You could write the wiki-code for that page or create a scaffolding that contains two text boxes (text left and right) and a list of users. So the editor would not have to mess around with the complex wiki code (multicolumn, userlnks) but only work with the form.

Another thing is that Confluence templates are only for initial filling the page. There is no back reference. With Scaffolding's live templates you can define the "link" between a page and a template. So if you edit the template, the page changes.

comments: author: Emily Johnson
body: Thank you, Niels! CustomWare should borrow your answer for their docs.
Documentation Theme - Default Width (in px) of left panel
Asked by Fabian Lopez:

What is (in px)the default width of the left panel on the documentation thme? Is it possible to change that parameter with CSS?


Answers:
author: Fabian Lopez
body: This answer was placed in a similar question By Sandro Herrmann \[Communardo\]

The initial width of the left panel sould be 250px. But a changed width will be saved to a cookie. So if you restart your browser you will get your last defined width.

One thing you can try is to define a minimum width for the left panel. The code for this is:

```
#splitter #splitter-sidebar {     min-width: 300px;  }  
```


author: Mikael Mikkola
body: So that code should be added to, e.g., the Stylesheet of the space or to the global stylesheet. To me it seems that the first "#splitter" is not needed in the code.

But how to make the following CSS work? It seems to me that it works but after 0.1 seconds the width is reseted to some default (that depends on the contents of the left panel).

```
 #splitter-sidebar {     width: 300px;  }  
```


Tags: documentation-theme

panel
Upgrade Confluence from 3.1 to 4.1
Asked by Thorben Theil:

Hi,

is there someone who successfully upgraded Confluence from 3.1 to 4.1? We have an old version in production use and need to upgrade now. I tried to upgrade using the installer (for linux systems) as well as upgrading manually to 3.5 first. The latest version we could get running was 3.4 but an upgrade from 3.4 to 3.5 fails, too.

Any ideas?


Answers:
author: Ellen Feaheny [AppFusions]
body: Hard to do this totally blind, to know exactly what state your system is at currently, let alone what plugins you have installed or other customizations.

At a minimum, you are using these, for where it sounds like you are at currently?

<http://confluence.atlassian.com/display/DOC/Confluence+3.5+Upgrade+Notes>

Happy to help you with a service contract to get you going quick. Email me if interested.

Ellen

ellen@appfusions.com


Tags: upgrade
Auto populating Confluence with new hire data from a web form, email, excel doc, or other?
Asked by Emily Johnson:

Asking this question on behalf of our awesome office staff:

I manage all the new hire entries for our company, and we use confluence as our internal knowledge base. I currently manually add all new hire information (e-mail, phone numbers, date of hire, etc) into multiple wiki pages. I would like to be able to populate multiple fields within the wiki via a single point of entry (web form, excel doc, etc.). Is this possible?

Thank you!


Answers:
author: Gary
body: Hi Emily,

This is most likely possible utilizing our rest api:

<http://docs.atlassian.com/atlassian-confluence/REST/3.2>

You could probably create a webform somewhere, and once the info is submitted, forward the infomation to your Confluence instance.

Cheers,

Gary


Tags: cloud

confluence-cloud
Confluence 4.1 - Content Indexing: pdfbox warn/exception during re-index
Asked by Gavin Fowler:

Hi

I've just upgraded to confluence 4.1 (from 4.0.5) and on start-up the content is reindexed. I can see from confluence log the following pdfbox warning/exception:

```
2012-01-06 10:08:10,383 WARN [scheduler_Worker-8] [apache.pdfbox.util.PDFStreamEngine] processOperator java.io.IOException: Error: expected hex character and not  :32java.io.IOException: Error: expected hex character and not  :32
```

Googling the error is seems to be related to the bundled version of pdfbox (pdfbox-1.2.1.jar), and has been reported here: <https://jira.atlassian.com/browse/CONF-22358>

My question is, should i manually upgrade pdfbox-1.2.1.jar (latest stable version is pdfxbox-1.6.0.jar), or is it best to wait for an official atlassian confluence update?

Many thanks.

Gavin.


Answers:
author: Gavin Fowler
body: Here's the response from Atlassian Support.

> Since this does not usually indicate an actual problem, and is more of a warning rather than an error, you should just suppress the messages from being printed in the logs by navigating to \<tt\>ConfluenceInstallationDir/confluence/WEB-INF/classes/\</tt\>, edit \<tt\>log4j.properties\</tt\> and add this line to the end of the file:
>
> ```
> log4j.logger.org.apache.pdfbox.util.PDFStreamEngine=ERROR
> ```
>
> Then restart Confluence. We are not aware of issues that you might face if you manually upgrade the pdfbox jar to 1.6, so we will not recommend that for now. Since the issue is already in progress, the fix should be rather soon, so best to wait for that and suppress the warning messages for now.


author: David Peterson
body: My suggestion would be to contact Atlassian Support and get their recommendation, via <http://support.atlassian.com/>. I suspect that the pdfbox packages are only used within whatever plugin is responsible for rendering to PDF - it seems a lot more locked down than it used to be.

comments: author: Gavin Fowler
body: Thanks David. I'll open a support request and post their response.


Tags: content

index

pdf
get-data display partial information
Asked by andrey dmitriev:

I have the following in the code

```
{get-data:name=Implementation Lead}
```

and I get this result.

user: bmadison  
email:\[billy@madison.com\]  
fullName: Billy Madison

However, I don't need this much data. How can I display just user, or any other field? I tried the following, and it didn't work

```
{get-data:name=Implementation Lead.user}
```


Answers:
author: David Peterson
body: Hi there,

My suggestion is to use the Reporting plugin, which can get this level of detail better. In this case:

```
{report-info:data:Implementation Lead &gt; user:name}
```

You can pull out other fields as well, via the [User Supplier](http://www.customware.net/repository/display/AtlassianPlugins/User+Supplier). Eg:

```
{report-info:data:Impelementation Lead &gt; user:full name}
```

Also, you can have it automatically link to the user's profile if you want:

```
{report-info:data:Implementation Lead &gt; user:full name|link=true}
```

Hope that helps!


Tags: scaffolding
Structure and scalability
Asked by Tim Milner:

We are in the process of designing a Confluence space for one of our projects teams - it will include some form of workflow, with template triggers, and then allowance for users to upload documents where they need to. We are considering two options with regards to structure, and I wondered if anyone could advise on which is more advisable.

1. Have one page with all of one type of document on - so potentially thousands of design documents attached to a page called eg. Design Documents; or

2. One page per document, which would mean we may have 25,000 pages within a space.

Any advice on the potential implications of both options in terms of space allowance etc.? Is there, for example, a limit to how many attachments you can put on one page? And also, a limit to how many pages you can have within one space, assuming each page has one attachment?

Essentially, how scaleable is each of those options? Would you recommend one over the other?

Thanks as usual in advance.

Tim


Answers:
author: Ellen Feaheny [AppFusions]
body: Hi Tim -

There's of course many ways to do this -

I think you are mixing use cases/needs here - that of wiki as an unstructured doc repository, and a document management system, for lets call it "structured docs" (or physical docs, like PDFs, Word docs, Excel, etc.. your "design documents").

Yet fully understand why you want to mix them, so addressing scaling concerns - and process and UX - are indeed key. But in short - 25K+ docs is alot.

May I propose that you use a connector application to a physical doc repo. With that, you have a number of options in terms of embedded lists, embedded docs (for visibility), and quick launch on the fly editing, etc.

AppFusions offers integrations for these purposes with Box, Google Docs, and Alfresco. Check our [Youtube channel](http://www.youtube.com/user/appfusions) or [website](http://www.youtube.com/user/appfusions)for a brief intro. If you email me, I can share some future roadmap efforts underway as well (and you can try with an eval license).

Federated search is another consideration - since I presume you want searchability between all your docs and wiki.

Best,

Ellen

[ellen@appfusions.com](mailto:ellen@appfusions.com)


Tags: scale

space
Confluence 4.1: Autoconvert Pasted Links. Confluence as a content Type
Asked by Gavin Fowler:

Hi

Hopefully this is an easily answered (noob?) question.

I'm looking at the Confluence 4.1 release notes for the feature "[Autoconvert Pasted Links](http://confluence.atlassian.com/display/DOC/Confluence+4.1+Release+Notes#Confluence41ReleaseNotes-AutoconvertforPastedLinks "Autoconvert Pasted Links")" and have easily leveraged this feature for the examples shown (googlemaps \& youtube). The supporting documentation suggests that Confluence can also be used as a content source, which is where my question focuses.

1. The release notes indicate that these confluence sources can be used: Confluence page, blog, comment, status, user links.
2. What is the user experience when a confluence url is pasted? is it just a hyper link, or should it render a thumbnail image like it does for youtube / googlemaps?
3. Does this only work on local confluence instance, or does it also work for remote confluence repositories (such as Atlassian's own confluence documentation)? i.e.[](http://confluence.atlassian.com/display/DOC/Getting+Started)[http://confluence.atlassian.com/display/DOC/Getting+Started](http://confluence.atlassian.com/display/DOC/Getting+Started%3C/a%3E%3C/li)\</li\<\>\>

Many thanks

Gavin.


Answers:
author: Stefan Kohler
body: Hi Gavin

When pasting any URL into the editor its autoconverted to a link. When pasting a Confluence URL into the editor is also converted to a link, but it will be reconized as a Confluence URL and be converted to an internal link.  
Pasting a Confluence URL from a differerend installation will just convert it to link, but not to an internal link..

So If I'm logged in on <http://confluence.example.com/> and would past <http://confluence.example.com/display/example/project+a> it would be converted to a link "Project A". If I would paste <http://confluence.atlassian.com/display/DOC/Getting+Started> it would just show that, but as link.. (hope I made any sence)

comments: author: Gavin Fowler
body: Many thanks for the information Stefan. I'm now clear on how the functionality is to work :)


author: Don Willis
body: Stefan's answer is exactly right, but there are a couple more things to say.

If you would like autoconvert to handle other AppLinked Confluence instances, please file a feature request. It is something we'd like to get to at some stage.

You can get *slightly* nice behaviour out of autoconvert and a remote Confluence instance if you [configure a shortcut link](http://confluence.atlassian.com/display/DOC/Configuring+Shortcut+Links) to that instance. Eg if you create a shortcut link to [http://confluence.atlassian.com/display/DOC/%s](http://confluence.atlassian.com/display/DOC/%25s) then pasting <http://confluence.atlassian.com/display/DOC/Configuring+Shortcut+Links> would result in [Configuring+Shortcut+Links](http://confluence.atlassian.com/display/DOC/Configuring+Shortcut+Links).

You can get slightly nicer behaviour by following the [Extending Autoconvert](https://developer.atlassian.com/display/CONFDEV/Plugin+Tutorial+-+Extending+Autoconvert) tutorial.


Tags: link
How do I rename the background text for the Confluence search box from 'Search Confluence' to something else?
Asked by Christian Maire:

I'm going to be making some public spaces, and people visiting them are not going to know what Confluence is, they're just going to be visiting our documentation. Therefore, the words 'Search Confluence' are going ot be meaningless to them, and at worst confusing. I'd like to either remove the text or have it say just 'Search'.

Is there a way for doing that in Confluence OnDemand?


Answers:
author: Sven
body: If you have "Custom HTML" available or can inject Javascript-Code to any page (perhaps with the html-macro), then this answer should work for you:

[https://answers.atlassian.com/questions/20506/change-the-default-text-in-the-search-box](/questions/20506/change-the-default-text-in-the-search-box)

Happy wikiing!

Bye

Sven


Tags: cloud

confluence-cloud

search