FORWARD MODULE - README ______________________________________________________________________________ NAME: Forward AUTHORS: Sean Robertson Peter Feddo ______________________________________________________________________________ DESCRIPTION Adds a "forward this page" link to each node. This module allows users to forward a link to a specific node on your site to a friend. You can customize the default form field values and even view a running count of the emails sent so far using the forward module. SYSTEM REQUIREMENTS Drupal 4.6.0+ or CivicSpace 0.8.2+ INSTALLATION Step 1) Create the 'forward' database table. If using MySQL, this can be done using the included 'forward.mysql' script. From the command line, enter: $ mysql -u -p < forward.mysql For example, if your username is 'drupal' and your password 'secret', you would type: $ mysql -udrupal -psecret < forward.mysql If you use a database prefix, be sure to edit the table name in forward.mysql before importing it. Step 2) Copy 'forward.module' and 'forward.theme' into your 'modules' directory. Step 3) Enable the forward module. Go to "administer >> modules" and put a checkmark in the 'status' column next to 'forward'. Step 4) Go to "administer >> settings >> forward" to configure the module. Edit 'forward.theme' to change the look and feel of your emails. You can also create different themes for different phptemplate themes with by copying the contents of 'forward.theme' into your theme's 'template.php' file and prepending the function name with 'phptemplate_'. Then you can customize the function as needed and those changes will only appear went sent by a user using that theme. For more information, see the Drupal handbook: http://drupal.org/node/11811 Step 5) Enable permissions appropriate to your site. The forward module provides two permissions: - 'access forward': allow user to forward pages. - 'administer forward': allow user to configure forward. Note that you need to enable 'access forward' for users who should be able to send emails using the forward module. Step 6) Go to "administer >> forward" to view forward usage statistics. CREDITS & SUPPORT Special thanks to Jeff Miccolis of developmentseed.org for supplying the tracking features and various other edits. Thanks also to Nick White for his EmailPage module, some code from which was used in this module, as well as the numerous other users who have submitted issues and patches for forward. All issues with this module should be reported via the following form: http://drupal.org/node/add/project_issue/forward ______________________________________________________________________________ http://www.ngpsystems.com