modules/letters/INSTALL.txt


        LETTERS MODULE - README
______________________________________________________________________________

NAME:       Letters
AUTHORS:    Sean Robertson <seanr@ngpsoftware.com>
______________________________________________________________________________


DESCRIPTION

This module allows users to write a letter to newspaper editors.  If CRMAPI is
installed and correctly cnfigured with a CRM application, it will also store
the user's cntact data in the CRM.


REQUIREMENTS

This module depends on the Location module to enable zipcode-based searches of
available newspapers.  Be sure that you have enabled the Location module and
installed the zipcode data packaged with it.


INSTALLATION

Step 1) Download latest release from http://drupal.org/project/letters

Step 2)
  Extract the package into your 'modules' directory.


Step 3)
  Enable the letters module.

  Go to "administer >> build >> modules" and put a checkmark in the 'enabled'
  column next to 'Letters'.


Step 4)
  Go to "administer >> site configuration >> Letters" to configure the module.


Step 5)
  Enable permissions appropriate to your site.

  The forward module provides two permissions:
   - 'access letters': allow user to send letters.
   - 'administer letters': allow user to configure letters.

  Note that you need to enable 'access letters' for users who should be able to
  send emails using the letters module.


Step 5)
  Enter newspaper data in the letters_newspapers table.
  
  This can be done via a GUI like phpMyAdmin or via the command line using the
  following insert syntax for each newspaper:
  
  INSERT INTO letters_newspapers (title,address,city,state,zip,phone,fax,email,homepage,statewide) VALUES ('Example Newspaper','1 Nonexistant St, NW','Washington','DC','20005','202-555-5555','202-555-5555','editor@example.com','http://www.example.com','0');
  
  The last value should be '1' if you want the newspaper to show up in all
  searches regardless of the zip code (useful for a major regional paper in a
  smaller or less populous state.

  You can also do this manually via the module's configuration page.


SUPPORT

All issues with this module should be reported via the following form:
http://drupal.org/node/add/project_issue/letters

______________________________________________________________________________
http://www.ngpsystems.com
1
2	LETTERS MODULE - README
3	______________________________________________________________________________
4
5	NAME: Letters
6	AUTHORS: Sean Robertson <seanr@ngpsoftware.com>
7	______________________________________________________________________________
8
9
10	DESCRIPTION
11
12	This module allows users to write a letter to newspaper editors. If CRMAPI is
13	installed and correctly cnfigured with a CRM application, it will also store
14	the user's cntact data in the CRM.
15
16
17	REQUIREMENTS
18
19	This module depends on the Location module to enable zipcode-based searches of
20	available newspapers. Be sure that you have enabled the Location module and
21	installed the zipcode data packaged with it.
22
23
24	INSTALLATION
25
26	Step 1) Download latest release from http://drupal.org/project/letters
27
28	Step 2)
29	Extract the package into your 'modules' directory.
30
31
32	Step 3)
33	Enable the letters module.
34
35	Go to "administer >> build >> modules" and put a checkmark in the 'enabled'
36	column next to 'Letters'.
37
38
39	Step 4)
40	Go to "administer >> site configuration >> Letters" to configure the module.
41
42
43	Step 5)
44	Enable permissions appropriate to your site.
45
46	The forward module provides two permissions:
47	- 'access letters': allow user to send letters.
48	- 'administer letters': allow user to configure letters.
49
50	Note that you need to enable 'access letters' for users who should be able to
51	send emails using the letters module.
52
53
54	Step 5)
55	Enter newspaper data in the letters_newspapers table.
56
57	This can be done via a GUI like phpMyAdmin or via the command line using the
58	following insert syntax for each newspaper:
59
60	INSERT INTO letters_newspapers (title,address,city,state,zip,phone,fax,email,homepage,statewide) VALUES ('Example Newspaper','1 Nonexistant St, NW','Washington','DC','20005','202-555-5555','202-555-5555','editor@example.com','http://www.example.com','0');
61
62	The last value should be '1' if you want the newspaper to show up in all
63	searches regardless of the zip code (useful for a major regional paper in a
64	smaller or less populous state.
65
66	You can also do this manually via the module's configuration page.
67
68
69	SUPPORT
70
71	All issues with this module should be reported via the following form:
72	http://drupal.org/node/add/project_issue/letters
73
74	______________________________________________________________________________
75	http://www.ngpsystems.com