To view the macro's documentation, click on its name below.
This will create a link on your page which, when clicked, is equivalent to clicking 'Add Page' on the Page Operations bar. more info...
Creates a simple form on a page for users to enter the name of the new page to add. more info...
Generates a list of links of pages which link into this page. more info...
This will create a link to a page, or a link to create a page based on a template and/or parent page. more info...
Creates a link to special Confluence locations. All locations are case-insensitive. more info...
Links to a page or URL, popping it up into a new window. more info...
Creates a list of pages which do not have any other pages linking to them. more info...
Creates a list of pages, websites and email addresses the current page links to. more info...
Creates a list of pages which are linked to but have not yet been created.
more info...
Below are listed some recipes which make use of this plugin. They are often good examples of how it can be used in real-world situations.
Includes the wiki content of all children of a page, headed by the page title and a link to edit the page. more info...
Create a reusable template for projects. more info...
This recipe generates a list of pages which redirect to other pages, and provides a non-redirecting link to that page, as well as direct links to edit or delete the page. more info...
If I use normal page linking like [this page], it will automatically be changed if the page gets renamed. I assume I lose that capability if I use these macros that reference pages. Correct?
Yes, that's the case at the moment. It may be possible to have it automatically detect the change, but that's not implemented yet. If you would like to see it happen in the future, please raise a [feature requests].
is it possible to specify a default title for the page beeing created? i tried to trick the parameters list, but confluence escapes the ampersand
add-page:boilerplate=StatusReport&title=Status+Report+for+XXXX
Sort of. You can specify the 'name' parameter, but then it will act like {link-page} - that is, once a page exists with the name specified, it will simply link to that page, rather than allowing you to add another page with a similar name. Of course, this may be exactly what you want to do. In which case I'd suggest using {link-page} instead, since this will be less confusing after the page has been created...
Eg:
{link-page:name=Status Report for XXXX|boilerplate=StatusReport}Status Report{link-page}With Linking 2.2.1 or later, you can dynamically drop in other information, such as today's date, or the title of the parent page. It's not properly documented yet, but there are a couple of examples here. In your case, this could be useful - you could do this, for example:
{link-page:name=Status Report for %content:title%|boilerplate=StatusReport}Status Report{link-page}This is handy if you have a bunch of similar subsections in your space which need unique names.
However, what I think you're really after is the ability to specify a prefix. That isn't currently possible, but is on the todo list. The main problem is what do to with non-live templates, which currently have no way of handling that type of information. But that's more of an implementation issue anyway...
Man, this is even handier than i'd expected!
I did the following:
(+) {add-page:boilerplate=StatusReport|name=Status Report for '%content:title%' - %global:current date > date:MMMM yyyy%|parent=@self|live=true}Add a new Status Report{add-page}Unfortunately, as you mentioned, once the status report for the current month exists, add-page links to the existing report instead of creating a new page. I'll try to figure out a way where the user can select the report period before the page/link is acually created. The create-page macro somehow does the trick, but only halfway.
Besides, using add-page as above, the usual "add page" dialog of Confluence is displayed with a disabled title text box.
You may find the Replace and Render or Run plugins useful here.
However, you may just need to specify the day to be part of the date also. How often are your status reports generated? Or, you just relabel the link to 'This month's status report'.
The disabled title text box is normal when the title is provided - such as clicking on a [Non-existent Page] link. But probably doesn't help you.
Anyway, hope that helps...
Thanks for the hint to the replace-and-render plugin!
I'm now using plain HTML to display two drop down lists (month, year) allowing the user to select the report period. Clicking the adjacent "Create Status Report" button triggers a JavaScript which in turn redirects to the "add page" dialog with the predefined title.
Cool. That sounds like a technique which might be useful to others. Perhaps you could post your wiki code as a comment on the Replace and Render Macro?
I've commented my solution on the replace-and-render plugin page.
I'd suggest clarifying how to using {link-page} (and related macros) to create a new page that has no parent and what is meant by the default value for the "parent" parameter.
For example:
{link-page:New Page} - creates a new page with parent @self (current page)
{link-page:New Page|parent=} - is the way to create a new page with no parent
Not entirely clear from above. Thanks.
I very much like the dynamic field facility with the Reporting plug-in Supplier API, but it seems like the facility to use the Scaffolding data supplier (i.e. data:<value name>) does not work. In particular, the following doesn't work as intended
{table-data:Suite Releases} || Some Text || A Link || | {text-data:Text} | {link-page:boilerplate=A Template|name=A page about %data:Text%}Info {link-page} {table-data}Unfortunately, the %data:Text% notation isn't Scaffold-context aware. So, when you put %data:Text% into your link-page macro, it will be looking for the 'Text' field at the top level of the page, not inside the current row.
Probably the best thing is to add it as a feature/bug request in JIRA and I'll see what we can do in the next version.
I've just seen this and think it is the same as the problem I'm experiencing (see message lower down). I'm just wondering if this was ever addressed/added?
Thanks
Yes, this is the same issue as with {list-data}, and currently it has not been addressed. It wasn't even possible with anything prior to Reporting 2.0.0 (which is not quite released yet). It's on the priority list for the next version of Scaffolding once Reporting 2 comes out.
I've just seen this and think it is the same as the problem I'm experiencing (see message lower down). I'm just wondering if this was ever addressed/added?
Thanks
The link-window macro doesn't handle = correctly so URLs with parameters result in an error.
For example http://www.google.fi/preferences?hl=en which is a perfectly valid url results in
Google search preferences
This is due to how Confluence parses macro parameters. To use a URL with an '=' in it, use the 'href' parameter instead of the default parameter. E.g.
{link-window:href=http://www.google.fi/preferences?hl=en}Google search preferences{link-window}Which results in:
Google search preferences
Thank you for the quick response and for this useful macro.
Has the "link-page" macro also an analogous option to the "create page" macro's title option?
Because that's exactly what I need:
I've already tried something like that
But this won't work, because I've to increment the number of the size of the list and get problems by deleting a page, which is not the last page with the highest number at the end of its title.
Any idea?
Sorry, I've forgotten to set the code in noformat-tags.
{link-page:name=%content:title%%content:children > collection:size%}Yeah, deleting pages would foil that method. There isn't anything around which would generate that number automatically (I'm not even sure how you could write something which would work reliably, since it's actually the combination of the first %...% value and the number which makes it unique). Perhaps some kind of persistent counter (I think there is a feature request for such a thing already, actually).
Hello,
Is there any way to create a news item based on a template, with a particular name and label?
r. Ville
Not at present. If you'd like to see it in the future, please create a feature request.
As a new user of Confluence I found a problem when adding this Macro to our site. When a new browser and the link included '=' character is opened and I choose to go back to the confluence window where the link was and I try to do something, I get the Confluence login page and have to login again. What can be the reason?{link-window:href=http://ourdomain/secure/CreateIssueDetails.jspa?pid=10010&issuetype=4&components=10111\}Jira {link-window}
I can't think of anything which would do this unless the target URL does something to log you out. From a completely technical point of view, I can't even see how it's possible...
Just to add some information, we run Confluence on the Jira authentication database if this does any difference? Also the "old" confluence window does not prompt for login until you try to do something. Is there some log where I could find more information in Confluence?
My suggestion would be to raise a support request with Atlassian themselves - this is most likely a configuration problem with Confluence, since I can't think of any way that clicking a link to an external site could possibly log you out of Confluence...
If you would like to follow it up from this end, the best idea is to create a bug report - it is both easier to track and more likely to get fixed in that environment.
I'd like to use add-page but have it open up the page to add in a new popup window. Can this be done?
I have just instlled Confluence 2.7 and this plug-in is not on the list. Could you include it for this version? Or, if I upload Link Plugin version 2.4.2, will it works for confluence 2.7? Thanks.
Is it possible to sort incoming links? I have possible many-to-many associations, and on one type of page I want to link pages of another type that link to it. I'd like to sort at a minimum by page title; ideally I would like to sort by the value of Scaffolding field, but that's probably reaching.
Thanks!
Not with the {incoming-links} macro, but you can if you use the Reporting Plugin. Something like:
{report-list} {local-reporter:content:incoming links} {text-sort:destination > title} {text-sort:destination > data:My Scaffold Data Field} {local-reporter} {report-body}{report-info:destination > title|link=true}{report-body} {report-list}Hi All,
Can you confirm if the Linking Plugin 2.6.2 is compatible with Confluence 2.6.2? It appears not as there is a dependency on the class AbstractAttachmentLink, which made its debut in Confluence 2.7 I think.
Also, can you direct me to where I may download some of the jar dependencies for the Linking plugin - e.g. confluence-supplier-2.0.1 and confluence-filtering-2.0.3? It appears that some of these versions are snapshots?
Many thanks for any information you can provide.
Regards,
Keith
Hi Keith,
Could you please confirm what version of Linking you're using? The latest version (released today) is 2.5.0. It was built against Confluence 2.7, but it's the first to do so and no major code modifications were made in the meantime, and there is no direct reference to AbstractAttachmentLink in any code anywhere that I've written. Perhaps you could email me the stack track for the problem you're having?
With regards to confluence-supplier and confluence-filtering, the source code is in Atlassian's SVN repository and the binaries are in Atlassian's Contributors Maven 2 repository. Final releases of the libraries used in Linking were also posted there today.
Let me know if you have any trouble.
Hi David - thanks for the prompt and helpful response! have located the jars as you stated and have popped you an email with the errors I encountered with Linking Pluging 2.5.0 and Confluence 2.6.2.
Thanks!
K