← 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: David Coles
  • Date: 2010-08-30 03:26:13 UTC
  • Revision ID: coles.david@gmail.com-20100830032613-d14vng0jkelniu3l
python-console: Fix globals broken with new JSON library.

simplejson always returns unicode strings. cJSON would return ordinary strings 
if possible. cPickle.loads() only accepts strings. At present we use pickle 
version 0 so they should all works as ASCII strings. Higher versions of pickle 
are not plain ASCII and are likely to break this and so this should be fixed 
at some point.

Also replaced unconditional exception with one that catches Pickle errors. Not 
sure the best way to report failures of these functions.

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.