FANDOM


RecentChangesMultiple прызначаны для адначаснага маніторынгу некалькіх вікі, дазваляючы на адной вікі праглядаць усе змены. Хоць гэты скрыпт зроблены як мага бліжэй да стылю стандартных свежых правак, існуе шмат тонкіх адрозненняў (гл. Нататкі ніжэй).

Гэта прылада распрацавана ў першую чаргу для вікі менавіта на ФЭНДОМЕ, але павінен працаваць і для вікі на іншых хостынгах па змаўчанні і мае некаторыя налады для апрацоўкі адменных выпадкаў для пэўных «нефэндомаўскіх» вікі (прыкладам, «&scriptdir=» ніжэй). Пры даданні вікі, не змесцаваных на ФЭНДОМЕ, важна адзначыць, што гэты скрыпт прызначаны для вікі, працоўных на MediaWiki, і патрабуе, каб Mediawiki API быў улучаны на вікі для карэктнай працы скрыпту.

Пераклады ці паведамленні пра багі могуць быць апублікаваны на старонцы абмеркавання (але таксама абавязкова паведаміце аўтару Fewfre (на ангельскім), каб выправіць абмылу як мага хутчэй).

Гэты скрыпт можна знайсці на Github, разам з часопісам змен з версіі 1.2.0.

HTTPS

Калі гэты скрыпт запушчаны на вікі з улучаным HTTPS, вы не зможаце загружаць кантэнт з вікі, якія скарыстаюць HTTP. Гэта функцыя бяспекі, улучаная браўзарам. У наш час гэта можа выклікаць праблемы пры выкарыстанні на неангельскіх вікі, бо неангельскія вікі ў наш час не скарыстаюць пратакол HTTPS, а ангельскія вікі скарыстаюць (неангельскія вікі скарыстаюць HTTPS, калі ля вікі ўнікальны дамен, без выкарыстання моўнага прэфікса). У наш час гэту праблему можна вырашыць так:

  • Запусціце гэты скрыпт на вікі, што выкарыстоўвае HTTP.

Пасля таго, як HTTPS будзе ўлучаны на ўсіх вікі, гэта праблема будзе выпраўлена.

Гэта праблема будзе па-ранейшаму ўплываць на некаторыя «нефэндомаўскія» вікі, аднак гэта будзе працягвацца і на HTTP. На дадзены момант гэту праблему можна вырашыць памянёным вышэй спосабам, але як толькі HTTPS будзе ўлучаны на ўсіх вікі, «нефэндомаўскія» вікі больш не змогуць загружацца датуль, пакуль не будуць абноўлены да пратакола HTTPS.


Усталёўка

Асноўнае прызначэнне

Усё, што сапраўды патрэбна пасля ўсталёўкі скрыпту, — гэта div з класам «rc-content-multiple» і спісам маркераў са спасылкай на дамен вікі (div трэба будзе дадаць праз рэжым выточнага кода). Паўторы ігнаруюцца. Прыклад:

<div class="rc-content-multiple">
*runescape.wikia.com
*wowwiki.com
*dev.wikia.com
</div>

Не паказвайце пратакол http:// ці https:// перад даменам вікі.

Асноўныя функцыі

Хоць яны не з'яўляюцца часткай Службовая:RecentChanges, некаторыя дадатковыя функцыі ўлучаны па змаўчанні.

  • AjaxRC: На грунце скрыпту AjaxRC ёсць опцыя «аўтаабнаўлення», якая пры актывацыі будзе абнаўляць спіс кожныя 60 секундаў. Файл cookie выкарыстоўваецца для захавання налады сцяжка пасля зграя.
    • Пасля актывацыі вам будзе прапанавана актываваць апавяшчэнні HTML5 (неабавязкова), якія будуць паведамляць вам пра абнаўленні, калі вы пераходзіце ад акна/укладкі. Каб адключыць іх пасля ўлучэння, пстрыкніце значок шасцярэнькі ў апавяшчэнні.
  • RecentChangesMultiple AjaxDiff icon AjaxDiff: На грунце скрыптоў AjaxDiff/LastEdited, вы можаце прагледзець «розніцу версій» старонкі, не пераходзячы на іх, націснуўшы значок справа ад спасылкі «розн».
  • RecentChangesMultiple AjaxGallery icon AjaxGallery: Пстрыкнуўшы па значку малюнка поруч з зменамі файлаў (няхай гэта будзе часопіса загрузкі, праўкі старонкі файла), вы можаце прагледзець выяву, з якой яно злучана. Для групавых часопісаў вы можаце прагледзець галерэю ўсіх выяў у спісе.
  • RecentChangesMultiple AjaxPagePreview icon AjaxPagePreview: Дазваляе праглядаць старонку, не выходзячы з бягучай старонкі.
    • Нататка: Гэта функцыя непаўнавартасная. У перадпраглядзе не запускаюцца некалькі файлаў CSS і JS. Такім чынам, перадпрагляд скарыстае толькі CSS з бягучай вікі для адлюстравання старонак. У браўзарах, што падтрымваюць рэдагаванне shadow dom (Chrome на момант напісання гэтага) ці хмарных стыляў (Firefox), ужываецца карыстацкі css з вікі (common.css), а таксама JS (для shadow dom), хоць яшчэ не ўсё.
  • Абмеркаванні: На грунце скрыпту DiscussionsFeed, зараз вы можаце бачыць Абмеркаванні у спісе правак. Гл. ніжэй для атрымання інфармацыі пра розныя нюансы.
  • Панэль спасылак вікі: Каб палегчыць навігацыю па пэўнай вікі ў спісе, націск аднаго са значкоў у падзеле «Загружаныя вікі» у верхняй частцы скрыпту/уздоўж левай часткі скрыпту дасць вам спіс спасылак на некаторыя агульныя старонкі для гэтай пэўнай вікі, а таксама некаторыя статыстычныя дадзеныя для гэтай вікі. Калі ў спісе толькі адна вікі, гэта панэль адкрыецца па змаўчанні.
  • Некалькі асобнікаў: Некалькі асобнікаў («кантэйнеры») могуць запускацца на адной старонцы.
    • Сюды ўваходзяць тыя, якія знаходзяцца ў межах тэгаў <tabber> і <tabview>.
    • Магчыма, што кожны асобнік загружае толькі адну вікі, што дазваляе стварыць больш тыповы дызайн RecentChanges, усё яшчэ праглядаючы трохі вікі на адной старонцы. Таксама магчыма абнавіць усе асобнікі, скарыстаючы функцыю rcm-refresh-all.
    • Майце на ўвазе, аднак, што некаторыя з дадатковых параметраў ніжэй правяраюцца толькі ў першым асобніку і ўплываюць на ўсё вікі на старонцы (data-lang, data-hiderail, data-loaddelay, data-timezone).

Дадатковыя параметры

Тым часам як вышэйапісанае працуе, і гэта ўсё, што можа спатрэбіцца, ёсць таксама мноства іншых дадатковых параметраў, якія можна дадаць трыма спосабамі: 1, які ўплывае на кожны RCM, 1, які ўплывае на кожную вікі ў пэўным спісе RCM, і той, які ўплывае на пэўную вікі.

Зменныя URL

Гэта ўплывае на кожны RCM на старонцы. У наш час адзінымі прынятымі зменнымі URL з'яўляюцца тыя, якія выкарыстоўваюцца на стандартнай старонцы RecentChanges. Гл. больш ніжэй.

прыклад: http://yourwiki.wikia.com/wiki/RecentChangesMultiplePage?hidemyself=1&days=7

Дадзеныя

Яны ўплываюць на кожную вікі/скрыпт у цэлым для аднаго тэга.

Назва Мяркуецца Па змаўчанні Апісанне
data-params= Параметры RC у URL-адрасе - Дакладныя параметры, якія вы скарысталі б на старонцы Службовая:RecentChanges без "?" пасля назвы (ex: hidemyself=1&days=10&limit=50). Гл. больш ніжэй.
data-hideusers= Спіс, падзелены коскамі - Спіс удзельнікаў, якім вы хочаце схаваць змены на ўсіх вікі, падзелены коскамі. Не скарыстайце прэфікс «Удзельнік:», прабелы ж могуць быць улучаны да/пасля косак (калі патрабуецца прабел/падкрэсленне ў імёнах удзельнікаў).
data-timezone= Радок utc Па змаўчанні гэты сцэнар адлюстроўвае даты ў фармаце UTC. Калі для гэтага атрыбута ўсталявана значэнне «local», паказаныя часовыя інтэрвалы будуць заснаваны на часе, што вызначаецца браўзарам.
data-autorefresh= Цэлы лік 60 Колькасць секундаў чакання скрыпту для аўтаматычнага абнаўлення (калі сцяжок абнаўлення пастаўлены). Кожны лік вышэй 0 з'яўляецца дапушчальным. Звернеце ўвагу, што час адлічваецца пасля таго, як абнаўленне спіса цалкам завершана, і ўсе вынікі былі дададзены.
data-autorefresh-evenOnFocus= Лагічнае значэнне true Калі аўтаабнаўленне ўлучана, па змаўчанні ён абновіць скрыпт, нават калі ў наш час вы адкрываеце старонку і чытаеце/праглядаеце праўку. Бо гэта можа раздражняць некаторых удзельнікаў, дадзеная опцыя (калі ўсталявана «false») дазволіць вам запабегчы абнаўленне скрыпту, калі вы адкрылі якое-небудзь акно.
data-notifications-hideusers= Спіс, падзелены коскамі - Спіс удзельнікаў, аб якіх вы не хочаце атрымваць абнаўленні на ўсіх вікі, падзелены коскамі. Не скарыстайце прэфікс «Удзельнік:», прабелы ж могуць быць улучаны да/пасля косак (калі патрабуецца прабел/падкрэсленне ў імёнах удзельнікаў).
data-discussions-enabled= Лагічнае значэнне true Спісы з Абмеркаваннямі на вікі-праектах ФЭНДОМА для кожнай вікі. Усталюеце значэнне «false» для адключэння. Гл. ніжэй дадатковую інфармацыю.
Паказаць/схаваць дадатковыя параметры (неабавязкова для большасці ўдзельнікаў)
Пашыраныя опцыі
Назва Мяркуецца Па змаўчанні Апісанне
data-lang= Код мовы auto-detect Гэта мова, што выкарыстоўваецца пры перакладзе тэксту ў скрыпце. Па змаўчанні гэты скрыпт скарыстае мову, усталяваная ў вашых карыстацкіх наладах (ці мова вікі, калі вы – ананім), для адлюстравання змесціва на вашай мове, калі ён падтрымваецца, ці «en», калі мова не падтрымваецца (з выняткам тэксту RecentChanges, які бярэцца наўпроста з сервера і заўсёды павінен падтрымвацца). Для тых, чыя мова не падтрымваецца, але няма жадання скарыстаць ангельскі, трэба ўсталяваць гэты двухлітарны код мовы («fr», «pl» і г. д.).
data-onlyshowusers= Спіс, падзелены коскамі - Калі спіс удзельнікаў існуе, скрыпт будзе паказваць змены толькі гэтым удзельнікам, хаваючы ўсе змены для астатніх. Не скарыстайце прэфікс «Удзельнік:», прабелы ж могуць быць улучаны да/пасля косак (калі патрабуецца прабел/падкрэсленне ў імёнах удзельнікаў).
data-ajaxlinks= Лагічнае значэнне false Усталюеце значэнне «true» для ўлучэння. Калі ўлучана, розныя спасылкі будуць паводзіць сябе аднолькава па кліку на іх значок: спасылкі «розн.» і «змены» адкрыюць ajax diffs і «Часопіс загрузак» і імёны файлаў (калі яны не знаходзяцца ў часопісе і ў іх ёсць старонкі, якія былі зменены) адкрые AJAX-галерэю.
data-hiderail= Лагічнае значэнне true Па змаўчанні кожная старонка, якая складаецца з тэга div з класам «.rc-content-multiple», будзе мець утоены блок у правай частцы старонкі (таму яна займае цэлую старонку, прыкладам, як звычайны RC). Гэты параметр з'яўляецца проста спосабам скасаваць працу функцыі, калі гэта трэба, калі параметр роўны «false».
data-autorefresh-enabled= Лагічнае значэнне false Калі cookie не прысутнічае, гэта вызначае, ці ўлучана функцыя аўтаматычнага абнаўлення па змаўчанні. Усталёўка яго ў значэнне «true» уключыць па змаўчанні.
data-loaddelay= Лік 10 Час (у мілісекундах), каб пачакаць паміж загрузкамі вікі. Адзіны выпадак калі час патрабуецца павялічыць, — гэта загрузка вялікага колькасці вікі (100+), каб пазбегнуць абмежавання нагрузкі і часова заблакаваць старонку.
data-extraLoadingEnabled= Лагічнае значэнне true Бо не ўся інфармацыя можа быць атрымана пры выточным выкліку (бо для гэтага патрабуецца выточная інфармацыя), яна загружаецца пасля дадання ўсяго змесціва на экран. Бо гэта не з'яўляецца строга патрэбным, гэта дае магчымасць адключыць яго (магчыма, каб абмежаваць серверныя выклікі ці сэканоміць на прапускной здольнасці). У наш час гэта патрэбна для:
  • Адлюстраванне загалоўкаў форумаў/сцен абмеркавання, а таксама выпраўленне спасылкі на старонку.
  • Адлюстраванне загалоўкаў Абмеркаванняў.
  • Даданне класаў карыстацкіх спасылак для груп карыстачоў/калі карыстач заблакаваны
data-localSystemMessages= Лагічнае значэнне true Некаторыя вікі-сайты абмежаваны публічным доступам, улучаючы API вікі. Хоць звычайна гэта не мае значэння, калі не кантраляваць яго, запуск гэтага скрыпту на такой вікі прадухіляе доступ да сістэмных паведамленняў, якія скрыпт скарыстае для падтрымкі мовы. Усталёўка гэтага параметра на «false» прымусіць заміж гэтага атрымваць сістэмныя паведамленні з Вікі Супольнасцяў. Гэта неабавязковы параметр, калі вы запускаеце скрыпт на ангельскай мове. Гэта «true» па змаўчанні, бо сістэмныя паведамленні для вікі могуць быць персаналізаваны, а выкарыстанне лакальных дазваляе скрыпту скарыстаць іх (для задавальнення/узгодненасці), а таксама для выдалення вонкавых залежнасцяў.
Прыклад

наборы дадзеных ідуць наўпроста ў div, прыкладам:

<div class="rc-content-multiple" data-params="hidemyself=1&days=10&limit=50" data-hideusers="TestUser,My awesome username,ILikePIE">
*list of wikis
</div>

Ля элементаў спіса

Кожны элемент у спісе павінен пачынацца з URL-адрасы вікі ў фармаце «name.wikia.com» (ці lang.name.wikia.com ці «wikiname.com» (ці іншага дамена верхняга роўня), калі ля вікі ёсць дамен «wikia»). Не ўлучайце «http://» і ўсё, што пасля, ці ўлучаючы першы «/» у корані.

Яны дазваляюць наладжваць пэўныя вынікі вікі, заміж таго каб патрабаваць, каб для кожнай вікі выкарыстоўваліся адны і тыя ж параметры.

Ля кожнага элемента спіса могуць быць дададзены параметры пасля яго ў фармаце «&paramname=», каб дадаць дадатковыя функцыі для адлюстравання/загрузкі ад гэтай вікі.

Назва Чаканае значэнне Значэнне па змаўчанні Апісанне
&params= Налады Свежых правак у URL - Тое ж, што і data-params, з выняткам таго, што «&» s павінны быць пераўтвораны ў коскі («,»), роўна «=» і двукроп'і («:»). Гл. таксама Налады СП ніжэй.
&hideusers= Спіс, падзелены коскамі - Падобна параметру «data-hideusers=» вышэй, ён прымае спіс удзельнікаў, падзелены коскамі, але заміж гэтага яны хаваюцца толькі для паказанай вікі. Не ўлучайце прэфікс «Удзельнік:».
&onlyshowusers= Спіс, падзелены коскамі - Падобна «data-onlyshowusers=» вышэй, ён прымае спіс удзельнікаў, падзелены коскамі, але заміж гэтага запускаецца толькі для паказанай вікі. Не ўлучайце прэфікс «Удзельнік:».
&notifications_hideusers= Спіс, падзелены коскамі - Падобна «data-notifications-hideusers=» вышэй, гэта прымае спіс удзельнікаў, падзелены коскамі, але заміж гэтага ён запускае толькі для паказанай вікі. Не ўлучайце прэфікс «Удзельнік:».
&notifications_enabled= Лагічнае true Усталюеце значэнне «false», каб вымінуць занясенне змен у гэту вікі пры адпраўленні апавяшчэнняў. Нататка: калі вы хочаце адключыць апавяшчэнні для ўсяго скрыпту, не скарыстайце налады скрыпту; заміж гэтага скарыстайце свой уласны браўзар, каб адключыць апавяшчэнні, якія вы прынялі (звычайна гэта значок шасцярэнькі пры ўсплывальным апавяшчэнні).
Прыватныя выпадкі для карэктнага адлюстравання вікі
&scriptdir= Тэкставае - (для нефэндомаўскіх вікі) Падкаталог скрыптоў вікі павінен мець доступ да API. Сканчэнне «/» не павінна ўлучацца. Па змаўчанні скрыпт правярае корань дамена (бо ён знаходзіцца на ФЭНДОМЕ), але для некаторых вікі ён можа быць нечым іншым (папулярнымі каталогамі з'яўляюцца «/ w» і «/wiki»). Лёгкі спосаб знайсці каталог API вікі - гэта ўвесці «console.log(mw.config.get("wgScriptPath"));» у кансолі вашага браўзара на гэтай адпаведнай вікі. Ці для новых вікі, перайдзіце на старонку Службовая:Version і выберыце «Script path».
&username= Тэкставае - Гэта «патрабуецца» толькі для нефэндомаўскіх вікі. Бо імёны ўдзельнікаў на вонкавых вікі невядомыя, гэта дазваляе паказваць іх. Гэта дазваляе «hidemyself» працаваць, а таксама выяўляць мае рацыю ўдзельнікаў (для адлюстравання спасылак на блакаванне і г. д.). Калі вам не падабаюцца гэтыя функцыі, іх можна апусціць. Калі паказана вікі на ФЭНДОМЕ, гэта не патрабуецца, бо яна правярае зарэгістраванага карыстача (хоць, калі ў вас розныя ўліковыя запісы для розных вікі FANDOM, гэта можа быць скарыстана).
&favicon= URL (без прэфікса http://) - Замяняе значок, што выкарыстоўваецца для вікі, паказаным. Проста пакажыце поўны URL-адрас без прэфікса «http://». Прызначаны для вікі, ля якіх не значкоў, ці калі па змаўчанні ён занадта падобен на значок іншай вікі ў спісе.
&bgcolor= Фон CSS - Калі ўсталявана, апошнія змены для гэтай вікі будуць адлюстроўвацца за гэтым фонавым колерам (заміж favicon tiled). Кожнае сапраўднае значэнне «background» CSS будзе працаваць (нават none, rgb() ці url()). Таксама можна наладзіць іншыя значэнні, прывязваючы CSS (прыкладам: &bgcolor=orange;opacity:0.5). Па змаўчанні непразрыстасць bgcolor складае 0,1.
Прыклады
<div class="rc-content-multiple">
*fewfre.wikia.com&hideusers=Fewfre,FewBot
*wiki.guildwars2.com&favicon=wiki.guildwars2.com/images/thumb/d/df/GW2Logo_new.png/180px-GW2Logo_new.png
*pixelmonmod.com&scriptdir=wiki&params=hidemyself:1,limit:5
</div>

Панэль параметраў

Прапануе спосаб налады параметраў «data-params =» у рэжыме рэальнага часу. На панэлі параметраў ёсць параметр для запамінання параметраў, якія вы змянілі з дапамогай localStorage (па змаўчанні адключана). Кожныя параметры, змененыя да ўлучэння гэтай функцыі, таксама будуць запомнены. Паўторны націск гэтай кнопкі прывядзе да выдалення інфармацыі са сховішча. Адзін з вышэйпаказаных метадаў варта скарыстаць, калі вы хочаце, каб змены захоўваліся на іншым кампутары/без выкарыстання localStorage. Панэль параметраў таксама дазваляе ўлучаць/выключаць Абмеркаванні.

З-за таго, што гэтыя параметры змяняюць вымогі да дысплэя, усе бягучыя змены, пералічаныя на старонцы, будуць вычышчаны, а потым абноўлены.

Параметры СП

Каб дапамагчы атрымваць спіс Службовая:RecentChanges як мага больш, гэты скрыпт прымае RC-стыль параметраў URL (выкарыстоўваецца, як апісана вышэй, з параметрамі «data-params», «&params», URL-зменнымі ці панэллю параметраў). Існуе трохі параметраў, як апісана ніжэй. Калі ласка, не рабіце, каб кожны эфект кожнай вікі быў індывідуальным (так што абмежаванне 50 для 4 вики фактычна абмежавана сумай 200).

Ёсць 4 спосабы паказаць параметры ў скрыпце. Калі паказана больш за адзін, яны будуць «праточвацца», прытым больш пэўная перапісвае менш пэўную (прыкладам: «&params» больш пэўна, чым «data-params»), але толькі калі яны абодва змяняюць адно і тое ж (прыкладам, «days»). Парадак спецыфічнасці такі:

  1. [Значэнні па змаўчанні]
  2. Зменныя URL – такое ж, як звычайная старонка RecentChanges.
  3. data-params
  4. Панэль параметраў (параметры часу выканання)
  5. &params (звернеце ўвагу, што «панэль параметраў» не будзе перазапісваць іх)

Звернеце ўвагу, што для лагічных перамыкачоў «true/false» значэнне «0» роўна false, а «1» — true.

Даступныя параметры
Параметр Значэнне па змаўчанні Апісанне
limit 50 Гэта можа быць кожны цэлы лік ад 0 да 500. (можа быць менш у залежнасці ад «days»)
days 7 Колькасць дзён. (можа быць менш у залежнасці ад «limit»)
hideminor 0
(false)
Хавае праўкі, адзначаныя як «малыя»,
hidebots 1
(true)
Хавае праўкі, зробленыя ботам
hideanons 0
(false)
Хавае праўкі, зробленыя ананімамі.
hideliu 0
(false)
Хавае праўкі, зробленыя зарэгістраванымі ўдзельнікамі.
hidemyself 0
(false)
Хавае змены, выкананыя з уліковага запісу, у які вы ўвайшлі. Нататка: «hide-users=» будзе перакрываць гэты параметр (нават пры выкарыстанні панэлі параметраў). Таксама звернеце ўвагу, што для вонкавага вікі трэба скарыстаць «&username=» (гл. вышэй), каб гэта працавала.
hideenhanced 0
(false)
Не паказвае трохі правак адной старонкі, а паказвае кожную праўку ў тым парадку, у якім яна была выканана. Нататка: не падтрымваецца на грунце «вікі-ад-вікі» (усё ці нічога).
hidelogs 0
(false)
Хавае часопісы.
namespace none Па змаўчанні адлюстроўваюцца ўсе прасторы імёнаў. Адлюстроўваныя прасторы імёнаў могуць быць абмежаваны даданнем нумара прасторы імёнаў для адлюстравання. Калі павінна адлюстроўвацца некалькі прастор імёнаў, яны павінны быць падзелены знакам «|», без прабелаў (прыкладам: 1|10|2001, каб паказваць толькі тэмы абмеркаванняў артыкулаў, шаблонаў і і тым форума)
Непадтрымоўваныя параметры
from, invert, associated, tagfilter, hidewikidata і кожныя іншыя, не пералічаныя.

Не саромейцеся запытваць падтрымку непадтрымоўванага параметра для дадання, калі вам гэта патрэбна; усё павінна быць больш-менш магчымым.

Дадатковыя функцыі

Абнавіць усё

  • Калі вы скарыстаеце некалькі асобнікаў на адной старонцы, усе яны могуць быць абноўлены адразу, падаўшы клас «rcm-refresh-all» для элемента на старонцы. прыкладам:
<span class="rcm-refresh-all button">Абнавіць усё</span>

Афармленне CSS

Гэты скрыпт скарыстае як мага больш за класы RecentChanges па змаўчанні, каб дазволіць стылю быць паслядоўным. Большасць функцый, злучаных з RCM, таксама скарыстаюць імёны класаў, якія дазваляюць наладжваць. Некаторыя карысныя класы:

  • .rc-entry-$1 ахапляе цэлую групу ўводу/запісы, прытым $ 1 з'яўляецца URL з кропкамі ў выглядзе працяжніка (прыкладам: dev-wikia-com). Па змаўчанні выкарыстоўваецца стыль «.rcm-tiled-favicon», але яго можна скарыстаць для налады кожных дадзеных, выдатных ад іх вікі.
  • .rc-entry-ns-$1 ахапляе ўсю групу ўводу/запісы, прытым $1 з'яўляецца нумарам прасторы імёнаў (прыкладам: 0 для асноўнай прасторы, 1 для абмеркаванняў і г. д.).
  • .rcm-favicon-goto-button уяўляе значок злева ад кожнага запісу. Можа выкарыстоўвацца для змены/выдаленні значка.

Датуль, пакуль «data-extraLoadingEnabled» не будзе адключана, карыстацкія спасылкі таксама маюць атрыбуты, дададзеныя пасля атрымання дадзеных. .rcm-userblocked азначае, што ўдзельнік заблакаваны на гэтай вікі, .rcm-usergroup-$1 дазваляе наладжваць імёны на грунце групы ўдзельнікаў (з «$1», якая з'яўляецца ідэнтыфікатарам uniq для гэтай групы), і дадаецца .rcm-useranon для ананімных удзельнікаў. Тут вы можаце знайсці агульныя ідэнтыфікатары груп (пералічаныя як «group-$1»), і тут вы можаце знайсці спіс усіх груп (і праў, якія прыходзяць з імі, калі цікава); проста зменіце URL-адрас вікі, каб убачыць яго для вашай мэтавай вікі (калі ўдзельнік мае якія-небудзь правы). Прыкладам: .rcm-usergroup-content-moderator

Існуе мноства іншых класаў (або карыстацкіх, або класаў RecentChanges), якія можна скарыстаць для налады скрыпту. Лепшы спосаб знайсці іх — проста праверыць элемент, які вы хочаце наладзіць, і перайсці адтуль.

Абмеркаванні

Пад канец 2016 года ФЭНДАМ пачаў укараняць сваю сістэму Абмеркаванняў на новых вікі, паступова выцясняючы звыклыя форумы. Праўкі ў Абмеркаваннях не адлюстроўваюцца на старонцы Свежых правак, таму яны таксама ўлучаны ў скрыпт. За гэтым рушыла ўслед трохі нечаканых вынікаў:

  • Абмеркаванні ўлучаюцца па змаўчанні. Яго можна адключыць на панэлі параметраў ці праз атрыбут data-discussions-enabled.
  • Не ўсе тэмы ў Абмеркаваннях маюць назвы, таму, калі загаловак адсутнічае, першыя 35 знакаў выточнага паведамлення выкарыстоўваюцца для яго ідэнтыфікацыі.
  • Бо загаловак тэмы не ўлучаны ў інфармацыю ад API, вернутую для пэўнага паста, загалоўкі часта трэба здабываць асобна (скарыстаючы той жа механізм другой загрузкі, што і загалоўкаў тым на сцяне/форуме, гэтак жа як і гэта, бягучая функцыя можа быць адключана з дапамогай атрыбута data-extraLoadingEnabled.
  • Многія налады не ўплываюць на Абмеркаванні. Некаторыя з іх працуюць: hidemyself, hideusers, onlyshowusers, limit і days (дэталі гл. ніжэй).
    • Limit - толькі да 50. Будзе працаваць ліміт менш 50.
    • hidemyself / hideusers - паўплывае на максімальную колькасць тым у Абмеркаваннях, якія вы бачыце (бо частка тым будзе выдалена з загружанага спіса).
  • Гэтыя змены ў наладах загружаюцца у дадатак да нармальным зменам. Калі для ліміту ўсталявана значэнне менш ці роўна 50, гэта можа падвоіць вынікі, што адлюстроўваюцца для пэўнай вікі.
  • Абмеркаванні правяраюцца толькі на вікі на ФЭНДОМЕ (бо яны існуюць вылучна на ім). Тым не менш, першы раз, калі скрыпт загружае змены на вікі-праектах, яму трэба праверыць усё вікі, каб даведацца, ці існуюць Абмеркаванні там. Калі яны вернуць абмылу 404, спроба загрузіць гэту пэўную вікі не паўторыцца.
  • Бо API вяртае аватары і вынікі галасавання, гэта інфармацыя таксама ўлучана. Яе можна выдаліць з дапамогай карыстацкага CSS, скарыстаючы класы .rcm-avatar і .rcm-upvotes адпаведна.
  • З-за асаблівасцяў працы API праўка паведамленняў не адлюстроўваецца як асобная праўка. Заміж гэтага паведамленне будзе проста адлюстроўвацца вышэй у спісе (калі дата стварэння ўсё яшчэ знаходзіцца ў межах верхніх 50). Адзін з магчымых нечаканых пабочных эфектаў палягае ў тым, што калі нехта рэдагуе паведамленне на наступны дзень пасля яго стварэння, ён не будзе адлюстроўвацца абодва дні.

Пераклад

Гэты скрыпт пераводзіцца двума рознымі спосабамі:

  1. Тэкст скрыпту ("TEXT" у кодзе) — звычайны спосаб перакладу, таксама як і пераклад кожнага іншага скрыпту, які трэба абнаўляць ручна.
  2. Тэкст са старонкі Свежых Правак ("MESSAGES" у кодзе) — гэта робіцца аўтаматычна, загружаючы тэкст, што звычайна знаходзіцца на старонцы Службовая:RecentChanges з сервера. Кожная мова, што падтрымваецца ФЭНДАМАМ, павінна падтрымвацца гэтым скрыптам для такога тыпу перакладу.

JS-файл для перакладаў можна знайсці на Github; пераклады таксама могуць быць апублікаваны на старонцы абмеркавання ці тут. Перавядзіце толькі першы падзел «TEXT», а не «MESSAGES».

Вялікі дзякуй чальцам Моўнай Брыгады Вікія за вялікую колькасць перакладаў, зробленых для гэтага скрыпту!

Гісторыя змен

Гл. часопіс змен для дэталёвых змен ці старонкі гісторыі для кожнага скрыпту (/code.js для V1.0.3 і папярэдніх, /code.2.js для V1.1.7 і папярэдніх і /core.js для бягучага).

  • 14 лютага 2015 – Гатова альфа-версія (з наступным перапынкам).
  • 22-27 траўня 2015 – Гатова бэта-версія.
  • 28 чэрвеня 2015 – Скрыпт апублікаваны.
  • V1.1.0 – 26 ліпеня 2015 – Кодаў перапісаны для выкарыстання API MediaWiki (гл. ніжэй).
  • V1.2.0 – 12 снежня 2015 – Зараз скрыпт скарыстае загрузнік для загрузкі дадзены ў скрыпт.
  • V2.0 - 29 кастрычніка 2016 - Скрыпт перапісаны ў TypeScript.
  • V2.6 - 28 студзеня 2017 - Абнаўленне зараз толькі здабывае і дадае новыя элементы заміж таго, каб здабываць і паўторна дадаваць усе змены. Гэта дазволіць больш эфектыўна скарыстаць абмежаванні вялікай выбаркі.

26 ліпеня 2015 - ліставанне кода для API MediaWiki – V1.1.0

Паказаць дэталі

Асноўнымі мэтамі гэтага ліставання былі:

  1. Даданне аўтаматычнай падтрымкі перакладу тэксту Свежых правак.
  2. Выдаленне залежнасцяў ад YQL (інфармацыя, атрыманая наўпроста з вікі праз API). Гэта таксама спрыяе прыводзіць да хутчэйшай загрузкі.
  3. Скарыстаючы падтрымку API, пашырана падтрымка Службовая:RecentChanges (дробныя змены адзначаны, больш за кантроль над кантэнтам ("days", "limit", "showbots" і г. д.)).
  4. Ліставанне кода для таго, каб ён быў крыху больш эфектыўным.
  • Важныя нататкі:
    • "&subdir" выдалены і "&scriptdir" дададзены (можа запатрабавацца для нефэндомаўскіх вікі, гл. вышэй). Прыкладам: &scriptdir=w/
    • «data-params» зараз прапануе значна большую падтрымку. "days" і "limit" зараз працуюць да той жа сумы, што і для кожнай вікі у спісе. Такім чынам, гэта павінна быць абмежавана некалькімі днямі / ніжняй мяжой, каб пазбегнуць загрузкі патэнцыйна некалькіх тысяч змен. Асобныя вікі могуць мець гэтыя абмежаванні, змененыя з дапамогай «&params»
  • Змены:
    • Зменены пераклад, каб скарыстаць дакладнейшую інфармацыю i18n са старонкі GitHub на ФЭНДОМЕ для RC_TEXT. Загружае RC_TEXT з сервера на грунце вашай мовы.
    • Асноўныя тэмы форума/сцены зараз таксама правяраюцца [аднаўленне, выдаленне, пераназванне] для «адказаў», заміж таго, каб чытаць іх цаліком як адну тэму.
    • Усе (нармальныя) параметры Свежых правак падтрымваюцца, за выняткам «hideenhanced», «from» і прагляду абранай прасторы імёнаў.
    • Зараз праўкі ботаў могуць быць паказаны (адключана па змаўчанні), і адзначаны як «малыя» праўкі.
    • Параметр gApp ператварыўся ў клас RecentChangesMultiple (каб патэнцыйна запускаць трохі па якой-небудзь прычыне, плюс аўтар аддае перавагу «традыцыйныя» структуры класа OO)
      • Такім чынам, #rc-content-multiple id зараз павінен быць класам .rc-content-multiple, каб дазволіць некалькі асобнікаў (хоць выкарыстанне ідэнтыфікатараў па-ранейшаму падтрымваецца)
    • Дадатковыя CSS-класы для старонкі Свежых правак.
    • Перапісаны параметры ў спісах СП (каб прыўнесці крыху больш за інфармацыю пра тое, як гэта выглядае ў сістэме mw)
    • Новы клас «WikiData» для захоўвання дадзеных, спецыфічных для вікі, больш зразумелай выявай, а таксама падаванне дапаможных метадаў

Нататкі

  • «Чырвоныя спасылкі» для старонак, якія не існуюць, не будуць адлюстроўвацца ў большасці часопісаў, бо гэту інфармацыю трэба будзе здабываць асобна для кожнай старонкі. Па змаўчанні яны адлюстроўваюцца чырвоным колерам.
  • Патруляванне не падтрымваецца ў наш час. Гэта злучана з абаронай MediaWiki, якая забараняе доступ да інфармацыі пра патруляванне, калі яна не дазволена (строга парушае працу скрыпту, калі ён спрабуе атрымаць яе без дазволу). Нават калі права існуе, інфармацыя не можа быць атрымана з-за патрэбы ўваходу ў гэту вікі, якая недаступная з-за крос-дамена (скрыжаванні адрасоў розных вікі (для бяспекі браўзара)).
  • Часопісы:
    • Часопісы могуць рабіць дзіўныя рэчы ў «рэдкіх» выпадках (прыкладам, дзеяння толькі для супрацоўнікаў і рэдка дзеяння толькі для пашырэнняў). Іх падтрымка можа быць дададзена, але яна не ўлучана па змаўчанні, бо кожны з гэтых параметраў павінен быць правераны ручна для кожнага тыпу дадзеных (а часам і кожнага пэўнага дзеяння).
    • (Часопіс праў удзельніка) — мае рацыю будуць пералічаны з выкарыстаннем іх «id» заміж перакладу назвы групы ўдзельнікаў. Такім чынам, гэта будзе падобна на «sysop». Не ўсё вікі маюць аднолькавыя групы, таму атрыманне перакладаў ад кожнай вікі больш злучана з нечым вялікім.
  • Гэты скрыпт здабывае пераклады RecentChanges наўпроста з сервера, бо такія пераклады могуць адрознівацца пры выкарыстанні на нефэндомаўскіх вікі. Калі загрузка не атрымоўваецца даволі доўга, старонка проста па змаўчанні будзе на ангельскай мове.

Рознае

  • «http: //» не варта скарыстаць у гэтым скрыпце, каб ён аўтаматычна не рабіўся спасылкай (гэта замінае працэсу), і з'яўляецца на Службовая:LinkSearch як старонка з вонкавай спасылкай (можа быць непажадана).
  • Скрыпт прызначаны для вікі на ФЭНДОМЕ, але павінен працаваць для кожнай вікі (пры ўмове, што яе версія рухавічка не вельмі састарэла).
  • Некаторыя нефэндомаўскія вікі проста не працуюць з-за асаблівасцяў налад (старая версія MediaWiki, адключаны API і г. д.)
  • Скрыпт павінен запускацца з выкарыстаннем code.2.js. Хоць першая версія больш не падтрымваецца, выточную версію Atom-feed можна знайсці ў файле code.js з дакументацыяй, якую можна знайсці тут.

Вымогі

  • jQuery
  • Усе вікі ў скрыпце павінны:
    • Працаваць на рухавічку Mediawiki (версія не ніжэй 1.16)
    • Працаваць з падлучаным Mediawiki API.
  • Браўзар павінен падтрымваць ECMAScript5 (падыдзе кожная не вельмі старая версія браўзара)
  • Скрыпт павінен працаваць на вікі ФЭНДОМА (каб быць упэўненымі, што ён мае доступ да такіх рэчаў, як код для згортвання спісаў).