4 Copyright 2000??, 2001, 2002 $ThePhpWikiProgrammingTeam = array(
5 "Steve Wainstead", "Arno Hollosi", "Jeff Dairiki",
6 "Aredridel Niothke", "Jan Nieuwenhuizen", "Sandino Araico Sánchez",
7 "Jon Åslund", "Marco Milanesi", "Carsten Klapp", "Joel Uckelman",
8 "Pablo Roca Rozas", "Scott R. Anderson", "Neil Brown", "Jan Hidders",
9 "Antti Kaihola", "Jeremie Kass", "John Jorgensen", "Tim Voght",
10 "Grant Morgan", "Clifford A. Adams", "Reini Urban");
12 This file is part of PhpWiki.
14 PhpWiki is free software; you can redistribute it and/or modify
15 it under the terms of the GNU General Public License as published by
16 the Free Software Foundation; either version 2 of the License, or
17 (at your option) any later version.
19 PhpWiki is distributed in the hope that it will be useful,
20 but WITHOUT ANY WARRANTY; without even the implied warranty of
21 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
22 GNU General Public License for more details.
24 You should have received a copy of the GNU General Public License
25 along with PhpWiki; if not, write to the Free Software
26 Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
30 /////////////////////////////////////////////////////////////////////
32 This is the starting file for PhpWiki. All this file does is set
33 configuration options, and at the end of the file it includes() the
34 file lib/main.php, where the real action begins.
36 This file is divided into six parts: Parts Zero, One, Two, Three,
37 Four and Five. Each one has different configuration settings you can
38 change; in all cases the default should work on your system,
39 however, we recommend you tailor things to your particular setting.
42 /////////////////////////////////////////////////////////////////////
43 // Part Zero: If PHP needs help in finding where you installed the
44 // rest of the PhpWiki code, you can set the include_path here.
46 // NOTE: phpwiki uses the PEAR library of php code for SQL database
47 // access. Your PHP is probably already configured to set
48 // include_path so that PHP can find the pear code. If not (or if you
49 // change include_path here) make sure you include the path to the
50 // PEAR code in include_path. (To find the PEAR code on your system,
51 // search for a file named 'PEAR.php'. Some common locations are:
55 // /usr/local/share/php
57 // /System/Library/PHP
59 // The above examples are already included by PhpWiki. You shouldn't
60 // have to change this unless you see a WikiFatalError:
62 // lib/FileFinder.php:82: Fatal[256]: DB.php: file not found
64 //ini_set('include_path', '.:/where/you/installed/phpwiki');
66 /////////////////////////////////////////////////////////////////////
67 // Part Null: Don't touch this!
69 define ('PHPWIKI_VERSION', '1.3.2-jeffs-hacks');
70 require "lib/prepend.php";
71 rcs_id('$Id: index.php,v 1.63 2002-01-17 05:52:11 carstenklapp Exp $');
73 /////////////////////////////////////////////////////////////////////
76 // Authentication and security settings:
78 /////////////////////////////////////////////////////////////////////
80 // The name of your wiki.
81 // This is used to generate a keywords meta tag in the HTML templates,
82 // and during RSS generation for the <title> of the RSS channel.
83 //define('WIKI_NAME', 'PhpWiki');
85 // If set, we will perform reverse dns lookups to try to convert the
86 // users IP number to a host name, even if the http server didn't do
88 define('ENABLE_REVERSE_DNS', true);
90 // Username and password of administrator.
91 // Set these to your preferences. For heaven's sake
92 // pick a good password!
93 define('ADMIN_USER', "");
94 define('ADMIN_PASSWD', "");
96 // If true, only the admin user can make zip dumps, else zip dumps
97 // require no authentication.
98 define('ZIPDUMP_AUTH', false);
100 // This setting determines the type of page dumps. Must be one of
101 // "quoted-printable" or "binary".
102 $pagedump_format = "quoted-printable";
104 // The maximum file upload size.
105 define('MAX_UPLOAD_SIZE', 16 * 1024 * 1024);
107 // If the last edit is older than MINOR_EDIT_TIMEOUT seconds, the
108 // default state for the "minor edit" checkbox on the edit page form
110 define("MINOR_EDIT_TIMEOUT", 7 * 24 * 3600);
112 // Actions listed in this array will not be allowed.
113 //$DisabledActions = array('dumpserial', 'loadfile');
115 // PhpWiki can generate an access_log (in "NCSA combined log" format)
116 // for you. If you want one, define this to the name of the log file.
117 //define('ACCESS_LOG', '/tmp/wiki_access_log');
120 // If ALLOW_BOGO_LOGIN is true, users are allowed to login (with
121 // any/no password) using any userid which: 1) is not the ADMIN_USER,
122 // 2) is a valid WikiWord (matches $WikiNameRegexp.)
123 define('ALLOW_BOGO_LOGIN', true);
125 // The login code now uses PHP's session support. Usually, the default
126 // configuration of PHP is to store the session state information in
127 // /tmp. That probably will work fine, but fails e.g. on clustered
128 // servers where each server has their own distinct /tmp (this is the
129 // case on SourceForge's project web server.) You can specify an
130 // alternate directory in which to store state information like so
131 // (whatever user your httpd runs as must have read/write permission
132 // in this directory):
134 //ini_set('session.save_path', 'some_other_directory');
137 /////////////////////////////////////////////////////////////////////
140 // Database Selection
142 /////////////////////////////////////////////////////////////////////
145 // This array holds the parameters which select the database to use.
147 // Not all of these parameters are used by any particular DB backend.
150 // Select the database type:
154 // For SQL based backends, specify the database as a DSN
155 // The most general form of a DSN looks like:
157 // phptype(dbsyntax)://username:password@protocol+hostspec/database
159 // For a MySQL database, the following should work:
161 // mysql://user:password@host/databasename
163 // FIXME: My version Pear::DB seems to be broken enough that there
164 // is no way to connect to a mysql server over a socket right now.
165 //'dsn' => 'mysql://guest@:/var/lib/mysql/mysql.sock/test',
166 //'dsn' => 'mysql://guest@localhost/test',
167 //'dsn' => 'pgsql://localhost/test',
169 // Used by all DB types:
171 // prefix for filenames or table names
173 * currently you MUST EDIT THE SQL file too (in the schemas/
174 * directory because we aren't doing on the fly sql generation
175 * during the installation.
177 //'prefix' => 'phpwiki_',
180 'directory' => "/tmp",
181 'dba_handler' => 'gdbm', // Either of 'gdbm' or 'db2' work great for me.
182 //'dba_handler' => 'db2',
183 //'dba_handler' => 'db3', // doesn't work at all for me....
188 /////////////////////////////////////////////////////////////////////
190 // The next section controls how many old revisions of each page are
191 // kept in the database.
193 // There are two basic classes of revisions: major and minor. Which
194 // class a revision belongs in is determined by whether the author
195 // checked the "this is a minor revision" checkbox when they saved the
198 // There is, additionally, a third class of revisions: author
199 // revisions. The most recent non-mergable revision from each distinct
200 // author is and author revision.
202 // The expiry parameters for each of those three classes of revisions
203 // can be adjusted seperately. For each class there are five
204 // parameters (usually, only two or three of the five are actually
205 // set) which control how long those revisions are kept in the
208 // max_keep: If set, this specifies an absolute maximum for the
209 // number of archived revisions of that class. This is
210 // meant to be used as a safety cap when a non-zero
211 // min_age is specified. It should be set relatively high,
212 // and it's purpose is to prevent malicious or accidental
213 // database overflow due to someone causing an
214 // unreasonable number of edits in a short period of time.
216 // min_age: Revisions younger than this (based upon the supplanted
217 // date) will be kept unless max_keep is exceeded. The age
218 // should be specified in days. It should be a
219 // non-negative, real number,
221 // min_keep: At least this many revisions will be kept.
223 // keep: No more than this many revisions will be kept.
225 // max_age: No revision older than this age will be kept.
227 // Supplanted date: Revisions are timestamped at the instant that they
228 // cease being the current revision. Revision age is computed using
229 // this timestamp, not the edit time of the page.
231 // Merging: When a minor revision is deleted, if the preceding
232 // revision is by the same author, the minor revision is merged with
233 // the preceding revision before it is deleted. Essentially: this
234 // replaces the content (and supplanted timestamp) of the previous
235 // revision with the content after the merged minor edit, the rest of
236 // the page metadata for the preceding version (summary, mtime, ...)
239 // Keep up to 8 major edits, but keep them no longer than a month.
240 $ExpireParams['major'] = array('max_age' => 32,
242 // Keep up to 4 minor edits, but keep them no longer than a week.
243 $ExpireParams['minor'] = array('max_age' => 7,
245 // Keep the latest contributions of the last 8 authors up to a year.
246 // Additionally, (in the case of a particularly active page) try to
247 // keep the latest contributions of all authors in the last week (even
248 // if there are more than eight of them,) but in no case keep more
249 // than twenty unique author revisions.
250 $ExpireParams['author'] = array('max_age' => 365,
255 /////////////////////////////////////////////////////////////////////
258 // Page appearance and layout
260 /////////////////////////////////////////////////////////////////////
262 // Select a valid charset name to be inserted into the xml/html pages,
263 // and to reference links to the stylesheets (css). For more info see:
264 // <http://www.iana.org/assignments/character-sets>. Note that PhpWiki
265 // has been extensively tested only with the latin1 (iso-8859-1)
268 // If you change the default from iso-8859-1 PhpWiki may not work
269 // properly and it will require code modifications. However, character
270 // sets similar to iso-8859-1 may work with little or no modification
271 // depending on your setup. The database must also support the same
272 // charset, and of course the same is true for the web browser. (Some
273 // work is in progress hopefully to allow more flexibility in this
274 // area in the future).
275 define("CHARSET", "iso-8859-1");
277 // Select your language/locale - default language is "C" for English.
278 // Other languages available:
279 // English "C" (English - HomePage)
280 // Dutch "nl" (Nederlands - ThuisPagina)
281 // Spanish "es" (Español - PáginaPrincipal)
282 // French "fr" (Français - Accueil)
283 // German "de" (Deutsch - StartSeite)
284 // Swedish "sv" (Svenska - Framsida)
285 // Italian "it" (Italiano - PaginaPrincipale)
287 // If you set $LANG to the empty string, your systems default language
288 // (as determined by the applicable environment variables) will be
291 // Note that on some systems, apprently using these short forms for
292 // the locale won't work. On my home system 'LANG=de' won't result in
293 // german pages. Somehow the system must recognize the locale as a
294 // valid locale before gettext() will work, i.e., use 'de_DE',
299 // Setting the LANG environment variable (accomplished above) may or
300 // may not be sufficient to cause PhpWiki to produce dates in your
301 // native language. (It depends on the configuration of the operating
302 // system on your http server.) The problem is that, e.g. 'de' is
303 // often not a valid locale.
305 // A standard locale name is typically of the form
306 // language[_territory][.codeset][@modifier], where language is
307 // an ISO 639 language code, territory is an ISO 3166 country code,
308 // and codeset is a character set or encoding identifier like
309 // ISO-8859-1 or UTF-8.
311 // You can tailor the locale used for time and date formatting by
312 // setting the LC_TIME environment variable. You'll have to experiment
313 // to find the correct setting:
314 //putenv('LC_TIME=de_DE');
316 // If you specify a relative URL for the CSS and images, the are
317 // interpreted relative to DATA_PATH (see below). (The default value
318 // of DATA_PATH is the directory in which index.php (this file)
323 // Note that if you use the stock phpwiki style sheet, 'phpwiki.css',
324 // you should make sure that it's companion 'phpwiki-heavy.css' is
325 // installed in the same directory that the base style file is.
326 // FIXME: These default CSS key names could use localization, but
327 // gettext() is not available at this point yet
328 $CSS_URLS = array('PhpWiki' => "phpwiki.css",
329 'Printer' => "phpwiki-printer.css",
330 'Modern' => "phpwiki-modern.css");
332 $CSS_DEFAULT = "PhpWiki";
334 // logo image (path relative to index.php)
335 $logo = "themes/default/images/logo.png";
337 // RSS logo icon (path relative to index.php)
338 // If this is left blank (or unset), the default "images/rss.png"
340 //$rssicon = "themes/default/images/RSS.png";
342 // Signature image which is shown after saving an edited page
343 // If this is left blank (or unset), the signature will be omitted.
344 //$SignatureImg = "themes/default/images/signature.png";
346 // this turns on url indicator icons, inserted before embedded links
347 // '*' icon is shown when the link type has no icon listed here, but
348 // ONLY for the AllowedProtocols specified in in part four! The
349 // 'interwiki' icon indicates a Wiki listed in lib/interwiki.map If
350 // you want icons just to differentiate between urls and Wikis then
351 // turn on only 'interwiki' and '*', comment out the other four.
353 $URL_LINK_ICONS = array(
354 'http' => 'themes/default/images/http.png',
355 'https' => 'themes/default/images/https.png',
356 'ftp' => 'themes/default/images/ftp.png',
357 'mailto' => 'themes/default/images/mailto.png',
358 'interwiki' => 'themes/default/images/interwiki.png',
359 '*' => 'themes/default/images/url.png'
363 // Date & time formats used to display modification times, etc.
364 // Formats are given as format strings to PHP strftime() function See
365 // http://www.php.net/manual/en/function.strftime.php for details.
366 $datetimeformat = "%B %e, %Y"; // may contain time of day
367 $dateformat = "%B %e, %Y"; // must not contain time
370 // this defines how many page names to list when displaying
371 // the MostPopular pages; the default is to show the 20 most popular pages
372 define("MOST_POPULAR_LIST_LENGTH", 20);
374 // this defines how many page names to list when displaying related pages
375 define("NUM_RELATED_PAGES", 5);
377 // This defines separators used in RecentChanges and RecentEdits lists.
378 // If undefined, defaults to '' (nothing) and '...' (three periods).
379 //define("RC_SEPARATOR_A", '. . . ');
380 //define("RC_SEPARATOR_B", '. . . . . ');
382 // Controls whether the '?' appears before or after UnknownWikiWords.
383 // The PhpWiki default is for the '?' to appear before.
384 //define('WIKIMARK_AFTER', true);
386 // Template files (filenames are relative to script position)
387 // However, if a LANG is set, they we be searched for in a locale
388 // specific location first.
389 $templates = array("BROWSE" => "templates/browse.html",
390 "EDITPAGE" => "templates/editpage.html",
391 "MESSAGE" => "templates/message.html");
393 /* WIKI_PGSRC -- specifies the source for the initial page contents of
394 * the Wiki. The setting of WIKI_PGSRC only has effect when the wiki is
395 * accessed for the first time (or after clearing the database.)
396 * WIKI_PGSRC can either name a directory or a zip file. In either case
397 * WIKI_PGSRC is scanned for files -- one file per page.
399 define('WIKI_PGSRC', "pgsrc"); // Default (old) behavior.
400 //define('WIKI_PGSRC', 'wiki.zip'); // New style.
401 //define('WIKI_PGSRC', '../../../Logs/Hamwiki/hamwiki-20010830.zip'); // New style.
403 // DEFAULT_WIKI_PGSRC is only used when the language is *not* the
404 // default (English) and when reading from a directory: in that case
405 // some English pages are inserted into the wiki as well
406 // DEFAULT_WIKI_PGSRC defines where the English pages reside FIXME: is
407 // this really needed? Can't we just copy these pages into the
409 define('DEFAULT_WIKI_PGSRC', "pgsrc");
410 // These are the pages which will get loaded from DEFAULT_WIKI_PGSRC.
411 $GenericPages = array("ReleaseNotes", "SteveWainstead", "TestPage");
413 /////////////////////////////////////////////////////////////////////
418 /////////////////////////////////////////////////////////////////////
420 // allowed protocols for links - be careful not to allow "javascript:"
421 // URL of these types will be automatically linked.
422 // within a named link [name|uri] one more protocol is defined: phpwiki
423 $AllowedProtocols = "http|https|mailto|ftp|news|nntp|ssh|gopher";
425 // URLs ending with the following extension should be inlined as images
426 $InlineImages = "png|jpg|gif|tiff|tif";
428 // Uncomment this to automatically split WikiWords by inserting spaces.
429 // The default is to leave WordsSmashedTogetherLikeSo in the body text.
430 //define("autosplit_wikiwords", 1);
432 // Perl regexp for WikiNames ("bumpy words")
433 // (?<!..) & (?!...) used instead of '\b' because \b matches '_' as well
434 $WikiNameRegexp = "(?<![[:alnum:]])([[:upper:]][[:lower:]]+){2,}(?![[:alnum:]])";
436 // InterWiki linking -- wiki-style links to other wikis on the web
438 // Intermap file for InterWikiLinks -- define other wikis there
439 // Leave this undefined to disable InterWiki linking.
440 define('INTERWIKI_MAP_FILE', "lib/interwiki.map");
442 // The themeinfo file can be used to override default settings above this line
443 // (i.e. templates, logo, signature etc.)
444 // comment out the $theme= lines to revert to the standard interface
445 // which defaults to /templates and /images
450 if (!empty($theme)) {
451 if (! @include("themes/$theme/themeinfo.php")) {
452 // FIXME: gettext doesn't work in index.php or themeinfo.php
453 trigger_error(sprintf(("Unable to open file '%s' for reading"),
454 "themes/$theme/themeinfo.php"), E_USER_NOTICE);
458 /////////////////////////////////////////////////////////////////////
461 // URL options -- you can probably skip this section.
463 /////////////////////////////////////////////////////////////////////
464 /******************************************************************
466 * The following section contains settings which you can use to tailor
467 * the URLs which PhpWiki generates.
469 * Any of these parameters which are left undefined will be deduced
470 * automatically. You need only set them explicitly if the
471 * auto-detected values prove to be incorrect.
473 * In most cases the auto-detected values should work fine, so
474 * hopefully you don't need to mess with this section.
476 ******************************************************************/
479 * Canonical name and httpd port of the server on which this PhpWiki
482 //define('SERVER_NAME', 'some.host.com');
483 //define('SERVER_PORT', 80);
486 * Relative URL (from the server root) of the PhpWiki
489 //define('SCRIPT_NAME', '/some/where/index.php');
492 * Relative URL (from the server root) of the directory from which
493 * other relative URL's for images and other support files are
496 //define('DATA_PATH', '/some/where');
499 * Define to 'true' to use PATH_INFO to pass the pagename's.
500 * e.g. http://www.some.where/index.php/HomePage instead
501 * of http://www.some.where/index.php?pagename=HomePage
502 * FIXME: more docs (maybe in README).
504 //define('USE_PATH_INFO', false);
507 * VIRTUAL_PATH is the canonical URL path under which your your wiki
508 * appears. Normally this is the same as dirname(SCRIPT_NAME), however
509 * using, e.g. apaches mod_actions (or mod_rewrite), you can make it
510 * something different.
512 * If you do this, you should set VIRTUAL_PATH here.
514 * E.g. your phpwiki might be installed at at /scripts/phpwiki/index.php,
515 * but * you've made it accessible through eg. /wiki/HomePage.
517 * One way to do this is to create a directory named 'wiki' in your
518 * server root. The directory contains only one file: an .htaccess
519 * file which reads something like:
521 * Action x-phpwiki-page /scripts/phpwiki/index.php
522 * SetHandler x-phpwiki-page
523 * DirectoryIndex /scripts/phpwiki/index.php
525 * In that case you should set VIRTUAL_PATH to '/wiki'.
527 * (VIRTUAL_PATH is only used if USE_PATH_INFO is true.)
529 //define('VIRTUAL_PATH', '/SomeWiki');
532 ////////////////////////////////////////////////////////////////
533 // Okay... fire up the code:
534 ////////////////////////////////////////////////////////////////
536 include "lib/main.php";
538 // (c-file-style: "gnu")
543 // c-hanging-comment-ender-p: nil
544 // indent-tabs-mode: nil