| 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> |