Shared Contact DB Add-On

This is a TWiki application using TWikiForms, TWikiTemplates and FormattedSearch queries.

Screenshots

Application homepage

Sample contact entry

Usage

The application homepage ContactDB contains a report showing the contacts and a form to add a new contact.

Each contact page has a comment box to add unstructured content (notes, etc) and a form that holds the structured content (name, job title, etc).

Customization

You can add/change the form fields. Follow this sequence.

• ContactForm - modify the form
• ContactTemplate - edit and save the template page (also if no changes are needed)
• ContactHeader - tweak the contact header if needed
• ContactDB - tweak the report header and SEARCH format as needed
• ContactsAsCSV - tweak the SEARCH format as needed

Installation Instructions

Note: You do not need to install anything on the browser to use this add-on. The following instructions are for the administrator who installs the add-on on the server where TWiki is running.

• Download the ZIP file from the Add-on Home (see below)
• Unzip ContactDbAddOn.zip in your twiki installation directory. Content:

  File:	Description:
  data/TWiki/ContactDbAddOn.txt	Add-on documentation page
  data/Sandbox/ContactDB.txt	Contact database home page
  data/Sandbox/ContactForm.txt	Form definition for contact pages
  data/Sandbox/ContactHeader.txt	Header for contact pages
  data/Sandbox/ContactsAsCSV.txt	Report topic, export to Excel in CSV format
  data/Sandbox/ContactTemplate.txt	Template for new contact pages
  data/Sandbox/NewContact.txt	Create new contact page
  lib/TWiki/Contrib/ContactDbAddOn.pm	Module with version info

• You get a contact database residing in Sandbox.ContactDB
• Duplicate the application pages from the Sandbox web to your own team's web: ContactDB, ContactForm, ContactHeader, ContactsAsCSV, ContactTemplate and NewContact. You can copy them on the shell level or clone the pages using your browser.
• Note: If you are not an administrator you can unzip the package on your computer and create the application pages in your team's web based on the content of the files in data/Sandbox/. For example, if your web is Marketing, create a page called ContactDB in the Marketing web with the content of the data/Sandbox/ContactDB.txt file. Repeat for other pages. The lib/TWiki/Contrib/ContactDbAddOn.pm files are not needed for a manual installation.

Add-On Info

• Set SHORTDESCRIPTION = Simple contact database that can be shared by the team

Add-on Author:	TWiki:Main.PeterThoeny
Copyright:	© 2010-2011 TWiki:Main.PeterThoeny © 2010-2011 TWiki:TWiki.TWikiContributor
License:	GPL (GNU General Public License)
Add-on Version:	2011-06-21
Change History:
2011-06-21:	TWikibug:Item6761: Add export to Excel feature
2011-03-16:	TWikibug:Item6596: Rebrand "Contact DB" to "Shared Contact DB"
2010-10-14:	TWikibug:Item6596: Initial version
TWiki Dependency:	$TWiki::Plugins::VERSION 1.1 (TWiki 4.0)
Other Dependencies:	none
Add-on Home:	http://TWiki.org/cgi-bin/view/Plugins/ContactDbAddOn
Feedback:	http://TWiki.org/cgi-bin/view/Plugins/ContactDbAddOnDev
Appraisal:	http://TWiki.org/cgi-bin/view/Plugins/ContactDbAddOnAppraisal

Related Topic: TWikiAddOns, ContactForm, ContactTemplate, ContactHeader, ContactDB, ContactsAsCSV