Skip to content

Commit

Permalink
General language improvements.
Browse files Browse the repository at this point in the history
- Remove the internal name "spampanel".
- Fix some minor English oddities / errors.
- Add some additional markup.
  • Loading branch information
tonyandrewmeyer authored Sep 13, 2016
1 parent c1f73cf commit da004e8
Showing 1 changed file with 22 additions and 24 deletions.
46 changes: 22 additions & 24 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,52 +1,50 @@


# Zimbra addon

This zimlet provides the following functionality:
- report a spam to our reporting system (spamreport.spamrl.com)
- automatically login to Spampanel and display Control Panel interface to a Zimbra tab

For every email we have the possibility to report it as spam to our system, by clicking right click and select "Report Spam".
If the operation was successfull the message "Email was reported as spam".
- automatically log in to our web interface and display Control Panel interface to a Zimbra tab

You may report any email as spam to our system by right-clicking it and selecting "Report Spam". If this is successful, the message "Email was reported as spam" will be shown.

In order to access Spam Filter panel, config_template.xml should contain an admin credentials. This admin should own your domain in our Spam Filtering system.
If your zimbra is configured over ssl, then your Spam Panel url should also use Https protocol. This is available for Logout url from your Spam Filter configuration.
In order to access the web interface, config_template.xml should contain an admin's credentials. This admin should own your domain in our spam filtering system.
If your zimbra is configured over SSL, then your web interface URL should also use the HTTPS protocol. This is available for 'Logout URL' in your web interface configuration.

For custom branding, replace "zimletName" and "label" in com_zimbra_spamexperts.properties files. Default values are "SpamExperts".
For a custom icon, just replace zimlet_icon.gif with your own. Be sure it will be a .gif file with dimensions 16x16 px.
For a custom icon, just replace zimlet_icon.gif with your own. Ensure that it is a .gif file with dimensions 16x16 px.

After all configuration is set up, you need to pack the addon (create a .zip archive with all sources file (com_zimbra_spamexperts.zip) ) and install it.
After all configuration is set up, you need to pack the addon (create a .zip archive with all sources named com_zimbra_spamexperts.zip) and install it.

Install the addon from cmd:
- upload com_zimbra_spamexperts.zip to /opt/zimbra/zimlets/ directory
- deploy the package using the command

/opt/zimbra/bin/zmzimletctl deploy /opt/zimbra/zimlets/com_zimbra_spamexperts.zip
Install the addon from the command line:
- upload com_zimbra_spamexperts.zip to `/opt/zimbra/zimlets/` directory
- deploy the package using the command `/opt/zimbra/bin/zmzimletctl deploy /opt/zimbra/zimlets/com_zimbra_spamexperts.zip`

You should see as response
You should see as response:

```
- INFO: Deploying Zimlet com_zimbra_spamexperts in LDAP.
- INFO: Installing Zimlet com_zimbra_spamexperts on this host.
- INFO: Upgrading Zimlet com_zimbra_spamexperts to 1.0
- INFO: Installing Zimlet config for com_zimbra_spamexperts
- INFO: Adding Zimlet com_zimbra_spamexperts to COS default
- INFO: Enabling Zimlet com_zimbra_spamexperts
```

Log in as a user in Zimbra and check for the zimlet in Zimlet section.

Log in as user in Zimbra and check for the zimlet in Zimlet section.

Due to Zimbra Cache is possible to not see the zimlet imediatly.
Due to Zimbra Cache is possible to not see the zimlet immediately.

Install the addon from Zimbra Admin Area:
- log in to your zimbra as administrator (using port 7071)
- go to Configure->Zimlets and deploy the zimlet
- check "Flush zimlet cache" to be sure you will see the zimlet imediatly
- check "Flush zimlet cache" to be sure you will see the zimlet immediately

By default, the zimlet is available to all users, but from Zimbra administration, for each user you can set if
By default, the zimlet is available to all users; from Zimbra administration, for each user, you can set if
that user should have access to this zimlet or not.

By default, zimbra debug mode for zimlets is enabled and all the information can be found in /opt/zimbra/log/mailbox.log
If for some reason, debug mode was disabled, it can be enabled for an admin user, after executing the following :
If for some reason, debug mode was disabled, it can be enabled for an admin user, after executing the following:

```
su - zimbra

zmprov addAccountLogger <your admin user email address> zimbra.zimlet debug
zmprov addAccountLogger <your admin user email address> zimbra.zimlet debug
```

0 comments on commit da004e8

Please sign in to comment.