4 * * validate input (fix javascript, add POST checks)
5 * * start this automatically the first time
7 * * eval index-user.php or index.php to get the actual settings.
8 * * ask to store it in index.php or index-user.php
10 * The file index-user.php will be generated which you can use as your index.php.
14 $config_file = 'index-user.php';
15 $fs_config_file = dirname(__FILE__) . (substr(PHP_OS,0,3) == 'WIN' ? '\\' : "/") . $config_file;
16 if (isset($HTTP_POST_VARS['create'])) header('Location: configurator.php?create=1#create');
17 printf("<?xml version=\"1.0\" encoding=\"%s\"?>\n", 'iso-8859-1');
19 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
20 "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
21 <html xmlns="http://www.w3.org/1999/xhtml">
23 <!-- $Id: configurator.php,v 1.12 2003-03-04 20:01:03 dairiki Exp $ -->
24 <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
25 <title>Configuration tool for PhpWiki 1.3.x</title>
26 <style type="text/css" media="screen">
28 /* TABLE { border: thin solid black } */
29 body { font-family: Verdana, Arial, Helvetica, sans-serif; font-size: 80%; }
30 pre { font-size: 120%; }
31 td { border: thin solid black }
33 tr.hidden { border: none; display: none; }
34 td.part { background-color: #eeaaaa; color: inherit; }
35 td.instructions { background-color: #ffffee; width: <?php echo $tdwidth ?>px; color: inherit; }
36 td.unchangeable-variable-top { border-bottom: none; background-color: #eeeeee; color:inherit; }
37 td.unchangeable-variable-left { border-top: none; background-color: #eeeeee; color:inherit; }
40 <script language="JavaScript" type="text/javascript">
42 function update(accepted, error, value, output) {
44 document.getElementById(output).innerHTML = "<font color=\"green\">Input accepted.</font>";
46 while ((index = error.indexOf("%s")) > -1) {
47 error = error.substring(0, index) + value + error.substring(index+2);
49 document.getElementById(output).innerHTML = "<font color=\"red\">" + error + "</font>";
53 function validate(error, value, output, field) {
54 update(field.value == value, error, field.value, output);
57 function validate_ereg(error, ereg, output, field) {
58 regex = new RegExp(ereg);
59 update(regex.test(field.value), error, field.value, output);
62 function validate_range(error, low, high, empty_ok, output, field) {
63 update((empty_ok == 1 && field.value == "") ||
64 (field.value >= low && field.value <= high),
65 error, field.value, output);
68 function toggle_group(id) {
69 var text = document.getElementById(id + "_text");
71 if (text.innerHTML == "Hide options.") {
73 text.innerHTML = "Show options.";
75 text.innerHTML = "Hide options.";
78 var rows = document.getElementsByTagName('tr');
80 for (i = 0; i < rows.length; i++) {
82 if (tr.className == 'header' && tr.id == id) {
87 for (; i < rows.length; i++) {
89 if (tr.className == 'header')
91 tr.className = do_hide ? 'hidden': 'nonhidden';
96 // Hide all groups. We do this via JavaScript to avoid
97 // hiding the groups if JavaScript is not supported...
98 var rows = document.getElementsByTagName('tr');
99 for (var i = 0; i < rows.length; i++) {
101 if (tr.className == 'header')
105 // Select text in textarea upon focus
106 var area = document.getElementById('config-output');
108 listener = { handleEvent: function (e) { area.select(); } };
109 area.addEventListener('focus', listener, false);
116 <body onload="do_init();">
118 <h1>Configuration tool for PhpWiki 1.3.x</h1>
121 //define('DEBUG', 1);
123 * The Configurator is a php script to aid in the configuration of PhpWiki.
124 * Parts of this file are based on PHPWeather's configurator.php file.
125 * http://sourceforge.net/projects/phpweather/
128 * TO CHANGE THE CONFIGURATION OF YOUR PHPWIKI, DO *NOT* MODIFY THIS FILE!
129 * more instructions go here
132 * * start this automatically the first time
134 * * eval index.php to get the actual settings.
135 * * ask to store it in index.php or settings.php
137 * The file settings.php will be generated which you can use as your index.php.
141 //////////////////////////////
142 // begin configuration options
146 * Notes for the description parameter of $property:
148 * - Descriptive text will be changed into comments (preceeded by //)
149 * for the final output to index.php.
151 * - Only a limited set of html is allowed: pre, dl dt dd; it will be
152 * stripped from the final output.
154 * - Line breaks and spacing will be preserved for the final output.
156 * - Double line breaks are automatically converted to paragraphs
157 * for the html version of the descriptive text.
159 * - Double-quotes and dollar signs in the descriptive text must be
160 * escaped: \" and \$. Instead of escaping double-quotes you can use
161 * single (') quotes for the enclosing quotes.
163 * - Special characters like < and > must use html entities,
164 * they will be converted back to characters for the final output.
167 $SEPARATOR = "///////////////////////////////////////////////////////////////////";
170 Copyright 1999, 2000, 2001, 2002 $ThePhpWikiProgrammingTeam = array(
171 "Steve Wainstead", "Clifford A. Adams", "Lawrence Akka",
172 "Scott R. Anderson", "Jon Åslund", "Neil Brown", "Jeff Dairiki",
173 "Stéphane Gourichon", "Jan Hidders", "Arno Hollosi", "John Jorgensen",
174 "Antti Kaihola", "Jeremie Kass", "Carsten Klapp", "Marco Milanesi",
175 "Grant Morgan", "Jan Nieuwenhuizen", "Aredridel Niothke",
176 "Pablo Roca Rozas", "Sandino Araico Sánchez", "Joel Uckelman",
177 "Reini Urban", "Tim Voght", "Jochen Kalmbach");
179 This file is part of PhpWiki.
181 PhpWiki is free software; you can redistribute it and/or modify
182 it under the terms of the GNU General Public License as published by
183 the Free Software Foundation; either version 2 of the License, or
184 (at your option) any later version.
186 PhpWiki is distributed in the hope that it will be useful,
187 but WITHOUT ANY WARRANTY; without even the implied warranty of
188 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
189 GNU General Public License for more details.
191 You should have received a copy of the GNU General Public License
192 along with PhpWiki; if not, write to the Free Software
193 Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
199 This is the starting file for PhpWiki. All this file does is set
200 configuration options, and at the end of the file it includes() the
201 file lib/main.php, where the real action begins.
203 If you include this file to override the default settings here,
204 you must also include lib/main.php.
206 This file is divided into seven parts: Parts Zero, One, Two, Three,
207 Four, Five and Six. Each one has different configuration settings you can
208 change; in all cases the default should work on your system,
209 however, we recommend you tailor things to your particular setting.
214 $properties["Part Zero"] =
215 new part('_part0', false, "
216 Part Zero: If PHP needs help in finding where you installed the
217 rest of the PhpWiki code, you can set the include_path here.");
219 if (substr(PHP_OS,0,3) == 'WIN') {
220 $include_path = ini_get('include_path') . ';' . dirname(__FILE__);
221 if (strchr(ini_get('include_path'),'/'))
222 $include_path = strtr($include_path,'\\','/');
224 $include_path = ini_get('include_path') . ':' . dirname(__FILE__);
227 $properties["PHP include_path"] =
228 new _ini_set('include_path', $include_path, "
229 NOTE: phpwiki uses the PEAR library of php code for SQL database
230 access. Your PHP is probably already configured to set
231 include_path so that PHP can find the pear code. If not (or if you
232 change include_path here) make sure you include the path to the
233 PEAR code in include_path. (To find the PEAR code on your system,
234 search for a file named 'PEAR.php'. Some common locations are:
242 The above examples are already included by PhpWiki. You shouldn't
243 have to change this unless you see a WikiFatalError:
245 lib/FileFinder.php:82: Fatal[256]:
246 DB.php: file not found
248 Define the include path for this wiki: pear plus the phpwiki path
250 \$include_path = '.:/Apache/php/pear:/prog/php/phpwiki';
252 Windows needs ';' as path delimiter. cygwin, mac and unix ':'
254 if (substr(PHP_OS,0,3) == 'WIN') {
255 \$include_path = implode(';',explode(':',\$include_path));
256 } elseif (substr(PHP_OS,0,6) == 'CYGWIN') {
257 \$include_path = '.:/usr/local/lib/php/pear'.
258 ':/usr/src/php/phpwiki';
263 $properties["Part Null"] =
264 new part('_partnullheader', "", "
265 Part Null: Don't touch this!");
269 $properties["Part Null Settings"] =
270 new unchangeable_variable('_partnullsettings', "
271 define ('PHPWIKI_VERSION', '1.3.5pre');
272 require \"lib/prepend.php\";
273 rcs_id('\$Id: configurator.php,v 1.12 2003-03-04 20:01:03 dairiki Exp $');", "");
276 $properties["Part One"] =
277 new part('_partone', $SEPARATOR."\n", "
280 Authentication and security settings. See Part Three for more.
285 $properties["Wiki Name"] =
286 new _define_optional('WIKI_NAME', 'PhpWiki', "
287 The name of your wiki.
288 This is used to generate a keywords meta tag in the HTML templates,
289 in bookmark titles for any bookmarks made to pages in your wiki,
290 and during RSS generation for the title of the RSS channel.");
293 $properties["Reverse DNS"] =
294 new boolean_define('ENABLE_REVERSE_DNS',
295 array('true' => "true. perform additional reverse dns lookups",
296 'false' => "false. just record the address as given by the httpd server"), "
297 If set, we will perform reverse dns lookups to try to convert the
298 users IP number to a host name, even if the http server didn't do it for us.");
300 $properties["Admin Username"] =
301 new _define_optional_notempty('ADMIN_USER', "", "
302 <a name=\"create\">You must set this! Username and password of the administrator.</a>",
303 "onchange=\"validate_ereg('Sorry, ADMIN_USER cannot be empty.', '^.+$', 'ADMIN_USER', this);\"");
305 $properties["Admin Password"] =
306 new _define_password_optional('ADMIN_PASSWD', "", "
307 For heaven's sake pick a good password.
308 You can also use our <a target=\"_new\" href=\"passencrypt.php\">passwordencrypter</a> to encrypt an existing password or
309 the \"Create Password\" button to create a good password.",
310 "onchange=\"validate_ereg('Sorry, ADMIN_PASSWD must be at least 4 chars long.', '^....+$', 'ADMIN_PASSWD', this);\"");
312 $properties["Encrypted Password"] =
313 new boolean_define_optional('ENCRYPTED_PASSWD',
314 array('true' => "true. ADMIN_PASSWD is encrypted",
315 'false' => "false. ADMIN_PASSWD is plaintext. Not recommended!"), "
316 If you used the passencrypt.php utility to encode the password or use an existing unix-crypt password,
317 then set this to true. Recommended!");
319 $properties["ZIPdump Authentication"] =
320 new boolean_define_optional('ZIPDUMP_AUTH',
321 array('false' => "false. Everyone may download zip dumps",
322 'true' => "true. Only admin may download zip dumps"), "
323 If true, only the admin user can make zip dumps, else zip dumps
324 require no authentication.");
326 $properties["Enable Plugin RawHtml"] =
327 new boolean_define_optional('ENABLE_RAW_HTML',
328 array('false' => "Disabled. Recommended on public sites.",
329 'true' => "Enabled"), "
330 Allow < ?plugin RawHtml ...>. Don't do this on a publicly accessable wiki for now.");
332 $properties["Strict Mailable Pagedumps"] =
333 new boolean_define('STRICT_MAILABLE_PAGEDUMPS',
334 array('false' => "binary",
335 'true' => "quoted-printable"), "
336 If you define this to true, (MIME-type) page-dumps (either zip dumps,
337 or \"dumps to directory\" will be encoded using the quoted-printable
338 encoding. If you're actually thinking of mailing the raw page dumps,
339 then this might be useful, since (among other things,) it ensures
340 that all lines in the message body are under 80 characters in length.
342 Also, setting this will cause a few additional mail headers
343 to be generated, so that the resulting dumps are valid
344 RFC 2822 e-mail messages.
346 Probably, you can just leave this set to false, in which case you get
347 raw ('binary' content-encoding) page dumps.");
351 $properties["HTML Dump Filename Suffix"] =
352 new _variable('HTML_DUMP_SUFFIX', ".html", "
353 Here you can change the filename suffix used for XHTML page dumps.
354 If you don't want any suffix just comment this out.");
358 $properties["Maximum Upload Size"] =
359 new numeric_define('MAX_UPLOAD_SIZE', "16 * 1024 * 1024", "
360 The maximum file upload size.");
364 $properties["Minor Edit Timeout"] =
365 new numeric_define('MINOR_EDIT_TIMEOUT', "7 * 24 * 3600", "
366 If the last edit is older than MINOR_EDIT_TIMEOUT seconds, the
367 default state for the \"minor edit\" checkbox on the edit page form
372 $properties["Disabled Actions"] =
373 new array_variable('DisabledActions', array(), "
374 Actions listed in this array will not be allowed. Actions are:
375 browse, create, diff, dumphtml, dumpserial, edit, loadfile, lock, remove,
376 unlock, upload, viewsource, zip, ziphtml");
378 $properties["Access Log"] =
379 new _define_commented('ACCESS_LOG', "/var/logs/wiki_access.log", "
380 PhpWiki can generate an access_log (in \"NCSA combined log\" format)
381 for you. If you want one, define this to the name of the log file,
382 such as /tmp/wiki_access_log.");
384 $properties["Compress Output"] =
385 new boolean_define_commented_optional
387 array('' => 'Compress when PhpWiki thinks approriate.',
388 'false' => 'Never compress output.',
389 'true' => 'Always try to compress output.'),
391 By default PhpWiki will try to have PHP compress it's output
392 before sending it to the browser (if you have a recent enough
393 version of PHP and the browser supports it.
395 Define COMPRESS_OUTPUT to false to prevent output compression.
397 Define COMPRESS_OUTPUT to true to force output compression,
398 even if we think your version of PHP does this in a buggy
401 Leave it undefined to leave the choice up to PhpWiki.");
403 $properties["HTTP Cache Control"] =
404 new _define_selection_optional
406 array('LOOSE' => 'LOOSE',
407 'STRICT' => 'STRICT',
409 'ALLOW_STALE' => 'ALLOW_STALE'),
413 This controls how PhpWiki sets the HTTP cache control
414 headers (Expires: and Cache-Control:)
420 <dd>This is roughly the old (pre 1.3.4) behavior. PhpWiki will
421 instruct proxies and browsers never to cache PhpWiki output.</dd>
424 <dd>Cached pages will be invalidated whenever the database global
425 timestamp changes. This should behave just like NONE (modulo
426 bugs in PhpWiki and your proxies and browsers), except that
427 things will be slightly more efficient.</dd>
430 <dd>Cached pages will be invalidated whenever they are edited,
431 or, if the pages include plugins, when the plugin output could
432 concievably have changed.
434 <p>Behavior should be much like STRICT, except that sometimes
435 wikilinks will show up as undefined (with the question mark)
436 when in fact they refer to (recently) created pages.
437 (Hitting your browsers reload or perhaps shift-reload button
438 should fix the problem.)</p></dd>
441 <dd>Proxies and browsers will be allowed to used stale pages.
442 (The timeout for stale pages is controlled by CACHE_CONTROL_MAX_AGE.)
444 <p>This setting will result in quirky behavior. When you edit a
445 page your changes may not show up until you shift-reload the
448 <p>This setting is generally not advisable, however it may be useful
449 in certain cases (e.g. if your wiki gets lots of page views,
450 and few edits by knowledgable people who won't freak over the quirks.)</p>
453 The default is currently LOOSE.");
455 $properties["HTTP Cache Control Max Age"] =
456 new numeric_define('CACHE_CONTROL_MAX_AGE', 600,
458 Maximum page staleness, in seconds.");
460 $properties["Markup Caching"] =
461 new boolean_define_commented_optional
462 ('WIKIDB_NOCACHE_MARKUP',
463 array('false' => 'Enable markup cache',
464 'true' => 'Disable markup cache'),
468 PhpWiki normally caches a preparsed version (i.e. mostly
469 converted to HTML) of the most recent version of each page.
470 (Parsing the wiki-markup takes a fair amount of CPU.)
472 Define WIKIDB_NOCACHE_MARKUP to true to disable the
473 caching of marked-up page content.
475 Note that you can also disable markup caching on a per-page
476 temporary basis by addinging a query arg of '?nocache=1'
477 to the URL to the page. (Use '?nocache=purge' to completely
478 discard the cached version of the page.)
480 You can also purge the cached markup globally by using the
481 \"Purge Markup Cache\" button on the PhpWikiAdministration page.");
484 $properties["Path for PHP Session Support"] =
485 new _ini_set('session.save_path', '/tmp', "
486 The login code now uses PHP's session support. Usually, the default
487 configuration of PHP is to store the session state information in
488 /tmp. That probably will work fine, but fails e.g. on clustered
489 servers where each server has their own distinct /tmp (this is the
490 case on SourceForge's project web server.) You can specify an
491 alternate directory in which to store state information like so
492 (whatever user your httpd runs as must have read/write permission
493 in this directory):");
497 $properties["Disable PHP Transparent Session ID"] =
498 new unchangeable_ini_set('session.use_trans_sid', "@ini_set('session.use_trans_sid', 0);", "
499 If your php was compiled with --enable-trans-sid it tries to
500 add a PHPSESSID query argument to all URL strings when cookie
501 support isn't detected in the client browser. For reasons
502 which aren't entirely clear (PHP bug) this screws up the URLs
503 generated by PhpWiki. Therefore, transparent session ids
504 should be disabled. This next line does that.
506 (At the present time, you will not be able to log-in to PhpWiki,
507 or set any user preferences, unless your browser supports cookies.)");
511 ///////// database selection
514 $properties["Part Two"] =
515 new part('_parttwo', $SEPARATOR."\n", "
522 $properties["Database Type"] =
523 new _variable_selection("DBParams|dbtype",
524 array('dba' => "dba DBM",
526 'ADODB' => "SQL ADODB",
527 'cvs' => "CVS File handler"), "
528 Select the database backend type:
529 Choose ADODB or SQL to use an SQL database with ADODB or PEAR.
530 Choose dba to use one of the standard UNIX dbm libraries.
531 CVS is not yet tested nor supported.
532 Recommended is SQL PEAR.");
534 $properties["Filename / Table name Prefix"] =
535 new _variable_commented("DBParams|prefix", "phpwiki_", "
536 Used by all DB types:
538 Prefix for filenames or table names
540 Currently you MUST EDIT THE SQL file too (in the schemas/
541 directory because we aren't doing on the fly sql generation
542 during the installation.");
545 $properties["SQL dsn Setup"] =
546 new unchangeable_variable('_sqldsnstuff', "", "
547 For SQL based backends, specify the database as a DSN
548 The most general form of a DSN looks like:
550 phptype(dbsyntax)://username:password@protocol+hostspec/database
552 For a MySQL database, the following should work:
554 mysql://user:password@host/databasename
556 To connect over a unix socket, use something like
558 mysql://user:password@unix(/path/to/socket)/databasename
560 <pre>'dsn' => 'mysql://guest@:/var/lib/mysql/mysql.sock/test',
561 'dsn' => 'mysql://guest@localhost/test',
562 'dsn' => 'pgsql://localhost/test',</pre>");
564 // Choose ADODB or SQL to use an SQL database with ADODB or PEAR.
565 // Choose dba to use one of the standard UNIX dbm libraries.
567 $properties["SQL Type"] =
568 new _variable_selection('_dsn_sqltype',
569 array('mysql' => "MySQL",
570 'pgsql' => "PostgreSQL"), "
575 $properties["SQL User"] =
576 new _variable('_dsn_sqluser', "wikiuser", "
581 $properties["SQL Password"] =
582 new _variable('_dsn_sqlpass', "", "
587 $properties["SQL Database Host"] =
588 new _variable('_dsn_sqlhostorsock', "localhost", "
589 SQL Database Hostname:
591 To connect over a local named socket, use something like
593 unix(/var/lib/mysql/mysql.sock)
599 $properties["SQL Database Name"] =
600 new _variable('_dsn_sqldbname', "phpwiki", "
601 SQL Database Name:");
603 list($dsn_sqltype,) = $properties["SQL Type"]->value();
604 $dsn_sqluser = $properties["SQL User"]->value();
605 $dsn_sqlpass = $properties["SQL Password"]->value();
606 $dsn_sqlhostorsock = $properties["SQL Database Host"]->value();
607 $dsn_sqldbname = $properties["SQL Database Name"]->value();
609 $properties["SQL dsn"] =
610 new unchangeable_variable("DBParams['dsn']",
611 "\$DBParams['dsn'] = \"\$_dsn_sqltype://{$dsn_sqluser}:{$dsn_sqlpass}@{$dsn_sqlhostorsock}/{$dsn_sqldbname}\";", "");
613 $properties["dba directory"] =
614 new _variable("DBParams|directory", "/tmp", "
618 $properties["dba handler"] =
619 new _variable_selection('DBParams|dba_handler',
620 array('gdbm' => "Gdbm - GNU database manager",
621 'dbm' => "DBM - Redhat default. On sf.net there's dbm and gdbm",
622 'db2' => "DB2 - Sleepycat Software's DB2",
623 'db3' => "DB3 - Sleepycat Software's DB3. Fine on Windows but not on every Linux"), "
624 Use 'gdbm', 'dbm', 'db2' or 'db3' depending on your DBA handler methods supported:");
626 $properties["dba timeout"] =
627 new _variable("DBParams|timeout", "20", "
628 Recommended values are 20 or 5.");
636 $properties["Page Revisions"] =
637 new unchangeable_variable('_parttworevisions', "", "
639 The next section controls how many old revisions of each page are
640 kept in the database.
642 There are two basic classes of revisions: major and minor. Which
643 class a revision belongs in is determined by whether the author
644 checked the \"this is a minor revision\" checkbox when they saved the
647 There is, additionally, a third class of revisions: author
648 revisions. The most recent non-mergable revision from each distinct
649 author is and author revision.
651 The expiry parameters for each of those three classes of revisions
652 can be adjusted seperately. For each class there are five
653 parameters (usually, only two or three of the five are actually
654 set) which control how long those revisions are kept in the
657 <dt>max_keep:</dt> <dd>If set, this specifies an absolute maximum for the
658 number of archived revisions of that class. This is
659 meant to be used as a safety cap when a non-zero
660 min_age is specified. It should be set relatively high,
661 and it's purpose is to prevent malicious or accidental
662 database overflow due to someone causing an
663 unreasonable number of edits in a short period of time.</dd>
665 <dt>min_age:</dt> <dd>Revisions younger than this (based upon the supplanted
666 date) will be kept unless max_keep is exceeded. The age
667 should be specified in days. It should be a
668 non-negative, real number,</dd>
670 <dt>min_keep:</dt> <dd>At least this many revisions will be kept.</dd>
672 <dt>keep:</dt> <dd>No more than this many revisions will be kept.</dd>
674 <dt>max_age:</dt> <dd>No revision older than this age will be kept.</dd>
676 Supplanted date: Revisions are timestamped at the instant that they
677 cease being the current revision. Revision age is computed using
678 this timestamp, not the edit time of the page.
680 Merging: When a minor revision is deleted, if the preceding
681 revision is by the same author, the minor revision is merged with
682 the preceding revision before it is deleted. Essentially: this
683 replaces the content (and supplanted timestamp) of the previous
684 revision with the content after the merged minor edit, the rest of
685 the page metadata for the preceding version (summary, mtime, ...)
690 // For now the expiration parameters are statically inserted as
691 // an unchangeable property. You'll have to edit the resulting
692 // config file if you really want to change these from the default.
694 $properties["Expiration Parameters for Major Edits"] =
695 new unchangeable_variable('ExpireParams|major',
696 "\$ExpireParams['major'] = array('max_age' => 32,
698 Keep up to 8 major edits, but keep them no longer than a month.");
700 $properties["Expiration Parameters for Minor Edits"] =
701 new unchangeable_variable('ExpireParams|minor',
702 "\$ExpireParams['minor'] = array('max_age' => 7,
704 Keep up to 4 minor edits, but keep them no longer than a week.");
708 $properties["Expiration Parameters by Author"] =
709 new unchangeable_variable('ExpireParams|author',
710 "\$ExpireParams['author'] = array('max_age' => 365,
713 'max_keep' => 20);", "
714 Keep the latest contributions of the last 8 authors up to a year.
715 Additionally, (in the case of a particularly active page) try to
716 keep the latest contributions of all authors in the last week (even
717 if there are more than eight of them,) but in no case keep more
718 than twenty unique author revisions.");
720 /////////////////////////////////////////////////////////////////////
722 $properties["Part Three"] =
723 new part('_partthree', $SEPARATOR."\n", "
725 Part Three: (optional)
729 $properties["User Authentication"] =
730 new boolean_define_optional('ALLOW_USER_LOGIN',
731 array('true' => "true. Check any defined passwords. (Default)",
732 'false' => "false. Don't check passwords. Legacy < 1.3.4"), "
733 If ALLOW_USER_LOGIN is true, any defined internal and external
734 authentication method is tried.
735 If not, we don't care about passwords, but check the next two constants.");
737 $properties["HTTP Authentication"] =
738 new boolean_define_optional('ALLOW_HTTP_AUTH_LOGIN',
739 array('false' => "false. Ignore HTTP Authentication. (Default)",
740 'true' => "true. Allow .htpasswd users login automatically."), "
741 The wiki can be optionally be protected by HTTP Auth. Use the username and password
742 from there, and if this fails, try the other methods also.");
744 $properties["Strict Login"] =
745 new boolean_define_optional('ALLOW_BOGO_LOGIN',
746 array('true' => "Users may Sign In with any WikiWord",
747 'false' => "Only admin may Sign In"), "
748 If ALLOW_BOGO_LOGIN is true, users are allowed to login (with
749 any/no password) using any userid which: 1) is not the ADMIN_USER,
750 2) is a valid WikiWord (matches \$WikiNameRegexp.)
751 If true, users may be created by themselves. Otherwise we need seperate auth.
752 This might be renamed to ALLOW_SELF_REGISTRATION");
754 $properties["Require Sign In Before Editing"] =
755 new boolean_define_optional('REQUIRE_SIGNIN_BEFORE_EDIT',
756 array('false' => "Do not require Sign In",
757 'true' => "Require Sign In"), "
758 If set, then if an anonymous user attempts to edit a page he will
759 be required to sign in. (If ALLOW_BOGO_LOGIN is true, of course,
760 no password is required, but the user must still sign in under
761 some sort of BogoUserId.)");
763 if (function_exists('ldap_connect')) {
764 $properties["LDAP Authentication"] =
765 new boolean_define_optional('ALLOW_LDAP_LOGIN',
766 array('true' => "Allow LDAP Authentication",
767 'false' => "Ignore LDAP"), "
770 $properties["LDAP Host"] =
771 new _define_optional('LDAP_AUTH_HOST', "localhost", "");
772 $properties["LDAP Root Search"] =
773 new _define_optional('LDAP_AUTH_SEARCH', "ou=mycompany.com,o=My Company", "
774 Give the right LDAP root search information in the next statement.");
778 $properties["LDAP Authentication"] =
779 new unchangeable_define('ALLOW_LDAP_LOGIN', "
780 if (!defined('ALLOW_LDAP_LOGIN')) define('ALLOW_LDAP_LOGIN', true and function_exists('ldap_connect'));
781 if (!defined('LDAP_AUTH_HOST')) define('LDAP_AUTH_HOST', 'localhost');
782 // Give the right LDAP root search information in the next statement.
783 if (!defined('LDAP_AUTH_SEARCH')) define('LDAP_AUTH_SEARCH', 'ou=mycompany.com,o=My Company');
785 Ignored. No LDAP support in this php. configure --with-ldap");
788 if (function_exists('imap_open')) {
789 $properties["IMAP Authentication"] =
790 new boolean_define_optional('ALLOW_IMAP_LOGIN',
791 array('true' => "Allow IMAP Authentication",
792 'false' => "Ignore IMAP"), "
795 $properties["IMAP Host"] =
796 new _define_optional('IMAP_AUTH_HOST', 'localhost', '');
798 $properties["IMAP Authentication"] =
799 new unchangeable_define('ALLOW_IMAP_LOGIN',"
800 // IMAP auth: check userid/passwords from a imap server, defaults to localhost
801 if (!defined('ALLOW_IMAP_LOGIN')) define('ALLOW_IMAP_LOGIN', true and function_exists('imap_open'));
802 if (!defined('IMAP_AUTH_HOST')) define('IMAP_AUTH_HOST', 'localhost');
803 ", "Ignored. No IMAP support in this php. configure --with-imap");
807 /////////////////////////////////////////////////////////////////////
809 $properties["Part Four"] =
810 new part('_partfour', $SEPARATOR."\n", "
813 Page appearance and layout
818 $properties["Theme"] =
819 new _define_selection_optional('THEME',
820 array('default' => "default",
821 'Hawaiian' => "Hawaiian",
822 'MacOSX' => "MacOSX",
823 'Portland' => "Portland",
824 'Sidebar' => "Sidebar",
825 'SpaceWiki' => "SpaceWiki"), "
828 Most of the page appearance is controlled by files in the theme
831 There are a number of pre-defined themes shipped with PhpWiki.
832 Or you may create your own (e.g. by copying and then modifying one of
837 define('THEME', 'default');
838 define('THEME', 'Hawaiian');
839 define('THEME', 'MacOSX');
840 define('THEME', 'Portland');
841 define('THEME', 'Sidebar');
842 define('THEME', 'SpaceWiki');</pre>");
846 $properties["Character Set"] =
847 new _define_optional('CHARSET', 'iso-8859-1', "
848 Select a valid charset name to be inserted into the xml/html pages,
849 and to reference links to the stylesheets (css). For more info see:
850 http://www.iana.org/assignments/character-sets. Note that PhpWiki
851 has been extensively tested only with the latin1 (iso-8859-1)
854 If you change the default from iso-8859-1 PhpWiki may not work
855 properly and it will require code modifications. However, character
856 sets similar to iso-8859-1 may work with little or no modification
857 depending on your setup. The database must also support the same
858 charset, and of course the same is true for the web browser. (Some
859 work is in progress hopefully to allow more flexibility in this
860 area in the future).");
864 $properties["Language"] =
865 new _variable_selection_optional('LANG',
866 array('en' => "English",
867 'nl' => "Nederlands",
874 Select your language/locale - default language is \"en\" for English.
875 Other languages available:<pre>
876 English \"en\" (English - HomePage)
877 Dutch \"nl\" (Nederlands - ThuisPagina)
878 Spanish \"es\" (Español - PáginaPrincipal)
879 French \"fr\" (Français - Accueil)
880 German \"de\" (Deutsch - StartSeite)
881 Swedish \"sv\" (Svenska - Framsida)
882 Italian \"it\" (Italiano - PaginaPrincipale)
884 If you set \$LANG to the empty string, your systems default language
885 (as determined by the applicable environment variables) will be
888 $properties["Language Locales"] =
889 new unchangeable_variable('language_locales',
890 "\$language_locales = array('en' => 'C',
898 if (empty(\$LC_ALL)) {
899 if (empty(\$language_locales[\$LANG]))
902 \$LC_ALL = \$language_locales[\$LANG];
904 putenv(\"LC_TIME=\$LC_ALL\");
906 Setting the LANG environment variable (accomplished above) may or
907 may not be sufficient to cause PhpWiki to produce dates in your
908 native language. (It depends on the configuration of the operating
909 system on your http server.) The problem is that, e.g. 'de' is
910 often not a valid locale.
912 A standard locale name is typically of the form
913 language[_territory][.codeset][@modifier], where language is
914 an ISO 639 language code, territory is an ISO 3166 country code,
915 and codeset is a character set or encoding identifier like
918 You can tailor the locale used for time and date formatting by
919 setting the LC_TIME environment variable. You'll have to experiment
920 to find the correct setting.
921 gettext() fix: With setlocale() we must use the long form,
922 like 'de_DE','nl_NL', 'es_MX', 'es_AR', 'fr_FR'.
923 For Windows maybe even 'german'. You might fix this accordingly.");
925 $properties["Wiki Page Source"] =
926 new _define_optional('WIKI_PGSRC', 'pgsrc', "
927 WIKI_PGSRC -- specifies the source for the initial page contents of
928 the Wiki. The setting of WIKI_PGSRC only has effect when the wiki is
929 accessed for the first time (or after clearing the database.)
930 WIKI_PGSRC can either name a directory or a zip file. In either case
931 WIKI_PGSRC is scanned for files -- one file per page.
933 // Default (old) behavior:
934 define('WIKI_PGSRC', 'pgsrc');
936 define('WIKI_PGSRC', 'wiki.zip');
938 '../Logs/Hamwiki/hamwiki-20010830.zip');
943 $properties["Default Wiki Page Source"] =
944 new _define('DEFAULT_WIKI_PGSRC', 'pgsrc', "
945 DEFAULT_WIKI_PGSRC is only used when the language is *not* the
946 default (English) and when reading from a directory: in that case
947 some English pages are inserted into the wiki as well.
948 DEFAULT_WIKI_PGSRC defines where the English pages reside.
950 FIXME: is this really needed?
955 $properties["Generic Pages"] =
956 new array_variable('GenericPages', array('ReleaseNotes', 'SteveWainstead', 'TestPage'), "
957 These are the pages which will get loaded from DEFAULT_WIKI_PGSRC.
959 FIXME: is this really needed? Can't we just copy these pages into
966 $properties["Part Five"] =
967 new part('_partfive', $SEPARATOR."\n", "
975 $properties["Allowed Protocols"] =
976 new list_variable('AllowedProtocols', 'http|https|mailto|ftp|news|nntp|ssh|gopher', "
977 allowed protocols for links - be careful not to allow \"javascript:\"
978 URL of these types will be automatically linked.
979 within a named link [name|uri] one more protocol is defined: phpwiki");
983 $properties["Inline Images"] =
984 new list_variable('InlineImages', 'png|jpg|gif', "
985 URLs ending with the following extension should be inlined as images");
989 $properties["WikiName Regexp"] =
990 new _variable('WikiNameRegexp', "(?<![[:alnum:]])(?:[[:upper:]][[:lower:]]+){2,}(?![[:alnum:]])", "
991 Perl regexp for WikiNames (\"bumpy words\")
992 (?<!..) & (?!...) used instead of '\b' because \b matches '_' as well");
994 $properties["Subpage Separator"] =
995 new _define_optional('SUBPAGE_SEPARATOR', '/', "
996 One character which seperates pages from subpages. Defaults to '/', but '.' or ':' were also used.",
997 "onchange=\"validate_ereg('Sorry, \'%s\' must be a single character. Currently only :, / or .', '^[/:.]$', 'SUBPAGE_SEPARATOR', this);\""
1000 $properties["InterWiki Map File"] =
1001 new _define('INTERWIKI_MAP_FILE', 'lib/interwiki.map', "
1002 InterWiki linking -- wiki-style links to other wikis on the web
1004 The map will be taken from a page name InterWikiMap.
1005 If that page is not found (or is not locked), or map
1006 data can not be found in it, then the file specified
1007 by INTERWIKI_MAP_FILE (if any) will be used.");
1009 $properties["WARN_NONPUBLIC_INTERWIKIMAP"] =
1010 new boolean_define('WARN_NONPUBLIC_INTERWIKIMAP',
1011 array('true' => "true",
1012 'false' => "false"), "
1013 Display a warning if the internal lib/interwiki.map is used, and
1014 not the public InterWikiMap page. This map is not readable from outside.");
1017 $properties["Part Six"] =
1018 new part('_partsix', $SEPARATOR."\n", "
1020 Part Six (optional):
1021 URL options -- you can probably skip this section.
1024 $properties["Server Name"] =
1025 new _define_commented_optional('SERVER_NAME', $HTTP_SERVER_VARS['SERVER_NAME'], "
1026 Canonical name and httpd port of the server on which this PhpWiki
1031 $properties["Server Port"] =
1032 new numeric_define_commented('SERVER_PORT', $HTTP_SERVER_VARS['SERVER_PORT'], "",
1033 "onchange=\"validate_ereg('Sorry, \'%s\' is no valid port number.', '^[0-9]+$', 'SERVER_PORT', this);\"");
1035 $scriptname = preg_replace('/configurator.php/','index.php',$HTTP_SERVER_VARS["SCRIPT_NAME"]);
1037 $properties["Script Name"] =
1038 new _define_commented_optional('SCRIPT_NAME', $scriptname, "
1039 Relative URL (from the server root) of the PhpWiki script.");
1041 $properties["Data Path"] =
1042 new _define_commented_optional('DATA_PATH', dirname($scriptname), "
1043 URL of the PhpWiki install directory. (You only need to set this
1044 if you've moved index.php out of the install directory.) This can
1045 be either a relative URL (from the directory where the top-level
1046 PhpWiki script is) or an absolute one.");
1050 $properties["PhpWiki Install Directory"] =
1051 new _define_commented_optional('PHPWIKI_DIR', dirname(__FILE__), "
1052 Path to the PhpWiki install directory. This is the local
1053 filesystem counterpart to DATA_PATH. (If you have to set
1054 DATA_PATH, your probably have to set this as well.) This can be
1055 either an absolute path, or a relative path interpreted from the
1056 directory where the top-level PhpWiki script (normally index.php)
1061 $properties["Use PATH_INFO"] =
1062 new boolean_define_commented_optional('USE_PATH_INFO',
1063 array('true' => 'use PATH_INFO',
1064 'false' => 'do not use PATH_INFO'), "
1065 Define to 'true' to use PATH_INFO to pass the pagenames.
1066 e.g. http://www.some.where/index.php/HomePage instead
1067 of http://www.some.where/index.php?pagename=HomePage
1068 FIXME: more docs (maybe in README). Default: true");
1072 $properties["Virtual Path"] =
1073 new _define_commented_optional('VIRTUAL_PATH', '/SomeWiki', "
1074 VIRTUAL_PATH is the canonical URL path under which your your wiki
1075 appears. Normally this is the same as dirname(SCRIPT_NAME), however
1076 using, e.g. apaches mod_actions (or mod_rewrite), you can make it
1077 something different.
1079 If you do this, you should set VIRTUAL_PATH here.
1081 E.g. your phpwiki might be installed at at /scripts/phpwiki/index.php,
1082 but you've made it accessible through eg. /wiki/HomePage.
1084 One way to do this is to create a directory named 'wiki' in your
1085 server root. The directory contains only one file: an .htaccess
1086 file which reads something like:
1088 Action x-phpwiki-page /scripts/phpwiki/index.php
1089 SetHandler x-phpwiki-page
1090 DirectoryIndex /scripts/phpwiki/index.php
1092 In that case you should set VIRTUAL_PATH to '/wiki'.
1094 (VIRTUAL_PATH is only used if USE_PATH_INFO is true.)
1098 $properties["Part Seven"] =
1099 new part('_partseven', $SEPARATOR."\n", "
1103 Miscellaneous settings
1106 $properties["Pagename of Recent Changes"] =
1107 new _define_optional('RECENT_CHANGES', 'RecentChanges', "
1108 Page name of RecentChanges page. Used for RSS Auto-discovery.");
1114 // Check if we were included by some other wiki version (getimg, en, ...)
1116 // If the server requested this index.php fire up the code by loading lib/main.php.
1117 // Parallel wiki scripts can now simply include /index.php for the
1118 // main configuration, extend or redefine some settings and
1119 // load lib/main.php by themselves.
1120 // This overcomes the index as config problem.
1123 // This doesn't work with php as CGI yet!
1124 if (defined('VIRTUAL_PATH') and defined('USE_PATH_INFO')) {
1125 if (\$HTTP_SERVER_VARS['SCRIPT_NAME'] == VIRTUAL_PATH) {
1126 include \"lib/main.php\";
1129 if (defined('SCRIPT_NAME') and
1130 (\$HTTP_SERVER_VARS['SCRIPT_NAME'] == SCRIPT_NAME)) {
1131 include \"lib/main.php\";
1132 } elseif (strstr(\$HTTP_SERVER_VARS['PHP_SELF'],'index.php')) {
1133 include \"lib/main.php\";
1137 // (c-file-style: \"gnu\")
1141 // c-basic-offset: 4
1142 // c-hanging-comment-ender-p: nil
1143 // indent-tabs-mode: nil
1150 // end of configuration options
1151 ///////////////////////////////
1152 // begin class definitions
1155 * A basic index.php configuration line in the form of a variable.
1157 * Produces a string in the form "$name = value;"
1159 * $WikiNameRegexp = "value";
1163 var $config_item_name;
1169 function _variable($config_item_name, $default_value, $description, $jscheck = '') {
1170 $this->config_item_name = $config_item_name;
1171 $this->description = $description;
1172 $this->default_value = $default_value;
1173 $this->jscheck = $jscheck;
1174 if (preg_match("/variable/i",get_class($this)))
1175 $this->prefix = "\$";
1176 elseif (preg_match("/ini_set/i",get_class($this)))
1177 $this->prefix = "ini_get: ";
1183 global $HTTP_POST_VARS;
1184 if (isset($HTTP_POST_VARS[$this->config_item_name]))
1185 return $HTTP_POST_VARS[$this->config_item_name];
1187 return $this->default_value;
1190 function _config_format($value) {
1191 $v = $this->get_config_item_name();
1192 // handle arrays: a|b --> a['b']
1193 if (strpos($v, '|')) {
1194 list($a, $b) = explode('|', $v);
1195 $v = sprintf("%s['%s']", $a, $b);
1197 return sprintf("\$%s = \"%s\";", $v, $value);
1200 function get_config_item_name() {
1201 return $this->config_item_name;
1204 function get_config_item_id() {
1205 return str_replace('|', '-', $this->config_item_name);
1208 function get_config_item_header() {
1209 if (strchr($this->config_item_name,'|')) {
1210 list($var,$param) = explode('|',$this->config_item_name);
1211 return "<b>" . $this->prefix . $var . "['" . $param . "']</b><br />";
1213 elseif ($this->config_item_name[0] != '_')
1214 return "<b>" . $this->prefix . $this->config_item_name . "</b><br />";
1219 function _get_description() {
1220 return $this->description;
1223 function _get_config_line($posted_value) {
1224 return "\n" . $this->_config_format($posted_value);
1227 function get_config($posted_value) {
1228 $d = stripHtml($this->_get_description());
1229 $d = str_replace("\n", "\n// ", $d) . $this->_get_config_line($posted_value) ."\n";
1233 function get_instructions($title) {
1235 $i = "<h3>" . $title . "</h3>\n " . nl2p($this->_get_description()) . "\n";
1236 return "<tr>\n<td width=\"$tdwidth\" class=\"instructions\">\n" . $i . "</td>\n";
1239 function get_html() {
1240 return $this->get_config_item_header() .
1241 "<input type=\"text\" size=\"50\" name=\"" . $this->get_config_item_name() . "\" value=\"" . htmlspecialchars($this->default_value) . "\" " .
1242 $this->jscheck . " />" . "<p id=\"" . $this->get_config_item_id() . "\" style=\"color: green\">Input accepted.</p>";
1246 class unchangeable_variable
1248 function _config_format($value) {
1251 // function get_html() { return false; }
1252 function get_html() {
1253 return $this->get_config_item_header() .
1254 "<em>Not editable.</em>" .
1255 "<pre>" . $this->default_value."</pre>";
1257 function _get_config_line($posted_value) {
1258 if ($this->description)
1260 return "${n}".$this->default_value;
1262 function get_instructions($title) {
1264 $i = "<h3>" . $title . "</h3>\n " . nl2p($this->_get_description()) . "\n";
1265 // $i = $i ."<em>Not editable.</em><br />\n<pre>" . $this->default_value."</pre>";
1266 return "<tr><td width=\"100%\" class=\"unchangeable-variable-top\" colspan=\"2\">\n".$i ."</td></tr>\n".
1267 "<tr style=\"border-top: none;\"><td class=\"unchangeable-variable-left\" width=\"$tdwidth\" bgcolor=\"#eeeeee\"> </td>";
1271 class unchangeable_define
1272 extends unchangeable_variable {
1273 function _config_format($value) {
1277 class unchangeable_ini_set
1278 extends unchangeable_variable {
1279 function _config_format($value) {
1285 class _variable_selection
1288 global $HTTP_POST_VARS;
1289 if (!empty($HTTP_POST_VARS[$this->config_item_name]))
1290 return $HTTP_POST_VARS[$this->config_item_name];
1292 list($option, $label) = current($this->default_value);
1293 return $this->$option;
1296 function get_html() {
1297 $output = $this->get_config_item_header();
1298 $output .= '<select name="' . $this->get_config_item_name() . "\">\n";
1299 /* The first option is the default */
1300 while(list($option, $label) = each($this->default_value)) {
1301 $output .= " <option value=\"$option\">$label</option>\n";
1303 $output .= "</select>\n";
1311 function _config_format($value) {
1312 return sprintf("define('%s', '%s');", $this->get_config_item_name(), $value);
1314 function _get_config_line($posted_value) {
1315 if ($this->description)
1317 if ($posted_value == '')
1318 return "${n}//" . $this->_config_format("");
1320 return "${n}" . $this->_config_format($posted_value);
1322 function get_html() {
1323 return $this->get_config_item_header() .
1324 "<input type=\"text\" size=\"50\" name=\"" . $this->get_config_item_name() . "\" value=\"" . $this->default_value . "\" {$this->jscheck} />" .
1325 "<p id=\"" . $this->get_config_item_id() . "\" style=\"color: green\">Input accepted.</p>";
1329 class _define_commented
1331 function _get_config_line($posted_value) {
1332 if ($this->description)
1334 if ($posted_value == $this->default_value)
1335 return "${n}//" . $this->_config_format($posted_value);
1336 else if ($posted_value == '')
1337 return "${n}//" . $this->_config_format("");
1339 return "${n}" . $this->_config_format($posted_value);
1343 class _define_commented_optional
1344 extends _define_commented {
1345 function _config_format($value) {
1346 $name = $this->get_config_item_name();
1347 return sprintf("if (!defined('%s')) define('%s', '%s');", $name, $name, $value);
1351 class _define_optional
1353 function _config_format($value) {
1354 $name = $this->get_config_item_name();
1355 return sprintf("if (!defined('%s')) define('%s', '%s');", $name, $name, $value);
1359 class _define_optional_notempty
1360 extends _define_optional {
1361 function get_html() {
1362 $s = $this->get_config_item_header() .
1363 "<input type=\"text\" size=\"50\" name=\"" . $this->get_config_item_name() . "\" value=\"" . $this->default_value . "\" {$this->jscheck} />";
1364 if (empty($this->default_value))
1365 return $s . "<p id=\"" . $this->get_config_item_id() . "\" style=\"color: red\">Cannot be empty.</p>";
1367 return $s . "<p id=\"" . $this->get_config_item_id() . "\" style=\"color: green\">Input accepted.</p>";
1371 class _variable_commented
1373 function _get_config_line($posted_value) {
1374 if ($this->description)
1376 if ($posted_value == $this->default_value)
1377 return "${n}//" . $this->_config_format($posted_value);
1378 else if ($posted_value == '')
1379 return "${n}//" . $this->_config_format("");
1381 return "${n}" . $this->_config_format($posted_value);
1385 class numeric_define_commented
1387 // var $jscheck = "onchange=\"validate_ereg('Sorry, \'%s\' is not an integer.', '^[-+]?[0-9]+$', '" . $this->get_config_item_name() . "', this);\"";
1389 function get_html() {
1390 return numeric_define::get_html();
1392 function _get_config_line($posted_value) {
1393 if ($this->description)
1395 if ($posted_value == $this->default_value)
1396 return "${n}//" . $this->_config_format($posted_value);
1397 else if ($posted_value == '')
1398 return "${n}//" . $this->_config_format('0');
1400 return "${n}" . $this->_config_format($posted_value);
1404 class _define_selection
1405 extends _variable_selection {
1406 function _config_format($value) {
1407 return sprintf("define('%s', '%s');", $this->get_config_item_name(), $value);
1409 function _get_config_line($posted_value) {
1410 return _define::_get_config_line($posted_value);
1412 function get_html() {
1413 return _variable_selection::get_html();
1417 class _define_selection_optional
1418 extends _define_selection {
1419 function _config_format($value) {
1420 $name = $this->get_config_item_name();
1421 return sprintf("if (!defined('%s')) define('%s', '%s');", $name, $name, $value);
1425 class _variable_selection_optional
1426 extends _variable_selection {
1427 function _config_format($value) {
1428 $v = $this->get_config_item_name();
1429 // handle arrays: a|b --> a['b']
1430 if (strpos($v, '|')) {
1431 list($a, $b) = explode('|', $v);
1432 $v = sprintf("%s['%s']", $a, $b);
1434 return sprintf("if (!isset(\$%s)) { \$%s = \"%s\"; }", $v, $v, $value);
1438 class _define_password
1440 // var $jscheck = "onchange=\"validate_ereg('Sorry, \'%s\' cannot be empty.', '^.+$', '" . $this->get_config_item_name() . "', this);\"";
1442 function _get_config_line($posted_value) {
1443 if ($this->description)
1445 if ($posted_value == '') {
1446 $p = "${n}//" . $this->_config_format("");
1447 $p = $p . "\n// If you used the passencrypt.php utility to encode the password";
1448 $p = $p . "\n// then uncomment this line:";
1449 $p = $p . "\n//if (!defined('ENCRYPTED_PASSWD')) define('ENCRYPTED_PASSWD', true);";
1452 if (function_exists('crypt')) {
1453 $salt_length = max(CRYPT_SALT_LENGTH,
1457 16 * CRYPT_BLOWFISH);
1458 // generate an encrypted password
1459 $crypt_pass = crypt($posted_value, rand_ascii($salt_length));
1460 $p = "${n}" . $this->_config_format($crypt_pass);
1461 return $p . "\ndefine('ENCRYPTED_PASSWD', true);";
1463 $p = "${n}" . $this->_config_format($posted_value);
1464 $p = $p . "\n// If you used the passencrypt.php utility to encode the password";
1465 $p = $p . "\n// then uncomment this line:";
1466 $p = $p . "\n//define('ENCRYPTED_PASSWD', false);";
1467 $p = $p . "\n// Encrypted passwords cannot be used:";
1468 $p = $p . "\n// 'function crypt()' not available in this version of php";
1473 function get_html() {
1474 return _variable_password::get_html();
1478 class _define_password_optional
1479 extends _define_password {
1480 function _config_format($value) {
1481 $name = $this->get_config_item_name();
1482 return sprintf("if (!defined('%s')) define('%s', '%s');", $name, $name, $value);
1487 class _variable_password
1489 // var $jscheck = "onchange=\"validate_ereg('Sorry, \'%s\' cannot be empty.', '^.+$', '" . $this->get_config_item_name() . "', this);\"";
1491 function get_html() {
1492 global $HTTP_POST_VARS, $HTTP_GET_VARS;
1493 $s = $this->get_config_item_header();
1494 $s .= "<input type=\"password\" name=\"" . $this->get_config_item_name() . "\" value=\"" . $this->default_value . "\" {$this->jscheck} />" .
1495 " <input type=\"submit\" name=\"create\" value=\"Create Password\" />";
1496 if (isset($HTTP_POST_VARS['create']) or isset($HTTP_GET_VARS['create'])) {
1497 $new_password = random_good_password();
1498 $this->default_value = $new_password;
1499 $s .= "<br /> <br />Created password: <strong>$new_password</strong>";
1501 if (empty($this->default_value))
1502 $s .= "<p id=\"" . $this->get_config_item_id() . "\" style=\"color: red\">Cannot be empty.</p>";
1503 elseif (strlen($this->default_value) < 4)
1504 $s .= "<p id=\"" . $this->get_config_item_id() . "\" style=\"color: red\">Must be longer than 4 chars.</p>";
1506 $s .= "<p id=\"" . $this->get_config_item_id() . "\" style=\"color: green\">Input accepted.</p>";
1511 class numeric_define
1513 // var $jscheck = "onchange=\"validate_ereg('Sorry, \'%s\' is not an integer.', '^[-+]?[0-9]+$', '" . $this->get_config_item_name() . "', this);\"";
1515 function _config_format($value) {
1516 return sprintf("define('%s', %s);", $this->get_config_item_name(), $value);
1518 function _get_config_line($posted_value) {
1519 if ($this->description)
1521 if ($posted_value == '')
1522 return "${n}//" . $this->_config_format('0');
1524 return "${n}" . $this->_config_format($posted_value);
1530 function _get_config_line($posted_value) {
1531 // split the phrase by any number of commas or space characters,
1532 // which include " ", \r, \t, \n and \f
1533 $list_values = preg_split("/[\s,]+/", $posted_value, -1, PREG_SPLIT_NO_EMPTY);
1534 $list_values = join("|", $list_values);
1535 return _variable::_get_config_line($list_values);
1537 function get_html() {
1538 $list_values = explode("|", $this->default_value);
1539 $rows = max(3, count($list_values) +1);
1540 $list_values = join("\n", $list_values);
1541 $ta = $this->get_config_item_header();
1542 $ta .= "<textarea cols=\"18\" rows=\"". $rows ."\" name=\"".$this->get_config_item_name()."\" {$this->jscheck}>";
1543 $ta .= $list_values . "</textarea>";
1544 $ta .= "<p id=\"" . $this->get_config_item_id() . "\" style=\"color: green\">Input accepted.</p>";
1549 class array_variable
1551 function _config_format($value) {
1552 return sprintf("\$%s = array(%s);", $this->get_config_item_name(), $value);
1554 function _get_config_line($posted_value) {
1555 // split the phrase by any number of commas or space characters,
1556 // which include " ", \r, \t, \n and \f
1557 $list_values = preg_split("/[\s,]+/", $posted_value, -1, PREG_SPLIT_NO_EMPTY);
1558 if (!empty($list_values)) {
1559 $list_values = "'".join("', '", $list_values)."'";
1560 return "\n" . $this->_config_format($list_values);
1562 return "\n//" . $this->_config_format('');
1564 function get_html() {
1565 $list_values = join("\n", $this->default_value);
1566 $rows = max(3, count($this->default_value) +1);
1567 $ta = $this->get_config_item_header();
1568 $ta .= "<textarea cols=\"18\" rows=\"". $rows ."\" name=\"".$this->get_config_item_name()."\" {$this->jscheck}>";
1569 $ta .= $list_values . "</textarea>";
1570 $ta .= "<p id=\"" . $this->get_config_item_id() . "\" style=\"color: green\">Input accepted.</p>";
1579 global $HTTP_POST_VARS;
1580 if ($v = $HTTP_POST_VARS[$this->config_item_name])
1583 return ini_get($this->get_config_item_name);
1586 function _config_format($value) {
1587 return sprintf("ini_set('%s', '%s');", $this->get_config_item_name(), $value);
1589 function _get_config_line($posted_value) {
1590 if ($posted_value && ! $posted_value == $this->default_value)
1591 return "\n" . $this->_config_format($posted_value);
1593 return "\n//" . $this->_config_format($this->default_value);
1597 class boolean_define
1599 function _get_config_line($posted_value) {
1600 if ($this->description)
1602 return "${n}" . $this->_config_format($posted_value);
1604 function _config_format($value) {
1605 if (strtolower(trim($value)) == 'false')
1607 return sprintf("define('%s', %s);", $this->get_config_item_name(),
1608 (bool)$value ? 'true' : 'false');
1610 function get_html() {
1611 $output = $this->get_config_item_header();
1612 $output .= '<select name="' . $this->get_config_item_name() . "\" {$this->jscheck}>\n";
1613 /* The first option is the default */
1614 list($option, $label) = each($this->default_value);
1615 $output .= " <option value=\"$option\" selected='selected'>$label</option>\n";
1616 /* There can usually, only be two options, there can be
1617 * three options in the case of a boolean_define_commented_optional */
1618 while (list($option, $label) = each($this->default_value))
1619 $output .= " <option value=\"$option\">$label</option>\n";
1620 $output .= "</select>\n";
1625 class boolean_define_optional
1626 extends boolean_define {
1627 function _config_format($value) {
1628 $name = $this->get_config_item_name();
1629 return "if (!defined('$name')) " . boolean_define::_config_format($value);
1633 class boolean_define_commented
1634 extends boolean_define {
1635 function _get_config_line($posted_value) {
1636 if ($this->description)
1638 list($default_value, $label) = each($this->default_value);
1639 if ($posted_value == $default_value)
1640 return "${n}//" . $this->_config_format($posted_value);
1641 else if ($posted_value == '')
1642 return "${n}//" . $this->_config_format('false');
1644 return "${n}" . $this->_config_format($posted_value);
1648 class boolean_define_commented_optional
1649 extends boolean_define_commented {
1650 function _config_format($value) {
1651 $name = $this->get_config_item_name();
1652 return "if (!defined('$name')) " . boolean_define_commented::_config_format($value);
1658 function value () { return; }
1659 function get_config($posted_value) {
1660 $d = stripHtml($this->_get_description());
1662 return "\n".$SEPARATOR . str_replace("\n", "\n// ", $d) ."\n$this->default_value";
1664 function get_instructions($title) {
1665 $group_name = preg_replace("/\W/","",$title);
1666 $i = "<tr class='header' id='$group_name'>\n<td class=\"part\" width=\"100%\" colspan=\"2\" bgcolor=\"#eeaaaa\">\n";
1667 $i .= "<h2>" . $title . "</h2>\n " . nl2p($this->_get_description()) ."\n";
1668 $i .= "<p><a href=\"javascript:toggle_group('$group_name')\" id=\"{$group_name}_text\">Hide options.</a></p>";
1669 return $i ."</td>\n";
1671 function get_html() {
1676 // html utility functions
1677 function nl2p($text) {
1678 preg_match_all("@\s*(<pre>.*?</pre>|<dl>.*?</dl>|.*?(?=\n\n|<pre>|<dl>|$))@s",
1679 $text, $m, PREG_PATTERN_ORDER);
1682 foreach ($m[1] as $par) {
1683 if (!($par = trim($par)))
1685 if (!preg_match('/^<(pre|dl)>/', $par))
1686 $par = "<p>$par</p>";
1692 function stripHtml($text) {
1693 $d = str_replace("<pre>", "", $text);
1694 $d = str_replace("</pre>", "", $d);
1695 $d = str_replace("<dl>", "", $d);
1696 $d = str_replace("</dl>", "", $d);
1697 $d = str_replace("<dt>", "", $d);
1698 $d = str_replace("</dt>", "", $d);
1699 $d = str_replace("<dd>", "", $d);
1700 $d = str_replace("</dd>", "", $d);
1701 $d = str_replace("<p>", "", $d);
1702 $d = str_replace("</p>", "", $d);
1703 //restore html entities into characters
1704 // http://www.php.net/manual/en/function.htmlentities.php
1705 $trans = get_html_translation_table (HTML_ENTITIES);
1706 $trans = array_flip ($trans);
1707 $d = strtr($d, $trans);
1712 * Seed the random number generator.
1714 * better_srand() ensures the randomizer is seeded only once.
1716 * How random do you want it? See:
1717 * http://www.php.net/manual/en/function.srand.php
1718 * http://www.php.net/manual/en/function.mt-srand.php
1720 function better_srand($seed = '') {
1721 static $wascalled = FALSE;
1724 list($usec,$sec)=explode(" ",microtime());
1726 $seed = (double) $usec * $sec;
1727 else // once in a while use the combined LCG entropy
1728 $seed = (double) 1000000 * substr(uniqid("",true),13);
1730 if (function_exists('mt_srand')) {
1731 mt_srand($seed); // mersenne twister
1739 function rand_ascii($length = 1) {
1742 for ($i = 1; $i <= $length; $i++) {
1743 // return only typeable 7 bit ascii, avoid quotes
1744 if (function_exists('mt_rand'))
1745 // the usually bad glibc srand()
1746 $s .= chr(mt_rand(40, 126));
1748 $s .= chr(rand(40, 126));
1754 // Function to create better user passwords (much larger keyspace),
1755 // suitable for user passwords.
1756 // Sequence of random ASCII numbers, letters and some special chars.
1757 // Note: There exist other algorithms for easy-to-remember passwords.
1758 function random_good_password ($minlength = 5, $maxlength = 8) {
1760 // assume ASCII ordering (not valid on EBCDIC systems!)
1761 $valid_chars = "!#%&+-.0123456789=@ABCDEFGHIJKLMNOPQRSTUVWXYZ_abcdefghijklmnopqrstuvwxyz";
1762 $start = ord($valid_chars);
1763 $end = ord(substr($valid_chars,-1));
1765 if (function_exists('mt_rand')) // mersenne twister
1766 $length = mt_rand($minlength, $maxlength);
1767 else // the usually bad glibc rand()
1768 $length = rand($minlength, $maxlength);
1769 while ($length > 0) {
1770 if (function_exists('mt_rand'))
1771 $newchar = mt_rand($start, $end);
1773 $newchar = rand($start, $end);
1774 if (! strrpos($valid_chars,$newchar) ) continue; // skip holes
1775 $newpass .= sprintf("%c",$newchar);
1782 function printArray($a) {
1783 echo "<hr />\n<pre>\n";
1785 echo "\n</pre>\n<hr />\n";
1788 // end of class definitions
1789 /////////////////////////////
1790 // begin auto generation code
1792 if (!function_exists('is_a'))
1794 function is_a($object, $class)
1796 $class = strtolower($class);
1797 return (get_class($object) == $class) or is_subclass_of($object, $class);
1802 if (@$HTTP_POST_VARS['action'] == 'make_config') {
1804 $timestamp = date ('dS of F, Y H:i:s');
1807 /* This is a local configuration file for PhpWiki.
1808 * It was automatically generated by the configurator script
1809 * on the $timestamp.
1814 /////////////////////////////////////////////////////////////////////
1818 $posted = $GLOBALS['HTTP_POST_VARS'];
1820 if (defined('DEBUG'))
1821 printArray($GLOBALS['HTTP_POST_VARS']);
1823 foreach($properties as $option_name => $a) {
1824 $posted_value = $posted[$a->config_item_name];
1825 $config .= $properties[$option_name]->get_config($posted_value);
1828 if (defined('DEBUG')) {
1829 $diemsg = "The configurator.php is provided for testing purposes only.
1830 You can't use this file with your PhpWiki server yet!!";
1831 $config .= "\ndie(\"$diemsg\");\n";
1835 /* We first check if the config-file exists. */
1836 if (file_exists($fs_config_file)) {
1837 /* We make a backup copy of the file */
1838 // $config_file = 'index-user.php';
1839 $new_filename = preg_replace('/\.php$/', time() . '.php', $fs_config_file);
1840 if (@copy($fs_config_file, $new_filename)) {
1841 $fp = @fopen($fs_config_file, 'w');
1844 $fp = @fopen($fs_config_file, 'w');
1848 fputs($fp, $config);
1850 echo "<p>The configuration was written to <code><b>$config_file</b></code>.</p>\n";
1851 if ($new_filename) {
1852 echo "<p>A backup was made to <code><b>$new_filename</b></code>.</p>\n";
1854 echo "<p><strong>You must rename or copy this</strong> <code><b>$config_file</b></code> <strong>file to</strong> <code><b>index.php</b></code>.</p>\n";
1856 echo "<p>A configuration file could <b>not</b> be written. You should copy the above configuration to a file, and manually save it as <code><b>index.php</b></code>.</p>\n";
1859 echo "<hr />\n<p>Here's the configuration file based on your answers:</p>\n";
1860 echo "<form method='get' action='$PHP_SELF'>\n";
1861 echo "<textarea id='config-output' readonly='readonly' style='width:100%;' rows='30' cols='100'>\n";
1862 echo htmlentities($config);
1863 echo "</textarea></form>\n";
1866 echo "<p>To make any corrections, <a href=\"configurator.php\">edit the settings again</a>.</p>\n";
1868 } else { // first time or create password
1869 $posted = $GLOBALS['HTTP_POST_VARS'];
1870 /* No action has been specified - we make a form. */
1873 <form action="configurator.php" method="post">
1874 <input type="hidden" name="action" value="make_config" />
1875 <table cellpadding="4" cellspacing="0">
1878 while(list($property, $obj) = each($properties)) {
1879 echo $obj->get_instructions($property);
1880 if ($h = $obj->get_html()) {
1881 if (defined('DEBUG')) $h = get_class($obj) . "<br />\n" . $h;
1882 echo "<td>".$h."</td>\n";
1889 <p><input type="submit" value="Save ',$config_file,'" /> <input type="reset" value="Clear" /></p>