Различия

Показаны различия между двумя версиями страницы.

--- wiki:devel:configuration [2025/01/03 16:11] – [Параметры] VladPolskiy
+++ wiki:devel:configuration [2025/01/03 16:55] (текущий) – [Template settings] VladPolskiy
@@ Строка 3: / Строка 3: @@
 ===== Default Settings =====
-Чтобы сделать плагин или шаблон настраиваемым, необходимо предоставить ''lib/plugins/<plugin>/conf/default.php'' который будет содержать настройки по умолчанию, и ''lib/plugins/<plugin>/conf/metadata.php'' который содержит описывающие [[#Configuration Metadata|метаданные конфигурации]] используемые [[plugin:config|диспетчером конфигурации]] для обработки/отображения параметров ((шаблоны аналогичны lib/tpl/<template>/conf/default.php и т.д.)).
+Чтобы сделать плагин или шаблон настраиваемым, необходимо предоставить ''lib/plugins/<plugin>/conf/default.php'' который будет содержать настройки по умолчанию, и ''lib/plugins/<plugin>/conf/metadata.php'' который содержит описывающие [[#Configuration Metadata|метаданные конфигурации]] используемые [[wiki:plugin:config|диспетчером конфигурации]] для обработки/отображения параметров ((шаблоны аналогичны lib/tpl/<template>/conf/default.php и т.д.)).
 <code php>
@@ Строка 66: / Строка 66: @@
-==== Examples ====
+==== Примеры ====
-=== ''multicheckbox'' with ''_other'' ===
+=== ''multicheckbox'' с ''_other'' ===
-Let's say initially a plugin uses the syntax:
+Предположим, изначально плагин использует следующий синтаксис:x:
 <code php>$meta['multi'] = array('multicheckbox', '_choices' => array('a','b','c','d'));</code>
-this means the multicheckbox will show four choices plus a string input.
+это означает, что в поле с несколькими флажками будут отображаться четыре варианта выбора и строковое поле ввода.
-Let's suppose also that the user inserts one or more extra values not in ''_choices''.
+Предположим также, что пользователь вставляет одно или несколько дополнительных значений, отсутствующих в ''_choices''.
-In the next release of the plugin the author's plugin decides to use the multicheckbox without the extra string, but, in order to be backwardly compatible, adopts:
+В следующем выпуске плагина авторский плагин решает использовать multicheckbox без дополнительной строки, но, в целях обратной совместимости, принимает:
 <code php>$meta['multi'] = array('multicheckbox', '_other' => 'exists', '_choices' => array('a','b','c','d'));</code>
-which means:
+что означает:
-  * if the user has inserted comma separated values, they will be printed in the extra string;
+  * если пользователь ввел значения, разделенные запятыми, они будут напечатаны в дополнительной строке;
-  * otherwise the extra string won't show.
+  * в противном случае дополнительная строка не будет отображаться.
-Note also that if the user inserts comma separated values which already exist (or some of them) in ''_choices'' but:
+Обратите внимание также, что если пользователь вставляет разделенные запятыми значения, которые уже существуют (или некоторые из них), в ''_choices'':
-  * they are already ticked, then the extra string will be removed and nothing else;
+  * они уже отмечены, то лишняя строка будет удалена и ничего больше;
-  * they are not already ticked, then the extra string will be removed and the relative value will be ticked.
+  * если они еще не отмечены, то лишняя строка будет удалена и отмечено относительное значение.
-===== Accessing Settings =====
+===== Доступ к настройкам =====
-====Core Settings====
+====Основные настройки====
-Inside [[xref>inc/init.php]] the configurations settings are read into a [[devel:environment|global array]] ''$conf[]''. When no settings were set, these are read from the default settings file.
+Внутри :&13:[[wiki:xref:dokuwiki:inc:init.php|init.php]] настройки конфигурации считываются в [[wiki:devel:environment|глобальный массив]] ''$conf[]''. Если настройки не заданы, они считываются из файла настроек по умолчанию. Вы можете получить доступ к основным настройкам в любом месте, используя ''$conf[]'' массив.
-You can access the core settings anywhere by using the ''$conf[]'' array.
 <code php>
@@ Строка 99: / Строка 98: @@
 </code>
-====Plugin settings====
+====Настройки плагина====
-You can access settings in [[plugins]] by using the ''%%$this->%%[[xref>getConf|getConf('<setting>')]]'' method.
+Вы можете получить доступ к настройкам [[plugins|плагина]] используя ''%%$this->%%
-In your plugin class you use:
+ [[xref>getConf|getConf('<setting>')]]'' метод.
+В классе вашего плагина используете:
 <code php>
 $keyvalue = $this->getConf('key');
 </code>
-==== Template settings====
+==== Настройки шаблона====
-In [[templates]] you can use ''[[xref>tpl_getConf|tpl_getConf('<setting>')]]''.
+В [[templates| шаблонах]] можно использовать ''[[xref>tpl_getConf|tpl_getConf('<setting>')]]''.
 <code php>
 $nicetoknow = tpl_getConf('special');
@@ Строка 113: / Строка 113: @@
-===== Labels in Configuration Manager =====
+===== Метки в диспетчере конфигураций =====
-For every setting in ''lib/plugins/<your plugin>/conf/default.php'' there can be a ''%%$lang[<setting>]%%'' value defined in ''lib/plugins/<your plugin>/lang/en/settings.php''. This value will be displayed as the label of the setting in the configuration manager. If the label file is left out or doesn't contain a value for the setting, the configuration manager will display "''%%plugin <plugin name> <setting>%%''" as the label instead.
+Для каждого параметра в ''lib/plugins/<your plugin>/conf/default.php'' может быть ''%%$lang[<setting>]%%'' определено значение в ''lib/plugins/<your plugin>/lang/en/settings.php''. Это значение будет отображаться как метка параметра в диспетчере конфигурации. Если файл метки пропущен или не содержит значения для параметра, диспетчер конфигурации отобразит "''%%plugin <plugin name> <setting>%%''" в качестве метки..
-You can also create a ''settings.php'' file for other languages.
+Вы также можете создать ''settings.php'' файл для других языков.
-Again, this also applies to templates (see [[:localization]] for further details).
+Опять же, это относится и к шаблонам (более подробную информацию см. в [[wiki:localization|Локализация]]).