Традиция:Приспособления
Сообщество: Портал • Разговоры • Голосования • Опросы • Администрация • Активность • События • Пожертвования •  Telegram •  ЖЖ
| ||
| Запросы: к администраторам • к бюрократам • изменение прав • на защиту, объединение, переименование и удаление страниц • на скрытие их версий • на проверку участников • к посредничеству • на комментирование • на источники • о саморекламе | ||
| Оценка: Примечательные статьи | ||
| Техническая поддержка • Приспособления • Личные скрипты и оформление • Ботоводство • К загрузке | ||
| Проекты: Работа недели • Патруль • О Википедии • Тематические: РБ, ГпР, Словарик • Авторские: АПЭ, ТСДНЭ | ||
| ||
| Новые темы добавляйте внизу, пожалуйста. | ||
|---|---|---|
Приспособле́ние (англ. 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.