Often it's the small things that matter most.

OpenOfficeBackup Installation Guide

  1. Download the package:
  2. Install the OpenOfficeBackup library:
    • Start OpenOffice. It's best to not have any document open at this point.
    • From the menu bar select:

      ToolsMacrosOrganize MacrosOpenOffice Basic...

      Screenshot: Tools --> Macros --> Organize Macros --> OpenOffice
							Basic...

    • From the opening OpenOffice Basic Macro dialogue select:

      Organizer...

      Screenshot: --> Organizer...

    • In the Organizer select the tab:

      Libraries

      make sure the location is set to:

      My Macros & Dialogs

      and select:

      Import...

      Screenshot: Libraries --> My Macros & Dialogs --> Import...

    • In the File Picker navigate to the OpenOfficeBackup installation folder you have unpacked from the download package.

      Double click the file:

      script.xlb

      or select it and press:

      Open

      Screenshot: script.xlb --> Open

    • Confirm the import:

      OK

      Screenshot: --> OK

    • Close the Organizer:

      Close

      Screenshot: --> Close

    • Close the OpenOffice Basic Macro dialogue:

      Close

      Screenshot: --> Close

  3. Create a menu entry for the GUI:

    In the OpenOfficeBackup library there is a module ui (user interface). In that module there is a subroutine Backup. That subroutine is the entry for the GUI, which is primarily there to configure the backups. Create a menu entry for that subroutine, so that you can launch the GUI.

    • From the menu bar select:

      ToolsCustomize...

      Screenshot:
							Tools --> Customize...

    • In the Customize dialogue select the tab:

      Menus

      there select the menu:

      Tools

      select the existing entry above the point where the new entry should appear, for example:

      Options...

      make sure the changes are saved in:

      OpenOffice

      create a group separator:

      ModifyBegin a Group

      Screenshot: Menus
							--> Tools --> Options... --> OpenOffice --> Modify --> Begin a
							Group

    • In the Customize dialogue press:

      Add

      Screenshot: -->
							Add

    • In the opening Add Commands dialogue:

      from the Category list select:

      → OpenOffice Macros → My Macros → OpenOfficeBackup  ui

      in the Commands list double click on:

      Backup

      or select and press:

      Add

      Screenshot: -->
							OpenOffice Macros --> My Macros --> OpenOfficeBackup --> ui --> Backup
							--> Add

    • Close the Add Commands dialogue:

      Close

      Screenshot: -->
							Close

    • You can still move the new entry within the list with the arrow buttons next to the list.
    • In the Customize dialogue confirm the changes:

      OK

      Screenshot: -->
							OK

    • The menu settings are document dependent. You'll have to repeat these steps for each document class you are working with (i.e. writer, calc, etc.) A corresponding document has to be open for that.
  4. Link the backup subroutines to the corresponding OpenOffice event hooks:

    In the OpenOfficeBackup library there is a module core. In that module there are two subroutines: OnDocumentSaved and OnDocumentSavedAs. These subroutines need to be hooked into the OpenOffice event handlers Document has been saved and Document has been saved as respectively.

    • From the menu bar select:

      ToolsCustomize...

      Screenshot: --> Tools --> Customize...

    • In the Customize dialogue:

      select the tab:

      Events

      make sure the changes are saved in:

      OpenOffice

      in the event list select:

      Document has been saved

      press:

      Macro

      Screenshot:
							--> Events --> OpenOffice --> Document has been saved --> Macro

    • In the Macro Selector dialogue:

      from the library tree select:

      My MacrosOpenOfficeBackupcore

      from the macro list select:

      OnDocumentSaved

      complete with:

      OK

      Screenshot:
							--> My Macros --> OpenOfficeBackup --> core --> OnDocumentSaved -->
							OK

    • In the Customize dialogue:

      in the event list select:

      Document has been saved as

      press:

      Macro

      Screenshot:
							--> Document has been saved as --> Macro

    • In the Macro Selector dialogue:

      from the library tree select:

      My Macros OpenOfficeBackupcore

      from the macro list select:

      OnDocumentSavedAs

      complete with:

      OK

      Screenshot:
							--> OK

    • In the Customize dialogue confirm the changes:

      OK

      Screenshot:
							--> OK

OpenOfficeBackup is now installed and ready to be configured.