No description
Find a file
2016-07-12 14:42:02 +02:00
bin Add dist/ folder, needed to generate project 2016-04-05 17:45:56 +02:00
build Add dist/ folder, needed to generate project 2016-04-05 17:45:56 +02:00
description CRLF -> LF 2016-04-06 16:47:21 +02:00
dialog Add example dialog 2016-04-07 11:55:05 +02:00
dist Also add the generated extension 2016-04-07 12:02:29 +02:00
idl/org/libreoffice/example Drop unused file 2016-04-06 13:39:05 +02:00
images Add toolbar & menu entry, and a shortcut 2016-04-06 16:44:09 +02:00
registry/org/openoffice/Office Fix toolbar/menu names 2016-04-07 16:45:41 +02:00
source/org/libreoffice/example Add example dialog 2016-04-07 11:55:05 +02:00
.classpath Add generated extension 2016-04-05 16:51:52 +02:00
.gitignore Add dist/ folder, needed to generate project 2016-04-05 17:45:56 +02:00
.project Add generated extension 2016-04-05 16:51:52 +02:00
.unoproject Add dist/ folder, needed to generate project 2016-04-05 17:45:56 +02:00
description.xml Add version number 2016-04-06 13:42:57 +02:00
LICENSE Initial commit 2016-04-05 16:49:42 +02:00
package.properties Add example dialog 2016-04-07 11:55:05 +02:00
README.md README: Adjust to changed term 2016-07-12 14:42:02 +02:00

LibreOffice Starter Extension

This repository contains some boilerplate code and config you need to get started to build your own LibreOffice Extension.

You can use this project as a starting point to write your own extension for LibreOffice.

Get started

  1. Install LibreOffice & LibreOffice SDK (5.0 or greater)
  2. Install Eclipse & the LOEclipse plugin
  3. Download this starter project & unzip it
  4. Import the project in Eclipse (File->Import->Existing Projects into Workspace)
  5. Let Eclipse know the paths to LibreOffice & the SDK (Project->Properties->LibreOffice Properties)
  6. Setup Run Configuration
  • Go to Run->Run Configurations
  • Create a new run configuration of the type "LibreOffice Application"
  • Select the project
  • Run!
  • Hint: Show the error log to view the output of the run configuration (Window->Show View->Error Log)
  1. The extension will be installed in LibreOffice and you will see a toolbar and a menu entry have been added to Writer.

Development Hints

  • The entry point is in StarterProjectImpl.java.
  • Toolbar items and menu entries are defined in Addons.xcu.
  • Shortcuts are defined in Accelerators.xcu.
  • The position of the toolbar is defined in WriterWindowState.xcu.
  • The dialog shown when clicking "Action One" is ActionOneDialog.xdl. The dialog itself contains information how to edit it.
  • The DialogHelper contains lots of helper methods to work with the dialog.
  • To debug the Java code, just stick a breakpoint anywhere in Eclipse and start your run configuration in debug mode.
  • If you add non-code files to your extension, you need to mention them in package.properties, else they won't be included in the packaged extension.
  • Now go on customizing the extension to your needs. You'll find lots of information in the OpenOffice Wiki.