modules/contact_forms/README.txt

$Id: README.txt,v 1.6 2008/12/31 12:37:41 gpdinoz Exp $

CONTACT_FORMS.MODULE

Overview
--------
This module expands the features of the site wide
contact form. It eliminates the need for the drop
down category menu by generating a form, and a
unique path, for each of the contact form categories.

The path 'contact/{category}' generates a contact form
for that category with a title = 'Contact {category}'.
e.g. path 'contact/Jill Jones' generates a contact form
for the category 'Jill Jones' with a title = 'Contact Jill Jones'. You can use underscore "_" or a dash "-" instead of spaces. 

If a path is entered that does not have a category you
can specify a page to redirect to. The default fall back
path is contact.

To define the subject of the generated form the path is as follows
'contact/{category}/Subject goes here'
e.g. path 'contact/Jill Jones/Enquiry about Sales' generates a contact form
for the category 'Jill Jones' with a title = 'Contact jill Jones' and the subject
'Enquiry about Sales'.


Requirements
------------
contact.module must be enabled.


Installation
------------
  1. Copy contact_forms folder to sites/all/modules/.
  2. Check contact.module is enabled
  3. Enable Contact Forms module


Upgrading
---------
If you are upgrading from an older version of Contact Lists
Disable and uninstall the old version then delete the contact_list folder
before you upload and enable the new version.


Usage
-----
This module was written for sites that have many email
contacts where you want a page with information about
the people / departments etc with links to their individual
contact forms.

Create a "Contact Directory" page with a path like 'directory'
and lay it out how you would like it. Links to the forms can
be made with the following code [using the drupal link function]
<?php
print l('Email Jill Jones', 'contact/Jill Jones');
?>
This page can be set as the fall back page if a contact/category
path is entered that doesn't exist.


Snippets
--------
1. The "old" contact/list page
This will give you a list of links to the contact forms.

<!-- start snippet -->
<p>Who would you like to contact?</p>
<?php
  $result = db_query('SELECT * FROM {contact} ORDER BY weight, category');
  print '<div id="contact-list">';
  print '<div class="item-list"><ul>';
  while ($contact = db_fetch_object($result)) {
    $cleanurl = str_replace(' ', '_' ,$contact->category);
    print '<li>'. l($contact->category , 'contact/'. $cleanurl) .'</li>';
  }
  print '</div>';
  print '</div>';
?>
<!-- end snippet -->


Credits
-------
Thanks to the following people who have helped with suggestions and code:
nancyw
alienbrain
incrn8
joachim
mfredrickson
jandd
arcaneadam
1	$Id: README.txt,v 1.6 2008/12/31 12:37:41 gpdinoz Exp $
2
3	CONTACT_FORMS.MODULE
4
5	Overview
6	--------
7	This module expands the features of the site wide
8	contact form. It eliminates the need for the drop
9	down category menu by generating a form, and a
10	unique path, for each of the contact form categories.
11
12	The path 'contact/{category}' generates a contact form
13	for that category with a title = 'Contact {category}'.
14	e.g. path 'contact/Jill Jones' generates a contact form
15	for the category 'Jill Jones' with a title = 'Contact Jill Jones'. You can use underscore "_" or a dash "-" instead of spaces.
16
17	If a path is entered that does not have a category you
18	can specify a page to redirect to. The default fall back
19	path is contact.
20
21	To define the subject of the generated form the path is as follows
22	'contact/{category}/Subject goes here'
23	e.g. path 'contact/Jill Jones/Enquiry about Sales' generates a contact form
24	for the category 'Jill Jones' with a title = 'Contact jill Jones' and the subject
25	'Enquiry about Sales'.
26
27
28
29	Requirements
30	------------
31	contact.module must be enabled.
32
33
34	Installation
35	------------
36	1. Copy contact_forms folder to sites/all/modules/.
37	2. Check contact.module is enabled
38	3. Enable Contact Forms module
39
40
41	Upgrading
42	---------
43	If you are upgrading from an older version of Contact Lists
44	Disable and uninstall the old version then delete the contact_list folder
45	before you upload and enable the new version.
46
47
48	Usage
49	-----
50	This module was written for sites that have many email
51	contacts where you want a page with information about
52	the people / departments etc with links to their individual
53	contact forms.
54
55	Create a "Contact Directory" page with a path like 'directory'
56	and lay it out how you would like it. Links to the forms can
57	be made with the following code [using the drupal link function]
58	<?php
59	print l('Email Jill Jones', 'contact/Jill Jones');
60	?>
61	This page can be set as the fall back page if a contact/category
62	path is entered that doesn't exist.
63
64
65	Snippets
66	--------
67	1. The "old" contact/list page
68	This will give you a list of links to the contact forms.
69
70	<!-- start snippet -->
71	<p>Who would you like to contact?</p>
72	<?php
73	$result = db_query('SELECT * FROM {contact} ORDER BY weight, category');
74	print '<div id="contact-list">';
75	print '<div class="item-list"><ul>';
76	while ($contact = db_fetch_object($result)) {
77	$cleanurl = str_replace(' ', '_' ,$contact->category);
78	print '<li>'. l($contact->category , 'contact/'. $cleanurl) .'</li>';
79	}
80	print '</div>';
81	print '</div>';
82	?>
83	<!-- end snippet -->
84
85
86	Credits
87	-------
88	Thanks to the following people who have helped with suggestions and code:
89	nancyw
90	alienbrain
91	incrn8
92	joachim
93	mfredrickson
94	jandd
95	arcaneadam