Wikka : WikkaWikiEMailNotifications

• Categories
• PageIndex
• RecentChanges
• RecentlyCommented
• Login/Register
• Search:

Wiki Email Notifications

This was originally based on the Notify on Change patch from http://wikkawiki.org/NotifyOnChange.

This patch allows any user to monitor any change on any page (immediately it occurs and not using crontab). It was set up as I tend to use my wiki for collaborative work, and the users stopped using it as they would not be aware that others had made changes without regular monitoring. RSS too was not much use as most pages were restricted to certain users.

There is not a lot of code to change, and it is mostly in a couple of files.

Features (With all below code installed)

- default users listed (in main conf) who always receive all changes (e.g. admins)
- users can get styled/html formatted emails showing simple diffs of each page change
- page owners can edit the list of people who receive emails for their page (on the Edit ACLs page)
TODO: users can select whether they receive emails for any particular page (check box on edit page maybe?)

Version:

V1.0 - zorruno 2010-01-10 - original, tested on WikkaWiki 1.2-p1
V1.1 - zorruno 2010-04-02 - bug fixes to acls.php & minor fixes
V1.2 - zorruno 2010-04-05 - accidentally deleted some of the acls.php mod, now back in & more minor fixes
V1.3 - zorruno 2010-05-02 - bug fix, Null user in array causing email warnings

To Do:

- Fix the last part of my code to add tick boxes for users & upload here
- add page number to subject line?
- add comments about code checks needed
- add comment about emails to users with no acl access
- new pages generate error about no diff available?
- mode the inline css code into a template css file?
- make behave more like ACLs e.g with + and - users etc?

Install:

I've broken the code into steps to make it easier to see what is going on. You may also not want to install everything if you only want some of the functionality.

1. additions to the wikki config file

1. adding one column to a table in the db (you don't need this if you have a fixed list of users that need to be notified for all pages)

1. the main code that generates the email on every page edit (with just this installed, you can either just use a fixed list of users to be notified for all pages, or manually edit the database to say which users will be notified for each page)

1. the code that generates simple diffs that can be sent off with each email (if you don't want diffs emailed, set the config accordingly)

1. code that allows the owner of each page to decide who will be notified of each change for that page (set similar to the acl lists)

1. TODO: code that allows each user to individually turn notifications on or off for any page. (a tick box is set on each page for the user that they can opt in or out with)

Step 1:

Changes to wikka.config.php (in the root directory). Add these to the end (or somewhere) in the array of config items. Watch where the commas go - you don't need it with the last item in the array.

'email_notifications_db':
- Set this to 1 to use a list of users for each page from the db (you must must do step 2).
- Set it to 0 to not obtain any usernames from the database (there is no need to do the database change in step 2 if this is set to 0)
email_notifications_all:
- Add the users in a comma separated list that you want notified of ALL page changes e.g. admins.
- Leave this empty ( => '' ) if you just want database users.
email_notifications_include_diff:
- Set this to '1' if you want a simple diff of the most recent page revision sent to the users (you must install the diff code below)
email_notifications_subject:
- This is some text in [square brackets] that will be sent at the beginning the subject line of all notification emails.
email_notifications_sender_name:
- This is the email name that emails will be sent from
email_notifications_sender_email:
- This is the email address that emails will be sent from

Step 2:

SQL code to add the user list for each page. You don't need this if you plan to have a fixed set of users that will be notified on any page change (i.e. you have set 'email_notifications_db' => '0'. Run this in phpmyadmin or similar. Ensure you use the correct prefix for your database tables (e.g. mine below is wikka_ )

Step 3:

- This is the code you need to insert for the main part of this mod.
- OPEN the file handlers/page/edit.php
- ADD the following code, just before //forward

Step 4:

- You need this if you want simple page diffs printed in the email.
- Most of this code was taken from the diff.php page handler
- ADD this code where it tells you to in step 3 (inside that code).

Step 5:

- If you want the page owners to be able to update the list of who gets notification emails, install these code changes
- When installed, an additional box will show on the Edit ACLs page that page owners can add/edit a list of users who will receive email notifications.
- Note that this will produce a fourth text boxes on the ACLs page it may make your template layout ugly, especially if it is not very wide.

OPEN up the page handlers/page/acls.php

AFTER: or somewhere in the language definition stuff(around line 16)

ADD:

// --------------------------------------------------------------------------
// START: Email Notification Mod
// Mod for sending emails out to users on page modification
// http://wikkawiki.org/WikkaWikiEMailNotifications
// --------------------------------------------------------------------------
// There will be no EMAILNOTIFY_ACL_LABEL defined ...unless we also add something to the language files, so feel free to do so
if (!defined('EMAILNOTIFY_ACL_LABEL')) define('EMAILNOTIFY_ACL_LABEL', 'Email Notify:');
if (!defined('ACL_SYNTAX_HELP_EMAIL_NOTIFY')) define('ACL_SYNTAX_HELP_EMAIL_NOTIFY', '--- --- Note that the Email Notify list requires a list of users only, and will ignore ##*##, ##+## and ##!## ---(including users prefixed with !).');
// END: Email Notifications mod

AFTER: (around line 67)

$default_comment_acl = $this->GetConfigValue('default_comment_acl');

ADD:

            // START: Email Notifications mod - V1.1
            $default_emailnotify_acl    = '';    //not really needed, but may use if mod is expanded
            $posted_emailnotify_acl = $_POST['emailnotify_acl'];
            // END: Email Notifications mod

FIND AND DELETE: (around line 84)