worldwide open-source software - wiki:config

acl

anonymous@undisclosed.example.com (Anonymous) — Mon, 19 Jan 2026 17:37:05 +0000

Access Control Lists (ACL)s

DokuWiki — like most wikis — is very open by default. Everyone is allowed to create, edit and delete pages. However sometimes it makes sense to restrict access to certain or all pages. This is when the Access Control List (ACL) comes into play. This page gives an overview of how ACLs work in DokuWiki and how they are configured.

Configuration and Setup

ACLs can be enabled in the installer and an initial ACL policy is set there as well. To manually enable ACLs, switch on the useacl option and create a copy of the example files conf/acl.auth.php.dist and conf/users.auth.php.dist. Rename the files to conf/acl.auth.php and conf/users.auth.php respectively.

Example of a minimal conf/users.auth.php file for a user admin with the password admin. If you use it, be sure to change the password afterwards.

conf/users.auth.php

# login:passwordhash:Real Name:email:groups (comma[,] separated)

admin:$2y$10$P5YH8uIM2uAE9snRq32yAuHMb4/XAzksFd5Cakqqtsw9BWeSsyLZq:admin:admin@admin.com:admin,user

Access Restrictions

Access restrictions can be bound to pages and namespaces. There are seven permissions: none, read, edit, create, upload, delete and admin. Each higher permission contains the lower ones, with read being the lowest and delete the highest one. You should note that create, upload and delete permissions can only be assigned to namespaces.

Rules that were set to namespaces apply on media namespaces as well as for page namespaces.

When DokuWiki checks which rights it should give to a user, it uses all rules matching the user's name or the groups he or she is in. The rule that provides a user's permission is chosen according to the following process:

Rules which match closer to the namespace:page are preferred over rules which match further away—we call this «specific matching».
When more than one rule matches at the same level, the rule giving the highest access level is preferred.

Users are in the groups they were assigned to in the user manager (or the auth backend). However there are two groups that are somewhat special:

@ALL Everyone, even users not logged in, is a member of the ALL group. You can use this group to restrict access for all users (as a default setting) and then relax the permissions for some selected users.
@user All self-registered users are by default automatically a member of the group 'user'. Use this to give permissions to 'logged-in' users. The name of this group is configured through the defaultgroup option. Unlike the virtual «ALL» group, the «user» group is a real group to which all users are added automatically when using the plain auth backend. If you use a different backend you need to use the groups provided by this backend.

Groups are represented internally and in the ACL manager by a prepended @ character to the group name.

Editing ACLs

To easily add new or change existing access rules, you should use the ACL Manager which is available from the Administration menu. A detailed description of its interface can be found here.

Basically there are three steps to add a new ACL rule:

select the namespace or page to restrict from the upper left tree navigation
choose to whom the ACL rule should apply
- by selecting a known group or user from the dropdown menu
- or by selecting «User:» or «Group:» and entering the group or user name in the field
set the appropriate permissions

Existing rules can be modified or deleted in the table at the bottom of the ACL manager.

ACLs by Example

In this section we will explain how access rules work, using a fictional example setup that looks like this in the ACL manager:

Let's have a look at each line:

This sets permission for everyone in the main namespace, allowing everybody to edit and create pages. However upload is not allowed.
User bigboss is given full rights.
Now the access for the devel namespace is restricted. Nobody is allowed to do anything.
Well not nobody really—we give members of the devel group almost full rights here. Deleting files however is not allowed.
User bigboss however is allowed full access to the devel namespace. He/she can even delete uploaded files.
The marketing group may read everything in the devel namespace, but cannot edit or create pages.
However the devel team doesn't want their boss to see the funstuff page—remember exact pagematches override namespace permissions.
And finally the marketing group is allowed to edit the devel:marketing page as well. (This page could however not have been created by them.)
Then the permissions for the namespace marketing are set. All members of the marketing group are allowed to upload there
- other users will be matched by line #1 so they can still create and edit.
- Rights for bigboss are inherited from line #2 so this user can still upload and delete files. (No wonder that everyone would like to be the bigboss.)
The last line finally restricts the start page to readonly for everyone. Even for bigboss. Only superusers will be able to ever edit that page.

Let's have a look at a second example to better understand specific matching:

This time we look what rules will match for different users when trying to access the page private:bobspage.

abby, a regular user
- three rules match, #1, #2, #4
- rule #4 is closest, it matches at the namespace level so it takes precedence over the other three
- abby's permissions level is None
bob, a regular user
- four rules match, #1, #2, #4, #6
- rule #6 wins as its an exact match
- bob's permission level is Delete
bob forgets to login and tries to access his page
- two rules match, #1 & #4
- rule #4 is closer, it wins
- bob's permission level while not logged in is None
charlie, a staff member
- five rules match, #1–#5
- two rules match at namespace level, #5 gives charlie the higher permission so it wins
- charlie's permission level is Delete

Note rule #5, which appears to duplicate rule #3. Without it, staff members wouldn't be able to access the private namespace as rule #4 would keep them out.

Background Info

Access restrictions are saved in a file called conf/acl.auth.php, which should be writable by the webserver if you want to use the ACL admin interface described above. It is not recommended to edit this file manually. Use the admin interface instead.

Empty lines and shell-style comments are ignored. Each line contains 3 whitespace separated fields:

The resource to restrict. This can either be a pagename or a namespace. Namespaces are marked by an additional asterisk (see examples below).
A group or user name. Groupnames are marked by a leading @ character.
A permission level (see below).

There are 7 permission levels represented by an integer. Higher levels include lower ones. If you can edit you can read, too. However the admin permission of 255 can not be used in the conf/acl.auth.php file. It is only used internally by matching against the superuser option.

Name	Level	applies to	Permission	DokuWiki constant
none	0	pages, namespaces	no permission—complete lock out	AUTH_NONE
read	1	pages, namespaces	read permission	AUTH_READ
edit	2	pages, namespaces	existing pages may be edited	AUTH_EDIT
create	4	namespaces	new pages can be created	AUTH_CREATE
upload	8	namespaces	mediafiles may be uploaded	AUTH_UPLOAD
delete	16	namespaces	mediafiles may be overwritten or deleted	AUTH_DELETE
admin	255	admin plugins	superuser¹⁾ can change admin settings	AUTH_ADMIN

Here is an example setup matching the first example given above:

*                     @ALL        4
*                     bigboss    16
devel:*               @ALL        0
devel:*               @devel      8
devel:*               bigboss    16
devel:*               @marketing  1
devel:funstuff        bigboss     0
devel:marketing       @marketing  2
marketing:*           @marketing  8
start                 @ALL        1

Please note that order does not matter in the file. The file is parsed as whole, then a perfect match for the current page/user combo is searched for. When a match is found further matching is aborted. If no match is found, group permissions for the current page are checked. If no match is found the check continues in the next higher namespace.

Note: The delete permission affects media files only. Pages can be deleted (and restored) by everyone with at least edit permission. Someone who has upload permissions but no delete permissions can only overwrite existing media files if the media revisions option is enabled.

User/Group Encoding

Because the ACL configuration uses a few special characters to denote special functionality (like @ prefixes, spaces, etc), user and group names need to be encoded when they contain certain characters to avoid clashes.

When you use the ACL Manager you don't have to think about this, it will do it automatically for you.

When manually editing ACLs, user and group names need to be encoded. Internally this is done using the auth_nameencode() method.

The encoding uses URL encoding for all non-letter/number ASCII chars (special chars in the lower 128 byte range). UTF-8 Multibytechars are not encoded.

Example: Herbert.Müller becomes Herbert%2eMüller

User Wildcards

It is possible to use user and group wildcards in the ACLs. This can be useful for Wikis with many registered users, if you want to give each user or group a personal namespace where only he/she has write access, and you don't want to edit the ACLs for each of them. To accomplish that %USER% is replaced by the username of the currently logged in user and %GROUP% by all the groups of this user.

In the following example a logged-in user gains full access (upload/delete) permissions for the user's namespace user:<username>:* and revoke all access from other namespaces located in user:*.

In this case logged-in user has access to own namespace only and have not access to users namespaces (even view names of namespaces) of other users.

#
# Grant full access to logged in user's namespace
user:%USER%:*          %USER%  16
#
# Allow to browse own namespace via the index
user:                  %USER%  1
#
# Allow read only access to start page located in "user" namespace 
user:start             %USER%  1
#
# Disable all access to user's home namespaces not owned by logged in user 
# (include view namespaces via the index) 
user:*                 @user   0
#
# Allow members of 'group' to edit pages in the 'group' namespace.
# BE CAREFUL, if you have a 'user' namespace, all members of the default group 
# will gain access to it since %GROUP% will be replaced literally
%GROUP%:*               %GROUP% 2

Note: version 2009-12-25c «Lemming» has some caveat. If you add, update or remove ACL entries from the admin interface then DokuWiki will replace %USER% in the second field of the ACL to %25USER%25 (this is bug FS#1955). To avoid this, change permissions manually only (by editing: conf/acl.auth.php) or correct them manually after each operation in the admin interface because %25USER%25 does not work as expected, only %USER% should be used in the conf/acl.auth.php. This bug is fixed in newer versions.

Note: The wildcard changed from @ to % in December 2008 – if you are upgrading from an older version you need to adjust your ACL setup accordingly.

¹⁾

see superuser

allowdebug

anonymous@undisclosed.example.com (Anonymous) — Tue, 13 Aug 2024 09:08:18 +0000

Параметр конфигурации: разрешенный отладка

Чтобы упростить ответ на запросы в службу поддержки, «ДокуВики» может по запросу выводить огромный список строк отладки.

Для этого включите эту опцию и добавьте &do=debug или ?do=debug к URL-адресу , как в http://example.com/dokuwiki/doku.php?id=playground&do=debug.

Это полезно для устранения всех проблем с конфигурацией при первой настройке Wiki. Но это также раскрывает много информации о сервере, на котором работает «ДокуВики». В инструментах отладки перечислены другие функции, которые включены с помощью этого параметра.

На всякий случай вам следует отключить эту опцию и, таким образом, отключить функцию отладки сразу после успешной настройки вашей Wiki.

Тип: Логический
По умолчанию:0

Предупреждение безопасности: изменение этой опции может представлять угрозу безопасности.

Смотрите также

Настройка «Докувики»
Безопасность
Инструменты отладки

auth_security_timeout

anonymous@undisclosed.example.com (Anonymous) — Wed, 15 Jan 2025 05:54:58 +0000

Настройка конфигурации: тайм-аут безопасности аутентификации

Чтобы избежать проблем с производительностью на медленных бэкэндах аутентификации, DokuWiki будет кэшировать данные аутентификации. Этот параметр определяет время в секундах, в течение которого кэшированные данные аутентификации считаются действительными, установите значение 0 для повторной проверки при каждом просмотре страницы.

Это означает, что когда пользователь (с действительными данными сеанса, указывающими на то, что он успешно вошел в систему ранее) получает доступ к странице, его учетные данные, имя пользователя и группы не извлекаются из бэкэнда аутентификации, а вместо этого используются данные в его сеансе. Только когда эти данные старше настроенного тайм-аута безопасности, эти данные в любом случае перепроверяются.

Он не выводит пользователей из системы автоматически. Он просто перепроверяет их учетные данные, выход из системы происходит только в том случае, если эти учетные данные больше не действительны.

Это также означает, что при удалении или редактировании пользователя в бэкэнде аутентификации этот пользователь может оставаться в системе еще 990 секунд или может не видеть измененные вами группы и т. д.

Тип: Номер
По умолчанию: 900

См. также

auth

anonymous@undisclosed.example.com (Anonymous) — Fri, 18 Aug 2023 23:05:03 +0000

Authentication Plugins

After you have enabled ACL in the config file you need to decide how you like to store user data. DokuWiki supports various methods and creating a new one is pretty easy. DokuWiki uses so–called authentication plugins that provide certain methods to store user data and passwords. The user won't even see this plugin but you as an administrator have to set up your desired authentication plugin and configure it properly. The plain authentication plugin is DokuWikis default simple version.

Look for available Auth Plugins in the plugin repository.

The plugins can be installed using the Extension Manager. If the available plugins do not fulfill the requirements, you can create your own auth plugin. For details see How to write an Authentication Plugin?

Migration of a wiki from before 2013

Since the release 2013-05-10 “Weatherwax” DokuWiki uses Authentication Plugins instead of Authentication Backends. This requires action from the administrator when upgrading such a wiki. See old authentication backends for FAQ and the previous backends.

Authentication related plugins

Chained Authentication – Use a sequence of authentication backends (e.g. LDAP then plain )
virtualgroup – allows to assign groups to a user independently from the backend.

Some suggestions grouped by tags in the plugin repository:

Plugins with acl-tag
Plugins with groups-tag
Plugins with users-tag

Authentication related Tips

Some relevant tips related to authentication backends

Change user name after authentication – Suggestion how to change the username after authentication (e.g. you want to allow login via a unique id that could change sometime (e.g. email address), but use another unmodifiable unique id as permanent identifier in Dokuwiki)
How to keep the login data of two web applications (e.g. a DokuWiki and a forum software) synchronised? See this forum post.

authtype

anonymous@undisclosed.example.com (Anonymous) — Wed, 15 Jan 2025 05:58:10 +0000

Настройка конфигурации: тип аутентификации

Это указывает, какой бэкэнд следует использовать для аутентификации.

DokuWiki поддерживает несколько бэкэндов аутентификации. Полный список см. в руководстве DokuWiki, главаМетоды аутентификации.

Тип: Строка
По умолчанию:authplain

Опасность : изменение этой опции может сделать вашу вики и меню конфигурации недоступными.

Смотрите также

Настройка DokuWiki

autopasswd

anonymous@undisclosed.example.com (Anonymous) — Mon, 26 Aug 2024 05:11:39 +0000

Настройки: autopasswd

«ДокуВики» поддерживает два метода назначения пароля после регистрации нового пользователя. Эта опция определяет какой из методов используется:

Автоматически сгенерированный пароль (1).
- Пользователь указывает свой электронный адрес, а «ДокуВики» генерирует пароль и отсылает его пользователю. Для использования этого метода назначьте autopasswd = 1. (Вы можете назначить электронный адрес, от имени которого будут отсылаться все письма от «ДокуВики», в опции «mailfrom»).
Пароль, определённый пользователем (0).
- Форма регистрации содержит два поля, в которых пользователь может вписать желаемый пароль. Письмо-подтверждение не будет отсылаться. Для использования этого метода назначьте autopasswd = 0.

Тип данных: логический
Значение по умолчанию: 1

См. также

Конфигурирование «ДокуВики»

autoplural

anonymous@undisclosed.example.com (Anonymous) — Wed, 15 Jan 2025 06:02:59 +0000

Настройка конфигурации: автомножественность

Эта опция, вероятно, полезна только в англоязычных вики. Если установлено значение 1, формы множественного числа связанных страниц автоматически пробуются, когда форма единственного числа не найдена (и наоборот). Таким образом, имена страницы и имя страницы будут автоматически ссылаться на одну и ту же существующую страницу.

Тип: Логический
По умолчанию: 0

Смотрите также

Настройка DokuWiki

basedir

anonymous@undisclosed.example.com (Anonymous) — Sun, 13 Apr 2025 06:56:11 +0000

Настройка конфигурации: basedir

Часть пути URL-адреса dokuwiki — пустая для автоопределенияt

Тип: Строка
По умолчанию:/

Обычно DokuWiki может самостоятельно определить полный URL , по которому он доступен (автоопределение). Но иногда это не работает по разным причинам. Если DokuWiki не работает должным образом и не может найти такие вещи, как изображения для своих веб-страниц, вы можете задать путь здесь.

Обратите внимание, что, несмотря на свое название, эта опция лишь отдаленно связана с файлами и каталогом. Фактически, это часть пути URL, которая ведет к вашей установке DokuWiki. Часто случается, что часть пути URL также является относительным каталогом от корня веб-сервера до каталога установки DokuWiki, отсюда и название.

Если ваш DokuWiki находится по адресу , вы, скорее всего, установите этот параметр на . Обязательно используйте начальный и конечный слеш!

http://www.someserver.org/dokuwiki/
/dokuwiki/

Если ваша установка DokuWiki расположена непосредственно внутри корня сервера или поддомена, http://www.subdomain.yourdomain.com вам следует установить basedir в один / слеш.

Общее правило таково: если ваш DokuWiki находится по адресу http://something.org/whatever, вы, скорее всего, установите этот параметр на /whatever/. Обязательно используйте начальный и конечный слеш!

Внимание: изменение этой опции может сделать вашу вики и меню конфигурации недоступными.

См. также

baseurl

anonymous@undisclosed.example.com (Anonymous) — Mon, 19 Jan 2026 17:48:20 +0000

Настройки: baseurl

URL к серверу (включая имя протокола). Оставьте пустым для автоопределения.

Указанный здесь путь — это путь к корню веб-сервера. Например, если адрес вашей вики — http://www.yourserver.com:port/dokuwiki/, значение этого параметра следует установить равным http://www.yourserver.com:port без косой черты в конце.

Тип данных: строковый
Значение по умолчанию:

Замечание: порт необходимо указывать только в том случае, когда веб-сервер настроен на прослушивание нестандартного порта. В противном случае номер порта можно опустить вместе с предшествующим ему двоеточием.

Внимание: изменение этого параметра может привести к неработоспособности вики и меню конфигурации.

См. также

Конфигурирование «Докувики»
Параметр basedir

breadcrumbs

anonymous@undisclosed.example.com (Anonymous) — Sun, 13 Apr 2025 07:32:35 +0000

Настройки: breadcrumbs

Параметр определяет количество страниц, отображаемых в строке пройденного пути «Вы посетили». Установка значения «0» отключает отображение соответствующей строки.

Тип данных: числовой
Значение по умолчанию: 10

См. также

broken_iua

anonymous@undisclosed.example.com (Anonymous) — Mon, 19 Jan 2026 18:06:36 +0000

Настройки: broken_iua

Эта опция позволяет обойти проблему некоторых платформ, где «сломана» функция ignore_user_abort. В действительности эта проблема встречается только при использовании IIS с PHP, запущенным как CGI.

Тип данных: логический
Значение по умолчанию: 0 (выключено)

См. также

cachetime

anonymous@undisclosed.example.com (Anonymous) — Sun, 16 Feb 2025 19:06:45 +0000

Настройки: cachetime

Определяет максимальный возраст кэшированных страниц в секундах. Для постоянного кэширования установите значение «0», для отмены кэширования вовсе — «-1».

Тип данных: числовой
Значение по умолчанию: 60*60*24 (60 сек. x 60 мин. x 24 ч. = один день)

См. также

camelcase

anonymous@undisclosed.example.com (Anonymous) — Fri, 17 Jan 2025 10:42:11 +0000

Настройка конфигурации: camelcase

Включите это для ссылок CamelCase. Это распространенный, но спорный способ ссылок в Wiki. Если вы включите это, а затем снова отключите, вы можете создать страницы-сироты.

Тип: Логический
По умолчанию: 0

Предупреждение : изменение этого параметра может привести к непредвиденному поведению.

canonical

anonymous@undisclosed.example.com (Anonymous) — Mon, 19 Jan 2026 17:45:18 +0000

Настройки: canonical

Когда эта опция включена, все ссылки создаются как абсолютные URL в форме http://server/path. В предыдущих релизах это было поведением по умолчанию. В настоящий момент более предпочтительны относительные URL (относительные к Serverroot).

Тип данных: логический
Значение по умолчанию: 0

См. также

compress

anonymous@undisclosed.example.com (Anonymous) — Fri, 18 Aug 2023 23:14:07 +0000

Настройки: compress

Включает простое обрезание пробелов и комментариев в файлах CSS и JavaScript. Не путайте с опцией compression — для избежания путаницы это действие иногда называют compaction (сжатие).

Тип данных: логический
Значение по умолчанию: 1 (включено)

См. также

compression

anonymous@undisclosed.example.com (Anonymous) — Fri, 18 Aug 2023 23:15:39 +0000

Настройки: compression

Определяет, как должны храниться старые версии страниц (см. «чердак»). По умолчанию используется «gz» — сжатие «gzip», установка опции в «bz2» приведет к сжатию «bzip2». Установка в «0» (ноль) отменяет сжатие. Не путайте с опцией «compress».

Тип данных: строковый
Значение по умолчанию: gz

Отметим, что если вы поменяете значение «compression» после того, как изменяли какие-либо статьи, старые версии этих статей станут недоступными по кнопке «История изменений» («Old revisions»). Для исправления этой ситуации перепакуйте старые версии.

Предупреждение: изменение этой опции может привести к непредсказуемому поведению системы.

См. также

Конфигурирование «ДокуВики»

config

anonymous@undisclosed.example.com (Anonymous) — Wed, 12 Feb 2025 08:33:01 +0000

Конфигурирование «Докувики»

Большая часть возможностей «Докувики» настраивается с помощью соответствующих параметров конфигурации. Самым простым способом изменения этих параметров является использование менеджера конфигурации.

Что можно настраивать в «Докувики»

«Системные» настройки «Докувики» можно найти в файле conf/dokuwiki.php. Однако, он содержит значения настроек системы по умолчанию. Для подстройки их «под себя» вам следует редактировать файл conf/local.php или создать его, если он не существовал. Что вообще можно настраивать, смотрите ниже в списке доступные параметры.

Имена пользователей, пароли (зашифрованные) и правила доступа (ACL) хранятся в users.auth.php и acl.auth.php.

Когда вы загружаете на сервер новый файл с помощью медиа менеджера, вы можете столкнуться с сообщением «Upload denied. This file extension is forbidden!». Это вызвано содержимым файла conf/mime.conf. Для загрузки файла нового типа, укажите этот тип в mime.conf.

При создании статей происходят некоторые автоматические подстановки. Некоторые из них порождают подсказки, смайлы или определённые спецсимволы. Эти подстановки определяются в файлах acronyms.conf, smileys.conf и entities.conf.

Обзор файлов конфигурации

Все файлы конфигурации хранятся в директории ./conf или в /etc/dokuwiki при установке из Debian-пакета.

«Основные» файлы обычно поставляются вместе с «ДокуВики», в то время как «локальные» файлы обычно создаются администратором вики.

Если какие-то настройки позволено сделать в локальном файле, то лучше сделать именно там, а не в основном файле. Это позволит избежать проблем при обновлении, т. к. основные файлы при нём меняются, а локальные — нет.

«Основной» файл	«Локальный» файл	Тип настроек	Краткое описание
`dokuwiki.php`	`local.php` `local.protected.php`	см. ниже	основные настройки вики
`acronyms.conf`	`acronyms.local.conf`	abbreviations	автоматические подсказки аббревиатур
`entities.conf`	`entities.local.conf`	entities	автоматические подстановки текста
`interwiki.conf`	`interwiki.local.conf`	interwiki	сокращения ссылок интервики
`mime.conf`	`mime.local.conf`	mime	настройки mime-типов для загрузки на сервер
`smileys.conf`	`smileys.local.conf`	smileys	подстановки графических смайлов
	`acl.auth.php`	см. acl	настройки листов доступа
	`users.auth.php`	см. acl	имена пользователей и пароли
`license.php`	`license.local.php`	license	перечень доступных лицензий
`scheme.conf`	`scheme.local.conf`	urlschemes	ключевые слова URL-ссылок
`mediameta.php`		exif	возможные метаданные для изображений
`wordblock.conf`	`wordblock.local.conf`	blacklist	спамерские чёрные списки
	`userscript.js`	javascript	Пользовательские JavaScript-улучшения
	`userstyle.css`	css	Пользовательские CSS-улучшения

Параметры конфигурации

Большая часть возможностей ДокуВики настраивается с помощью соответствующих параметров конфигурационного файла. Проще всего их редактировать через Менеджер конфигураций

Эта страница описывает все возможные параметры и все их возможные значения. Значения по умолчанию для всех параметров хранятся в файле conf/dokuwiki.php. Если вы хотите изменить какие-либо из этих параметров, то лучше всего сделать это в файле conf/local.php — это гарантирует сохранение внесённых изменений при обновлении «ДокуВики». Менеджер конфигурации также работает с этим файлом. Файл conf/local.protected.php можно использовать для конфигурации настроек, которые не могут быть изменены.

Пример файла conf/local.php:

<?php
$conf['title']     = "Admin's Wiki";
$conf['useacl']    = 1;
$conf['superuser'] = 'admin';

Несколько замечаний относительно формата конфигурационного файла. Этот файл представляет собой фрагмент кода PHP, потому должен следовать синтаксису этого языка. В частности, каждая строка должна заканчиваться точкой с запятой. Переменные могут иметь следующие типы данных:

Числовой: значения записываются как есть. Пример: 9.
Строковый: строки заключаются в одинарные или двойные кавычки. Например, 'foo bar'.
Логический: допустимы значения «true» (истина) или «false» (ложь) («1» и «0» соответственно).
Массив: представляет собой набор из нескольких значений одного из указанных выше типов.

Доступные параметры

Подразделы: антиспам, аутентификация, медиафайлы, общие, отображение, расширенные настройки, редактирование, сеть, ссылки.

Общие настройки

https://www.dokuwiki.org/wiki:config

Настройки отображения

Настройки аутентификации

Антиспамовские настройки

Настройки редактирования

Настройки ссылок

target (wiki, interwiki, extern, media, windows)

Настройки для медиафайлов

Расширенные настройки

Настройки сети

cookiedir

anonymous@undisclosed.example.com (Anonymous) — Mon, 19 Jan 2026 17:51:07 +0000

Настройки: cookiedir

Директория для cookie. Оставьте пустым для автоопределения.

Тип данных: строковый
Значение по умолчанию:

Внимание: изменение этого параметра может привести к неработоспособности вики и меню конфигурации.

См. также

Конфигурирование «Докувики»
Параметр basedir

css

anonymous@undisclosed.example.com (Anonymous) — Fri, 18 Aug 2023 23:08:01 +0000

Краткое руководство по стилям CSS

То, как выглядит «ДокуВики», в большой степени определяется шаблонами. Шаблоны содержат наборы CSS-файлов по умолчанию, которые могут быть легко подстроены под ваши нужды, а также расширены.

Настройте свою «ДокуВики»

Узнать больше о CSS в «ДокуВики» можно:

в «Вопросах и ответах»;
в Таблицы стилей CSS

Если эти статьи по ссылкам кажутся вам малопонятными, воспользуйтесь поиском Гугла: CSS+Tutorial.

cssdatauri

anonymous@undisclosed.example.com (Anonymous) — Mon, 19 Jan 2026 17:52:22 +0000

Настройка конфигурации: cssdatauri

Эта опция принимает размер файла в байтах. Все изображения, указанные в таблицах CSS-стилей, которые меньше установленного размера, будут встроены непосредственно в CSS. Это увеличивает размер CSS, но избавляет браузер от необходимости выполнять множество HTTP-запросов для крошечных изображений и в итоге ускоряет отображение. Установка опции на 0 отключает функцию.

Обратите внимание, что некоторые очень старые браузеры (Internet Explorer < 8) не смогут это понять, и изображения будут отсутствовать.

Тип: Число
По умолчанию: 512 со времен билда «Elenor of Tsort» (до этого – 0)

Смотрите также

deaccent

anonymous@undisclosed.example.com (Anonymous) — Sun, 13 Apr 2025 08:57:36 +0000

Настройки: deaccent

Когда этот параметр равен «1» («убирать только диакритические знаки»), акцентированные символы преобразуются в их ASCII-эквиваленты («ü» превращается в «ue») или просто теряют акценты («á» превращается в «a»).

Когда этот параметр равен «2» («полная транслитерация»), символы из нелатинских алфавитов заменяются наиболее близкими ASCII-эквивалентами (см. страницу «Романизация»).

Установка значения «0» («отключить») отключает все эти возможности.

Тип данных: числовой (0–2)
Значение по умолчанию: 1

Предупреждение: изменение этого параметра может привести к непредсказуемому поведению системы.

См. также

Конфигурирование «Докувики»
Романизация
Параметр fnencode — кодировка имён файлов

defaultgroup

anonymous@undisclosed.example.com (Anonymous) — Mon, 19 Jan 2026 17:57:23 +0000

Настройки: defaultgroup

При регистрации новый пользователь будет автоматически добавлен в эту группу.

Тип данных: строковый
Значение по умолчанию: user

Примечание: значение для данного параметра указывается без префикса @

См. также

Конфигурирование «Докувики»

defer_js

anonymous@undisclosed.example.com (Anonymous) — Mon, 28 Aug 2023 10:50:37 +0000

Параметр конфигурации: defer_js

Примечание. Это флаг функции. На данный момент вы можете изменить его настройку, но в будущем этот параметр будет удален, а его настройка по умолчанию станет постоянной.

Обычно загрузка файлов JavaScript (включая большие библиотеки, такие как jQuery) приостанавливает загрузку и сборку других ресурсов страницы ( HTML / CSS /media/и т. д.). Это замедляет начальную загрузку страницы, иногда невероятно тормозит.

Начиная с релиза «Hogfather» (01.06.2020), весь JavaScript можно опционально использовать с атрибутом «defer» для независимой (асинхронной) загрузки его файлов и выполнения по окончании сборки всех ресурсов страницы. Это ускоряет начальную загрузку страницы, иногда невероятно.

Пока все плагины не будут скорректированы, такое поведение может привести к поломке JavaScript некоторых плагинов. Если у вас возникнут проблемы, вы можете отключить этот параметр, чтобы вернуться к старому, более медленному поведению. Пожалуйста, также создайте отчет об ошибке соответствующему разработчику плагина и направьте его на javascript .

Тип: Логический
По умолчанию:true

Смотрите также

dformat

anonymous@undisclosed.example.com (Anonymous) — Mon, 19 Jan 2026 17:58:42 +0000

Настройки: dformat

Параметр определяет формат отображения дат. Непосредственно передаётся PHP-функции «strftime».

Многие русскоязычные пользователи предпочитают видеть даты в формате «%d.%m.%Y %H:%M», а не в формате по умолчанию.

Тип данных: строковый
Значение по умолчанию: %Y/%m/%d %H:%M

Существует одно исключение, которое не соответствует правилам форматирования strftime: вы можете использовать «%f» для показа неточных дат (например, «%Y/%m/%d %H:%M (%f)» отобразит дату как «2009/09/16 10:36 (3 недели назад)»).

См. также

Конфигурирование «ДокуВики»

disableactions

anonymous@undisclosed.example.com (Anonymous) — Mon, 19 Jan 2026 18:01:15 +0000

Настройки: disableactions

Выключает некоторые команды ?do=название-команды.

Тип данных: строковый
Значение по умолчанию:

Вы можете отключить функцию поиска:

$conf['disableactions'] = 'search';

Для отключения нескольких действий используйте запятую:

$conf['disableactions'] = 'search,register';

Менеджер конфигурации

Плагин Менеджер конфигурации показывает флажки для отключения некоторых действий.

См. также

Конфигурирование «Докувики»
Режимы действий, они же режимы do
Для получения списка всех действий используйте плагин Менеджер конфигурации.

dmode

anonymous@undisclosed.example.com (Anonymous) — Mon, 19 Jan 2026 18:02:58 +0000

Настройки: dmode

Этот параметр определяет права доступа, с которыми должны создаваться каталоги. Права задаются в восьмеричном виде с начальным нулём. По умолчанию каталоги создаются с правами '0755'' (rwxr-xr-x в текстовом виде).

Тип данных: числовой
Значение по умолчанию: 0755

Для Виндоус-серверов данный параметр игнорируется.

См. также

Конфигурирование «Докувики»
Параметр fmode — права доступа к файлам
Перед использованием обязательно прочтите статьи:
- Настройка прав доступа к файлам
- Безопасность

dnslookups

anonymous@undisclosed.example.com (Anonymous) — Mon, 19 Jan 2026 18:05:33 +0000

Конфигурация: dnslookups

DokuWiki ищет DNS имена пользователей редактирующих страницы. Если у вас нет DNS сервера или он работает медленно, рекомендуем отключить эту опцию

Тип: Логическое
По умолчанию: 1

См. также

Конфигурирование «Докувики»

dontlog

anonymous@undisclosed.example.com (Anonymous) — Mon, 19 Jan 2026 18:08:29 +0000

Настройки: dontlog

В этом параметре перечислены типы журналов, которые вы не хотите вести. По умолчанию отключено только ведение журнала отладки.

Тип: Массив
По умолчанию: debug

Смотри также

fetchsize

anonymous@undisclosed.example.com (Anonymous) — Mon, 19 Jan 2026 18:16:29 +0000

Настройки: fetchsize

Максимальный объём (в байтах), который позволено закачать скрипту fetch.php из внешних источников. Это используется для кэширования внешних изображений и масштабирования их в случае необходимости. Для полного отключения этой возможности просто установите этот параметр в ноль («0»).

Тип данных: числовой
Значение по умолчанию: 0

Включение этой опции влечет двоякие последствия:

позитивные:
- это позволяет красиво масштабировать внешние изображения;
- внешние сервера не будут «дубасится» запросами (используется локальное кэширование вместо прямых ссылок);
негативные:
- это может быть использовано для DoS-атаки (англ.) (небольшой запрос на ваш сервер вызывает перекачку гораздо большего объема данных).

Рекомендуется включать эту опцию с относительно небольшим (порядка размера обычного изображения) значением, порядка 100–150 КБ.

См. также

Конфигурирование «ДокуВики»

fmode

anonymous@undisclosed.example.com (Anonymous) — Mon, 19 Jan 2026 18:03:36 +0000

Настройки: fmode

Этот параметр определяет права доступа, с которыми должны создаваться файлы.

Права задаются в восьмеричном виде с начальным нулём. По умолчанию файлы создаются с правами 0644 (rw-r--r-- в текстовом виде).

Тип данных: числовой
Значение по умолчанию: 0644

Для Виндоус-серверов данный параметр игнорируется.

Первая ненулевая цифра (вторая в примере выше) определяет права пользователя (т. е. права владельца файла);
вторая ненулевая цифра определяет групповые права (т. е. права пользователей входящих в ту же группу что и файл);
последняя цифра определяет права других (т. е. всех остальных пользователей).

Для конвертации прав в корректное восьмеричное число используйте следующий значения:

Read (чтение) = 4
Write (запись) = 2
Execute (выполнение) = 1

Для каждой «позиции» просуммируйте соответствующие значения. Таким образом, если вы желаете дать владельцу файла права на чтение и запись — укажите 4+2=6 в качестве первой ненулевой цифры. Если членам группы вы желаете дать права на чтение и исполнение (такое может быть у директорий) — укажите 4+1=5 во второй позиции. Значение по умолчанию, приведенное выше, интерпретируется как: у владельца права на чтение и запись, а членов группы и «остальных» — только на чтение.

См. также

Конфигурирование «Докувики»
Параметр dmode — права доступа к каталогам
Перед использованием обязательно прочтите статьи
- Настройка прав доступа к файлам
- Безопасность

fnencode

anonymous@undisclosed.example.com (Anonymous) — Sun, 13 Apr 2025 08:58:08 +0000

Настройки: fnencode

«Докувики» хранит всё содержимое страницы в txt-файлах. Чтобы избежать проблем, когда имя страницы содержит специальные символы или не-ASCII символы, а файловая система не поддерживает их, «Докувики» использует механизм кодирования. Какой механизм используется, можно настроить в этом параметре.

Тип данных: строковый
Значение по умолчанию: url
Возможные значения:
- url — используется URL-кодирование, имена файлов могут получится очень длинными;
- safe — используется более компактное кодирование имён файлов (рекомендуется);
- utf-8 — кодирование не используется, имена записываются в формате UTF-8.

Предупреждение: Изменение этого параметра может привести к непредвиденным последствиям. При изменении данного параметра вы можете сделать недоступными страницы, которые были созданы при другом значении данного параметра.

Под ОС Windows для корректной поддержки UTF-8 и кириллицы в именах файлов требуется PHP 7.1 или выше. Обратите внимание: в составе сборки DokuWiki on stick используется MicroApache с PHP 5, и его придётся обновить самостоятельно из официального репозитория, или из состава других WAMP-дистрибутивов.

Хранение UTF-8-имён файлов может быть невозможно в некоторых файловых системах.

См. также

ftp

anonymous@undisclosed.example.com (Anonymous) — Mon, 19 Jan 2026 17:36:11 +0000

Настройки: ftp

Параметры FTP для использования «safemodehack» — см. соответствующую страницу.

Тип данных: массив
Значение по умолчанию:

См. также

Конфигурирование «ДокуВики»

fullpath

anonymous@undisclosed.example.com (Anonymous) — Mon, 19 Jan 2026 18:17:09 +0000

Настройки: fullpath

Параметр определяет, следует ли показывать полный путь к отображаемым страницам.

Тип данных: логический
Значение по умолчанию: 0 (выключено)

См. также

Конфигурирование «ДокуВики»

gdlib

anonymous@undisclosed.example.com (Anonymous) — Mon, 19 Jan 2026 18:21:02 +0000

Настройки: gdlib

Для масштабирования изображений «Докувики» использует PHP-библиотеку LibGD (если она доступна). «Докувики» пытается автоматически определить наличие и версию LibGD. Однако в старых версиях PHP это не работает. Вы можете принудительно указать версию LibGD в этой опции.

Возможные значения:

0 — LibGD недоступна;
1 — для LibGD версии 1.x;
2 — для LibGD 2.x с автоопределением подверсии.

gdlib:

Тип данных: числовой
Значение по умолчанию: 2

Функция изменения размера, которая принимала этот параметр, устарела с момента выпуска Igor в июле 2022 года. Параметр не используется в новой функции обрезки (изменения) размера.

См. также

Конфигурирование «Докувики»
Параметр im_convert

hidepages

anonymous@undisclosed.example.com (Anonymous) — Sat, 02 Sep 2023 14:12:08 +0000

Настройки: hidepages

Эта опция задаётся регулярным выражением, позволяющим исключить определённые страницы из автоматически составляемых списков (RSS, последние обновления, результаты поисков, индексы). Весьма полезно вычленить отдельные страницы, которые используются в шаблонах с боковыми панелями. Регулярное выражение сравнивается с полным (с начальным двоеточием) ID статьи, если совпадает, то считается, что статью нужно скрыть. Это только «косметическое» средство, не следует использовать его в безопасности.

Тип данных: строковый
Значение по умолчанию:

Пример

Расположение файла для правки Dokuwiki/conf/local.php

Пример для исключения страниц :reports:template, :reports:sidebar и страниц, вложенных в них:

$conf['hidepages'] = '^:reports:(?:template|sidebar)';

Еще один пример. Директория /data/pages содержит следующие страницы:

.
├── admin
│   ├── build_notes.txt
│   ├── new_software.txt
│   └── todos.txt
├── admin_links.txt
├── labels
│   └── start.txt
├── playground
│   └── playground.txt
├── sidebar.txt
├── software
│   ├── dokuwiki
│   │   └── start.txt
│   ├── kdialog
│   │   └── start.txt
│   ├── start.txt
│   └── __template.txt
├── start.txt
├── templates
│   └── start.txt
└── wiki
    ├── dokuwiki.txt
    ├── syntax.txt
    └── welcome.txt

Чтобы скрыть страницы admin_links, sidebar и все, что находится в пространствах имён :admin, :labels, :playground, :templates и, :wiki, используйте:

$conf['hidepages'] = '^:(admin*|sidebar|playground|labels|templates|wiki)';

См. также

htmlok

anonymous@undisclosed.example.com (Anonymous) — Wed, 12 Feb 2025 08:24:13 +0000

Настройка конфигурации: htmlok

Определяет, разрешено ли встраивание HTML с использованием <html> тегов. Это может нарушить макет и соответствие XHTML, если вставлен неправильный HTML.

Эта опция и механизм были удалены из релиза «Jack Jackrum» 2023 года. Замена возможна через плагин HTMLok.

Следующее применимо только до релиза «Igor»:

Эту опцию не следует включать ни при каких обстоятельствах, за исключением следующих случаев:

вы единственный пользователь с правами на запись
вы точно знаете, что делаете

Это большой риск безопасности при использовании на свободном сайте, поскольку он позволяет любому встраивать произвольный JavaScript в ваши страницы вики. Это может быть использовано для кражи cookie и получения несанкционированного привилегированного доступа к вашей вики, что может привести к возможному повышению привилегий, что может позволить захватить ваш сервер, украсть личную информацию и т. д.

Тип: Логический
По умолчанию:0

Предупреждение о безопасности : изменение этого параметра может представлять угрозу безопасности.

Смотрите также

javascript

anonymous@undisclosed.example.com (Anonymous) — Wed, 14 Aug 2024 22:53:02 +0000

JavaScript

Для удобства «ДокуВики» позволяет использовать программистам JavaScript. Также как и страницы стилей CSS, все файлы JavaScript загружаются через программу-диспетчер с целью уменьшения количества HTTP-запросов, для кэширования, а также удаления пробелов и комментариев (настройка compress).

Эта статья даст общее представление о том, как скрипты JavaScript загружаются из ядра «ДокуВики», плагинов и шаблонов. Также здесь содержится информация об обработке событий и стиля программирования, когда JavaScript используются в ДокуВики.

Загрузка JavaScript

Все Java скрипты собираются и загружаются через js.php, который объединяет все найденные файлы яваскрипта, убирает пробелы и комментарии (если включена опция compress) и помещает результат в кэш. Также он (js.php) даёт команду браузеру помещать в кэш результат, так что, когда вы разрабатываете новый яваскрит, не забывайте сбрасывать кэш браузера (например Shift+F5, Shift+CTL+R и тому подобное) всякий раз, когда ваш скрипт изменён. Если ваш сайт сидит в облаке, в отдельных случаях может потребоваться touch его настроек.

«ДокуВики» получает JavaScript из:

автоматически сгенерированные яваскрипты (языковые строки, настройки конфигурации, панель инструментов);
lib/scripts/*.js ¹⁾;
lib/plugins/*/script.js;
lib/tpl/<currenttemplate>/script.js;
conf/userscript.js.

Из вышеизложенного следует, что использование яваскриптов возможно в шаблонах и плагинах (с помощью файла script.js), а также возможно определить свои собственные скрипты в conf/userscript.js.

Также яваскрипт может быть добавлен в main.php, расположенном в lib/tpl/<currenttemplate>. Хорошо знакомый HTML-код <head> </head> принимает JavaScript.

Об атрибутах внешних скриптов

Однако до загрузки файла скрипта, особенно если он крупный, рендеринг сайта будет останавливаться, это стандартное поведение браузеров служит очень частой причиной для недовольства «Dokuwiki». Кроме того, скрипт исполняется немедленно после загрузки, не дожидаясь окончания сборки самой страницы. До появления атрибутов defer в HTML 4.01 (откладывающего запуск скрипта до окончания загрузки его цели) и async в HTML 5 (процесса, полностью независимого от рендеринга) для тега <script> работающие со страницей скрипты рекомендовалось размещать в конце неё. Async рекомендуется для библиотечных скриптов, а defer - для обрабатывающих страницу, и размещать теги с такими атрибутами можно на привычном месте внутри тега head. Но если defer-скрипт опирается на async-библиотеку и та так увесиста, что не всегда успевает грузиться даже до его старта, то defer-скрипт всё же придётся поставить в конец шаблона.

Синтаксис подключения, использования (include)

Диспетчер яваскриптов «ДокуВики» позволяет использовать специальные (особые) комментарии, чтобы подгружать отличные от вышеописанных файлы скриптов. Это важно для случаев, когда в основном только один файл яваскрипт подвергается анализу (разбору) диспетчером, например в плагинах и шаблонах.

Подключаемые файлы не проверяются механизмом кэширования на предмет обновления. Необходимо изменить основной файл, чтобы запустить механизм кэширования.

Либо использовать самообновляющий детектор <script charset=«UTF-8» src=«/lib/tpl/шаблон/editor.js?ver=' . date ( «y-m-d_H:i:s», filemtime ( '/var/www/сайт/lib/tpl/шаблон/editor.js' ) ) . '» defer></script>

Подключения (includes) не поддерживаются внутри подключаемых файлов с целью предотвращения кольцевых ссылок (рекурсии).

Путь для подключения (includepath) должен содержать только буквы, цифры, знак подчёркивания, знак дроби и точку.

include

/* DOKUWIKI:include somefile.js */

Этот код включит указанный файл в то место, где был расположен комментарий. Путь к файлу по умолчанию относительный, но будет абсолютный, если поставить в начале знак дроби (/).

include_once

/* DOKUWIKI:include_once common_library.js */

Указанный файл будет подключен (использован), только если файл с аналогичным имененм не подгружался ранее с помощью оператора include_once. Данное имя файла будет доступно через любые другие скриптовые файлы (из всех плагинов), поэтому стоит давать понятное наименование такому файлу.

Использование этого оператора имеет смысл, если разрабатываются несколько независимых плагинов, каждый из которых использует одну и ту же библиотеку яваскрипт. Использование оператора include_once несколько раз с одинаковым именем подключаемого файла даст гарантию того, что библиотека будет подгружена только один раз, даже если будет установлено несколько плагинов одновременно.

DokuWiki JavaScript Library

DokuWiki does not use any of the bigger JavaScript libraries like Prototype, Dojo or JQuery. Instead it comes with a small set of handy classes and functions that may help you with writing JavaScript code for DokuWiki.

Event Handling

As said in Avoid Inappropriate Mixing, event handlers should not be mixed into HTML code. Instead those handlers should be assigned when the Document Object Model (DOM) was loaded. The DOM is a tree-based object representation of the HTML that is available to the JavaScript. Your JavaScript need merely figure out which objects to attach functions to and then to attach functions to them.

To attach functions to any given DOM Object in a cross-browser compatible way, the addEvent() function is provided. It takes the DOM object, an event name (like 'click') and a callback function (the handler) as arguments. This function also takes care of multiple plugins trying to register an event on the same DOM object.

Additionally, addEvent() changes the properties and methods of the event in Internet Explorer - so you can use the target property and can call the preventDefault() and stopPropagation() methods.

Unfortunately, the JavaScript in your script.js loads before the HTML has finished loading and before the DOM tree has been made. The objects that the JavaScript needs don't yet exist. However, you may still run JavaScript when script.js loads, as long as that JavaScript doesn't require DOM.

To solve this problem DokuWiki provides the addInitEvent() function. This function will register a given callback to be run as soon as the DOM is ready.

Here's an example (from the summary_enforcement tip) using both methods:

function enforceSummary() {
    /*...*/
}
 
function installSummaryEnforcement()
{
    var summary_input = document.getElementById('edit__summary');
    if(summary_input !== null)
    {
        /*...*/
        addEvent(summary_input, 'change', enforceSummary);
        addEvent(summary_input, 'keyup', enforceSummary);
    }
}
 
addInitEvent(installSummaryEnforcement);

In this example, we need to attach enforceSummary() to the onchange and onkeyup handlers for the summary input field. installSummaryEnforcement() does this.

The call to addInitEvent() will run the installSummaryEnforcement() function as soon as the DOM is loaded.

Notice how installSummaryEnforcement() itself works. First it acquires a DOM object by ID (though there are other ways to acquire it). In this case the object may not exist since the summary field is only shown when editing a page, so the function first tests to see if it got the object. If it did, it calls addEvent() to attach enforceSummary() to the event handlers.

The DokuWiki event functions were originally provided by Dean Edwards here and here.

For deeper insight on the event system see the source

Predefined Global Variable

DokuWiki defines certain JavaScript variables for the use in your script:

DOKU_BASE – the full webserver path to the DokuWiki installation
DOKU_TPL – the full webserver path to the used Template
LANG – an array of languagestrings

SACK (AJAX) Library

DokuWiki provides a simple AJAX library named SACK by Gregory Wild-Smith.

See the Source tw-sack.js for details on how to use it.

$()

The $() function is a handy shortcut to the all-too-frequent document.getElementById() function of the DOM. Like the DOM function, this one returns the element that has the id passed as an argument. Unlike the DOM function, though, this one goes further. You can pass more than one id and $() will return an Array object with all the requested elements.

Taken from the prototype library
See Docs by Sergio Pereira

Additional functions

DokuWiki provides various other tool methods. Especially the following might be useful for your development: isset, getElementsByClass, findPosX, findPosY, jsEscape, prependChild.

For details check the source of these files:
- script.js
- helpers.js

JSINFO

Since november 23, 2009 DokuWiki passes the global $JSINFO to javascript. (see the mailinglist mailinglist)

The usual way in a plugin is this:

function register(Doku_Event_Handler $controller) {
    $controller->register_hook('DOKUWIKI_STARTED', 'AFTER',  $this, '_adduser');
}
function _adduser(&$event, $param) {
    global $JSINFO;
    $JSINFO['user'] = $_SERVER['REMOTE_USER'];
}

add exact time when the array is send to JavaScript

¹⁾

чтобы избежать излишней загрузки скриптов для тех, кто читает статью, содержимое edit.js и media.js загружается только в режиме редактирования или отображения медиафайлов

²⁾

Please note as well that there is no language attribute of the script tag! Instead use type=«text/javascript» to be standards compliant.

license

anonymous@undisclosed.example.com (Anonymous) — Sat, 02 Sep 2023 14:59:23 +0000

Настройки: лицензия

Эта настройка управляет типом лицензии, под которой распространяется содержимое вашего сайта. Список лицензий хранится в файле conf/license.php. По умолчанию там хранится набор лицензий Creative Commons и GNU FDL.

Тип данных: строковый
Значение по умолчанию: cc-by-nc-sa

Желательно изначально выбрать нужный тип лицензии, поскольку позднейшее изменение условий лицензирования контента может потребовать согласования со всеми авторами.

Чтобы полностью отключить эту функцию, например, для частной внутренней вики, просто выберите «no license» (или оставте для параметра значение пустым).

Например, добавьте эту строку в свой conf/local.php:

$conf['license'] = ' ';

Добавление новой лицензии

Во избежание проблем при установке обновлений не редактируйте conf/license.php. Список дополнительных лицензий следует хранить в файле conf/license.local.php.

Пример содержимого:

<?php
$license['license'] = array(
    'name' => 'Полное имя лицензии',
    'url'  => 'http://example.com/license',
);

Ключ license — это сокращённое имя лиценции, используемое в конфигурационном файле.

Для каждой лицензии должны быть добавлены картинки с именем <сокращённое имя лицензии> и расширением gif или png. Картинка с размерами 80×15 пикселов должна лежать в lib/images/license/button и с размерами 88×31 пиксель — в lib/images/license/badge.

См. также

Конфигурирование «Докувики»

mailguard

anonymous@undisclosed.example.com (Anonymous) — Mon, 25 Aug 2025 03:48:53 +0000

Настройки: mailguard

Этот параметр определяет, будет или нет, а если будет, то как, производится шифрование адресов электропочты против ботов — сборщиков адресов элекропочты. Возможные значения:

visible — заменяет «@» на «[at]», «.» на «[dot]», «-» на «[dash]»;
hex — использует шестнадцатеричные последовательности для кодирования адресов;
none — никакого шифрования не происходит.

Тип данных: строковый
Значение по умолчанию: hex

См. также

Конфигурирование «ДокуВики»

manager

anonymous@undisclosed.example.com (Anonymous) — Tue, 20 Jan 2026 18:21:28 +0000

Настройки конфигурации: Менеджер

Определяет, кто имеет права администратора в DokuWiki. Администраторы получают доступ к ограниченному набору элементов в окне администрирования, например, к менеджеру отмены изменений, но они не могут получить доступ к ACL и менеджеру пользователей, а также изменять параметры конфигурации. В открытой вики может быть хорошей идеей иметь пару администраторов, готовых помочь в борьбе со спамом в вики.

Вы можете задать либо имя пользователя, либо имя группы, добавив @перед именем группы символ.

Тип: Строка
По умолчанию: !!not set!!

В комплект плагинов, доступных менеджерам, входят:

См. также

Затронутые плагины

Следующие плагины имеют административные интерфейсы, доступные менеджерам. Они не входят в комплект DokuWiki и должны быть установлены отдельно, см. раздел «Плагины».

maxseclevel

anonymous@undisclosed.example.com (Anonymous) — Sun, 13 Apr 2025 08:34:40 +0000

Настройки: maxseclevel

В этой переменной задаётся максимальный уровень вложенности заголовка, при котором параграф, относящийся к этому заголовку, рассматривается как отдельная редактируемая секция и в конце этой секции отображается кнопка «Правка» (Edit).

Тип данных: числовой (0–5)
Значение по умолчанию: 3

Нулевое значение приведёт к деактивации всех кнопок «Правка» (Edit) внутри страницы.

См. также

maxtoclevel

anonymous@undisclosed.example.com (Anonymous) — Sun, 13 Apr 2025 08:30:15 +0000

Настройки: maxtoclevel

Нижний уровень заголовков, которые необходимо включать в автоматически генерируемое содержание.
Верхний уровень заголовков настраивается параметром toptoclevel

Тип данных: числовой (0–5)
Значение по умолчанию: 3

Значение 0 отключает генерацию содержания.

См. также

mediarevisions

anonymous@undisclosed.example.com (Anonymous) — Tue, 20 Jan 2026 19:00:52 +0000

Параметр конфигурации: mediarevisions

Включает или отключает сохранение версий медиафайлов. Если включено (по умолчанию), то при загрузке файла с тем же именем, что и существующий файл, существующий файл копируется в архив, а новый сохраняется как новая версия. Старые версии можно восстановить через вкладку «История» в менеджере полноэкранных медиафайлов.

Отключение этой опции означает потерю перезаписанных файлов, но при этом вы значительно экономите место на диске.

Тип: Логический
По умолчанию:1

См. также

Настройка DokuWiki
Обработка изображений и медиафайлов
Менеджер полноэкранного мультимедиа
Всплывающее окно «Менеджер мультимедиа» можно открыть с помощью панели инструментов окна «Редактирование».

phpok

anonymous@undisclosed.example.com (Anonymous) — Wed, 12 Feb 2025 08:18:17 +0000

Настройка конфигурации: phpok

<php> Определяет, разрешено ли встраивание PHP с использованием тегов.

Эта опция и механизм были удалены из релиза Jack Jackrum без замены. В настоящее время (по состоянию на 4 апреля 2023 г.) нет плагина, который можно использовать для замены этой функциональности сопоставимым образом.

Следующее применимо только до освобождения Игоря:

Это большой риск безопасности при использовании на свободном сайте, поскольку он позволяет любому выполнить произвольный PHP-код на вашем сервере. Это может быть использовано для захвата вашего сервера, кражи личной информации и т. д. Если вы точно не знаете, что делаете, вам никогда не следует включать эту опцию.

Тип: Логический
Значение по умолчанию:0

Предупреждение о безопасности: изменение этого параметра может представлять угрозу безопасности.

rss_content

anonymous@undisclosed.example.com (Anonymous) — Sun, 16 Feb 2025 18:40:06 +0000

Настройки: rss_content

Указывает, какое содержание должно попадать в RSS-ленты.

Тип данных: строковый
Значение по умолчанию: abstract
- Возможные значения:
  - abstract — асбтрактный¹⁾
  - diff — объединённый diff²⁾
  - htmldiff — HTML-форматированная таблица diff³⁾
  - html — полное содержимое HTML-страницы⁴⁾

См. также

¹⁾

ориг. plain text, first paragraph or so

²⁾

ориг. plain text unified diff wrapped in <pre> tags

³⁾

ориг. diff as HTML table

⁴⁾

ориг. the full page rendered in XHTML

rss_linkto

anonymous@undisclosed.example.com (Anonymous) — Sun, 16 Feb 2025 18:39:08 +0000

Настройки: rss_linkto

Устанавливает параметр ссылки заголовка при создании XML-ленты новостей¹⁾.

Тип данных: строковый
Значение по умолчанию: diff
- Возможные значения:
  - diff — различия между версиями (ревизиями);
  - page — версия страницы на момент редактирования²⁾;
  - rev — страница со списком её версий;
  - current — текущая версия страницы.

См. также

¹⁾

ориг. Sets the default link target for the created XML feeds.

²⁾

ориг. the page as of the revision

rss_type

anonymous@undisclosed.example.com (Anonymous) — Sun, 16 Feb 2025 18:38:11 +0000

Настройки: rss_type

Параметр определяет XML-тип новостных лент.

Тип данных: строковый
Значение по умолчанию: rss1
- Возможные значения:
  - rss — RSS 0.91
  - rss1 — RSS 1.0
  - rss2 — RSS 2.0
  - atom — Atom 0.3
  - atom1 — Atom 1.0

См. также

savedir

anonymous@undisclosed.example.com (Anonymous) — Sun, 13 Apr 2025 06:57:34 +0000

Настройка: savedir

Относительный путь к подкаталогу (внутри каталога, определённого параметром basedir), в котором хранятся файлы вики. Этот каталог должен быть доступен веб-серверу на запись.

Тип данных: строковый
Значение по умолчанию: ./data

Внутри этого каталога находится несколько подкаталогов и список изменений. Вы можете изменить их расположение с помощью следующих параметров¹⁾:

Параметр	Подкаталог по умолчанию
datadir	pages
olddir	attic
mediadir	media
mediaolddir	media_attic
mediametadir	media_meta
cachedir	cache
lockdir	locks
changelog	changes.log
metadir	meta
indexdir	index
tmpdir	tmp
logdir	log

Внимание: изменение этого параметра может привести к неработоспособности вики и меню конфигурации.

См. также

¹⁾

недоступно в менеджере конфигурации

sidebar

anonymous@undisclosed.example.com (Anonymous) — Sun, 22 Jun 2025 10:49:04 +0000

Конфигурация Dokuwiki

Узнайте о DokuWiki

Расширенное использование

Шаблоны, которые в настоящее время поддерживают эту настройку (другие шаблоны могут поддерживать другие формы боковых панелей): 20cones, ach, adoradark, aran, benjamin, binkytestinstance, bootstrap3, codowik, dokuwiki, grassstains, greensteel, mindthedark, starter, starterbootstrap¹⁾, starterpjax, taratasy, writr, zenlike

См. также

¹⁾

не поддерживает боковые панели в пространствах имен

sitemap

anonymous@undisclosed.example.com (Anonymous) — Sat, 02 Sep 2023 14:54:02 +0000

Настройки: sitemap

«Докувики» может автоматически генерировать карту сайта в формате XML, удовлетворяющую требованиям поисковых машин Яндекса, Гугла, Бинга, Яху. В опции указывается количество дней — период, с которым должна пересоздаваться карта сайта. По умолчанию карта сайта не создаётся.

Тип данных: числовой
Значение по умолчанию: 0

См. также

sneaky_index

anonymous@undisclosed.example.com (Anonymous) — Sat, 02 Sep 2023 14:21:12 +0000

Настройки: sneaky_index

Если этот параметр включен, то пространства имён, доступа к которым пользователь не имеет, не будут отображаться в построенном для него (пользователя) индексе пространств имён (sitemap). Это может нарушить вид индекса, если более глубокие пространства имён доступны, чем менее глубокие (как обычно и бывает). Не рекомендуется кому-либо, кроме параноидальных людей ;-)

Тип данных: логический
Значение по умолчанию: 0 (выключено)

См. также

Конфигурирование «Докувики»

startpage

anonymous@undisclosed.example.com (Anonymous) — Sat, 01 Feb 2025 09:33:54 +0000

Настройка конфигурации: Стартовая страница

Это имя страницы по умолчанию в каждом пространстве имен (включая корневое пространство имен), которое загружается, когда имя страницы не указано. Это должно быть допустимое имя страницы и никогда не содержать пространство имен.

Тип: Строка
По умолчанию start

Другими типичными значениями являются index или home или как это start называется на вашем родном языке.

Примечание: Эта страница документации называется startpage, чтобы избежать путаницы с начальной страницей пространства имен config. Опция просто называется start.

Предупреждение : изменение этого параметра может привести к непреднамеренному поведению при изменении в вики, где некоторое время использовалось другое значение.

Смотрите также

Создание пространств имен

superusers

anonymous@undisclosed.example.com (Anonymous) — Wed, 14 Jan 2026 18:55:37 +0000

Configuration Setting: superuser

Указывает, кто обладает правами суперпользователя в DokuWiki. Суперпользователи всегда имеют все разрешения независимо от ограничений ACL и могут редактировать ограничения ACL (аналогично root).

Вы можете задать либо имя пользователя, либо список имен пользователей («admin1,admin2»), либо имя группы, добавив перед именем группы символ @. Если вы запустите установщик DokuWiki и выберете включение ACL , этот параметр будет иметь значение '@admin'. Чтобы изменить или установить суперпользователя вручную, отредактируйте файл и измените параметр на имя пользователя (пользователей), которому (которым) назначен суперпользователь conf/local.php and change the setting $conf['superuser'].

Тип: Строка
По умолчанию: !!not set!!¹⁾

Внимание: изменение этого параметра может сделать вашу вики и меню настроек недоступными.

См. также

¹⁾

Однако обычно это значение устанавливается автоматически установщиком DokuWiki, если пользователь вызывает установщик во время установки DokuWiki..

tocminheads

anonymous@undisclosed.example.com (Anonymous) — Sun, 13 Apr 2025 08:32:00 +0000

Настройки: tocminheads

Минимальное количество заголовков, при котором будет создаваться содержание.

Тип данных: числовой (0–5)
Значение по умолчанию: 3

Наименьшее возможное количество заголовков для генерации содержания – 1. Установление значения 0 приводит к её отключению (так же, как и нулевое значение «maxtoclevel»). Примечание: Уровень заголовков, подходящих для генерации содержания, проверяется параметрами «maxtoclevel» и «toptoclevel»

См. также

toptoclevel

anonymous@undisclosed.example.com (Anonymous) — Sun, 13 Apr 2025 08:30:55 +0000

Настройки: toptoclevel

Верхний уровень заголовков, которые необходимо включать в автоматически генерируемое содержание.
Нижний уровень заголовков настраивается параметром maxtoclevel

Тип данных: числовой (1–5)
Значение по умолчанию: 1

Параметр 0 здесь не допускается!
Примечание: Поставьте значение 2, чтобы исключить попадание в содержание главного титула страницы. Это полезно для вики с включенным useheading и дизайном, показывающим титул на баннере страницы.

См. также

updatecheck

anonymous@undisclosed.example.com (Anonymous) — Wed, 14 Aug 2024 23:15:26 +0000

Настройки: updatecheck

Проверка новой версии «Докувики».

Тип данных: логический
Значение по умолчанию: 1 (включено)

См. также

upload_files

anonymous@undisclosed.example.com (Anonymous) — Fri, 09 Jan 2026 12:52:16 +0000

Макс. размер загружаемого файла 32 MB.

Чтобы увеличить максимальный размер загружаемого файла в DokuWiki до 32 МБ (или больше), нужно изменить настройки PHP в файле php.ini, установив директивы upload_max_filesize и post_max_size (например, upload_max_filesize = 32M и post_max_size = 32M), а затем перезапустить веб-сервер для применения изменений, как описано на официальной странице DokuWiki.

Шаги для изменения размера файла:

Найдите php.ini: Местоположение файла зависит от вашего сервера (Apache, Nginx, IIS), но часто находится в директориях /etc/php/, /usr/local/etc/php/ или в корневой папке вашего веб-сайта.

Отредактируйте директивы:

upload_max_filesize = 32M

post_max_size = 32M (Этот параметр должен быть равен или больше upload_max_filesize)
(Опционально) memory_limit = 128M (Убедитесь, что памяти достаточно)
(Опционально) max_execution_time = 300 (Увеличьте время выполнения скриптов, если нужно)
Перезапустите веб-сервер: После сохранения изменений обязательно перезапустите ваш веб-сервер (Apache, Nginx, PHP-FPM), чтобы новые настройки вступили в силу.

Список разрешённых расширений файлов

В DokuWiki разрешены к загрузке и отображению стандартные медиа-файлы, такие как .gif, .jpg (или .jpeg), .png для изображений, а также .mp4, .ogg, .webm для видео, .mp3, .wav, .ogg для аудио, и .pdf для документов, при этом список можно расширять через конфигурационные файлы (mime.conf и mime.local.conf), добавляя новые типы MIME.

Стандартно разрешенные типы:

Изображения: gif, jpg, png.
Видео: webm, ogv, mp4 (может зависеть от настроек).
Аудио: ogg, mp3, wav (может зависеть от настроек).
Документы (через MIME-типы): doc, xls, ppt, rtf, pdf.

Как добавить новые расширения:

Чтобы разрешить загрузку других типов файлов (например, .docx, .xlsx, .svg), нужно отредактировать конфигурационные файлы DokuWiki:

Найдите mime.conf (основной файл) и/или создайте/отредактируйте mime.local.conf в папке conf/.
Добавьте новые записи в формате расширение MIME-тип. Например, для SVG добавьте: svg image/svg+xml.

Пример добавления PDF (если не работает): Если PDF не отображается, можно добавить запись в mime.conf.

useheading

anonymous@undisclosed.example.com (Anonymous) — Sun, 13 Apr 2025 07:25:27 +0000

Настройки: useheading

Когда эта опция активирована, ссылка на имя статьи вики будет автоматически использовать первый заголовок в статье для следующего:

заголовок страницы, который отображается в браузере или в результатах поисковых машин;
текст для ссылки на статью, если только в определении ссылки не содержится явного названия;
заголовок новости в RSS-рассылке.

Тип данных: смешанный
Значение по умолчанию: 0
- Возможные значения:
  - «Никогда» (0) — отключено. Будет использоваться имя страницы в тексте ссылки;
  - «Только содержимое вики» (content) — использовать текст первого заголовка в ссылках в текстах статей;
  - «Только навигация» (navigation) — использовать текст первого заголовка в ссылках в строке «Вы посетили:», обратных ссылках, результатах поиска и т. п.;
  - «Всегда» (1) — использовать текст первого заголовка во всех ссылках.

(Обновлено в «Докувики» 2009-02-14. Для обратной совместимости любые другие значения преобразуются в «0» или «1» с помощью функции empty())

Предупреждение о безопасности

Если страница имеет ограничения по доступу, в её первом заголовке страницы никогда не пишите ничего конфиденциального.

Первый заголовок страниц с ограниченным доступом для чтения будет раскрыт в других частях вики, которые ссылаются на эту страницу. Даже если вы убедитесь, что на страницах без ограничений нет ссылок на конкретную страницу, редактор страницы без ограничений все равно может создать ссылку на страницу с ограниченным доступом, чтобы открыть первый заголовок.

См. также

Конфигурирование «Докувики»

useslash

anonymous@undisclosed.example.com (Anonymous) — Fri, 09 Aug 2024 01:21:50 +0000

Настройка конфигурации: useslash

Если вы включили опцию userrewrite, вы можете использовать эту опцию дополнительно, чтобы использовать косую черту / вместо двоеточия :в качестве разделителя пространств имен в URL-адресах.

Тип: Логический
По умолчанию:0

Значение	Информация	Пример URL-адреса
0	`:` используется как разделитель. По умолчанию.	http://example.com/dokuwiki/wiki:syntax
1	`/` используется как разделитель.	http://example.com/dokuwiki/wiki/syntax

Смотрите также

Настройка DokuWiki

usewordblock

anonymous@undisclosed.example.com (Anonymous) — Tue, 20 Jan 2026 17:51:07 +0000

Настройки: usewordblock

Включает использование «чёрного списка» для противодействия спаму в вики (англ.).

Тип данных: логический
Значение по умолчанию: 1 (включено)

См. также

Конфигурирование «ДокуВики»

xsendfile

anonymous@undisclosed.example.com (Anonymous) — Tue, 20 Jan 2026 17:49:52 +0000

Настройки: xsendfile

В «Докувики» все медиафайлы (изображения) закачиваются с помощью PHP-скрипта для того, чтобы проверить ограничения доступа и в случае масштабирования изображений. Это требует больше ресурсов, чем просто закачка их самим веб-сервером. Некоторые серверы позволяют перехватить доставку у скрипта, коль скоро он произвёл свои проверки. Это делается путём отправки определённых HTTP-заголовков. Какие именно должны быть заголовки, зависит от самого веб-сервера.

Эта опция включает посылку таких заголовков. Замечание: если вы укажете неверное значение, ваши изображения и другие медиафайлы могут перестать работать.

Тип данных: числовой
Значение по умолчанию: 0 (выключено)

Допустимы следующие значения:

Значение	Результат
0	Заголовки не посылаются, все данные доставляются с помощью самой «Докувики»
1	Используется пропрайтерный заголовок lighttpd (для lighttpd перед релизом 1.5)
2	Используется стандартный заголовок X-Sendfile
3	Используется проприетарный заголовок Nginx

Для поддержки X-SendFile в Apache вам нужен mod_xsendfile. Затем добавьте директивы XSendFile on и XSendFilePath PATH, например, к вашей конфигурации VirtualHost. PATH для XSendFilePath — это путь к каталогу данных вашей установки «Докувики».

Ускоренные загрузки в nginx возможны только с URI. Настройте местоположение для вашего каталога данных относительно корня вики.

location ~ ^/dokuwiki/data/ {
 internal;
 root /public;
}

Опция internal защищает путь от удалённого доступа. Если каталог данных не является подкаталогом веб-корня, вы можете использовать alias вместо этого.

location ~ ^/dokuwiki/.*\.php {
 root /public;
 # FastCGI options...
}
location ~ ^/dokuwiki/data/ {
 internal;
 alias /private/data/; # note the trailing slash
}

Предупреждение: изменение этой опции может привести к непредсказуемому поведению системы.

См. также

Конфигурирование «Докувики»

Настройки: youarehere

Параметр определяет альтернативный способ отображения вашего местонахождения в вики: в виде пути к просматриваемой странице в дереве пространств имён. Если вы используете эту возможность, возможно вы захотите отключить стандартную строку «Вы посетили».

Тип данных: логический
Значение по умолчанию: 0

См. также

Конфигурирование «ДокуВики»
Параметр конфигурации «Вы посетили»

worldwide open-source software - wiki:config

acl

Access Control Lists (ACL)s

Configuration and Setup

See also

Access Restrictions

Editing ACLs

ACLs by Example

Background Info

User/Group Encoding

User Wildcards

allowdebug

Параметр конфигурации: разрешенный отладка

Смотрите также

auth_security_timeout

Настройка конфигурации: тайм-аут безопасности аутентификации

См. также

auth

Authentication Plugins

Migration of a wiki from before 2013

Authentication related plugins

Authentication related Tips

authtype

Настройка конфигурации: тип аутентификации

Смотрите также

autopasswd

Настройки: autopasswd

См. также

autoplural

Настройка конфигурации: автомножественность

Смотрите также

basedir

Настройка конфигурации: basedir

См. также

baseurl

Настройки: baseurl

См. также

breadcrumbs

Настройки: breadcrumbs

См. также

broken_iua

Настройки: broken_iua

См. также

cachetime

Настройки: cachetime

См. также

camelcase

Настройка конфигурации: camelcase

See also

canonical

Настройки: canonical

См. также

compress

Настройки: compress

См. также

compression

Настройки: compression

См. также

config

Конфигурирование «Докувики»

Что можно настраивать в «Докувики»

Обзор файлов конфигурации

Параметры конфигурации

Доступные параметры

Общие настройки

Настройки отображения

Настройки аутентификации

Антиспамовские настройки

Настройки редактирования

Настройки ссылок

Настройки для медиафайлов

Расширенные настройки

Настройки сети

cookiedir

Настройки: cookiedir

См. также

css

Краткое руководство по стилям CSS

Настройте свою «ДокуВики»

cssdatauri