JabRef Plugin System

Starting with 2.4b1, JabRef can be extended using a plugin system which was build using Java Plugin Framework (JPF).

To use plugins simply put the jar file of the plugin in a folder called plugins in the folder where the JabRef.jar is located. When starting up, JabRef will print a list of all plugins loaded.

How to write a plugin

JabRef offers the following extension-points for developers:

These extension-points are defined in the plugin.xml of the JabRef-core-plugin, which can be found in JabRef/src/plugins/net.sf.jabref.core/.

To start developing follow these rough steps:

  1. Checkout the JabRef trunk from subversion (https://jabref.svn.sourceforge.net/svnroot/jabref/trunk). This contains both JabRef itself and plug-ins contributed so far to JabRef (you don't need the htdocs folder), which make great starting points for your own plugins.
  2. Compile JabRef using ant jars.
  3. Create your own project and define your extension in your own plugin.xml that satisfy the extension points of the core plugin.xml. In particular make sure that:
  4. Create a jar of your project and put it into the plugins-folder of JabRef.
  5. Your plugin should be loaded when you run JabRef from the jar.

Feel free to ask us questions related to the plugin system on the mailing-list!

How to add an extension point to JabRef

This documentation is intended for JabRef developers who want to add further extensions points.

To add a new extension-point, you need to declare this extension-point in the plugin.xml of the core plugin similar to this:

<extension-point id="PushToApplication">
	<parameter-def type="string" id="pushToApp"
		custom-data="<classname of the interface that plugin providers need to implement>" />
	<!-- optionally other parameters (we currently do not use any of these for anything)
		<parameter-def type="string" id="name" />
		<parameter-def type="string" id="description"
			multiplicity="none-or-one" />

Then you need to re-run the plugin code generator "ant generate", which will re-create the helper class in "net.sf.jabref.plugin.core.generated" so that it includes a method getPushToApplicationExtensions() which returns a list of all PushToTalk extensions registered with the system.

This list then can be used like this (here an example what we do with the entry fetcher extensions):

 * Load fetchers that are plug-in extensions
JabRefPlugin jabrefPlugin = JabRefPlugin.getInstance(PluginCore.getManager());
if (jabrefPlugin != null){
	for (EntryFetcherExtension ext : jabrefPlugin.getEntryFetcherExtensions()){
		EntryFetcher fetcher = ext.getEntryFetcher();
		if (fetcher != null){
// and later...
for (EntryFetcher fetcher : fetchers){
  GeneralFetcher generalFetcher = new GeneralFetcher(sidePaneManager, this, fetcher);