Manual:Variable/ru


 * Эта страница о создании переменных. Как использовать имеющиеся переменные, см. . О глобальных переменных PHP, используемых в MediaWiki, см. Manual:wg variable.

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

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

Определение пользовательских переменных
Переменные - это особой конструкции магические слова, поэтому нашим первым шагом будет определение переменной как магического слова:


 * 1) Выберите магический идентификатор(ID) слова для вводимой Вами переменной. Это только внутренний идентификатор, который используется для связи различных частей определения переменной: имен, которые появляются в вики-тексте, и кода PHP, который будет назначать значение переменной. Лучше всего выбрать идентификатор, который будет однозначно связан с вашим расширением(шаблоном) и вряд ли будет перепутан с другими магическими идентификаторами слов, используемыми другими расширениями(шаблонами). Обычная стратегия - использовать что-то вроде , где canonicalname - это имя, под которым вы зарегистрируете свое расширение (см. Регистрация пользовательских переменных ниже).
 * 2) Определите имена, которые будут отображаться в вики-тексте. Для этого вам нужно определить и зарегистрировать https://www.mediawiki.org/wiki/Manual:Magic_wordsWords в файле через https://www.mediawiki.org/wiki/Manual:Magic_words. Ваши имена могут быть с учетом регистра и языка. Смотрите  для получения дополнительной информации.
 * 3) Укажите код PHP для присвоения значения переменной. Для этого вам нужно определить и зарегистрировать функцию ловушки(хука) с помощью ParserGetVariableValueSwitch.

Обратите внимание, что единственным отличием этого процесса(регистрации переменной) от общего процесса определения магических слов является последний шаг: определение функции ловушки(хука) для ParserGetVariableValueSwitch. Функции парсера имеют другой метод для привязки идентификатора к коду PHP. Смотрите Manual: Функции парсера для получения дополнительной информации.

Регистрация пользовательских переменных
Данный процесс состоит из двух шагов:


 * 1) Define the variable so that it gets included in . This requires adding a member to  .  For more information, please see Registering features with MediaWiki.
 * 2) Declare the magic word ID as a variable. To accomplish this we write and assign a hook to , the subject of this article.

Пример
''Note: if you wish to use this example as a coding template, please replace  with something unique to your project so that there is less risk of name clashes with MediaWiki or any of its extensions. For example, if your extension was named  and you were reasonably sure that no-one else had an extension with constants, variables, functions, or classes beginning 'BEST_', 'wgBEST', 'wfBEST', or even 'BEST' you might want to replace 'My' with 'BEST'.''

File

File

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

 * - список магических слов встроенных по умолчанию в основной пакет MediaWiki.
 * - рассмотрение различных видов магических слов и то, как MediaWiki различает переменные, функции синтаксического анализатора и шаблоны.
 * Спец разметка