This is a How-to about integrating the awesome Vanilla 2 Forum Framework into Akelos.
In this manual, Vanilla 2 is being rewritten as an Akelos-Module named forum inside an existing Akelos Application.

It is based on Vanilla 2.0 Release Candidate 1 (Vanilla_2.0_rc1, vanillaforums-Garden-cb12ba2)

1. Install Akelos
2. Setup your application: Windows | Mac OS X
3. Install the Akelos module Admin Plugin
4. Install any other Available plug-in repositories.
5. Download the Vanilla 2-Source
6. Install a Vanilla 2 environment (http://yourhost.com/vanillaforums/)

Make sure in the forum_controller.php it reads:

class ForumController extends ApplicationController
    {
        // Your Code here...
    }

And in all module specific Controllers (everything in /forum/*_controller.php):

class Forum_CategoriesController extends ForumController
    {
        // Your Code here...
    }

• /installers/forum/category_installer.php
• /installers/forum/comment_installer.php
• /installers/forum/discussion_installer.php
• /installers/forum/draft_installer.php
• /installers/forum/search_installer.php
• /installers/forum/vanilla_installer.php

Make sure that in all module specific Installers (everything in /installers/forum/*_installer.php) it reads:

class CategoryInstaller extends AkInstaller
    {
        var $module = 'forum';
 
        // Your Code here...
 
    }

• Add the following Route directive to /your_akelos_app/config/routes.php (in the very top before all other routes!):

/**
 * Vanilla 2 Forum
 */
$Map->connect('/forum/:controller/:action/:id', array('module' => 'forum', 'controller' => 'discussions', 'action' => 'index'));

• Generate Model & Controller

  ./script/generate model Forum::Category
  ./script/generate controller Forum::categories

• Add the Table-scheme to the /installers/forum/category_installer.php:

$this->createTable('forum_categories', "
	id,
	parent_id,
	discussion_count,
	do_allow_discussion integer(4) default 1,
	name string(30),
	urlcode string(30),
	description,
	sort_by,
	created_by integer not null,
	created_at datetime not null,
	updated_by,
	updated_at
");

• Migrate using:

  ./script/migrate forum::category install

• Generate Model

  ./script/generate model Forum::Comment

• Add the Table-scheme to the /installers/forum/comment_installer.php:

$this->createTable('forum_comments', "
	id,
	discussion_id,
	created_by,
	created_at,
	updated_by,
	updated_at,
	deleted_by,
	deleted_at,
	body text not null,
	format string(20),
	flag integer(4) default 0,
	score float(10.2),
	attribs
");

• Migrate using:

  ./script/migrate forum::comment install

• Generate Model & Controller

  ./script/generate model Forum::Discussion
  ./script/generate controller Forum::discussions

• Add the Table-scheme to the /installers/forum/discussion_installer.php:

$this->createTable('forum_discussions', "
	id,
	category_id,
	created_by integer not null,
	created_at datetime not null,
	updated_by,
	updated_at,
	last_comment_by,
	last_comment_at,
	last_comment_id,
	name string(100) not null,
	body text not null,
	format string(20),
	comment_count integer default 1,
	closed integer(1) default 0,
	announce integer(1) default 0,
	sink integer(1) default 0,
	score float(10.2),
	attribs
");

• Migrate using:

  ./script/migrate forum::discussion install

• Generate Model & Controller

  ./script/generate model Forum::Draft
  ./script/generate controller Forum::drafts

• Generate Controller

  ./script/generate controller Forum::post

• Generate Model

  ./script/generate model Forum::Search

• Generate Controller

  ./script/generate controller Forum::settings

• Generate Model & Controller

  ./script/generate model Forum::Vanilla
  ./script/generate controller Forum::vanilla

• Move all JS files from /vanilla/applications/vanilla/js/ → /your_akelos_app/public/javascripts/