Conditional Multi-Excerpt plugin for Confluence is useful for following purpose:
Conditional Multi-Excerpt plugin comes with 2 macros to create common single source content and reusing it
Related Concepts
Using the Conditional Multi-Excerpt plugin
First step to use this plugin is to decide condition keyword(s) which is just a Logical group name to spaces wherever you are using Conditional Multi-Excerpt. This group name could be your product names or feature name or just version (ex, prodA, featureA or ver500). This group name can be configured using TechAuth->Set Condition Keyword link at top navigation bar of Confluence. Conditional Tag is decided on basis on this keyword. As for example see following image
Fig1: providing Conditional keyword
Sample space taken for example is http://<site_base_url>/display/Tiger/<page>. Tiger spacekey is assigned a name wild. So, whichever space is assigned to wild group, content provided under KEY_wild_ST and KEY_wild_END tags will be displayed. So, while using Conditional Multi-Excerpt macro these tags could be used to provide content that is specific to wild group.
Any content provided outside these tags will be shown as it is wherever Conditional Multi-Excerpt Include macro is used to reuse the content. As for example if there is another space cat (http://<site_base_url/display/cat/<page>) and is assigned to group 'domestic' then conditional multi-excerpt use and output will look like
Conditional Multi-Excerpt and Conditional Multi-Excerpt Include macro UI looks like following
If no conditional part is provided, content of Conditional Multi-Excerpt will be shown as it is wherever it is reused with help of Conditional Multi-Excerpt Include macro.
Example Use Case
For one more working example suppose we have got two spaces
First space http://<yoursite>/display/prodA500/<page> which explains about prodA version 5.0.0
Second space http://<yorsite>/display/prodA622/<page> which explains about prodA version 6.2.2
(However, using our solution these 2 spaces could be merged in 1, depending on complexity and amount of difference in content)
Step wise procedure of using Conditional Multi-Excerpt for better content management is as follows:
(NOTE: Same effect can be created in single space too. As for example in above case if we will change the Condition Keyword or SpaceKey Keyword map of space prodA500 to prodA500:ver622, then after refreshing page of prodA500 space, content will displayed that was under KEY_ver622_ST and KEY_ver622_END tags.)
Credits
Our customers play and important role in making our solution better. Thanks to everyone who provided feedback, suggestions and reported some issues. Special thanks to Gillian Flato (Thales eSecurity) for specific suggestions.
Atlassian Marketplace Listing URL - Conditional MultiExcerpt