forked from GNUsocial/gnu-social
85 lines
2.4 KiB
Plaintext
85 lines
2.4 KiB
Plaintext
|
|
||
|
|
Install
|
||
|
|
How to install the Phorum HTML Purifier plugin
|
||
|
|
|
||
|
|
0. PREREQUISITES
|
||
|
|
----------------
|
||
|
|
This Phorum module only works on PHP5 and with HTML Purifier 4.0.0
|
||
|
|
or later.
|
||
|
|
|
||
|
|
1. UNZIP
|
||
|
|
--------
|
||
|
|
Unzip phorum-htmlpurifier-x.y.z, producing an htmlpurifier folder.
|
||
|
|
You've already done this step if you're reading this!
|
||
|
|
|
||
|
|
2. MOVE
|
||
|
|
-------
|
||
|
|
Move the htmlpurifier folder to the mods/ folder of your Phorum
|
||
|
|
installation, so the directory structure looks like:
|
||
|
|
|
||
|
|
phorum/
|
||
|
|
mods/
|
||
|
|
htmlpurifier/
|
||
|
|
INSTALL - this install file
|
||
|
|
info.txt, ... - the module files
|
||
|
|
htmlpurifier/
|
||
|
|
|
||
|
|
3. INSTALL HTML PURIFIER
|
||
|
|
------------------------
|
||
|
|
Download and unzip HTML Purifier <htmlpurifier.org>. Place the contents of
|
||
|
|
the library/ folder in the htmlpurifier/htmlpurifier folder. Your directory
|
||
|
|
structure will look like:
|
||
|
|
|
||
|
|
phorum/
|
||
|
|
mods/
|
||
|
|
htmlpurifier/
|
||
|
|
htmlpurifier/
|
||
|
|
HTMLPurifier.auto.php
|
||
|
|
... - other files
|
||
|
|
HTMLPurifier/
|
||
|
|
|
||
|
|
Advanced users:
|
||
|
|
If you have HTML Purifier installed elsewhere on your server,
|
||
|
|
all you need is an HTMLPurifier.auto.php file in the library folder which
|
||
|
|
includes the HTMLPurifier.auto.php file in your install.
|
||
|
|
|
||
|
|
4. MIGRATE
|
||
|
|
----------
|
||
|
|
If you're setting up a new Phorum installation, all you need to do is create
|
||
|
|
a blank migrate.php file in the htmlpurifier module folder (NOT the library
|
||
|
|
folder.
|
||
|
|
|
||
|
|
If you have an old Phorum installation and was using BBCode,
|
||
|
|
copy migrate.bbcode.php to migrate.php. If you were using a different input
|
||
|
|
format, follow the instructions in migrate.bbcode.php to create your own custom
|
||
|
|
migrate.php file.
|
||
|
|
|
||
|
|
Your directory structure should now look like this:
|
||
|
|
|
||
|
|
phorum/
|
||
|
|
mods/
|
||
|
|
htmlpurifier/
|
||
|
|
migrate.php
|
||
|
|
|
||
|
|
5. ENABLE
|
||
|
|
---------
|
||
|
|
Navigate to your Phorum admin panel at http://example.com/phorum/admin.php,
|
||
|
|
click on Global Settings > Modules, scroll to "HTML Purifier Phorum Mod" and
|
||
|
|
turn it On.
|
||
|
|
|
||
|
|
6. MIGRATE SIGNATURES
|
||
|
|
---------------------
|
||
|
|
If you're setting up a new Phorum installation, skip this step.
|
||
|
|
|
||
|
|
If you allowed your users to make signatures, navigate to the module settings
|
||
|
|
page of HTML Purifier (Global Settings > Modules > HTML Purifier Phorum Mod >
|
||
|
|
Configure), type in "yes" in the "Confirm" box, and press "Migrate."
|
||
|
|
|
||
|
|
ONLY DO THIS ONCE! BE SURE TO BACK UP YOUR DATABASE!
|
||
|
|
|
||
|
|
7. CONFIGURE
|
||
|
|
------------
|
||
|
|
Configure using Edit settings. See that page for more information.
|
||
|
|
|
||
|
|
vim: et sw=4 sts=4
|