← 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: Matt Giuca
  • Date: 2010-07-20 12:16:51 UTC
  • mto: This revision was merged to the branch mainline in revision 1818.
  • Revision ID: matt.giuca@gmail.com-20100720121651-rgeeztj6jn1tsrou
Submit page: No longer disables the radio button for closed projects.
Displays them in red rather than grey (grey implies disabled, red implies caution).
Added notice that the deadline has passed, but submission can still be done with a penalty.

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.