|
| July 27th, 2008 Version 2.0 released! All the current known issues have been resolved. Additionally you can now include excerpts from other spaces. See the details below. The trial works for up to ten excerpt includes. There is no time limit on the trial. You can purchase the plugin anytime to remove the limitation. |
Description/Features
The multi excerpt plugin behaves like the excerpt macro, but allows for multiple excerpts, from multiple spaces.
Usage
{multi-excerpt} parameters:
- name - required the excerpt section must be identified
{multi-excerpt-include} parameters:
- pageTitle - required title of the page from which the macro is being retrieved
- spacekey:pageTitle - the above option can also take the form of spacekey:pageTitle if including content from a different space.
- name - required must match the excerpt being retrieved
- nopanel - optional this excerpt is displayed inside a panel unless nopanel=false.
Examples
On the page with text you wish to have included elsewhere:
A page with title: Sample Page
{multi-excerpt:name=some sample 1}
some text excerpt 1
{multi-excerpt}
{multi-excerpt:name=some sample 2}
some text excerpt 2
{multi-excerpt}
On the page where you are including the text
{multi-excerpt-include:pageTitle=Sample Page|name=some sample 1|nopanel=true}
{multi-excerpt-include:pageTitle=Sample Page|name=some sample 2|nopanel=true}
{multi-excerpt-include:spaceKey:pageName|name=excerptName|nopanel=true}
Output on the page with excerpts being displayed
some text excerpt 1 some text excerpt 2 some text from a different space sample page
Version History
New Requested features and fixes for version 2.0
Open Issues
Please add new issues to the multi-excerpt JIRA project
Please vote for an existing issues which appeal to you.
FAQ
How does the trial work?
Version 2.0+ of the plugin allows up to 10 multi-excerpt-includes to work. The same excerpts can be included multiple places and only count once. Once you have more then 10 the addition multi-excerpt-includes will display a message with a link to where you can purchase a license.
How much does the plugin now cost?
The plugin currently costs $50.
Why is this now commercial when it was free?
The plugin was initially released as open source. After approx. 1000 downloads the newer versions of Confluence required updates to the plugin. Additionally people requested clever enhancements. I fixed the plugin a couple of times, but Confluence updates continued to break it.
After trying to figure out how to best help the many companies who use this plugin I decided to rerelease it completely fixed, updated and with several feature requests implemented.
To do this I have to charge a small fee. Purchasers of this plugin will be offered support to their issues and continue to see enhancements to this plugin.
Will this continue to work as new versions of Confluence as they're released?
Yes!
What versions of Confluence will this work with?
Currently tested against 2.7 and 2.8 however if I receive requests for other versions of Confluence I'll endeavor to support those as well.
My question is not answered
Please add it as a JIRA issue and I'll add the answer here
I'd like to see a new feature
Please add it to the JIRA support project and I'll do my best to evaluate it and respond or implement it if possible ASAP. I'd love more ideas.
How are payments processed
Payments are processed using Paypal and Google Checkout via the award-winning payment processor e-junkie.
Our project is open source or non for profit, do you honor Atlassian's same approach towards these types of projects?
Yes. If you have a Confluence license of those types just email me the site from a similar email address (same domain) and I'll send you a license. soon the plugin will determine the Confluence license type automatically and this will not be necessary.
What happened to the original open source code?
It's still available here.
Download history of the multi-excerpt plugin for the last year
Total:

Comments (53)
Dec 08, 2006
Alan Vander Hoeven says:
I like this plug in and have used it quite a bit. I would however really l...I like this plug in and have used it quite a bit. I would however really like to do a multi-excerpt-include with a page from a different space. The pageTitle parm does not recognize the space:page convention.
May 19, 2008
Nicholas K says:
Any chance that mult-excerpt works across spaces? Or does it have the same limit...Any chance that mult-excerpt works across spaces? Or does it have the same limitation identified with excerpt (CONF-5752)?
Cross-space excerpting would be great.
Jul 28, 2008
Brendan Patterson says:
This now works for v2.0. Please see the usage documentation for details.This now works for v2.0. Please see the usage documentation for details.
Jul 05, 2007
Richard Tilghman says:
This plug-in is a GREAT idea. However, what I really need is for it to be ...This plug-in is a GREAT idea. However, what I really need is for it to be integrated with other macros like the Children macro... that way I can actually have multiple excerpts for dynamically defined locations (say a list of all children below a parent) displayed without having to manually create the lists with multiple excerpts specified.
Any chance this new version of excerpt will be incorporated into other macros?
Rick
Jul 05, 2007
David Peterson [CustomWare] says:
I would suggest a combination of the set-data macro from the Scaffolding Plugin ...I would suggest a combination of the set-data macro from the Scaffolding Plugin and the Reporting Plugin (check out the 'Custom Children' recipe).
Jul 28, 2008
Brendan Patterson says:
This should now work with version 2.0.This should now work with version 2.0.
Sep 18, 2007
Firat Vakiliev says:
This pludin is suited for me, however it is`t support the source page security r...This pludin is suited for me, however it is`t support the source page security restrictions. Why?
Jul 28, 2008
Brendan Patterson says:
Page security restrictions have been added for v2.0!Page security restrictions have been added for v2.0!
Dec 14, 2007
Redcosmos King says:
I would like to be able to group together contents from multiple "multi-excerpt"...I would like to be able to group together contents from multiple "multi-excerpt" sections with the same name within the page. For example, a content page with markup:
{multi-excerpt:name=topic1} some content for topic1 {multi-excerpt} ..... {multi-excerpt:name=topic2} some content for topic2 {multi-excerpt} ..... {multi-excerpt:name=topic1} some more content for topic1 {multi-excerpt} ..... {multi-excerpt:name=topic2} some more content for topic2 {multi-excerpt} .....Then a summary page with markup:
Topic 1: {multi-excerpt-include:Content page|name=topic1} Topic 2: {multi-excerpt-include:Content page|name=topic2}should show:
The current behavior seems to only show the last excerpt for each "multi-excerpt:name":
Jul 28, 2008
Brendan Patterson says:
thanks for the great idea. I've added the suggestion here: http://developer.atla...thanks for the great idea. I've added the suggestion here: http://developer.atlassian.com/jira/browse/CMEP-6
please vote for it.
Mar 12, 2008
Rick Hadsall says:
I love this plugin, with one major exception - it kills all formatting within t...I love this plugin, with one major exception - it kills all formatting within the excerpt. So while it renders great on the page that includes the content, on the master page, it looks terrible. Headings (h1 h2 h3 h4 etc), macros, table formatting all get killed...
Is there a way you could make an option to turn that on and off?
Mar 13, 2008
Brendan Patterson says:
Rick, Could you please try this version and let me know if it works better. At...Rick,
Could you please try this version and let me know if it works better.
Atlassian seems to have changed the way the page render modes work in the last few versions. In fact I had no idea so many people were using it till it broke
Jul 28, 2008
Brendan Patterson says:
this is fixed with v2.0 and will continue to work moving forward.this is fixed with v2.0 and will continue to work moving forward.
Mar 13, 2008
Man Che says:
I was trying to install this plugin, but get some error when loading, any help h...I was trying to install this plugin, but get some error when loading, any help here?
I am on Confluence 2.6.0 and J2SE v1.4.2_13 SDK
Thanks in advance.
Man Che
Multi Excerpt
Vendor: Brendan Patterson
Plugin Version: 1.1
Multi Excerpt Plugin
Uninstall plugin | multi-excerpt
Identify multiple excerpts within a page
Error: There was a problem loading the descriptor for module 'macro' in plugin 'Multi Excerpt'. Class version is incompatible with current JVM: biz.artemissoftware.confluence.multiexcerpt.MultiExcerptMacro |
Mar 13, 2008
Brendan Patterson says:
Yes the issue here is that you're running with Java 1.4.2 and this multi-excerpt...Yes the issue here is that you're running with Java 1.4.2 and this multi-excerpt-macro plugin was compiled with JDK 1.5
Your options are to:
1) move to running your Confluence instance with Java 5 (also known as 1.5)
2) grab the source code and recompile it with JDK 1.4
3) contact me to recompile it for you.....I'd do it for free but I'm about 3x overbooked. But ping me via email if you need help.
May 21, 2008
Man Che says:
We use Java 6 now, and looks like the error goes away. Thanks.We use Java 6 now, and looks like the error goes away.
Thanks.
Jun 05, 2008
Aditee says:
Hi, We have just upgraded to confluence 2.7.3 and have Multi Excerpt plugin ver...Hi,
We have just upgraded to confluence 2.7.3 and have Multi Excerpt plugin version 1.1 installed.
When we are using a table inside the multi-excerpt macro it is not displaying the table and just reading it as simple text.
{multi-excerpt:name=some sample 1} || Status || Task || Target Date || Comments || | 1 | XYVVVVV | ABC | type any comments here...| {multi-excerpt}Could you please let us know what can we do to recitify this.
Also the multi-excerpt-include plugin in this case is working as expected and is able to display the table on the page it is called.
JFYI previously when we had confluence 2.5.8 and Multi Excerpt 1.0 it worked fine.
Thanks and Regards
Aditee
Jun 15, 2008
Simon Wheatley says:
Hi Aditee, The new version linked in Brendan's answer on Mar 13 solved this for...Hi Aditee,
The new version linked in Brendan's answer on Mar 13 solved this for us. It seems the version in the Plugin Repository is out of date.
Jun 15, 2008
Simon Wheatley says:
I'm not sure where the issues log for this project is, so I'm posting this here....I'm not sure where the issues log for this project is, so I'm posting this here. Hope that's OK.
Currently the multi-excerpt macro doesn't render images which are attached to the original page. Would be really cool if it did!
Jun 16, 2008
Brendan Patterson says:
thanks for the problem report. I've noted it. For the moment this is probably th...thanks for the problem report. I've noted it. For the moment this is probably the best place to report issues.
keep in mind that the source code is available so if you have any people available who know a bit about Java you can probably tweak this into shape.
Thanks for the interest!
Jun 16, 2008
Simon Wheatley says:
Thanks Brendan, no expectation of anything. (Sadly my Java-fu is limited to be...Thanks Brendan, no expectation of anything.
(Sadly my Java-fu is limited to being able to spell it, my skills are mainly in JS, CSS and HTML.)
Jul 28, 2008
Brendan Patterson says:
fixed in version v2.0fixed in version v2.0
Aug 11, 2008
Simon Wheatley says:
The macro still doesn't seem to render images which are attached to the original...The macro still doesn't seem to render images which are attached to the original page. If you attach the images to the "slave" page, then they are rendered. Have I missed something?Scratch that. I've misread the plugin repo page in admin, and thought someone else had installed v2. I'm still on v1.2 which is probably why it's not working./me Goes to get credit card.
Aug 12, 2008
Brendan Patterson says:
Simon, I saw your first post yesterday and have just now had the time to look a...Simon,
I saw your first post yesterday and have just now had the time to look at your issue.
I believe your revised statement is correct
I've just done another test and the image rendering does seem to be working in every direction that I can tell.
thanks for the purchase!!!!! I REALLY appreciate it!!!!!!
Brendan
Aug 13, 2008
Simon Wheatley says:
Yep, it's all working now. Thank you.Yep, it's all working now. Thank you.
Jun 24, 2008
Mike Burr says:
Hi, is there a way to link excerpts between spaces? Thanks.Hi, is there a way to link excerpts between spaces? Thanks.
Jul 28, 2008
Brendan Patterson says:
Yes. I've added this feature for v2.0. You can find the new syntax in the docum...Yes. I've added this feature for v2.0. You can find the new syntax in the documentation of this page. Thanks for the great suggestion!
Jul 19, 2008
Vijay Iyer says:
I observe the same behavior reported by Rick Hadsall on March 12, and will be tr...I observe the same behavior reported by Rick Hadsall on March 12, and will be trying 2.7.1 on Monday when my wiki adminstrator is in. Since it seems by the comments of some (Simon Wheatley) to do the trick, it would be great if it were made the current version...it's going to be a hard sell to my administrator to install this new version based on the comments here!
Jul 19, 2008
Brendan Patterson says:
Hi, I've actually fixed that problem with formatting and added a few new featur...Hi,
I've actually fixed that problem with formatting and added a few new features including permission checking AND the ability to include excerpts from other spaces.
I've been working hard and will be releasing these updates in the next couple of days (they're not available just yet). So please put a 'watch' on this page (meaning you'll be emailed updates) and stay tuned.
I'll be adding other new features people have suggested as well ASAP.
thanks,
Brendan
Jul 28, 2008
Brendan Patterson says:
All known issues issues as of this posting are fixed for version 2.0.All known issues issues as of this posting are fixed for version 2.0.
Jul 29, 2008
Darcy Max says:
Hi--great plugin! We just updated to version 2.0 of the multi-excerpt plugin...Hi--great plugin! We just updated to version 2.0 of the multi-excerpt plugin, and are running v2.5.7 version of confluence. For my page, I am using the dynamictable plugin within the multi-excerpt text, and the table rendors correctly in the multi-excerpt-include page, but the raw text is displayed in the page where content will be displayed elsewhere. Is it the dynamictable plugin, or something else that is causing this problem? Thanks!
Jul 30, 2008
Brendan Patterson says:
Hi, I'm working on this. Will hopefully have the fix in a day or two. I ran int...Hi,
I'm working on this. Will hopefully have the fix in a day or two. I ran into a tricky issue.
Stay tuned
Jul 31, 2008
Brendan Patterson says:
Darcy, Can you please try the attached updated version and see if it does what ...Darcy,
Can you please try the attached updated version and see if it does what you need?
plugins-multi-excerpt-2.0.1.jar
One caveat is that you might have to visit the page with the multi-excerpt once for the page with the multi-excerpt-include(s) to display properly. Or maybe not. I'm not sure
Otherwise I think it should well.
thanks!!!
Brendan
Jul 31, 2008
Brendan Patterson says:
Just confirmed this works with dynamictable macro for Confluence 2.5.7Just confirmed this works with dynamictable macro for Confluence 2.5.7
Aug 01, 2008
Darcy Max says:
Thanks Brandon--you're the man! It did fix the problem, and I did have to vi...Thanks Brandon--you're the man! It did fix the problem, and I did have to visit page twice for it to render correctly in the multi-excerpt-include page (the multi-excerpt page rendered correctly the first viewing). It does put some extra spacing before the text though. Suggestions? Thanks again. Darcy.
Aug 01, 2008
Brendan Patterson says:
I had a look and confirmed what you're seeing. However I think you can fix thi...I had a look and confirmed what you're seeing.
However I think you can fix this by putting the macro on the same line.
For instance instead of this:
===== start outside {multi-excerpt:name=some sample 1} start inside stuff stuff more stuff end inside {multi-excerpt} end outside ===try doing this:
===== start outside{multi-excerpt:name=some sample 1} start inside stuff stuff more stuff end inside{multi-excerpt} end outside ===Aug 04, 2008
Darcy Max says:
Worked perfectly! Many thanks!Worked perfectly! Many thanks!
Aug 05, 2008
Bob Swift says:
Documentation for how to use this with excerpts from other spaces needs to be co...Documentation for how to use this with excerpts from other spaces needs to be corrected. From our experiments, it looks like you need to specify the space and page as the default parameter. It is not clear what named parameter represents the default parameter, but pageTitle didn't seem to be it. The space key does not go in front of the excerpt name as shown under parameters. The example is more accurate.
{multi-excerpt-include:spaceKey:pageName|name=excerptName}I would suggest making page the parameter name (see Macro Parameters Index) for the page name with or without a space key and it be the same as the default parameter.
Aug 05, 2008
Brendan Patterson says:
Hi Bob, Thanks for pointing that out! You are absolutely right. I have updated ...Hi Bob,
Thanks for pointing that out! You are absolutely right. I have updated the documentation.
I'm pretty sure you have 'content contributor' privileges so feel free to edit any page of mine in the future directly.
Aug 06, 2008
Vijay Iyer says:
As far as I can tell, it's not possible to use this plugin to include excerpts s...As far as I can tell, it's not possible to use this plugin to include excerpts specified on the /same/ page. Is this right? IF it were possible, then this would be a nice way to cleanly place the same content multiple times within a page...I'm not sure of another way to do this. Maybe somebody has some ideas...
Aug 06, 2008
Brendan Patterson says:
This does work on the same page if you choose to use it that way. For instance...This does work on the same page if you choose to use it that way.
For instance this (all on the same page):
{multi-excerpt:name=some sample 1} a text excerpt 1 {multi-excerpt} ======= {multi-excerpt-include:pageTitle=Home|name=some sample 1|nopanel=true} {multi-excerpt-include:pageTitle=Home|name=some sample 1|nopanel=true} =======yields this:
Aug 06, 2008
Vijay Iyer says:
Thanks for the reply, I've verified that your snippet works as you describe on o...Thanks for the reply, I've verified that your snippet works as you describe on our installation (v2.8.0). I've updated the issue [CMEP-8] accordingly to a much simpler request.
I've isolated the problem I'm having to the combination with the visibility plugin, which we're quite dependent on. Including {multi-excerpt-include} within a visibilty plugin block appears to disable wiki rendering.
This has been reported as a new issue. [CMEP-9]
Aug 06, 2008
Brendan Patterson says:
An impressive use of plugins! I'll have a look. Off hand I'm not sure what the ...An impressive use of plugins!
I'll have a look. Off hand I'm not sure what the issue is.
When you sent your initial post I was going to recommend peeling back or reading the individual layers to see what's breaking but it looks like maybe you've done that.
Aug 06, 2008
Brendan Patterson says:
Did you try it the other way around? Putting the visibility plugin inside the m...Did you try it the other way around? Putting the visibility plugin inside the multi-excerpt?
I'm not sure if it will work any better but it's at least a 50/50 chance. If it does work then the visibility plugin must be fixed since it's encapsulating the other content.
Sep 29, 2008
Mika Halttu says:
I tried to include content which had {create-page} plugin to create sub-pages an...I tried to include content which had {create-page}
plugin to create sub-pages and read it with reporting plugin.
It works ok for Multi-Excerpt plugin v. 1.1in Confluence 2.8, but in Confulence 2.9.1 and Multi-Excerpt 2.0 these new pages created with same create-page command are created as sub-pages to page that has excerpt written, not where excerpt is included. Same happens when reading reporting plugin, only pages under the page where excerpts are written are included.
How can I adjust multi-excerpt-include to target the including page, not the included page?
Oct 07, 2008
Brendan Patterson says:
I'll have to look into this. Figuring out how the excerpt plugin works when used...I'll have to look into this. Figuring out how the excerpt plugin works when used in conjunction with other plugins/macros can be tricky especially when you factor in Confluence server changes from version to version as seems to have caused an issue here.
Can you give me some specific examples? Perhaps both some code snippets?
You can surround any wiki-markup code with {code} text markup {code} tags.
Aug 28
Tim Kaddoura says:
This macro works like a charm in 3.0.1 but breaks the rendering of macros like -...This macro works like a charm in 3.0.1 but breaks the rendering of macros like - say - table-plus. If a table-plus macro resides within a multi-excerpt, the displayed content (on the page itself) gets rendered as a single string as oppose to an actual table. Code to reproduce:
{multi-excerpt:name=blah} {table-plus:sortIcon=true} || Attribute Name || UI Location || Notes/Description | {color:gray}*Data Type (DS)*{color} | | Last idle time | Display Channel | Timestamp counter when the channel last entered idle state | {color:gray}integer{color} | | Call | Display Channel | Last call ID made on that channel | {color:gray}integer{color} | {table-plus} {multi-excerpt}Any chance we can get this fixed?
Update
Never mind - I reproduced this issue with the native {excerpt} macro and turns out with the same issue. This isn't multi-excerpt's fault after all!
Aug 28
Brendan Patterson says:
Hi Tim, Thanks for the report and your interest! I'll look into it. My general...Hi Tim,
Thanks for the report and your interest! I'll look into it.
My general policy is to do my best to support what macros work with the default Confluence {excerpt} macro. Do you know off hand if the {table-plus} plugin works with that as well?
Brendan
Aug 28
Tim Kaddoura says:
Hi Brendan; I'm not sure if you caught my update on time, but I did try the same...Hi Brendan; I'm not sure if you caught my update on time, but I did try the same test with the default CONF {excerpt} and it fails as well. i.e. the following code fails to render the table:
{excerpt} {table-plus:sortIcon=true} || Attribute Name || UI Location || Notes/Description | {color:gray}*Data Type (DS)*{color} | | Last idle time | Display Channel | Timestamp counter when the channel last entered idle state | {color:gray}integer{color} | | Call | Display Channel | Last call ID made on that channel | {color:gray}integer{color} | {table-plus} {excerpt}So at this stage, the ball isn't on your court - I gotta do my begging elsewhere (maybe I'll start with Bob Swift
Aug 28
Bob Swift says:
... I would start with Atlassian (owner of the excerpt plugin). I suspect...Sep 01
Tim Kaddoura says:
Ok I did go beg over by Atlassian's doorstep and reported a customer ticket: CSP...Ok I did go beg over by Atlassian's doorstep and reported a customer ticket: CSP-36331
. I'll update you folks as soon as I get a response back (or perhaps when they create a community bug over at jira.atlassian.com)
Sep 04
Tim Kaddoura says:
Ok; Atlassian wouldn't budge on this issue as I had initially predicted: I am a...Ok; Atlassian wouldn't budge on this issue as I had initially predicted:
So I ended up reporting a bug against the TBL dev project (TBL-76). I should really be posting this comment on the table plugin wiki page - but Bob appears to have eagle-eyes over every wiki page
Sep 08
Louis Meyer says:
Hey there, I was wondering whether it would be possible to get multi-excerpts w...Hey there,
I was wondering whether it would be possible to get multi-excerpts working with the contentbylabel marcro?