1
IVLE phpBB3 integration
2
=======================
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
9
phpBB requires PHP and a database driver to run. If on a Debian system, install
10
the 'php5' and 'php5-pgsql' packages.
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'. You also need to tell Apache
15
not to send it through the IVLE dispatcher. Directives in your IVLE Apache
16
virtual host like this should work:
21
Alias /phpbb3 /local/path/to/phpBB3
23
phpBB uses a different database. We will use PostgreSQL here, but IVLE does not
24
care which you use, as long as phpBB supports it. Create a database:
26
sudo -u postgres createdb -E UTF-8 ivle_forum
28
Point your web browser at the phpBB URL, and follow the installation procedure.
29
Once it is installed and working, we need to apply some IVLE-specific patches
30
to achieve authentication integration:
32
patch -p1 -d /local/path/to/phpBB3 < ivle/webapp/forum/phpbb3.diff
33
chown -R www-data: /local/path/to/phpBB3
35
Choose a secure password with which to sign authentication cookies. Put it in
36
$ivle_secret in phpBB3/config.php.
38
To configure the IVLE side of things, create a new file at
39
/etc/ivle/plugins.d/forum.conf. In it put the following:
41
[ivle.webapp.forum#Plugin]
42
base = phpbb3 # Assuming that you used the same Alias line.
43
secret = <FORUM SECRET> # Replace this with your chosen secret.
45
You should now be able to click on the Forum tab in IVLE and be automatically
added
removed
doc/setup/forum.txt
