Problem with glossary application

Hello everybody,

I’m testing the glossary application developed by Sarthak Gupta. This application is generally outstanding.
But it does not work out of the box.

I’v installed the application as described (e.g. adjusted…) and set the rights of users and pages correctly (I hope so).

The problem is that only the admin of the wiki (who has installed the app) can see the content. All other users get the following error message:

I’ve reinstalled the application and saw the following error message:

Incomplete macro definition in [Object home:Glossary.WebHome^XWiki.WikiMacroClass[0]], macro code is empty
class org.xwiki.rendering.macro.wikibridge.WikiMacroException: Incomplete macro definition in [Object home:Glossary.WebHome^XWiki.WikiMacroClass[0]], macro code is empty
at org.xwiki.rendering.wikimacro.internal.DefaultWikiMacroFactory.checkMacroCode(
at org.xwiki.rendering.wikimacro.internal.DefaultWikiMacroFactory.buildMacro(
at org.xwiki.rendering.wikimacro.internal.DefaultWikiMacroFactory.createWikiMacro(
at org.xwiki.rendering.wikimacro.internal.DefaultWikiMacroInitializer.registerMacro(
at org.xwiki.rendering.wikimacro.internal.DefaultWikiMacroInitializer.registerMacrosForWiki(
at org.xwiki.rendering.wikimacro.internal.DefaultWikiMacroInitializer.registerExistingWikiMacros(
at org.xwiki.rendering.wikimacro.internal.DefaultWikiMacroInitializer.registerExistingWikiMacros(
at org.xwiki.rendering.wikimacro.internal.RegisterMacrosOnImportListener.onEvent(
at org.xwiki.observation.internal.DefaultObservationManager.notify(
at org.xwiki.observation.internal.DefaultObservationManager.notify(
at org.xwiki.extension.xar.internal.handler.packager.Packager.importXARToWiki(
at org.xwiki.extension.xar.internal.handler.packager.Packager.importXARToWiki(
at org.xwiki.extension.xar.internal.handler.packager.Packager.importXAR(
at org.xwiki.extension.xar.internal.handler.XarExtensionHandler.installInternal(
at org.xwiki.extension.xar.internal.handler.XarExtensionHandler.install(
at org.xwiki.extension.handler.internal.DefaultExtensionHandlerManager.install(
at org.xwiki.extension.job.internal.AbstractExtensionJob.installExtension(
at org.xwiki.extension.job.internal.AbstractExtensionJob.applyAction(
at org.xwiki.extension.job.internal.AbstractExtensionJob.applyActions(
at org.xwiki.extension.job.internal.InstallJob.runInternal(
at org.xwiki.job.AbstractJob.runInContext(
at java.util.concurrent.ThreadPoolExecutor.runWorker(
at java.util.concurrent.ThreadPoolExecutor$

At the moment I’m thankful for every advice. I don’t know whether it’s a general XWiki config problem or an application problem…

Thank you very much!

Hi @Thomas_Nett I just checked and the glossary macro is badly coded and it has a bug. By default it sets the visibility to “current user” so that only the current user can see the macro, see application-glossary/application-glossary-ui/src/main/resources/Glossary/Code/GlossaryMacro.xml at master · xwiki-contrib/application-glossary · GitHub

Could you open a jira for the glossary macro project on (at Glossary Application - JIRA )?


As a workaround, you just need to edit the macro page and change the visibility.

Hi Vincent, thanks for your input. The workaround does not work for me yet. I will test it on a new installation.
I’ve created an issue: Loading...

Hi Vincent,

thanks for your fixes in version 0.3.

I’ve updated the glossary app in Extension Manager. While installing I got the following warning:

Failed to install optional dependency [[org.xwiki.platform:xwiki-platform-rendering-macro-velocity-[10.11.2]](http://testwiki/xwiki/bin/admin/XWiki/XWikiPreferences?section=XWiki.Extensions&search=glossary&repo=&extensionId=org.xwiki.platform%3Axwiki-platform-rendering-macro-velocity&extensionVersion=%5B10.11.2%5D&extensionNamespace=wiki%3Axwiki)] with error:
InstallException: Dependency [org.xwiki.platform:xwiki-platform-rendering-macro-velocity-[10.11.2]] is not compatible with core extension feature [org.xwiki.platform:xwiki-platform-rendering-macro-velocity/11.1] ([org.xwiki.platform:xwiki-platform-rendering-macro-velocity/11.1])

What does that mean? I’m running XWiki 10.11.2 at the moment.

Could you check what version of this extension you have installed in your wiki?

Velocity Macro and Velocity API are installed in version 11.1.
I don’t understand why…

Nevertheless the glossary application seems to work correctly :slight_smile:
Will there be any improvements in the future as you wrote it is “badly coded”?

I refactored and fixed the “badly” coded places. Actually, this word is a bit too strong. Originally I had an old version locally and thought I was on the last version… Then I realized I was missing a lot of improvements of it so it’s not as bad as I initially thought.

Now this extension is NOT supported by the XWiki Dev team. It was coded by Sarthak, one GSOCer who’s not been active for a long time now. So this extension is waiting for some love from someone to continue improving it. I did some quick changes to make it usable but I’m not sure I’ll have the time to improve it much over that.

OTOH it’s a nice extension. It would be great if someone could spend time to improve it even further.

FTR I added 2 small improvements as part of the refactorings:

  • Support for nested pages (ie you can have glossary entries in nested pages now)
  • Ability to put Glossary pages anywhere in the wiki
1 Like