Вікісховище:Додатки

The Gadget tab of Preferences on French Wikipedia

Додатки, або гаджети — це стандартні користувацькі скрипти, що розширюють функціонал MediaWiki (програмне забезпечення, на якому працює Вікісховище), доступні для легкого встановлення через налаштування користувача. (Доступні також інші користувацькі скрипти, які треба встановлювати вручну.) Індивідуальні додатки можна вмикати або вимикати (деякі увімкнені за замовчуванням), відвідавши Ваші Налаштування (Вам треба перебувати в системі) і поставивши або прибравши відповідну галочку. Для роботи більшості додатків треба, щоб у Вашому браузері був увімкнений JavaScript.

Технічні деталі

Визначення

• MediaWiki:Gadgets-definition — це сторінка, через яку додатки встановлюються таким чином, щоб їх було видно в Налаштуваннях
  • Використання додатків може бути обмежене до користувачів із певними правами шляхом додавання, наприклад,rights=delete до визначення додатка. Гаджети можна робити стандартними (також і для незареєстрованих користувачів) шляхом додавання default. Використання додатків може бути обмежене до лише зареєстрованих користувачів шляхом додавання коду rights=upload.
• Спеціальна:Додатки надає загальні відомості про встановлені додатки, що містять посилання на файли скриптів цих додатків
• MediaWiki:Common.js підвантажує деякі скрипти автоматично

Локалізація

• Локалізація самих додатків, якщо необхідно, виконується декількома різними способами. Зазвичай це робиться в межах скрипту кожного гаджета, або з використанням окремої підсторінки (напр., MediaWiki:Gadget-HotCat.js/de), але в деяких випадках існує декілька мовних версій цілого скрипту. {{Gadget-talk}} категоризує локалізації, і якщо необхідно, поміщає скрипти в категорію Користувацькі скрипти, що потребують інтернаціоналізації.

• Локалізація описів додатків виконується шляхом створення підсторінок /xx основної (англомовної) сторінки опису скрипту (напр., MediaWiki:Gadget-Cat-a-lot і MediaWiki:Gadget-Cat-a-lot/fr). Спеціальна:Налаштування, завдяки {{Gadget-desc}}, забезпечує описи додатків посиланнями «перекласти це», що дещо полегшують завдання.

Шаблони

• {{Gadget-state}} містить деяку застарілу інформацію про додатки і його треба час від часу оновлювати. Зазначення поточного стану додатка є питанням, що розглядається у phab:T51501

• {{Gadget-desc}} стандартизує описи додатків (відображаються в Налаштуваннях)
• {{Gadget-help}} і {{Gadget-talk}} стандартизують шапки на сторінках довідки й обговорення додатків
• {{ActivateGadget}} і {{DeactivateGadget}} генерують посилання, які, при завантаженні, створюють діалогове вікно, яке запитує користувача, увімкнути чи вимкнути додаток
• Деякі додатки мають документацію щодо сумісності з різними браузерами, на підсторінці (напр., Help:Gadget-PrettyLog/Compatibility); це має загальний формат, але не шаблон

Обмеження

Починаючи з MediaWiki 1.18, з питань безпеки додатки (і користувацький CSS/JS) не завантажуються на деяких спеціальних сторінках. До таких сторінок належить і Спеціальна:Налаштування, що зруйнувало попередні способи розміщення додатків на інших ділянках сторінки Налаштувань. Див. phab:T20186. phab:T35220 — запит на заміну безпосередньо через MediaWiki того, що раніше робилося через Javascript.

Посилання

• Category:Gadget scripts
• Commons:User Scripts - проект для покращення додатків та інших користувацьких скриптів
• MediaWiki talk:Gadgets-definition - обговорення
• mw:Extension:Gadgets - розширення MediaWiki, що уможливлює використання додатків
• mw:Extension:Gadgets/Scripts - деякі додатки на mediawiki.org
• mw:ResourceLoader - програмний каркас додатків; V2, у розробці, бачить суттєві зміни; див. також phab:T31398 і phab:T22153
• Special:GadgetUsage показує кількість активних і неактивних користувачів, у яких увімкнені різні додатки