Dossier
Fundamental Contact Relationship Management
Current Location: >> Main Page >> Dev HQ >> Module Library >> Dossier
labDossier Manual
Initial Release Article posted December 13, 2003 [on pnMods | pnADD-ONS ]
1.1 Release Article posted August 5, 2004 [on pnMods | TheBix | pnADD-ONS ]
Homepage: here
Module Library: here
Download: here
FAQ: here
I. Introduction
labDossier facilitates an online addressbook or rolodex that allows the specification of and navigation by relationships between contacts, as well as extensive, customizable contact information types.
labDossier was created as part of research on the 6 degrees phenomenon and sites like Friendster.
labDossier does not yet possess the ability to specify published or private contacts, and, therefore, is intended for use as a either a private or group contact list.
labDossier requires that labCategories be installed and a set of categories established for use.
II. Installation and Configuration To install labDossier, unzip and upload the labDossier module folder to your site modules directory. Then go to the Modules admin page and regenerate the list. If labCategories is not yet installed, please do this first. Also make sure that the labDossier category set is added to labCategories. When ready, initialize and activate the labDossier module entry. labDossier includes a menu item for My Accounts. To utilize this, copy the labDossier/pnimages/labDossier.gif file to ./images/menu. The option to display the menu must then be turned on in the labDossier settings. Proceed to labCategories and make any additions or deletions to both the Contact Info and Relationship Types category lists utilize the items desired. New category groups can be created as well by making a child category to Contact Info or Relationship Type and populating it with the new fields. The labDossier config page works like a switchboard that must be connected correctly in order for other aspects of the module to function. First, select the top level category for the master labDossier category ID and submit the page. Now the Relationship Type and Contact Information category sets must be selected. These will be direct child categories of the master labDossier category selected previously. The resulting page of the switchboard will include fields for the categories associated with contact emails, site URLs, job titles, company names, department names, and the Location field set. Again, select the associated categories for each and submit the switchboard. (note: Department does not have an associated category at this time) The next phase allows selection of a list of Job Titles (and Departments, if a category was selected). This is for a default list of items to use in each of the specified fields during contact information updates. Also select associated fields for street address, city, state, zip, and country. Update the switchboard. The final phase of the switchboard allows selection of a default list of values for city, state, and/or country. The labCategories module includes a loadable file for US States that can be used for the state field list. Additional categories can be added by specifying the parent category they are to be placed under in the bottom switchboard field and entering a name for the new category. Afterwards, the new category will be available both to the switchboard as well as within the module itself, whether as a new contact info field/set or as a contact relationship type/set. III. Populating Contacts From the labDossier menu, click the Add Contact link. Enter the contact name and click Create. A contact is typically a person, associated with for business, with information on how to get ahold of them. However, a contact can also be a business, or a location, or a community. All of them have a name, and that is all that is needed to create the contact. More information can be added later. While viewing an existing contact, there is a rapid contact creation form that automatically associates the new contact with the current one in the specified manner (available via dropdown). Existing contacts may also be selected from an adjacent dropdown to establish a relationship with the current contact.

IV. Using labDossier
The use of associations between contacts can be seen in the available display types. Each display can be set to display up to four degrees of relation from the current contact. This means that all contacts associated with the current will be shown in the first degree. All contacts related to the those in the first degree will be displayed in the second degree. The third and fourth degrees (if shown and available) are generated the same way.
The default display type is tiered by degree. All first degree contacts are listed, separated with commas, followed by all second degree contacts, etc.

The Verbose display will list each contact as above in the Tiered display, but as a vertical list with additional contact information. Each sub-category of contact information (Names, Numbers, Location, etc) can be selected to show specific contact information.

Finally, the Hierarchical display is intended to illustrate connections between contacts in the network, starting from the current contact displayed. Each contact, once listed, will only be expanded the first time it is displayed, to reduce redundancy.

V. Use-Cases for labDossier
While the standard installation of labDossier will provide all of the functionality and fields that most users need for contact management, there are other ways to configure the module. Some of them are as follows:
* Provide a group or community with a means of establishing buddylists.
* Revamp contact info fields to reflect character attributes and statistics for a role-playing game site.
* Start a new Friendster/6Degrees site.