Sorry for the bad news. The original post is available below.
--Fountain of Apples
MOD Title: Forum Secretary
MOD Description: Adds a logging actions system to phpBB which can track administrator actions and moderator actions in an ACP-based log, and actions that a user made in a log that the user (and admin) can view.
MOD Version: Still in Planning
MOD Download: Not yet
Demo/Screenshots: Not yet
Code: Select all
svn co https://svn.sourceforge.net/svnroot/foamods/forumsecretary forumsecretary
Another Log Actions MOD? Doesn't this MOD already exist?
Yes, it does. There are quite a few around, and there's a very good MOD by morpheus2matrix in the database. However, that MOD has not been updated since October 2003 and was last tested by the MOD team on phpBB 2.0.6. It's been a little while since then.
Furthermore, Forum Secretary aims to be more comprehensive than morpheus2matrix's Log Actions MOD, even being more comprehensive than the log actions system in Olympus.
Forum Secretary allows for three seperate logs, an Administration Log (which tracks actions done in the ACP) and a Moderation Log (which tracks actions done in the MCP on the various forums by moderators), which are viewed within the ACP. In addition, a User Log can be kept. It will track everything that a user has done on the board, and can be viewed and managed both by the user and an admin. However, the user does not have absolute control, i.e. any log entry that the user deletes is simply hidden for them, the admin can still view it.
Forum Secretary also comes with EXTENSIVE configuration options, including the ability to password-protect the system (so, for example, only the main admin (the guy who installed the board) can view the logs). Individual logs can also be enabled/disabled, an automatic pruning system can be set up for logs, and each log has an independent set of controls. Users also get a set of configuration controls for themselves, although their controls do not do permanent actions and admin controls supersede them.
How is the MOD organized?
The actual Forum Secretary MOD is a backend log management system, it does not itself log anything. What it does is it provides three functions which can be used to add an entry to either of the three logs (admin, moderator, or user). These functions can be added throughout anywhere in phpBB to add a log action. Of course, Forum Secretary will add such log actions everywhere within a vanilla phpBB. However, the key detail here is that Forum Secretary is extensible to other MODs. Any other MOD can add support for Forum Secretary by simply calling one of the three functions in Forum Secretary which add log entries. And, by using PHP's function_exists() function to conditionally check for a function, the same code will work for boards with Forum Secretary installed, and boards without. Adding support in your MODs is effortless.
Forum Secretary will include 4 parts to installation (4 separate install files). Part 1 is the required part which will install the Forum Secretary backend. The majority of this will be copying included files; there are very few code edits to worry about with Part 1. The other three parts are optional, and contain all the edits for implementing admin log actions, moderator log actions, and user log actions for a vanilla phpBB. Each of these are seperate so that if you, for example, don't want to have the user log enabled, you don't have to run the part that adds the user log actions. This is important because the log actions together will span across a lot of phpBB's files, and will take a good amount of time to install if installation is occurring by hand.
What's the development schedule planned for?
Well, obviously, the bulk of the development will be spent in working on the backend; the rest is simply sorting through the phpBB files and adding function calls where necessary. This is all that's planned so far, however if you have any suggestions, please post.
Thanks for your interest!
--Fountain of Apples