← 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: 2009-02-24 02:02:03 UTC
  • mto: This revision was merged to the branch mainline in revision 1119.
  • Revision ID: matt.giuca@gmail.com-20090224020203-aqdcjnsj6y7wl32o
Added a new look to the IVLE header bar. Mmmm... Web 2.0.
Added top-level directory image-source, containing SVG and script files for
    generating the images.
ivle/webapp/coremedia/images: Added 'chrome' directory containing the rendered
    images.
Modified ivle/webapp/base/ivle-headings.html and
    ivle/webapp/coremedia/ivle.css to support the new images.
    Note that the H1 and H2 at the top of the page are no longer displayed
    (and their custom styles have been removed). There is a heading image
    instead.

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.