Mercurial > hg > mlmmj

annotate contrib/web/php-admin/README @ 759:73c8715367fb

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Better techniques for locating support files in php-admin - existing installations will need to have their conf/config.php altered to set the variable $confdir
author Ben Schmidt
date Wed, 06 Oct 2010 10:35:04 +1100
parents 16b4215d0709
children 331115b58da4
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
309
e39e57029aa9 php-admin
mmj
parents:
diff changeset
1 mlmmj-1.0.0 August 31th 2004
e39e57029aa9 php-admin
mmj
parents:
diff changeset
2
e39e57029aa9 php-admin
mmj
parents:
diff changeset
3 To use this web-interface you have to:
e39e57029aa9 php-admin
mmj
parents:
diff changeset
4
e39e57029aa9 php-admin
mmj
parents:
diff changeset
5 1) Copy the files from the php-admin directory of the mlmmj distribution to a
e39e57029aa9 php-admin
mmj
parents:
diff changeset
6 suitable location and point your webroot to the htdocs directory. If you
e39e57029aa9 php-admin
mmj
parents:
diff changeset
7 don't want the webinterface in the root of your website it is recommended to
e39e57029aa9 php-admin
mmj
parents:
diff changeset
8 make an alias in your web server configuration in order to keep the conf
e39e57029aa9 php-admin
mmj
parents:
diff changeset
9 directory at the same level as the htdocs directory and still outside
759
73c8715367fb Better techniques for locating support files in php-admin
Ben Schmidt
parents: 384
diff changeset
10 webscope. If you want to keep it somewhere else, you will need to modify
73c8715367fb Better techniques for locating support files in php-admin
Ben Schmidt
parents: 384
diff changeset
11 the first line of code in index.php, edit.php and save.php.
309
e39e57029aa9 php-admin
mmj
parents:
diff changeset
12
759
73c8715367fb Better techniques for locating support files in php-admin
Ben Schmidt
parents: 384
diff changeset
13 2) If your lists are stored somewhere other than /var/spool/mlmmj, edit
73c8715367fb Better techniques for locating support files in php-admin
Ben Schmidt
parents: 384
diff changeset
14 conf/config.php to reflect this.
73c8715367fb Better techniques for locating support files in php-admin
Ben Schmidt
parents: 384
diff changeset
15
73c8715367fb Better techniques for locating support files in php-admin
Ben Schmidt
parents: 384
diff changeset
16 3) Change the permissions of the listdir/control directories of any list you
309
e39e57029aa9 php-admin
mmj
parents:
diff changeset
17 want to control using the web-interface, so the web server can write in it:
e39e57029aa9 php-admin
mmj
parents:
diff changeset
18
e39e57029aa9 php-admin
mmj
parents:
diff changeset
19 # chown -R wwwrun /var/spool/mlmmj/mlmmj-test/control/
e39e57029aa9 php-admin
mmj
parents:
diff changeset
20
759
73c8715367fb Better techniques for locating support files in php-admin
Ben Schmidt
parents: 384
diff changeset
21 4) If the web server does not run as the same user the mailserver writes as
384
16b4215d0709 PHP updates from Christoph
mmj
parents: 309
diff changeset
22 you need to create a group (eg. mlmmj) and add both users to it. The
16b4215d0709 PHP updates from Christoph
mmj
parents: 309
diff changeset
23 subscribers.d directory then needs to be writable by that group:
16b4215d0709 PHP updates from Christoph
mmj
parents: 309
diff changeset
24
16b4215d0709 PHP updates from Christoph
mmj
parents: 309
diff changeset
25 # chgrp -R mlmmj /var/spool/mlmmj/mlmmj-test/subscribers.d/
16b4215d0709 PHP updates from Christoph
mmj
parents: 309
diff changeset
26 # chmod -R g+w /var/spool/mlmmj/mlmmj-test/subscribers.d/
16b4215d0709 PHP updates from Christoph
mmj
parents: 309
diff changeset
27
759
73c8715367fb Better techniques for locating support files in php-admin
Ben Schmidt
parents: 384
diff changeset
28 5) To enable access control on Apache you have to rename dot.htaccess to
73c8715367fb Better techniques for locating support files in php-admin
Ben Schmidt
parents: 384
diff changeset
29 .htaccess and edit the path inside the file to point to a htpasswd file
73c8715367fb Better techniques for locating support files in php-admin
Ben Schmidt
parents: 384
diff changeset
30 somewhere outside the webscope.
309
e39e57029aa9 php-admin
mmj
parents:
diff changeset
31
e39e57029aa9 php-admin
mmj
parents:
diff changeset
32 If you don't have one already, you can create one like this
e39e57029aa9 php-admin
mmj
parents:
diff changeset
33
e39e57029aa9 php-admin
mmj
parents:
diff changeset
34 htpasswd -c /home/mlmmj/htpasswd USER
e39e57029aa9 php-admin
mmj
parents:
diff changeset
35
e39e57029aa9 php-admin
mmj
parents:
diff changeset
36 It will then ask you for a password for the given username.
e39e57029aa9 php-admin
mmj
parents:
diff changeset
37
759
73c8715367fb Better techniques for locating support files in php-admin
Ben Schmidt
parents: 384
diff changeset
38 6) That is it, you are ready to use the interface.