| 1 |
WordPress Multi User |
|---|
| 2 |
-------------------- |
|---|
| 3 |
|
|---|
| 4 |
WordPress MU is a multi user version of WordPress. |
|---|
| 5 |
|
|---|
| 6 |
If you're not comfortable editing PHP code, taking care of a complex |
|---|
| 7 |
webserver and database system and being pro-active about following |
|---|
| 8 |
developments of this project then run, don't walk, to |
|---|
| 9 |
http://wordpress.com/ and sign yourself and your friends up to free blogs. |
|---|
| 10 |
It's easier in the long run and you'll save yourself a lot of pain |
|---|
| 11 |
and angst. ;) |
|---|
| 12 |
|
|---|
| 13 |
Install |
|---|
| 14 |
======= |
|---|
| 15 |
Unarchive into a web directory and call that directory through your |
|---|
| 16 |
browser and web server. Follow the instructions and links and all |
|---|
| 17 |
should work fine. |
|---|
| 18 |
|
|---|
| 19 |
If you're upgrading, skip to the end of this document. |
|---|
| 20 |
|
|---|
| 21 |
Apache |
|---|
| 22 |
====== |
|---|
| 23 |
Apache must be configured so that mod_rewrite works. Here are |
|---|
| 24 |
instructions for Apache 2. Apache 1.3 is very similar. |
|---|
| 25 |
|
|---|
| 26 |
1. Make sure a line like the following appears in your httpd.conf |
|---|
| 27 |
LoadModule rewrite_module /usr/lib/apache2/modules/mod_rewrite.so |
|---|
| 28 |
|
|---|
| 29 |
2. In the <Directory> directive of your virtual host, look for this |
|---|
| 30 |
line |
|---|
| 31 |
"AllowOverride None" |
|---|
| 32 |
and change it to |
|---|
| 33 |
"AllowOverride FileInfo Options" |
|---|
| 34 |
|
|---|
| 35 |
3. In the <VirtualHost> section of the config file for your host there |
|---|
| 36 |
will be a line defining the hostname. You need to add the following |
|---|
| 37 |
if you want virtual hosts to work properly: |
|---|
| 38 |
"ServerAlias *.domain.tld" |
|---|
| 39 |
Replace domain.tld with whatever your one is, and remove the quotes. |
|---|
| 40 |
|
|---|
| 41 |
|
|---|
| 42 |
DNS |
|---|
| 43 |
=== |
|---|
| 44 |
If you want to host blogs of the form http://blog.domain.tld/ where |
|---|
| 45 |
domain.tld is the domain name of your machine then you must add a |
|---|
| 46 |
wildcard record to your DNS records. |
|---|
| 47 |
This usually means adding a "*" hostname record pointing at your |
|---|
| 48 |
webserver in your DNS configuration tool. |
|---|
| 49 |
Matt has a more detailed explanation: |
|---|
| 50 |
http://photomatt.net/2003/10/10/wildcard-dns-and-sub-domains/ |
|---|
| 51 |
|
|---|
| 52 |
|
|---|
| 53 |
PHP |
|---|
| 54 |
=== |
|---|
| 55 |
For security reasons, it's very important that PHP be configured as follows: |
|---|
| 56 |
|
|---|
| 57 |
1. Don't display error messages to the browser. This is almost always |
|---|
| 58 |
turned off but sometimes when you're testing you turn this on and forget |
|---|
| 59 |
to reset it. |
|---|
| 60 |
|
|---|
| 61 |
2. GLOBAL variables must be turned off. This is one of the first things |
|---|
| 62 |
any security aware admin will do. These days the default is for it to |
|---|
| 63 |
be off! |
|---|
| 64 |
|
|---|
| 65 |
3. If you want to restrict blog signups, set the restrict domain email |
|---|
| 66 |
setting in the admin. |
|---|
| 67 |
|
|---|
| 68 |
The easiest way of configuring it is via the .htaccess file that is |
|---|
| 69 |
created during the install. If you haven't installed WPMU yet then edit |
|---|
| 70 |
the file htaccess.dist in this directory and add these two lines at the |
|---|
| 71 |
top: |
|---|
| 72 |
|
|---|
| 73 |
php_flag register_globals 0 |
|---|
| 74 |
php_flag display_errors 0 |
|---|
| 75 |
|
|---|
| 76 |
This is NOT included in that file by default because it doesn't work on |
|---|
| 77 |
all machines. If it doesn't work on your machine, you'll get a cryptic |
|---|
| 78 |
"500 internal error" after you install WPMU. To remove the offending lines |
|---|
| 79 |
just edit the file ".htaccess" in your install directory and you'll see |
|---|
| 80 |
them at the top. Delete and save the file again. |
|---|
| 81 |
Read here for how to enable this: http://ie.php.net/configuration.changes |
|---|
| 82 |
|
|---|
| 83 |
If you don't want to edit your .htaccess file then you need to change your |
|---|
| 84 |
php.ini. It's beyond the scope of this README to know exactly where it is |
|---|
| 85 |
on your machine, but if you're on a shared hosted server you probably |
|---|
| 86 |
don't have access to it as it requires root or administrator privileges |
|---|
| 87 |
to change. |
|---|
| 88 |
|
|---|
| 89 |
If you do have root access, try "locate php.ini" or check in: |
|---|
| 90 |
|
|---|
| 91 |
/etc/php4/apache2/php.ini |
|---|
| 92 |
/usr/local/lib/php.ini |
|---|
| 93 |
|
|---|
| 94 |
Once you have opened your php.ini, look for the sections related to |
|---|
| 95 |
register_globals and display_errors. Make sure both are Off like so: |
|---|
| 96 |
|
|---|
| 97 |
display_errors = Off |
|---|
| 98 |
register_globals = Off |
|---|
| 99 |
|
|---|
| 100 |
You'll have to restart Apache after you modify your php.ini for the |
|---|
| 101 |
settings to be updated. |
|---|
| 102 |
|
|---|
| 103 |
|
|---|
| 104 |
UPGRADING |
|---|
| 105 |
========= |
|---|
| 106 |
Please see this page for instructions on upgrading your install: |
|---|
| 107 |
http://trac.mu.wordpress.org/wiki/UpgradingWpmu |
|---|
| 108 |
|
|---|
| 109 |
|
|---|
| 110 |
Support Forum and Bug Reports |
|---|
| 111 |
============================= |
|---|
| 112 |
Please read http://trac.mu.wordpress.org/wiki/DebuggingWpmu before |
|---|
| 113 |
asking any questions. Without all the information required there |
|---|
| 114 |
we'll just ask for it anyway or worse, your request will be ignored. |
|---|
| 115 |
|
|---|
| 116 |
http://mu.wordpress.org/forums/ |
|---|
| 117 |
|
|---|
| 118 |
Trac is our bug tracking system. Again, please read the above link |
|---|
| 119 |
before submitting a bug report. |
|---|
| 120 |
http://trac.mu.wordpress.org/report/1 |
|---|
| 121 |
|
|---|
| 122 |
You can login to both sites using your wordpress.org username and |
|---|
| 123 |
password. |
|---|
| 124 |
|
|---|
| 125 |
http://mu.wordpress.org/ |
|---|
