← Back to branch summary

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

« back to all changes in this revision

Viewing changes to doc/setup/forum.txt

  • Committer: William Grant
  • Date: 2009-02-25 23:04:11 UTC
  • Revision ID: grantw@unimelb.edu.au-20090225230411-lbdyl32ir0m3d59b
Make all of the services executable.

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.