youngmon/atlassian-qna huggingface dataset:
Can a Confluence space be set up so that all pages created in that space have a default page restriction?
Asked by JT:

We have a space where the information is a combination of public and private information. Is it possible to set up the space so that all new pages created in the space have a veiw restriction set, by default, to the private group. The private group would then review the page and determine if the restriction should be removed and the page made viewable to the public.


Answers:
author: Andrew Frayling
body: Hi,

I don't think it's possible to create that exact workflow out of the box, but you could achieve the same thing by having a private branch off the root of you space, create the pages there first and then move them to the public branch once they had been approved. E.g.

-Home  
--Public  
---User Guides

--Private  
---User Guides  
----Doohicky User Guide

Restrictions are inherited so if you apply the restriction at the "Private" page then everything underneath it will automatically be restricted. Once the reviewers have approved the "Doohicky User Guide" they move it (Browse -\> Pages -\> drag and drop) to the "Public" branch where the restriction is automatically removed and the structure is now:

-Home  
--Public  
---User Guides  
----Doohicky User Guide

--Private  
---User Guides

Arguably more steps than just adding and removing a restriction, but it has the same end result and if you move the pages you have a simple log of pages that still need approval as they're the ones still in the "Private" branch.

Would that work for you?

Andrew.


author: Peter Vojtech
body: Hi Andrew, I have the same query and the above method wouldn't work as we have a number of existing categories, with pages which are relevant for different users, so it sounds like its not possible to set a default page restriction?

E.g.

Building a House

* Foundations
* Frames
* Fit Out

I want Project Manager to see most pages. I want Electrician to see some fitout pages and Builder to see some frame and fitout pages.

By default, a new page is restricted only to the owner and project manager.

Can something like this be done?

Regards

Peter


Tags: confluence-administration

content
Can I stop characters from converting to icons?
Asked by SallyD:

hi, all.

I'm uploading a Word file that contains (i) in the content. Confluenece is changing this to a circle with an 'i' in the center, which makes sense in some situations. Is there a way for me to keep my (i)? It goes along with (ii) and (iii). They get a bit lost without their leader. ;-)

Sally


Answers:
author: Steffen Heller
body: If you use \\(i) instead of (i) it should be shown correctly. For this you could do a search and replace in your Word file.
Team Calendars: How do you change the appearance of the calendar on the dashboard ?
Asked by Jeet Kumar:

How do you change the appearance of the calendar on the dashboard ?

One user would like to see the month view instead of "upcoming events". Is it possible to change this ?

I know there is a "dashboard-calendar" macro, but I don't know how to change its settings.


Answers:
author: DavidA
body: Hi Jeet,

I suspect you could embed the calendar macro in the dashboard in Confluence 3.5 by copying its wiki markup into the welcome message. I'm not sure how that can be done in Confluence 4 though.

The upcoming events calendar can be hidden by disabling the "Dashboard Calendar" plugin module.


author: Matthew Erickson
body: Hi Jeet,

Unfortunatly the Team Calendars dashboard does not support this. You could try using the site welcome message to display a calendar macro, but this message is the same for all users.  

Cheers,  
Matt
Why doesn't the TOC macro work in IE with headings that contain punctuation?
Asked by Ben Bristow:

Hello,

We have some page headings such as "Step 2: Catalog Transfer", or "How to create widgets, and deploy them".

Clicking these links in a page's TOC when using IE version 8 or 9 doesn't take one to the appropriate header.

A look at the url reveals that IE is (for example) parsing a comma in a TOC link as: \&2C.

Can anyone point me to some information on why this might be happening, or what in my Confluence configuration could be causing this? Or is this simply the rule to follow: "no punctuation in headers populated in a TOC"?

Thanks!

Ben


Answers:
author: Thomas Lohschmidt
body: Hi,

I found out, too. On some pages whose title contains special characters, the toc macro links do not work.

As a workaround I wrote the following JavaScript lines, which put an anchor before every heading, which makes the toc links functional again.

Put this into your main.vmd decorator:

```
#if( ($mode != "edit" &amp;&amp; $mode != "edit-preview" ))&lt;script type="text/javascript"&gt;AJS.toInit(function() {if (jQuery('.toc-macro').length &gt; 0) {   jQuery.each(jQuery('h1, h2, h3, h4, h5, h6'),function(index,value){     var id = decodeURIComponent(jQuery(this).attr("id"));       var anchor = '&lt;a name="'+id+'" style="font-size:0;line-height:0;height:0;width:0;position:absolute;"&gt;&amp;nbsp;&lt;/a&gt;';     jQuery(this).before(anchor);   });}});&lt;/script&gt;#end
```

Notice: I used "jQuery" instead of AJS.$ because AJS.$.each does not work in a Velocity decorator.

Regards

Thomas


Tags: table-of-contents
How to logout all confluence or jira users - resetting the sessions in order to prevent Not permitted error?
Asked by Sorin Sbarnea (Citrix):

After switching from one LDAP to another, I discovered that many people were getting "Not permitted" error page.

An workaround is to logout and loging again but informing thousants of people to do so is not something easy.

The question is how can you logout all people?


Answers:
author: CEDRIC ZABEL
body: Simply restarting Jira logs everyone out. I discovered this by accident.

I don't use Confluence, so I don't know if this will work there, but you could try it.

comments: author: Sorin Sbarnea (Citrix)
body: No it doesn't, at least in my case.


author: David Hergert _PAYX_
body: Agreed - I've restarted Confluence and user's session cookies still get them in.


Tags: jira

login

logout

permission
Show Favorites on a page, but only these of a specific space?
Asked by Thomas Klug:

Is there a plugin or a walk around that will show me my favorites on a page, but only these which belongs to a specific space?


Answers:
author: LuizA
body: Hello There,

To show only the favorites from one specific space is not possible, but you can use the Confluence Favorite Extension to show your favorites from everywhere within Confluence, see below:

<https://marketplace.atlassian.com/plugins/nl.stefankohler.confluence.favorite-extension>

It is a different functionality but as you need to work with your favorites, maybe this can help.

Kind Regards,

LJ.


Tags: favourite
Update SMTP Mail Server
Asked by Xiuqing Bao:

I want to update SMTP Mail Server to send notification emails. But I don't want to set username or password under SMTP Host. So do I must need an unauthenticated SMTP?


Answers:
author: cisco
body: ?can confluence use the server mail setted on jira?


author: cisco
body: could u tell us how did u do?

comments: author: LucasA
body: Hi trepatreolo,

I believe that Cathy kept the Mail acceptance opened to all the messages from the JIRA server based on its IP address. In this case you don't need to set a username/password. I have a similar configuration in my lab environment.


author: Septa Cahyadiputra
body: Hi Cathy,

It seems that you would need to use JNDI location in order to hide the username and password of the mail server used to be saved on the server's {{server.xml}} file.

Please follow this documentation for detailed instruction on how to use JNDI location to configure your mail server

<http://confluence.atlassian.com/display/DOC/How+do+I+configure+Confluence+to+use+GMail+as+the+mail+server>

Hope it helps.

Cheers,  
Septa Cahyadiputra

comments: author: Xiuqing Bao
body: I don't think so. Our password need to be changed every three months, so we don't want to use username or password neither under SMTP host nor in JNDI location.


author: Septa Cahyadiputra
body: Hi Cathy,

It is not possible to set an SMTP server without username and password as Confluence would need it to authenticate against the configured SMTP server to send the outgoing mail(s).

Cheers,  
Septa Cahyadiputra


author: Xiuqing Bao
body: I have solved it by setting the right SMTP host, then we can send emails without username and password now


Tags: email

smtp
Creating Meaningful Global Templates in Confluence 4+
Asked by Danielle Johnston:

I am trying to create a series of global templates for my team in Confluence. There are a series of common macros that I have been using to create pages that I want to 'just template' into a fashion that other members of my team can perform the task.

But... well, I'm blocked. Since the move to the new editor, it seems like there is no documentation on how to refer to macros in wiki markup language. Can someone point me to documentation on wiki markup for macros (like jiraissues, team calendars, roadmap, rapidboard) so that I can embed them in templates?


Answers:
author: EPS Software Engineering AG
body: Hi Danielle,

Maybe our Add-on Page Tree Creator (PTC) could be a solution. It works a bit different than the Confluence blueprints / templates. The PTC-templates are based on normal confluence pages and therefore you can use all macros without any limitation. You can even replace macro parameters during the page creation process.

Try our [**Live Examples**](https://focuspro.eps.ch/display/PEPSMarktExample/Marketplace+Examples) (no registration needed) and see how it works.

**[Marketplace link: Page Tree Creator](https://marketplace.atlassian.com/plugins/eps.focuspro.PageTreeCreator/server/overview)**.

Regards,  
Stephan


author: Andrew Frayling
body: Hi Danielle,

The best place to look is the [Confluence 3.5 Documentation](http://confluence.atlassian.com/display/CONF35/Confluence+Documentation+Home), in particular the [Working with Macros](http://confluence.atlassian.com/display/CONF35/Working+with+Macros) section for the JIRA macros.

How are you displaying Road Map and Rapid Board in pages at the moment? Is that by subscribing to JIRA gadgets in Confluence and embedding JIRA gadgets in Confluence pages? If so you can find the Gadget macro wiki syntax at <http://confluence.atlassian.com/display/CONF35/Gadget+Macro>

For Team Calendars, these were released after Confluence 4 so there is no documented wiki syntax, but the following might work:

```
{calendar:id=&lt;your calendar id&gt;}
```

e.g.

```
{calendar:id=cccfe4a8-84ed-462f-91bf-a26f4f5e4058}
```

the above is based on converting the Confluence 4 format:

```
&lt;ac:macro ac:name="calendar"&gt;  &lt;ac:parameter ac:name="id"&gt;cccfe4a8-84ed-462f-91bf-a26f4f5e4058&lt;/ac:parameter&gt;&lt;/ac:macro&gt;
```

using the [Storage Format documentation](http://confluence.atlassian.com/display/DOC/Confluence+Storage+Format).

Hope that's of some help?

Andrew.


Tags: cloud

confluence-cloud

markup

template
I am receiving this error when installing new plugins - what can I do?
Asked by Eric Tran:

I am not able to install new plugins, I get the following error:

The system attempted to connect to <http://jira.burntapps.com:8090/rest/plugins/1.0/pending/15fc1381-aff5-4810-b068-ff41ada2bd29> to retrieve the status of your operation, but failed. This may indicate a problem with the base URL configuration of your instance. Try refreshing the page to see if the operation completed, and see the UPM documentation for more details about this error.

I have already verified that this is the correct based URL.


Answers:
author: Septa Cahyadiputra
body: Hi Eric,

Its a bit tough to understand the cause of your issue without analyzing the logs. We highly recommend you to send this query to our [support channel](https://support.atlassian.com) in order to get the appropriate support on this issue.

Just to confirm again, please double check if your server base configuration on your JIRA instance "General Configuration" exactly the same as how you access it. For example, if you access it trough [http://jira.burntapps.com:8090](http://jira.burntapps.com:8090/rest/plugins/1.0/pending/15fc1381-aff5-4810-b068-ff41ada2bd29) then you would need to configured it as [http://jira.burntapps.com:8090](http://jira.burntapps.com:8090/rest/plugins/1.0/pending/15fc1381-aff5-4810-b068-ff41ada2bd29) at your "General Configuration" page.

Hope it helps.

Cheers,  
Septa Cahyadiputra

comments: author: Ted Choi
body: omg thank you =)


author: Septa Cahyadiputra
body: Pleasure is all mine :)
How to enable the search from crawler?
Asked by AlysonA:

From CSP-79457:

"Hi!

I use a software called TheBrain (<http://www.thebrain.com/>), I can attach web pages in this software and it indexes its content (files, webpages, etc.). But it can't index my wiki pages (event if it has access to the page). How can I change that, please?"

Later on we found out that it works on wiki pages visible for anonymous users, but not for content that requires user credentials. According to [http://confluence.atlassian.com/display/DOC/Setup+External+Search+Tool+To+Index+Confluence](http://confluence.atlassian.com/display/DOC/Setup+External+Search+Tool+To+Index+Confluence%20), there needs to be a confluence user specifically for TheBrain to use. But we can't find a way to associate a user to the TheBrain software. Any thoughts?

Thanks!


Answers:
author: Andrew Frayling
body: Hi,

Does adding the following parameters to the URLs that you want to attach work:

```
?os_AuthType=basic&amp;os_username=&lt;user&gt;&amp;os_password=&lt;password&gt;
```

where \<user\> and \<password\> are the details of the Confluence user you have created for "TheBrain".

Andrew.


author: Richard Hierro
body: Done :)


author: Richard Hierro
body: Thank for your answer, Andrew!

It works, thanks a lot !

Richard

comments: author: Andrew Frayling
body: Hi Richard,

Glad it worked. Could you give Alyson a nudge via your CSP-79457 support ticket to mark my answer as correct please?

Thanks,

Andrew.
Best way to automatically update a page on an Atlassian-hosted Confluence site
Asked by Dave Drexler:

Hi folks - I'd like to create a "System Status" page on our hosted Confluence site. My company's product is a website, and if the site is down or experiencing other issues, I'd like to use Confluence to communicate the situatiion to our customers. But I don't want the status updates to be a manual process. I also don't want the information to exist in any publically-accessible site.

We have plenty of tools that monitor our website's health and pump out status information. But how to insert that info into an Atlassian-hosted page? Using something like the HTML-include macro won't work, since we don't want the info on a public site.

Any ideas?


Answers:
author: Bob Swift (personal)
body: [Confluence Command Line Interface](https://studio.plugins.atlassian.com/wiki/display/CSOAP) [storePage](https://studio.plugins.atlassian.com/wiki/display/CSOAP/Documentation#Documentation-storePage) action.

comments: author: Dave Drexler
body: Thanks, Bob, that was one of my first thoughts. But Atlassian Support told me that the CLI plugin was verboten in the hosted sites.


author: Bob Swift (personal)
body: Download the client to your PC, there is no host requirement other that SOAP API being enabled.


author: Dave Drexler
body: Well, they would (and did) enable the API for me, so I can give that a try. Meanwhile, I think I'm getting close with a script I found here: <http://confluence.atlassian.com/display/DISC/XML-RPC+Page+Updater+Example>


author: Bob Swift (personal)
body: The remote API setting is on be default and you can control it provided you are the site administrator. It is the same remote API required for the XML-RPC.


author: Dave Drexler
body: Actually, it was off by default, and the settings are greyed out. This is an Atlassian-hosted version of Confluence (at "onconfluence.com") and the General settings in the console are not accessible.

I think I have my answer with this little Python script (linked above). Works like a charm.

Thanks, Bob - I appreciate your help (and all your plugins).


Tags: cloud

confluence-cloud
Confluence plugin with macros - content linking
Asked by Martin Stiborsky:

Hello,

I'm working on my first plugin for Confluence. I have created few macros. One of the type is something like "list macro", this one will make list of all my other macros on the page.

What I need is to link every item (=found macro) of the list, to particular place where the macro is on the page. With HTML anchor probably.

Right now, I haven't clear idea how to do it. Could you please give me a little hint, if you know some concept?

Btw, now I realized, it is almost the same like "Table of contents" macro...It would be nice to see the source ;)

Thanks!


Answers:
author: Septa Cahyadiputra
body: Hi Martin,

I'm not really sure of the concept here, but in regards to the "Table of Content" plugin source, you could find it here

<https://studio.plugins.atlassian.com/svn/TOC/tags/toc-plugin-2.5.12/>

Hope it helps you find the necessary answer on this.

Cheers,  
Septa Cahyadiputra


Tags: app

macro
How to migrate Confluence users from one AD to another one?
Asked by Sorin Sbarnea (Citrix):

I have an old AD with Confluence user accounts and I need to swithc to the official one.

Assuming that the users id is the same how can I do this in Confluence 3.5?


Answers:
author: HuseinA
body: You can just simply disable (and remove if necessary) the current existing AD User Directory, create a new [AD User Directory](http://confluence.atlassian.com/x/oQ2zDQ), sync it and you should be all set. Note that you'll need to be logged in as an internal admin user to perform the mentioned steps. If you're not sure about your internal admin account, you can identify it using [this way](http://confluence.atlassian.com/display/DOC/Restoring+Passwords+To+Recover+Admin+User+Rights#RestoringPasswordsToRecoverAdminUserRights-Step1IdentifyAdministrator).


Tags: active-directory

migration

user-directory
Export a confluence page for client review (no login required)
Asked by Gijs Epping:

Hi,

We had a problem that we wanted our customers to review technical documentation but i didn't want them to have access to the system. The content of page is private so i couldn't put it on a public page.

Currently there is no option to link to a "private" viewing url that has visibilbe without logging in. So i created a simple script that exports a whole page (attachments and all) and put it in a folder.

It is some ugly coding but it works! just fill in your username, password, the space ID and the page title and you can export it.

```
&lt;?php$soapClient = new SoapClient(null, array("location" =&gt; "http://shopworks.atlassian.net/confluence/rpc/soap-axis/confluenceservice-v1?wsdl","uri" =&gt; "http://soap.rpc.confluence.atlassian.com", "trace" =&gt; TRUE));$soapClient = new SoapClient(    "http://shopworks.atlassian.net/confluence/rpc/soap-axis/confluenceservice-v2?wsdl"    ,array("trace" =&gt; 1, "exceptions" =&gt; 0));      $token = $soapClient-&gt;login('username', 'password');$name_document = 'Title of the document';$name_space = 'TO';$page = $soapClient-&gt;getPage($token,$name_space,$name_document);$page2 = $soapClient-&gt;renderContent($token, $name_space, $page-&gt;id);$attachments = $soapClient-&gt;getAttachments($token,$page-&gt;id);foreach($attachments as $attachment){    $file = file_get_contents((string)$attachment-&gt;url.'&amp;os_username=username&amp;os_password=hk37K');    $dir = "/home/shopworks/www/wiki/download/attachments/".$page-&gt;id.'/';        if(!is_dir($dir)){       mkdir($dir, 0777);       chmod($dir, 0777);    }        file_put_contents($dir.$attachment-&gt;fileName, $file);}function niceName($name){    $name = str_replace(' ', '_', $name);    $name = strtolower($name);        return $name;}$str =  str_replace('&lt;/style&gt;',$style, $page2);$str = str_replace('&lt;/body&gt;',$footer, $str);$newName = md5(time()).'-'.niceName($name).'.html';file_put_contents($newName, $str);chmod($newName, 0777);echo 'http://www.shopworks.nl/customerpage/'.$newName;?&gt;
```

Hope somebody finds it as usefull as me.

Greetings Gijs

<http://www.shopworks.nl>


Answers:
author: Gijs Epping
body: Hi Gary,

Thank you, the format is html. When you use this with other plugins like Balsamiq or Gliffy you will have some problemns viewing.

But this is our latetst version with a nice template:

<http://pastebin.com/UEQqNutZ>

Greetings Gijs


author: Gary
body: Hi Gijs,

Nice work on this - what format does the page get saved as locally? Our Support Staff will proably link this as a posssible workaround for other users - again, great work.

Cheers,

Gary


Tags: cloud

confluence-cloud
Sort headings automatically in a page
Asked by Rumceisz:

Hi All,

let me ask for a help: is there a wikimarkup or macro we can automatically sort the headings in a pge in Confluence? There is a page in our company where are important infos about applications are listed (more than 100). The content is continuinely gaining with new application infos.

But to find the correct place of an application name is very cumbersome. So it would be very helpful if we could add the new content to the end of the page and after save the new content jumps to its correct place in the alphabetically order.

Tanks for your suggestions!

Best Regards,

Rumi


Answers:
author: Andrew Frayling
body: Hi Rumi,

I can't think of a way of doing this in-page as a page is unstructured content, but if you had a separate page for each application you could assemble a single index page in alphabetical order by using the Content By Label Macro - <http://confluence.atlassian.com/display/DOC/Content+by+Label+Macro>

If you had a separate page for each application and made sure you labelled each page with a common label you could then have an index page with the Content By Label macro on it which had the parameter set to order by page title. Whenever you subsequently created a page for a new application it would automatically be inserted into the correct position in the alphabetised list.

Would that work for you?

Andrew.

comments: author: Rumceisz
body: Hi Andrew,

my page is not unstructured: it has 100+ 'h1' headings and I would like to sort the content according to the headings. E.g. I have headings ('h1' wiki markup):

h1. Gary

....

h1.Bill

..

h1.Andy

....

h1.Drew

...

and I would like to achieve:

h1.Andy

...

h1.Bill

...

h1.Drew

...

h1.Andy

...


author: Andrew Frayling
body: Hi Rumi,

Sorry, when I said "unstructured" I meant it's not fields in database or columns in a table or spreadsheet and as such Confluence just sees it as one big block of text that it cannot sort.

As mentioned you could split it into separate pages where each heading it the title of a separate page and Confluence is then able to order by page title, or you could try splitting it into a table with each heading and its content as a separate row and wrapping it with the [Table Plus Macro](https://plugins.atlassian.com/plugins/org.swift.confluence.table) which you could then sort by column.

Does that help?

Andrew.


Tags: sort