plugins/spamcop/options.php

   1 <?php
   2
   3    /**
   4     **  options.php -- SpamCop options page
   5     **
   6     **  Copyright (c) 1999-2003 The SquirrelMail development team
   7     **  Licensed under the GNU GPL. For full terms see the file COPYING.
   8     **
   9     **  $Id$
  10     **/
  11
  12 define('SM_PATH','../../');
  13 require_once(SM_PATH . 'include/validate.php');
  14
  15 displayPageHeader($color, 'None');
  16
  17 /* globals */
  18 sqgetGlobalVar('action', $action);
  19 sqgetGlobalVar('meth', $meth);
  20 sqgetGlobalVar('ID' , $ID);
  21
  22 sqgetGlobalVar('username', $username, SQ_SESSION);
  23 /* end of globals */
  24
  25 $action = (!isset($action) ? '' : $action);
  26
  27 switch ($action) {
  28     case 'enable':
  29         setPref($data_dir, $username, 'spamcop_enabled', 1);
  30         break;
  31     case 'disable':
  32         setPref($data_dir, $username, 'spamcop_enabled', '');
  33         break;
  34     case 'save':
  35         setPref($data_dir, $username, 'spamcop_delete', '');
  36         break;
  37     case 'delete':
  38         setPref($data_dir, $username, 'spamcop_delete', 1);
  39         break;
  40     case 'meth':
  41         if (isset($meth)) {
  42             setPref($data_dir, $username, 'spamcop_method', $meth);
  43         }
  44         break;
  45     case 'save_id':
  46         if (isset($ID)) {
  47             $ID = trim($ID);
  48             $ID = preg_replace('/@.*/','',$ID);
  49             $ID = preg_replace('/.*\./','',$ID);
  50             setPref($data_dir, $username, 'spamcop_id', $ID);
  51         }
  52         break;
  53 }
  54
  55 global $spamcop_enabled, $spamcop_delete;
  56 spamcop_load();
  57
  58 ?>
  59       <br />
  60       <table width="95%" align="center" border="0" cellpadding="2" cellspacing="0">
  61       <tr><td bgcolor="<?php echo $color[0]; ?>">
  62          <center><b><?php echo _("Options"); ?> - Message Filtering</b></center>
  63       </td></tr></table>
  64       <br />
  65
  66       <table align="center">
  67         <tr>
  68           <td align="right">SpamCop link is:</td>
  69           <td><?php if ($spamcop_enabled) {
  70           ?>Enabled (<a href="options.php?action=disable">Disable it</a>)
  71           <?PHP } else {
  72           ?>Disabled (<a href="options.php?action=enable">Enable it</a>)
  73           <?PHP }
  74           ?></td>
  75         </tr>
  76         <tr>
  77           <td align="right" valign="top">Delete spam when reported:<br />
  78             <font size="-2">(Only works with email-based reporting)</font>
  79           </td>
  80           <td valign="top"><?php if ($spamcop_delete) {
  81           ?>Enabled (<a href="options.php?action=save">Disable it</a>)
  82           <?php } else {
  83           ?>Disabled (<a href="options.php?action=delete">Enable it</a>)
  84           <?php }
  85           ?></td>
  86         </tr>
  87         <tr>
  88           <td align="right">Spam Reporting Method:</td>
  89           <form method="post" action="options.php"><td>
  90             <select name="meth">
  91               <option value="quick_email"<?php
  92                 if ($spamcop_method == 'quick_email') echo ' selected'
  93                 ?>>Quick email-based reporting</option>
  94               <option value="thorough_email"<?php
  95                 if ($spamcop_method == 'thorough_email') echo ' selected'
  96                 ?>>Thorough email-based reporting</option>
  97               <option value="web_form"<?php
  98                 if ($spamcop_method == 'web_form') echo ' selected'
  99                 ?>>Web-based form</option>
 100             </select>
 101             <input type="hidden" name="action" value="meth">
 102             <input type="submit" value="Save Method">
 103           </td></form>
 104         </tr>
 105         <tr>
 106           <td valign="top" align="right">Your SpamCop authorization code:<br />
 107             <font size="-2">(see below)</font>
 108           </td>
 109           <form method="post" action="options.php"><td valign="top">
 110             <input type="text" size="30" name="ID" value="<?php
 111               echo htmlspecialchars($spamcop_id) ?>" />
 112             <input type="hidden" name="action" value="save_id" />
 113             <input type="submit" value="Save ID" />
 114           </td></form>
 115         </tr>
 116       </table>
 117
 118 <p>SpamCop is a free service that greatly assists in finding the true source
 119 of the spam and helps in letting the proper people know about the abuse.</p>
 120
 121 <p>To use it, you must get a SpamCop authorization code.  There is a free <a
 122 href="http://spamcop.net/anonsignup.shtml">sign up page</a> so you can use
 123 SpamCop.</p>
 124
 125 <p><b>Before you sign up, be warned:</b>  Some users have reported that the
 126 email addresses used with SpamCop find their way onto spam lists.  To be
 127 safe, you can just create an email forwarding account and have all SpamCop
 128 reports get sent to there.  Also, if it gets flooded with spam, you can then
 129 just delete that account with no worries about losing your real email address.
 130 Just go create an email forwarder somewhere (<a
 131 href="http://www.yahoo.com/">Yahoo!</a> has a <a
 132 href="http://dir.yahoo.com/Business_and_Economy/Business_to_Business/Communications_and_Networking/Internet_and_World_Wide_Web/Email_Providers/Forwarding_Services/Free_Forwarding/">list
 133 of places</a>) so that messages from system administrators and whatnot can
 134 be sent to you.</p>
 135
 136 <p>Once you have signed up with SpamCop and have received your SpamCop
 137 authorization code, you need to enable this plugin -- just click the link
 138 above.  Once enabled, you go about your normal life.  If you encounter a
 139 spam message in your mailbox, just view it.  On the right-hand side, near
 140 the top of where the message is displayed, you will see a link to report
 141 this message as spam.  Clicking on it brings you to a confirmation page.
 142 Confirming that you want the spam report sent will do different things with
 143 different reporting methods.</p>
 144
 145 <p><b>Email-based Reporting</b><br />
 146 Pressing the button forwards the message to the SpamCop service and will
 147 optionally delete the message.  From there, you just need to go to your
 148 INBOX and quite soon a message should appear from SpamCop.  (It gets sent to
 149 the account you registered with, so make sure that your mail forwarder works!)
 150 Open it up, click on the appropriate link at the top, and a new browser
 151 window will open.</p>
 152
 153 <p>Currently, the quick reporting just forwards the request to the thorough
 154 reporting.  Also, it appears that this is for members (non-free) only.
 155 Hopefully this will change soon.</p>
 156
 157 <p><b>Web-based Reporting</b><br />
 158 When you press the button on the confirmation page, this will pop open a new
 159 browser window and the SpamCop service should appear inside.  The message
 160 will not be deleted (working on that part), but you won't need to wait for a
 161 response email to start the spam reporting.</p>
 162
 163 <p>The SpamCop service will display information as it finds it, so scroll
 164 down until you see a form button.  It might pause a little while it is
 165 looking up information, so be a little patient.  Read what it says, and
 166 submit the spam.  Close the browser window.  Press Cancel or click on the
 167 appropriate mail folder to see messages and/or delete the spam.</p>
 168
 169 <p><b>For more information</b> about SpamCop, it's services, spam in general,
 170 and many related topics, try reading through SpamCop's <a
 171 href="http://spamcop.net/help.shtml">Help and Feedback</a> section.</p>
 172
 173 </body></html>