Simple Groupware Extensions / Add-ons

Similar to Firefox add-ons or mobile application stores, the extension manager allows you to use free contributions from the open source community. That way you can extend and customize Simple Groupware to get the best functionality. Extensions are downloaded directly from sourceforge.net. There are also automatic checks for requirements like minimal PHP or Simple Groupware versions.
This guide describes how the extension manager works and how you can create your own extension(s).

Some facts about Simple Groupware extensions:

  • All extensions are open source
  • All extensions are verified before being published
  • All extensions can be installed and uninstalled with 2 clicks


Extension list


Debian binaries 0.1
Most hosting companies use Debian on their servers, but they don't install packages like catdoc, xpdf or unzip. Also sometimes the packages are installed, but the webpage is running in a chroot environment which forbids to execute these binaries. Using this option, you can directly use Debian binaries included in the Simple Groupware packages. Contents: catdoc exiv2 gzip mp3info pdfinfo pdftotext ppthtml tar unzip xls2csv Note: These packages may not be the latest versions, so you should only use them in combination with a virus scanner.

Win32 binaries 0.1
Most hosting companies use Debian on their servers, but they don't install packages like catdoc, xpdf or unzip. Also sometimes the packages are installed, but the webpage is running in a chroot environment which forbids to execute these binaries. Using this option, you can directly use Debian binaries included in the Simple Groupware packages. Contents: catdoc convert (ImageMagick) exiv2 graphviz gzip mp3info pdfinfo pdftotext ppthtml tar unzip xls2csv Note: These packages may not be the latest versions, so you should only use them in combination with a virus scanner.

Compose Html 0.3
Compose Html makes it possible to write emails in HTML.

Example 0.4
Example is a demonstration module for handling bookmarks. It is similar to the normal bookmarks module, but does not contain categories. A new folder "Example" is created under "/Workspace/Extensions/". v0.3: added PHP include view v0.4: added validator example

Mini tasks 0.2
Mini Tasks is a module for handling personal tasks. It is similar to the normal tasks module, but does not contain responsibles and project management features. A new folder "Mini tasks" is created under "/Workspace/Extensions/".

Private Items 0.1
Private items extends contacts, calendar, tasks, notes with the option to make items private. Private items are only visible to the user who created the asset.

Tasks Rating 0.1
Tasks Rating changes the priority field in the task module from a select box to a rating field.

Extension screenshots


Simple Groupware Extensions - Compose Html Emails
Compose Html Emails
Simple Groupware Extensions - Task Ratings
Task Ratings
  
Simple Groupware Extensions - Private Items
Private Items
Simple Groupware Extensions - Mini Tasks
Mini Tasks

View more ...


Using the extension manager


To start the extension manager, login as super administrator and click "Simple Groupware Extensions" on the administration overview page. The extension manager automatically downloads the list of packages and displays all installed packages:

Simple Groupware Extension Manager - List of packages
Extension Manager - List of packages

When installing a package, the package archive gets downloaded from sourceforge.net and extracted to "<sgs-dir>/simple_cache/". From there the files get translated and moved to "<sgs-dir>/ext/". If a package contains a file named "install.php", the file gets executed during the installation process. Files named "readme.txt" are displayed during the installation.
Folders can be automatically created under "/Workspace/Extensions/" by including a "folders.xml" in the package. The files "modules.txt" in "<sgs-dir>/modules/schema/" and "<sgs-dir>/modules/schema_sys/" can be extended by including a file named "modules.txt" or "sys_modules_ext.txt" in the main folder of the package.

Simple Groupware Extension Manager - Install a package
Extension Manager - Install a package

When uninstalling a package, all files of the package are moved to "<sgs-dir>/old/<package-filename>/" and empty directories are removed if possible. If a package contains a file named "uninstall.php", the file gets executed during the un-installation process. This process does not remove any data from the database.

Note: To install extensions, your server needs to be connected to the internet.


Develop a new extension


To build your own extension, please follow this tutorial.