Традиция:Приспособления

Приспособления Эта страница описывает смысл и механизм работы приспособлений (гаджетов) «Традиции». Описание предназначения отдельных приспособлений смотрите на странице Традиция:Описание приспособлений.

Приспособле́ние (англ. gadget) — код на языке JavaScript и (или) CSS, доступный для подключения любому зарегистрированному участнику Традиции через его собственную страницу настроек (на вкладке приспособлений). После такого подключения Традиция становится для этого участника несколько более навороченною: добавляются новые функции или новые элементы внешнего вида Традиции. Так участник может приспособить Традицию к своим нуждам.

Подключение таких приспособлений обеспечивается расширением MediaWiki, называемым Gadgets.

Предназначение

Приспособления — это ещё один способ изменить персональное оформление участника или добавить дополнительные инструменты.

Нет разницы в возможностях скрипта, вызванного из личного файла monobook.js участника Традиции, и того же скрипта, оформленного и подключёного как приспособление. Единственная разница состоит в удобстве подключения.

Основным достоинством приспособления является именно лёгкость его подключения: участнику Традиции нет надобности править свои служебные файлы, вместо этого достаточно поставить галочку в настройках.

Следующие особенности приспособлений могут считаться их недостатками:

• Параметры работы некоторых приспособлений можно изменять. Однако для этого участнику Традиции всё же придётся редактировать свой monobook.css или monobook.js — так что, хотя приспособления в подключении значительно проще традиционных элементов персонального оформления, в донастройке они не проще.

• Обычные элементы персонального оформления можно было увидеть на странице monobook.css или monobook.js участника Традиции — а вот галочки в настройках, которыми приспособления подключаются, так просто увидеть нельзя. Недостаток этой особенности состоит в том, что нельзя легко выяснить, насколько то или иное приспособление популярно среди участников Традиции, а достоинство в том, что у участников больше личной жизни ;-)

• Изменения в приспособления могут вноситься только администраторами. Недостаток этой особенности состоит в том, что автору приспособления (если только сам он не администратор) труднее отлаживать и исправлять и развивать и пополнять своё приспособление (придётся всякий раз обращаться к администрации с просьбой о внесении изменений в код приспособления); достоинство же в том, что только доверенные лица (администраторы проекта) имеют доступ к приспособлению, так что зловредное изменение скриптов (скажем, для слежения за участниками или для захвата чужих учётных записей) становится куда менее вероятным.

Список приспособлений

Полный список приспособлений располагается на странице Служебная:Gadgets.

Составные части приспособлений задаются администраторами на странице MediaWiki:Gadgets-definition.

Описания своих приспособлений вы можете оформлять как подразделы страницы Традиция:Описание приспособлений.

Технические подробности и примеры

Список всех существующих приспособлений задаётся на странице MediaWiki:Gadgets-definition. Приспособления, там определённые, появляются на вкладке «Приспособления» в настройках участников Традиции, чтобы те могли отмечать надобные им приспособления. Обзорный список приспособлений также появляется на странице Служебная:Gadgets вместе со ссылками на соответствующие системные сообщения (для удобства редактирования).

Каждая строка в MediaWiki:Gadgets-definition, которая начинается одним (или более) символом «*» (звёздочкою), определяет одно приспособление; она должна иметь такой вид:

 * mygadget|mygadget.js|mygadget.css

То есть каждая строка состоит из нескольких значений, разделённых символом «|». Первое значение («mygadget» в данном примере) станет системным именем приспособления, и к нему относится системное сообщение (в данном примере — «MediaWiki:Gadget-mygadget»), в которое надобно поместить краткое описание приспособления (в таком описании можно использовать вики-разметку). Как раз оно, это описание, и появится возле той галочки в настройках, которая соответствует приспособлению.

Системное имя приспособления должно начинаться с латинской буквы, и может содержать только латинские буквы и (или) цифры!

Остальные значения в этой строке содержат окончания имён тех файлов, составленных на языке JavaScript и (или) CSS, из которых состоит приспособление, и которые содержатся в системных сообщениях (под именем «MediaWiki:Gadget-mygadget.js» и «MediaWiki:Gadget-mygadget.css» в данном примере); окончания эти должны беспременно оканчиваться на «.js» или «.css», в зависимости от языка.

Приспособление может состоять из какого угодно количества таких сообщений; и, в частности, некоторый общий код может использоваться несколькими приспособлениями в дополнение к их собственному особенному коду, как «MediaWiki:Gadget-commonStuff.js» вот в этом примере:

 * frobinator|commonStuff.js|frob.js|frob.css|pretty.css
 * l33t|commonStuff.js|tools.js|l33t.js

Список приспособлений на странице MediaWiki:Gadgets-definition может разделяться на разделы и подразделы при помощи строк, которые начинаются и заканчиваются двумя или более последовательными знаками равенства («=») — а середина такой строки должна содержать окончание названия того системного сообщения, в котором задано название раздела или подраздела. Например, вот так:

 == editing-gadgets ==

Этот пример определяет новый раздел на вкладке «Приспособления» в настройках, а название раздела будет взято из системного сообщения MediaWiki:Gadget-section-editing-gadgets.