← Back to branch summary

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

« back to all changes in this revision

Viewing changes to doc/setup/forum.txt

Give console and tutorial services security declarations.

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'. 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:
17
 
 
18
 
  <Location /phpbb3>
19
 
      SetHandler none
20
 
  </Location>
21
 
  Alias /phpbb3 /local/path/to/phpBB3
22
 
 
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:
25
 
 
26
 
  sudo -u postgres createdb -E UTF-8 ivle_forum
27
 
 
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:
31
 
 
32
 
  patch -p1 -d /local/path/to/phpBB3 < ivle/webapp/forum/phpbb3.diff
33
 
  chown -R www-data: /local/path/to/phpBB3
34
 
 
35
 
Choose a secure password with which to sign authentication cookies. Put it in
36
 
$ivle_secret in phpBB3/config.php.
37
 
 
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:
40
 
 
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.
44
 
 
45
 
You should now be able to click on the Forum tab in IVLE and be automatically
46
 
logged in.