42 |
It is important that new directory index file begins with dot -- that |
It is important that new directory index file begins with dot -- that |
43 |
ensures that files won't be visible from Directory Manager interface. |
ensures that files won't be visible from Directory Manager interface. |
44 |
|
|
45 |
6. Go to you web server and check if you got autorization request. If you |
6. (if you don't want to users in SQL database) Go to you web server and |
46 |
did, you also have .htusers in same directory in which is .index.php |
check if you got autorization request. If you did, you also have |
47 |
|
.htusers in same directory in which is .index.php |
48 |
|
|
49 |
7. edit .htusers file to add users. You can do that by calling adduser.pl |
edit .htusers file to add users. You can do that by calling adduser.pl |
50 |
script. If you press just enter for password or enter auth_pop3 |
script. If you press just enter for password or enter auth_pop3 |
51 |
docman will user e-mail address to connect to pop3 server and check |
docman will user e-mail address to connect to pop3 server and check |
52 |
password on it. For that e-mail address must be in following form: |
password on it. For that e-mail address must be in following form: |
57 |
to enter invalid e-mail address it that's valid pop3 account. But, that |
to enter invalid e-mail address it that's valid pop3 account. But, that |
58 |
WILL change, so you are warned! |
WILL change, so you are warned! |
59 |
|
|
60 |
|
7. (alternative to 6 if your users are in SQL database) change $gblUsers |
61 |
|
in .docman.conf to $gblUsers = "htusers_sql"; |
62 |
|
|
63 |
|
Download php-dbi class from http://pil.dk/downloads/dbi.tar.gz and |
64 |
|
untar it in docman's directory |
65 |
|
|
66 |
|
cd /home/html/docman |
67 |
|
tar xvfz dbi.tar.gz |
68 |
|
|
69 |
|
Construct SQL query which returns login, full name, password and |
70 |
|
email from your tables(s). If you don't have some of that data, replace |
71 |
|
them with literal strings. |
72 |
|
|
73 |
|
e.g. if your table is called my_users with columns who in which |
74 |
|
is login and column pw in which is plain text password you |
75 |
|
can use following query to get requested format: |
76 |
|
select who,'Auth user',pw,'nobody@com' from my_users |
77 |
|
|
78 |
|
Enter that SQL query under $dbi_sql in .docman.conf |
79 |
|
|
80 |
|
Construct $dbi in .docman.conf in following format: |
81 |
|
|
82 |
|
$dbi = "driver:database:user:password" |
83 |
|
|
84 |
|
driver can be: pgsql, mysql, oracle or odbc (as supported by php-dbi), |
85 |
|
database is name of database in which are your users and user/password |
86 |
|
is credentials for user which connects to database |
87 |
|
|
88 |
8. (optional) You can create file named .info.inc in /home/httpd/html |
8. (optional) You can create file named .info.inc in /home/httpd/html |
89 |
directory for some kind of motd file. You can use html markup in it |
directory for some kind of motd file. You can use html markup in it |
90 |
also! |
also! |
105 |
Breakout of files in /home/httpd/docman/: |
Breakout of files in /home/httpd/docman/: |
106 |
|
|
107 |
docman.php - main docman php file (to be installed as DirectoryIndex) |
docman.php - main docman php file (to be installed as DirectoryIndex) |
108 |
|
|
109 |
|
docman.conf - configuration file which will be copied in document |
110 |
|
root of site |
111 |
|
|
112 |
auth_pop3.php - authorization module ($gblIncDir in docman.php must point |
auth_pop3.php - authorization module ($gblIncDir in docman.php must point |
113 |
to location of this file) |
to location of this file) |
114 |
|
|
115 |
|
htusers_file.php - module for access to users in .htusers files |
116 |
|
htusers_sql.php - module for access to users which are in SQL database |
117 |
|
|
118 |
adduser.pl - perl script for adding of users (you can also add users |
adduser.pl - perl script for adding of users (you can also add users |
119 |
manually by editing .htusers file) |
manually by editing .htusers file) |
120 |
|
|
121 |
docman.txt - user documentation |
docman.txt - user documentation |
122 |
admin.txt - administrator's documentation |
admin.txt - administrator's documentation |
123 |
|
|
124 |
Breakout of files in /home/httpd/html/: |
contrib/ - directory with optional usefull scripts |
125 |
|
|
126 |
|
dbi/ - optional directory for dbi classes is users are stored |
127 |
|
in SQL database, it will be created after unpacking of |
128 |
|
http://pil.dk/downloads/dbi.tar.gz |
129 |
|
|
130 |
|
Breakout of files in /home/httpd/html/ (root directory of site under docman |
131 |
|
management): |
132 |
|
|
133 |
.changelog - changes of files under docman management |
.changelog - changes of files under docman management |
134 |
.htusers - file with users |
.htusers - file with users |
135 |
.info.inc - file with MOTD which is included in interface |
.info.inc - file with MOTD which is included in interface |
136 |
|
.docman.conf - configuration file for this site |
137 |
|
|
138 |
Files in each directory under docman management (some of them may be missing, |
Files in each directory under docman management (some of them may be missing, |
139 |
they will be created automatically): |
they will be created automatically): |