search

johndoh / roundcube-sauserprefs

Adds a 'Spam' tab to the 'Personal Settings' to allow the user to change their SpamAssassin preferences.
https://plugins.roundcube.net/#/packages/johndoh/sauserprefs
55 stars 18 forks source link

readme

Roundcube Webmail SAUserPrefs

This plugin adds the ability for users to edit they SpamAssassin user prefs from within Roundcube. It interacts with preferences storied in a database via SQL. For more information on setting up SpamAssassin to work with a database please see the SpamAssassin Wiki.

Inspiration for this plugin was taken from: WebUserPrefs

ATTENTION

This is just a snapshot from the GIT repository and is NOT A STABLE version of SAUserPrefs. It is Intended for use with the GIT-master version of Roundcube and it may not be compatible with older versions. Stable versions of SAUserPrefs are available from the Roundcube plugin repository (for 1.0 and above) or the releases section of the GitHub repository.

Requirements

License

This plugin is released under the GNU General Public License Version 3+.

Even if skins might contain some programming work, they are not considered as a linked part of the plugin and therefore skins DO NOT fall under the provisions of the GPL license. See the README file located in the core skins folder for details on the skin license.

Install

NB: When downloading the plugin from GitHub you will need to create a directory called sauserprefs and place the files in there, ignoring the root directory in the downloaded archive.

Config

The default config file is plugins/sauserprefs/config.inc.php.dist Rename this to plugins/sauserprefs/config.inc.php

SpamAssassin v4

To enable support for SpamAssassin v4 set $config['sauserprefs_sav4'] = true; in your config file. This replaces old rule names such as whitelist_from with with their v4 equivalent automatically. Note: Some default prefs in your config file may need to be updated. See SpamAssassin docs for more details.

Supported languages for ok_languages option

Taken from Mail::SpamAssassin::Plugin::TextCat

Changing the order of the sections

To change the order of the sections add a sections attribute with the sections listed in the desired order to the sasectionslist object in skins/[skin]/templates/sauserprefs.html. For example:

<roundcube:object name="sasectionslist" id="sections-table"
  class="records-table" cellspacing="0"
  sections="general,tests,bayes,headers,report,addresses" />

Delete user bayesian data stored in database

If the bayesian data is stored in the same database as the user prefs then it is possible for users to delete their data from the UI. See config file for example SQL

"SERVICE CURRENTLY NOT AVAILABLE! Error No. [500]" Error Message

On some setups users might see "SERVICE CURRENTLY NOT AVAILABLE! Error No. [500]" shows up at the top of the sauserprefs screen. In this case there could be a problem with the database connection. Try adding ?new_link=true to the end of the sauserprefs DSN in the config file. For example:

$config['sauserprefs_db_dsnw'] =
'mysql://username:password@localhost/database?new_link=true';

sauserprefs_save hook

Before prefs are saved to the database the plugin hook sauserprefs_save is executed, this allows you to perform any custom actions like extra validation or setting specific values. Arguments:

Return:

sauserprefs_sections_list hook

This allows you to modify the sections list. Arguments:

Return:

sauserprefs_section_name hook

This allows you to modify the title displayed at top of the preferences screen. Arguments:

Return:

sauserprefs_list hook

This allows you to modify the elements of the preferences screen before they are displayed. Arguments:

Return:

Replacing the storage class

To replace the default sql storage class with your own you need to set a special config options:

Overriding SpamAssassin test scores

An additional "Test Scores" section can be added to the UI to allow overriding of default test scores (e.g. score A_HREF_TO_REMOVE 2.0). To do this add the scores to the sauserprefs_default_prefs array. For example:

$config['sauserprefs_default_prefs'] = [
  ...
  'score SYMBOLIC_TEST_NAME' => 2.0,
];

Customizing the Elastic skin

The colors and styles used by this plugin can be overridden by adding a _custom.less file to the skins/elastic sub-folder of this plugin and then recompiling the CSS.