Tree Forum

Summary

This library is intended to supply a non-recrusive, simple and modular way to create and manage tree-forums. The library is design with thought of the MVC patterns, supplying each part as an independent module

visit the Wiki Page for an API for the available classes.

a note about the wiki - there are some new actions that are not currently on the wiki, and some of the current docs might be obsolete. i hope to get to fixe this soon. for now, the best docs are at the file's source code

Demo

i've started working on a test run for the framework. for now, you can see it here. i actually developed the "C" and "V" classes for the framework for this example, but i'm not sure they're the ones i'm gonna stick with. on the example page you can:

• view a forum page
• login (username and pass are provided)
• post new messages (when logged in)
• open messages
• create user (only accessible through admin and editor users you want to try it out, ask me and i'll give you a permission)
• open user page
• receive a list of available public forums.
• mark a message as read/unread.
• restrict forums (available through admin interface. email me if you want access for it).

you can use firePHP to see debug info.

as of V0.7 the example is now nearing basic maturity. it still misses some basic functionality- such as creating forums and modifying user permissions. when this is done the example will be marked as an RC.

the example now uses ALL main model actions (with an exception of the ForumM's ability to create custom permissions).

Package Content

for now, the main focus is to supply the logic part of the framework. existing modules:

• ForumM : a class that handles forum creation and deployment.
• MessageM : a class that handles all message related actions.
• UserM : a class that handles user related actions.
• TFUser: a user handler class, which is designed to hold the minimum required for the library to function.

also, the package contains various framework classe-families:

• TFModel: this class fmailly supplies the basic interface for all other Model classes. it supplies extended functionality, such as parameter settings, error handling, and an elevated getter and setter mechanism. in a way, this is the heart of the framework.
• NewDao: this class familly supplies the database abstraction layer.

the package also comes with various test cases and examples of how to use the classes.

General Notes

i've uploaded the forum example files. it introduces 2 new class families- TFController, and TFView (which is actualy a very basic interface). i haven't decided their future in the library, so i haven't introduced them to the core. Last note for SVN users- the trunk isn't updated at all right now. for core versions use core branch.

Release Notes:

Version 0.8

1. added a new class: SearchM
2. restructured the data_access folder-layout and class inheritance (added 1 new interface and 2 abstract classes). also added a MatchCondition generator.
3. started working on PHPUnit tests for the library

Version 0.8.1

1. fixed a bug with the match syntax, and made SearchM use match condition for message searches.
2. added an object-oriented syntax to the condition generator. look at the QueryExample.php test file to see it in work. this is backward compatible

Version 0.8.2

1. updated the sql files.
2. made fulltext searches optional, and toggled off by default.
3. some bug fixes with the controllers (for the forum example)

Version 0.7

1. added the ability to create new and custom forum permissions
2. TFModel and ModelResult now support the is prefix for their accessors (returns a boolean representation for their values)
3. MessageM has the ability to mark messages as read/unread by a user. ForumM can read that data when retrieving the messages.
4. this is a wrap-up of the various fixes and upgrades done in 0.6.* versions- such as the upgrade of the Query and MysqlQuery classes.
5. the permission checks weren't functioning properly, and they have been re-orgenized.
6. there has been an overall refactoring and re-ordering of the code to make it easier to rad and maintain.

Version 0.6

1. added a new action to 3 main models- the new action. its should be used for creating the creation forms.
2. TFUser was moved from the singelton pattern to the factory pattern. this is due to session issues. hence, it was split to a factory class (TFUser) and a model (TFUserM). this is backward-compatible.
3. TFModel can now accept actions with no coupled methods.
4. loads of fixes and small behavioral changes, due to the test runs through the forum-example branch.
5. a system-wide typo was fixed- used to write permision instead of permis*s*ion. a lot
6. database structure was modified substantialy, and is not even a bit backward compatible

Version 0.6.1

I have made some improvements and fixes through the forum example. as of this version.

Version 0.6.7

Vast amount of fixes and add-ins. mostly through the example forum. ForumM have a lot of improvements. NewDao and Query and MysqlQuery have all been improved as well. MessageM have new functionality. there have been variouse bug fixes and security holes found and fixed. I am not renaming it to 0.8 as there is no new classes and all adds and fixes were to enhance the current usage model.