Metadata-Version: 1.0
Name: vs.org
Version: 1.0.9.1
Summary: Plone 4 add-on: Representation of organisational structures
Home-page: http://svn.plone.org/svn/collective/vs.org/
Author: Veit Schiele
Author-email: vs.org@veit-schiele.de
License: GPL
Description: 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
        - Products.ATVocabularyManager
        - Products.DataGridField
        - Products.MasterSelectWidget
        - pycountry
        
        
        Requirements
        ============
        
        * tested with Plone 4.0.X
        * no support for Plone 3.X
        
        Licence
        =======
        
        ``vs.org`` is published under the GNU Public Licence V 2 (GPL 2)
        
        Authors
        =======
        
        | Andreas Jung
        | info@zopyx.com
        | www.zopyx.com
        |
        | Veit Schiele
        | kontakt@veit-schiele.de
        | www.veit-schiele.de
        |
        | Carsten Raddatz
        | carsten.raddatz@veit-schiele.de
        
        Credits
        =======
        
        *  Anne Wather (Original author)
        
        
        Changelog
        =========
        
        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
        
        
Keywords: Zope Plone
Platform: UNKNOWN
Classifier: Development Status :: 5 - Production/Stable
Classifier: Framework :: Plone
Classifier: Framework :: Plone :: 4.0
Classifier: Framework :: Plone :: 4.1
Classifier: Framework :: Plone :: 4.2
Classifier: Programming Language :: Python
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: License :: OSI Approved :: GNU General Public License (GPL)
