Wiki source for ConfigurationOptions


Show raw source

===== Wikka Configuration Options ##(wikka.config.php)##=====

>>==See also==
~-the ##[[WikkaConfigActionInfo | {{wikkaconfig}}]]## action
>>The table below lists the configuration options available in the ##wikka.config.php## file. The ##wikka.config.php## file is generated by the [[WikkaInstallation | installer]] when installing Wikka for the first time and when [[UpgradeNotes | upgrading]] from previous versions. It is intended to be edited only by the web site admin only, because it contains sensitive password information and crucial configuration options for the operation of Wikka. You can use a FTP client to edit this file on your web server.

----
{{since version="1.4.1" display="inline"}}
|=|Option|=|Default|=|Description|=|
||##behind_reverse_proxy##||'0'||Generates correct wikilinks if behind a reverse proxy by processing X-Forwarded-* headers. '1' to enable.||

{{since version="1.3" display="inline"}}
|=|Option|=|Default|=|Description|=|
||##default_comment_read_acl##||'*'||Sets the default [[ACLInfo | permissions]] for reading comments. ||
||##default_comment_write_acl##||'+'||Sets the default [[ACLInfo | permissions]] for posting comments. ||
||##utf8_compat_search##||'0'|| '0' for legacy search (case-sensitive, wildcards, but incompatible with some character encodings [default]); '1' for UTF-8 compatible searches (non-case-sensitive, no wildcards). ||
||##default_locale##|| || // todo // ||

{{since version="1.2" display="inline"}}
|=|Option|=|Default|=|Description|=|
||##theme##||'light'||Global theme selected by the wiki owner. It should match the name of an existing folder under ##templates/## or ##plugins/templates##. As of 1.2 it defaults to ##light##.||
||##version_check_interval##||'1h'||Minimum time interval between version checks. Possible interval units are ##h## (hours), ##m## (minutes), ##s## (seconds), ##d## (days), ##w## (weeks), ##M## (months), and ##y## (years).||
||##enable_user_host_lookup##||'1'||Enables ('1') or disables ('0') lookup of user hostname from IP address. Disable this setting when reverse DNS lookups are slow or not available. Default is '1'.||
||##safehtml_path##||'3rdparty/core/safehtml'||Path to SafeHTML code module.||
||##stylesheet_hash##||''(random sequence)''||Internally generated during installation/upgrade to ensure stylesheets are reloaded when accessing the new site for the first time.||

{{since version="1.1.6.4" display="inline"}}
|=|Option|=|Default|=|Description|=|
||##allow_user_registration##||'0'||Setting this to "1" (default) allows user registrations. Setting this value to "0" disables all new user registrations (logins remain enabled).||
||##default_comment_display##||'threaded'||How comments are displayed to anonymous users or newly registered users. Options are 'threaded' (default, comments are nested), 'date_asc' (listing starts with oldest comment), and 'date_desc' (listing starts with newest comment). These are configurable on a per-user basis in the ''UserSettings'' page.||
||##enable_version_check##||'1'||Enables automatic check of Wikka updates for admins (default: 1 - strongly recommended). Set this value to "0" to disable version upgrade check.||
||##public_sysinfo##||'0'||Toggles public vs. admin-only (default) display of system information.||
||##wikka_template_path##||'plugins/templates, templates'||The path to the ##templates## directory. It is relative to the root of your wikka directory.||

{{since version="1.1.6.2" display="inline"}}
|=|Option|=|Default|=|Description|=|
||##mysql_host##||'localhost'||The host your MySQL server is running on. Usually ##localhost## i.e., the same machine your Wikka site is on. ''REQUIRED''||
||##mysql_user##||'wikka'||Name of the MySQL user used to connect to your database. ''REQUIRED.''||
||##mysql_password##||||Password of the MySQL user used to connect to your database. ''REQUIRED.''||
||##table_prefix##||'wikka_'||Prefix of all tables used by Wikka. This allows you to run multiple Wikka installations using the same MySQL database by configuring them to use different table prefixes. ''REQUIRED.''||
||##root_page##||'HomePage'||Your Wikka site's home page. You can use a WikiName for CamelCase linking.||
||##wakka_name##||'MyWikkaSite'||The name of your Wikka site. It usually is a WikiName||
||##rewrite_mode##||''(autodetected)''||URL rewriting enabled = ##'1'##. URL rewriting disabled = ##'0'##. See ModRewrite for further information||
||##wiki_suffix##||'@wikka'||Used to distinguish different wikkas. If you want to have more then one wikka on the same server, you'll have to set a different suffix for all of them.||
||##action_path##||'plugins/actions, actions'||The path to the ##actions## directory. It is relative to the root of your wikka directory. Additionally, path to the ##plugins/actions## directory {{since version="1.1.6.6" display="inline"}}||
||##handler_path##||'plugins/handlers,handlers'||The path to the ##handlers## directory. It is relative to the root of your wikka directory. Additionally, path to the ##plugins/handlers## directory {{since version="1.1.6.6" display="inline"}}||
||##gui_editor##||'1'||When set to '1', users see a toolbar (WikkaEdit) when editing pages that allows them to apply some of the markup by clicking toolbar buttons. When set to '0', the toolbar is disabled.||
||##wikka_formatter_path##||'plugins/formatters, formatters'||location of Wikka formatter - ''REQUIRED'' Additionally, path to the ##plugins/formatters## directory {{since version="1.1.6.6" display="inline"}}||
||##wikka_highlighters_path##||'formatters'||location of Wikka built-in code highlighters - ''REQUIRED''||
||##geshi_path##||'3rdparty/plugins/geshi'||location of GeSHi package||
||##geshi_language_path##||'3rdparty/plugins/geshi/geshi'||location of GeSHi language highlighting files||
||##referrers_purge_time##||'30'||The number of days referring pages (pages that link to your wiki) are kept in the referral logs. Setting this option to '0' or leaving it empty disables the referrer log.||
||##pages_purge_time##||'0'|| Setting <code>pages_purge_time</code> will remove old page revisions older than the specified setting. So if you set this to 7, page revisions older than 7 days will be deleted. The most recent pages will never be purged. If you have a huge wiki with thousands of pages that are all frequently updated you might want to turn this on, but most wikis will never need to adjust this setting.||
||##xml_recent_changes##||'10'||Number of recent change items that are sent when the RecentChanges feed is accessed.||
||##hide_comments##||'0'||If set to '1', Comments and the 'Add Comment' form will not be visible. If set to '0', users can see and add comments.||
||##require_edit_note##||'0'||≈||
||##anony_delete_own_comments##||'1'||If set to '1', anonymous users can delete their own comments, provided they do so from the host machine they used to create the comment. If '0', anonymous users cannot delete their own comments.||
||##double_doublequote_html##||'safe'||determines if HTML in wikkapages is passed through SafeHtml ('safe'), shown as it is ('raw') or passed through ##htmlspecialchars_en## (anything else)||
||##public_sysinfo##||'0'||enable or disable public display of system information in SysInfo||
||##sql_debugging##||'0'||Set this to '1' to see all of the database queries that are made when a page is generated. The queries will appear at the bottom of the page.||
||##admin_users##||''(admin user created during installation)''||A list of users allowed to administer the wiki. Specify multiple wiki names separated by commas e.g: DarTar, NilsLindenberg, YanB||
||##admin_email##||''(admin email address setup during installation)''||Email address of the wiki administrator.||
||##upload_path##||'uploads'||The path to the directory file attachments will be stored in.||
||##mime_types##||'mime_types.txt'||not in use at the moment||
||##geshi_header##||'div'||##div## or ##'pre'## to wrap code block||
||##geshi_line_numbers##||1||disable line numbers (0), or enable normal (1) or fancy line numbers (2)||
||##geshi_tab_width##||4||set tab width (in spaces) in GeSHi||
||##grabcode_button##||1||enable (1) or disable (0) code block downloading.||
||##wikiping_server##||||server to report your recentchanges to. See WikiPing for details||
||##default_write_acl##||'+'||write-access to pages. See AclInfo for details. Changes here only affect newly created pages, not existing ones! Common values are '*' (everyone), '+' (registered users) 'UserName' (user with Username)||
||##default_read_acl##||'*'||Reading-access to pages. See ##default_write_acl##||
||##meta_keywords##||||This is set during install. Controls the meta tag keywords included in the head of every Wikka page.||
||##meta_description##||||This is set during install. Controls the meta tag description included in the head of every Wikka page.||
||##wakka_version##||'1.2'||Wikka's version number. Do not change this value! Your installation would get out of sync with the official releases.||

===Discontinued===
|=|Option|=|Default|=|Description|=|
||##external_link_tail##||'∞'||Appended to any external link as a visual indicator that the link points to a location outside the wiki {{until version="1.1.6.5" display="inline"}}.||
||##header_action##||'header'||Specifies the name of the file that generates the header of wiki pages {{until version="1.1.6.3" display="inline"}}||
||##footer_action##||'footer'||Specifies the name of the file that generates the footer of every wiki page {{until version="1.1.6.3" display="inline"}}||
||##stylesheet##||'wikka.css'||Specifies the name of the stylesheet to use. Stylesheets are stored in the ##css## directory. (Make sure your webserver has read access to the ##css## directory and the ##*.css## files. {{until version="1.1.6.7" display="inline"}}||
||##navigation_links##||||Specifies the navigation links that are output in the header and displayed to all users.{{until version="1.1.6.7" display="inline"}}||
||##logged_in_navigation_links##||||Specifies the navigation links that are output in the header and displayed to logged in users.{{until version="1.1.6.7" display="inline"}}||
||##default_comment_acl##||'*'||Sets the default rights for commenting pages. See ##default_write_acl## {{until version="1.2" display="inline"}}||
||##base_url##||''(autodetected)''||Your Wikka site's base URL. Page names get appended to it, so it should include the ##'?wakka='## bit if URL rewriting doesn't work on your server. The Wikka installer tries to guess the proper value. Change this only if you know what you're doing, see ModRewrite for further information. If you wish to use HTTPS, you will have to adjust this parameter accordingly ''REQUIRED.''{{until version="1.3.2" display="inline"}}||

----
CategoryEN
Valid XHTML :: Valid CSS: :: Powered by WikkaWiki