Minor version update

• Code maintenance: upgrade library dependencies

• Code maintenance: upgrade library dependencies

• Add "Find includes - selected space" to MultiExcerpt macro in macro editor
• Disable "Find includes - all spaces (SLOW)" by default. It is too CUP-intensive on large production sites.
• Do not log any data originally entered by a user

• Add "Find includes - selected space" to MultiExcerpt macro in macro editor
• Disable "Find includes - all spaces (SLOW)" by default. It is too CUP-intensive on large production sites.
• Do not log any data originally entered by a user

• Fix "Find Includes" to work for search across spaces
• Refactor "Find Includes" to use paginated Confluence search APIs (decrease load on database, increase scalability)
• Eliminate usage of deprecated Spring Hibernate APIs

• Fix "Find Includes" to work for search across spaces
• Refactor "Find Includes" to use paginated Confluence search APIs (decrease load on database, increase scalability)
• Eliminate usage of deprecated Spring Hibernate APIs

• Automatic migration tool for Server --> Cloud migrations
• See the release notes at MultiExcerpt - Server/Data Center - 5.6.0

• Automatic migration tool for Server --> Cloud migrations
• See the release notes at MultiExcerpt - Server/Data Center - 5.6.0

• per-macro configuration setting for enable/disable rendering inline comments from MultiExcerpts in MultiExcerpt Includes. This setting is on the MultiExcerpt Include and overrides the one that already exists in the MultiExcerpt and in the global settings.
• color picker for inline comments now has a preview of the hex color that is configured
• See the release notes at MultiExcerpt - Server/Data Center - 5.5.14

• per-macro configuration setting for enable/disable rendering inline comments from MultiExcerpts in MultiExcerpt Includes. This setting is on the MultiExcerpt Include and overrides the one that already exists in the MultiExcerpt and in the global settings.
• color picker for inline comments now has a preview of the hex color that is configured
• See the release notes at MultiExcerpt - Server/Data Center - 5.5.14

• add the ability for inline comments in "MultiExcerpt Enhanced Permission" macros to be rendered in "MultiExcerpt Include" macros. This is the same feature that was introduced recently for inline comments "MultiExcerpt" macros being included in "MultiExcerpt Include" macros.

• add the ability for inline comments in "MultiExcerpt Enhanced Permission" macros to be rendered in "MultiExcerpt Include" macros. This is the same feature that was introduced recently for inline comments "MultiExcerpt" macros being included in "MultiExcerpt Include" macros.

• Added logging to the processing code for the "Find Includes" button for MultiExcerpt macros.
• To enable the logging, use the Confluence Logging and Profiling admin tool to enable DEBUG or INFO level logging for the package net.artemis.plugins.conf.multiexcerpt4.rest
• The UI for the Confluence Logging and Profiling admin tool is hard to use: beware and make SURE you click the "Save" button that is way down at the bottom of that admin page when you change logging settings. Our document here has some screenshots: Downloading Confluence Server Log Files
• Search your Confluence server log for the log prefix FindIncludes:

• Added logging to the processing code for the "Find Includes" button for MultiExcerpt macros.
• To enable the logging, use the Confluence Logging and Profiling admin tool to enable DEBUG or INFO level logging for the package net.artemis.plugins.conf.multiexcerpt4.rest
• The UI for the Confluence Logging and Profiling admin tool is hard to use: beware and make SURE you click the "Save" button that is way down at the bottom of that admin page when you change logging settings. Our document here has some screenshots: Downloading Confluence Server Log Files
• Search your Confluence server log for the log prefix FindIncludes:

• Added XSS protection for old legacy wiki markup macro "multi-excerpt-include".

• Added XSS protection for old legacy wiki markup macro "multi-excerpt-include".

• Fix NullPointerException for legacy macros used in wiki markup

• Fix NullPointerException for legacy macros used in wiki markup

• Decrease size of the installation .OBR file by removing unnecessary chrome .zips

• Decrease size of the installation .OBR file by removing unnecessary chrome .zips

• See MultiExcerpt 5.5.8 Release Notes
• Adds the capability to enable/disable inline comments per macro. The setting is in the MultiExcerpt macro and affects whether or not inline comments on content in the body of the MultiExcerpt will be rendered in MultiExcerpt Includes
• Adds the capability for an admin to separately control the global setting for inline comment rendering in MultiExcerpt Includes vs Confluence Excerpt Includes.
• Bug fix: failure in inline comments feature when rendering in a Confluence Gadget in a Jira Dashboard

• See MultiExcerpt 5.5.8 Release Notes
• Adds the capability to enable/disable inline comments per macro. The setting is in the MultiExcerpt macro and affects whether or not inline comments on content in the body of the MultiExcerpt will be rendered in MultiExcerpt Includes
• Adds the capability for an admin to separately control the global setting for inline comment rendering in MultiExcerpt Includes vs Confluence Excerpt Includes.
• Bug fix: failure in inline comments feature when rendering in a Confluence Gadget in a Jira Dashboard

• Use MultiExcerpt Include Page Context. This new feature allows you to override the default behavior of rendering included content using the page context of the page containing the original content. Now you can override that to use the page context of the page containing the MultiExcerpt Include macro. See details in the release notes at MultiExcerpt 5.5.7

• Use MultiExcerpt Include Page Context. This new feature allows you to override the default behavior of rendering included content using the page context of the page containing the original content. Now you can override that to use the page context of the page containing the MultiExcerpt Include macro. See details in the release notes at MultiExcerpt 5.5.7

• Added client-side logic to disallow setting the "Space With Excerpt" parameter for a MultiExcerpt Include when the space is the current space. There is no need for a "Space With Excerpt" parameter for "this" space. Leave it blank. This is done to be consistent with how Confluence handles page links. They do not populate space attributes for page links within the current space. We need to be consistent with Confluence for proper handling of things like link rewriting during page copy operations.
• Added client-side logic to clear the "Space With Excerpt" parameter for a MultiExcerpt Include when the macro editor is opened, but only if the parameter is set to the current space. The user is prompted to save the macro to persist the change. This is also done to be consistent with Confluence's implementation of page links.

• Added client-side logic to disallow setting the "Space With Excerpt" parameter for a MultiExcerpt Include when the space is the current space. There is no need for a "Space With Excerpt" parameter for "this" space. Leave it blank. This is done to be consistent with how Confluence handles page links. They do not populate space attributes for page links within the current space. We need to be consistent with Confluence for proper handling of things like link rewriting during page copy operations.
• Added client-side logic to clear the "Space With Excerpt" parameter for a MultiExcerpt Include when the macro editor is opened, but only if the parameter is set to the current space. The user is prompted to save the macro to persist the change. This is also done to be consistent with Confluence's implementation of page links.

• enhance logging in net.artemis.plugins.conf.multiexcerpt4.advanced.xhtml.MultiExcerptHelper to make warning level loglines take up less disk space and provide full details with info level logging.

• enhance logging in net.artemis.plugins.conf.multiexcerpt4.advanced.xhtml.MultiExcerptHelper to make warning level loglines take up less disk space and provide full details with info level logging.

• admin tool for enable/disable MultiExcerpt Include cache was broken by the 5.5.1 release. This fixes it.

• admin tool for enable/disable MultiExcerpt Include cache was broken by the 5.5.1 release. This fixes it.

• Use Confluence's default encoding for rendering inline comments
• Update "Close" widget on "Find Includes" dialog in preparation for Confluence 7.12 support.

• Use Confluence's default encoding for rendering inline comments
• Update "Close" widget on "Find Includes" dialog in preparation for Confluence 7.12 support.

• Render inline comments in included content!
• Admin can enable (or disable) this new feature to allow inline comments to be rendered in included content
• Admin can disable inline comment viewing for anonymous users (not possible using only Confluence permissions)
• Users can toggle inline comment visibility on a page (for themself) and have that setting persisted
• See the MultiExcerpt 5.5.1 - Release Notes

• Render inline comments in included content!
• Admin can enable (or disable) this new feature to allow inline comments to be rendered in included content
• Admin can disable inline comment viewing for anonymous users (not possible using only Confluence permissions)
• Users can toggle inline comment visibility on a page (for themself) and have that setting persisted
• See the MultiExcerpt 5.5.1 - Release Notes

• minor code maintenance

• minor code maintenance

• add modules to more fully support Cloud --> Server migration

• add modules to more fully support Cloud --> Server migration

• better cluster support for the cache
• upgrade to Spring Java Configuration for more modern dependency injection (better startup performance, more maintainable code)
• when MultiExcerpt Enhanced Permissions (MEEP) is disabled then includes for MEEPs are disabled for users who do not have view permission for the page but do have permission via the MEEP. Previously, disabling MEEP only prevented page authors from adding new MEEPs.

• better cluster support for the cache
• upgrade to Spring Java Configuration for more modern dependency injection (better startup performance, more maintainable code)
• when MultiExcerpt Enhanced Permissions (MEEP) is disabled then includes for MEEPs are disabled for users who do not have view permission for the page but do have permission via the MEEP. Previously, disabling MEEP only prevented page authors from adding new MEEPs.

• XSS protection for MultiExcerpt Enhanced Permissions macro when including attachments
• Performance enhancement for MultiExcerpt Include cache access

• XSS protection for MultiExcerpt Enhanced Permissions macro when including attachments
• Performance enhancement for MultiExcerpt Include cache access

• security update
• fix problem with nesting excerpts inside of includes

• security update
• fix problem with nesting excerpts inside of includes

• Security update - SQL Injection Protection!!!
• work around Atlassian bug: NullPointerException caused by Page Properties Report macro and DefaultConversionContext
• update macro migrator for new MacroDefinition constructors in Confluence 7.7+

• Security update - SQL Injection Protection!!!
• work around Atlassian bug: NullPointerException caused by Page Properties Report macro and DefaultConversionContext
• update macro migrator for new MacroDefinition constructors in Confluence 7.7+

• minor code maintenance

• minor code maintenance

• fix special case for licensing

• fix special case for licensing

• security enhancements for retrieving attachments from restricted pages (MultiExcerpt Enhanced Permissions)
• fix failure during DEBUG level logging in a MultiExcerpt macro class

• security enhancements for retrieving attachments from restricted pages (MultiExcerpt Enhanced Permissions)
• fix failure during DEBUG level logging in a MultiExcerpt macro class

• fix problem w/ compatibility w/ Microblog app
• add "Find Includes" to MultiExcerpt Enhanced Permissions
• allow cache to be flushed directly from admin tool
• add help/hover text to admin tool
• UI improvements in admin tool

• fix problem w/ compatibility w/ Microblog app
• add "Find Includes" to MultiExcerpt Enhanced Permissions
• allow cache to be flushed directly from admin tool
• add help/hover text to admin tool
• UI improvements in admin tool

• tolerate trailing space in MultiExcerpt Enhanced Permissions name parameter
• included MultiExcerpt cache name in the admin tool
• add success message to "Save and Update" in admin tool
• improve error message for missing excerpt

• tolerate trailing space in MultiExcerpt Enhanced Permissions name parameter
• included MultiExcerpt cache name in the admin tool
• add success message to "Save and Update" in admin tool
• improve error message for missing excerpt

• It is recommended to FLUSH YOUR CACHE after this upgrade because it contains cache fixes.
• make cache key unique for matching excerpt name and page name (in different spaces)
• make MultiExcerpt Include case-sensitive for excerpt name. Now consistent with MultiExcerpt-Cloud and also fixes problems with "Find Includes". Admins can opt out of case-sensitivity in admin console.

• It is recommended to FLUSH YOUR CACHE after this upgrade because it contains cache fixes.
• make cache key unique for matching excerpt name and page name (in different spaces)
• make MultiExcerpt Include case-sensitive for excerpt name. Now consistent with MultiExcerpt-Cloud and also fixes problems with "Find Includes". Admins can opt out of case-sensitivity in admin console.

• FLUSH YOUR CACHE after this upgrade for best results
• Do not render error message for anonymous user for ME-Include of restricted resource, only render blank
• Fix cache clash for with/without surrounding panel includes
• Do not cache error messages for includes
• Log debug() instead of warn() for denied access of MultiExcerpt Include Enhanced Permissions because that macro is expected to deny access for some users in normal flows.

• FLUSH YOUR CACHE after this upgrade for best results
• Do not render error message for anonymous user for ME-Include of restricted resource, only render blank
• Fix cache clash for with/without surrounding panel includes
• Do not cache error messages for includes
• Log debug() instead of warn() for denied access of MultiExcerpt Include Enhanced Permissions because that macro is expected to deny access for some users in normal flows.

• Add ability for admin to disable the "Find Includes" button for multiexcerpts. It is a CPU-intensive DB query that is being redesigned right now. This is a temporary measure for admins to use for disabling this feature.
• Decrease log level to DEBUG for an ERROR level log that is for a harmless condition
• Fix a NullPointerException in error handling code.

• Add ability for admin to disable the "Find Includes" button for multiexcerpts. It is a CPU-intensive DB query that is being redesigned right now. This is a temporary measure for admins to use for disabling this feature.
• Decrease log level to DEBUG for an ERROR level log that is for a harmless condition
• Fix a NullPointerException in error handling code.

• Fix issue with excerpts on pages with bodiless macros
• Less chatty server logging
• Fix caching across spaces
• Add access checks to cache
• Add MultiExcerpt Enhanced Permissions macros to drop-down in MultiExcerpt-Include editor
• Security token fix for admin tool
• Hover text for super long MultiExcerpt names
• Max size limit for cached items

• Fix problem for excerpts on pages with bodiless macros
• Less chatty server logs
• Access checks for cache
• Add MultiExcerpt Enhanced Permissions to dropdown in MultiExcerpt Include editor
• Security token for admin tool
• Hover text for super long MultiExcerpt names
• Max size for cache items

We are excited to announce this Data Center release of the MultiExcerpt.

Coming soon:

We will be following this release with another release in the near term. The upcoming release will include additional feature enhancements, usability improvements, and bug fixes. Those will all be detailed in the upcoming release notes.

• fix issues for including excerpts from other spaces
• semicolons in page titles
• Find Includes for different macros with the same name
• improvements for downloading attachments
• support for case-sensitive DB column names (SQL Server)

nested K15 macros (like Scroll Ignore) work with MultiExcerpt cache enabled

Fixed a bug to allow proper functioning of 3rd party macros inside of MultiExcerpt Includes. For example, Scroll Ignore macro from K15.

Replace DOMNodeInserted with MutationObserver

---

Upcoming: DataCenter approved version coming shortly:

We are excited to be rolling out a DataCenter approved version of this app in the coming weeks.

We will provide more information directly to customers, in our knowledgebase, our documentation wiki, and release notes around the transition. The new licensing and change will be no different from most other DataCenter approved apps.

We will also make sure there is no change in service for at least a three-month window/grace period for customers to update licenses ( as per Atlassian’s guidance ).

Fixed bug with surrounding panels of multiexcerpt-include.

This is a minor security update to address a vulnerability found as a result of penetration testing. The theoretical vulnerability found was that the MultiExcerpt admin screen wasn't using a validating token as it should be. This has been fixed.

Bug: CMEP-78

https://artemis.atlassian.net/browse/CMEP-75

https://artemis.atlassian.net/browse/CMEP-79

• New feature: It is possible to see all multi-excerpt includes for related multi-excerpt - CMEP-57
• Bugs: CMEP-77 and CMEP-78

Issues resolved:

• multiexcerpt "go to included page" not working
• Multiexcerpt Include macro does not render in ConfluenceMobile
• MultiExcerpt named ... was not found

This version of the multi-excerpt add-on has a few bug fixes:

• users can now click (esc) to minimize the new "multiexcerpt search" box
• the @self reference to the same page within the multiexcerpt-include has been fixed
• the optional 'surrounding panel' for the multiexcerpt-include has been fixed

Please note to see some of these updates you'll need to clear the add-on's cache which is enabled by default. Clearing cache is explained in the add-on's documentation or can simply be found at under Confluence Admin -> Cache Management -> MultiExcerpt -> Flush cache.

There is a new drop down select box in the multiexcerpt-include macro which lets you select existing multiexcerpts.

• look ahead / type ahead search for multiexcerpts
• completely accessible and functional with 'keyboard only'
• still allows you to add multiexcerpt names that might not yet exist to facilitate some workflows where this is required

This should speed content creation and reduce errors. It is a long requested feature now implemented!

Updates that seemed to take place with Confluence 5.9 cause it to insert the p tag around rendered macros. We had stripped these out but forgot to strip them out of the cache. This update fixes that issue, but if you still see the problem you might need to flush the cache under Admin -> Cache Management -> net.artemis.plugins.conf.multiexcerpt4.cache

Cheers!

Brendan

This fixes an issue where people who were upgrading to Confuence 5.9 were seeing inline multiexcerpt-includes appear on new lines.

I've also fixed the errors sometimes given when a multiexcerpt didn't exist on the referenced page to be more informative and clear along with eliminating errors in the log.

Something seems to have changed in a recent version of Confluence which started adding newlines before and after macros. This fix allows multiexcerpts to appear inline.

The new MultiExcerpt Enhanced Permissions macro now lets users share multiexcerpts even from restricted pages and spaces with specific users and or groups.

This version of the multiexcerp and multiexcerpt-include macros now use Confluence's built in cache. This affords several benefits:

• cache can now be cleared/refreshed/flushed by the Confluence "Cache Management" administration screen
• cache size can now be configured
• cache usage can now be viewed
• cache should be preloaded (in many cases) on a Confluence restart rather than needing to be repopulated
• protects against memory overruns

In almost all cases I believe users should now enable cache. It is still an option on the MultiExcerpt Admin screen.

Additionally fixed a link in the MultiExcerpt Admin screen to Confluence's Cache Management screen. This was the only difference 4.16.1 to 4.16.2

This version of the multiexcerp and multiexcerpt-include macros now use Confluence's built in cache. This affords several benefits:

• cache can now be cleared/refreshed/flushed by the Confluence "Cache Management" administration screen
• cache size can now be configured
• cache usage can now be viewed
• cache should be preloaded (in many cases) on a Confluence restart rather than needing to be repopulated
• protects against memory overruns

In almost all cases I believe users should now enable cache. It is still an option on the MultiExcerpt Admin screen.

The main update here is we added a new parameter for 'Add Panel' to MultiExcerpt-Include.

The macros labels and descriptions are also cleaned up.

• now when you create a multi-excerpt it immediately pops up the window to enter a name
• I have removed the "no panel" option and now never render a panel.
  • I've had dozens of requests to improve this feature. Because of what seems to be a 'bug' in Confluence I cannot simply default to having 'no panel'. If this release causes any problems by removing panels for multiexcerpt-includes please let me know and I'll try to figure something out.
• this release also covers more versions of Confluence than the last release.

It looks like with my most recent release a certain dependency was being expected not available in older versions of Confluence such as 5.1.x.

In this case the add-on could not be updated.

This version fixes that problem.

Confluence now seems to have a bug where it doesn't always pass a macro the parameters. This fix addresses that issue for the 'nopanel' option in multi-excerpt macro

This release includes two parts:

• Confluence 5.8.2 prevents add-ons from add-ons adding links in some areas of the Administration screen so I had to move the link slightly.
• The add-on now converts wiki-markup to XHTML both on the fly and presumably during an upgrade. Atlassian support requested this update on behalf of a customer and have also done some vetting of it.

Small feature request. Now if you add "@self" in place of the 'page name' for the multiexcerpt-include it will dynamically find multiexcerpts on that same page.

This request was made to have it more effectively work in certain templating use cases.

Several customers have started asking for 'data center compatibility' so I've run several automated and manual tests along with researching the particular needs of 'data center compatible addons'.

I think we're all set with version 4.10.0

Also fixed a couple of minor and corner case bugs.

There was a critical issue where a multiexcerpt-include was no longer detecting a recursive condition when referencing an outter multiexcerpt.

This is definitely fixed in this version!

Fixed a circular reference issue if a multi-excerpt-include referenced a multi-excerpt it was embedded within. This is a critical bug fix:

https://artemis.atlassian.net/browse/CMEP-34

Just a minor fix to the admin link to access caching configuration.

Added cache controls. Please see the MultiExcerptCache controls documentation for more details.

Also disabling caching by default as it was causing issues in some specific circumstances.

Implemented this feature:

"User access limitations should create no missing page note"

https://studio.plugins.atlassian.com/browse/CMEP-24

fixed the "Go To Included Page" button

A small number of customers were reporting issues so I've updated to what should prove to be a more stable deployment model 

Although hundreds of companies use this plugin with no issues a few users were reporting seeing dependency errors which had to do with specific combinations of Confluence and it's platform's dependencies availability.

This release should eliminate a few issues where the plugin couldn't load because Confluence wasn't providing certain dependencies to the plugin.

I had inserted a MacroMigrator to update legacy wikimakrup to XHTML.

However some users have reported problems so I'm removing for now and working on new methods and more extensive testing of that feature.

- updated to work with Confluence 4.3

- added a macro migrator

This version probably works with earlier versions 4.0 to 4.3 but I need to do a bit more testing against those earlier versions.   The main reason to use this with 4.0, 4.1, 4.2 would be to use the MacroMigrator to migrate legacy wiki markup:

Some more details on re-running the migration process for unmigrated macros:

https://confluence.atlassian.com/display/DOC/Migration+from+Wiki+Markup+to+XHTML-Based+Storage+Format

https://confluence.atlassian.com/display/DOC/Migration+of+Templates+from+Wiki+Markup+to+XHTML-Based+Storage+Format

fixed a small issue where anonymous users couldn't see an excerpt

This is a complete rewrite of the MultiExcerpt plugin to work with Confluence 4.1+   (already tested against Confluence 4.2)

minor update for Marketplace functionality - fix for issue: https://studio.plugins.atlassian.com/browse/CMEP-50