vs.org 1.1.1

Plone 4 add-on: Representation of organisational structures

vs.org

Using vs.org almost any organization including its institutions, departments and employees may be represented within a Plone site. Even complex organizational structures can be made accessible and displayed, structered by business area, specialization and region.

Features

vs.org offers the following content types:

Institution

Telephone numbers

An institution can hold an arbitrary number of telephone numbers. The vocabulary for descriptions can be assigned such that common declarations telephone, fax and mobile can be used, as well as reception, ward and others. Each number may be marked as externally visible. This way it is possible to administer internal numbers in vs.org, even if the page for the institution is published.

Address

Any number of addresses may be assigned to an institution. Provide details of street address, P.O. box, a delivery address and others. The first address given is used to generate a map using Google maps services. If the automatic mapping is not precise enough you may provide geo coordinates. With the generated map you may also display directions in RichText. An optional photograph or image of the institution is also helpful.

Business area

Any institution may show its business area. Editors may administer the business area vocabulary.

Employees

Employees of an institution are referenced from entries in an employee folder. The order of employees is freely assignable.

Department

A department can hold an arbitrary number of telephone numbers, described by custom vocabulary. Each number may be marked as externally visible.

Building section / floor / room no.

Departments are always part of an institution, so have no address of their own. Instead you provide building section, floor or room number details.

Specialization

Any department may be assigned a specialization.

Employee

Any employee can be described using

• Position

• Salutation

• Title (academic or other)

• Firstname

• Surname

• Telephone numbers

• Email

• URL

• Portrait

• Notes

Again, any number of telephone number is possible. Each may carry arbitrarily assigned vocabulary for description. For each employee a business card in vcard format is generated that can be imported into address books and contacts.

Views

The institution homepage view makes specific institutions, departments accessible using their business areas, specializations and regions.

Portlets

Institution portlet

This portlet shows name and image of the institution, the addresses linking to Google maps, the telephone numbers and employees.

Department portlet

Very similar to the institution portlet, showing building section, floor and room number instead of an address.

Similar institutions, similar departments

Shown in the context of an institution, this portlet provides other institutions sharing the same business area. In the same way, a portlet shows other departments having the same specialization.

Employee search

Searching for employees is using the employee’s surnames. This search can be adapted to specific institutions.

Use cases

Websites of organizations having a complex organizational structure.

Intranets and extranets that are used by employees and/or partner organizations who need to find contact information quickly.

References

• Immanuel Diakonie Group

Requirements

• Plone 4.3

• Products.ATVocabularyManager

• Products.DataGridField

• Products.MasterSelectWidget

• pycountry

Requirements

• tested with Plone 4.3.X

• use vs.org 1.0.X for Plone 4.0-4.2 compatibility

Licence

vs.org is published under the GNU Public Licence V 2 (GPL 2)

Authors

Andreas Jung

[e-mail]

www.zopyx.com

Veit Schiele

[e-mail]

www.veit-schiele.de

Carsten Raddatz

[e-mail]

Credits

• Anne Wather (Original author)

Changelog

1.1.0 (2013/06/03)

• Plone 4.3 compatibility

1.0.9 (2012/03/30)

• using keepReferencesOnCopy=1 for all reference fields

1.0.8 (2012/01/27)

• loading Products.CMFCore.permissions.zcml explictely

1.0.7 (2011/11/23)

• DisplayName() method of the Employee class got a new parameter ‘showPosition’

1.0.6 (2011/10/20)

• setting employee’s image reference to language neutral

1.0.5 (2011/10/20)

• proper indexing hook for SearchableText for IEmployee

1.0.4 (2011/10/20)

• support one-digit country codes in phone number validation checks

1.0.3 (2011/07/05)

• fixed renaming issue (renaming an Employee caused the parent EmployeeFolder being renamed)

1.0.2 (2011/07/04)

• ISE related bugfixes and minor fine-tuning

1.0.1 (2011/05/11)

• initial release