← Back to branch summary

~azzar1/unity/add-show-desktop-key

« back to all changes in this revision

Viewing changes to doc/setup/forum.txt

Quick port of fileservice to the new framework. It's still very much old-style,
though.

Show diffs side-by-side

added added

removed removed

Lines of Context:
doc/setup/forum.txt
 
1
IVLE phpBB3 integration
 
2
=======================
 
3
 
 
4
IVLE has an optional forum, an integrated instance of phpBB3.
 
5
It is not installed by default, so this document describes how to do it.
 
6
These instructions assume that you already have a working IVLE instance on the
 
7
same server.
 
8
 
 
9
phpBB requires PHP and a database driver to run. If on a Debian system, install
 
10
the 'php5' and 'php5-pgsql' packages.
 
11
 
 
12
You will first need to grab a copy of phpBB3. Extract it somewhere, and make it
 
13
visible under the IVLE domain. Make sure that you do not conflict with any
 
14
existing URLs, by using a directory like 'phpbb3'. A directive in your IVLE
 
15
Apache virtual host like this should work:
 
16
 
 
17
  Alias /phpbb3 /local/path/to/phpBB3
 
18
 
 
19
phpBB uses a different database. We will use PostgreSQL here, but IVLE does not
 
20
care which you use, as long as phpBB supports it. Create a database:
 
21
 
 
22
  sudo -u postgres createdb -E UTF-8 ivle_forum
 
23
 
 
24
Point your web browser at the phpBB URL, and follow the installation procedure.
 
25
Once it is installed and working, we need to apply some IVLE-specific patches
 
26
to achieve authentication integration:
 
27
 
 
28
  patch -p1 -d /local/path/to/phpBB3 < ivle/webapp/forum/phpbb3.diff
 
29
  chown -R www-data: /local/path/to/phpBB3
 
30
 
 
31
Choose a secure password with which to sign authentication cookies. Put it in
 
32
$ivle_secret in phpBB3/config.php.
 
33
 
 
34
To configure the IVLE side of things, create a new file at
 
35
/etc/ivle/plugins.d/forum.conf. In it put the following:
 
36
 
 
37
 [ivle.webapp.forum#Plugin]
 
38
 base = phpbb3 # Assuming that you used the same Alias line.
 
39
 secret = <FORUM SECRET> # Replace this with your chosen secret.
 
40
 
 
41
You should now be able to click on the Forum tab in IVLE and be automatically
 
42
logged in.