Open main menu

Extensie:WikiLove

This page is a translated version of the page Extension:WikiLove and the translation is 91% complete.

Outdated translations are marked like this.
Other languages:
Afrikaans • ‎Cymraeg • ‎Deutsch • ‎English • ‎Nederlands • ‎Türkçe • ‎azərbaycanca • ‎dansk • ‎español • ‎français • ‎magyar • ‎română • ‎русский • ‎ייִדיש • ‎עברית • ‎اردو • ‎العربية • ‎فارسی • ‎বাংলা • ‎සිංහල • ‎中文 • ‎日本語 • ‎한국어
Extensiile pentru MediaWiki
OOjs UI icon advanced.svg
WikiLove
Statutul de lansare: stabilă
WikiLove-screenshot-2014.png
Implementare User interface
Descriere E ușor să adăugați feedback pozitiv la paginile de discuții ale utilizatorilor
Autor(i) Ryan Kaldari, Jan Paul Posma, Brandon Harris (design)
Versiune recentă 1.2
MediaWiki 1.27+ - WikiLove master ar trebui să fie utilizat numai cu master's core; în caz contrar, utilizați sucursale potrivite (de exemplu, WikiLove REL1_27 cu core REL1_27 sau ramuri potrivite de lansare WMF).
Schimbările bazei de date Da
Licență MIT License
Descărcare
Parametrii
$wgWikiLoveGlobal
$wgWikiLoveTabIcon
$wgWikiLoveLogging
Hook-uri utilizate
GetPreferences
SkinTemplateNavigation
BeforePageDisplay
LoadExtensionSchemaUpdates
MakeGlobalVariablesScript
ListDefinedTags
ChangeTagsListActive
Traduceți extensia WikiLove dacă este disponibilă la translatewiki.net
Verificați utilizare și versiunea de matrix.
Probleme cauzate Sarcini deschise · Raportați probleme

WikiLove este o extensie proiectată pentru a promova raspândireaWikiLove în cadrul Wikipedia și posibil în alte wikiuri. Anume, face ca adăugarea de premii, cadouri și invitațiile în paginile de comunicare ale utilizatorului la fel de simplu ca și clicul a câtorva butoane.

Specifically, it makes adding awards, gifts, and invitations to user talk pages as simple as clicking a few buttons.

Contents

Descărcare

The extension can be retrieved directly from Git [?]:

  • Browse code
  • Some extensions have tags for stable releases.
  • Each branch is associated with a past MediaWiki release. There is also a "master" branch containing the latest alpha version (might require an alpha version of MediaWiki).

Extract the snapshot and place it in the extensions/WikiLove/ directory of your MediaWiki installation.

If you are familiar with git and have shell access to your server, you can also obtain the extension as follows:

cd extensions/
git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/WikiLove.git

Instalare

  • Descărcați și plasați fișierul(ele) într-un director numit WikiLove în directorul dvs. extensions/.
  • Adăugați următorul cod în partea de jos a setărilor locale (LocalSettings.php):
    wfLoadExtension( 'WikiLove' );
    
  • Rulați scriptul de actualizare care va crea automat tabelele bazelor de date necesare pentru această extensie.
  •   Realizat – Navigați la Special:Version pe wiki-ul dvs. pentru a verifica dacă extensia a fost instalată cu succes.

Dacă doriți să utilizați premiile încorporate, trebuie să aveți activat InstantCommons. Pentru aceasta, adăugați acest lucru la LocalSettings.php:

$wgUseInstantCommons = true;

Extensia ar trebui să fie acum activă. Accesați fila de editare din preferințele dvs. pentru a activa interfața.

De asemenea, puteți utiliza aceste opțiuni de configurare în LocalSettings.php:

  • $wgWikiLoveGlobal - activați extensia pentru toți utilizatorii, eliminând preferințele utilizatorului (implicit: fals)
    • Notă: puteți de asemenea să activați setarea în mod prestabilit, dar totuși să oferiți utilizatorilor opțiunea de al dezactiva ("opt-out") utilizând:
$wgDefaultUserOptions['wikilove-enabled'] = 1;
  • $wgWikiLoveTabIcon - utilizați o pictogramă pentru interfaţa care le susţine (adică Vector) (implicit: adevărat)
  • $wgWikiLoveLogging - activați logarea dării pe WikiLove (implicit: false); acest lucru creează automat un tabel de baze de date wikilove_log pe care îl puteți folosi pentru interogări statistice
WikiLove 1.0 supported MW 1.17+

Utilizare

Pentru a permite contului dvs. să utilizeze WikiLove, accesați fila de editare din preferințele dvs. și activați WikiLove sub "Funcțiile Labs" (sau, în unele versiuni, sub "Opțiuni generale").

Pentru a utiliza WikiLove, accesați pagina de discuții a utilizatorului și dați clic pe pictograma inimii. Urmați instrucțiunile de acolo.

Configurație personalizată

Pentru a afla cum să personalizați WikiLove pentru un editor individual (mai degrabă decât un întreg wiki), vedeți documentația utilizatorului

Puteți personaliza opțiunile pentru propriul dvs. wiki editând pagina MediaWiki: WikiLove.js. Aici puteți schimba configurația la fel ca în cazul opțiunilor încorporate: defaultOptions.js. Iată câteva exemple de configurații personalizate WikiLove: Malayalam Wikipedia, English Wikipedia, Wikimedia Commons, English Sturmkrieg.

Opțiunile din partea de sus a defaultOptions.js sunt câteva setări implicite pentru confortul dvs. Dacă omiteți anumite proprietăți din tipuri sau subtipuri, aceste valori implicite vor fi utilizate (defaultText, defaultBackgroundColor, defaultBorderColor, defaultImageSize, defaultImage). Apoi este lista de tipuri. Fiecare tip poate avea proprietățile name (obligatoriu) și icon (opțional). În plus, un tip poate avea o listă de subtipuri sau nu, caz în care proprietățile suplimentare vor fi atribuite tipului propriu-zis.

If you omit certain properties from types or subtypes, these defaults will be used (defaultText, defaultBackgroundColor, defaultBorderColor, defaultImageSize, defaultImage). Then there is the list of types. Each type can have the properties name (required) and icon (optional). Furthermore, a type can have a list of subtypes, or not, in which case the additional properties will be assigned to the type itself.

Dacă tipul are subtipuri, acestea sunt listate într-o listă de obiecte subtypes. Opțional, tipul poate avea și proprietatea select, care specifică eticheta de deasupra meniului derulant. Fiecare subtip poate avea următoarele proprietăți:

Optionally, the type can also have the property select, which specifies the label above the dropdown menu. Each subtype can have the following properties:

  • option - nume în meniul derulant
  • descr - Descriere când selectați subtipul
  • header - Antetul mesajului care se adaugă, adică partea care va fi între == ... ==
  • title - Titlul casetei de mesaj
  • text - Textul casetei de mesaj (vedeți mai jos pentru detalii)
  • image - Imaginea casetei de mesaj
  • gallery - Galerie pentru selectarea unei imagini (vedeți mai jos pentru detalii)
  • fields - Matricea de câmpuri pe care utilizatorul le poate edita; pot conține următoarele valori: header, title, image, message
  • imageSize - Dimensiunea imaginii (de exemplu, 100px)
  • backgroundColor - Culoarea de fundal (orice culoare validă CSS, de exemplu #fdffe7 or yellow)
  • borderColor - Culoarea marginii(la fel)

Atunci când nu se utilizează subtipuri, aceste opțiuni (cu excepția primelor două) trebuie adăugate la tipul însuși.

În câmpurile text și email (precum și în defaultText), puteți utiliza câteva coduri care vor fi înlocuite automat:* $1 - Mesaj de utilizator

  • $2 - Titlu
  • $3 - Nume imagine
  • $4 - Mărime imagine
  • $5 - Culoare fundal
  • $6 - Culoare margine
  • $7 - Numele de utilizator al destinatarului

Pentru a ușura selectarea imaginilor de către utilizator, puteți crea o galerie cu imagini predefinite. Pentru aceasta, creați o proprietate gallery, care are următoarele proprietăți:

  • imageList - O serie de nume de imagini
  • width - Lățimea maximă a imaginilor din galerie (în pixeli); pentru 3 imagini 145 este recomandat
  • height - Înălțimea maximă a imaginilor din galerie (în pixeli)
  • number - Numărul de imagini aleatorii afișate (opțional); dacă este omis, toate imaginile sunt afișate

Aveți posibilitatea să utilizați imagini de pe Wikimedia Commons, așa cum fac premiile implicite. Așa cum am menționat mai înainte, trebuie să activați InstantCommons pentru asta.

Eliminarea articolelor

Dacă doriți doar să eliminați unele dintre elementele WikiLove implicite, le puteți șterge din obiectul $.wikiLoveOptions. Iată câteva exemple pe care le-ați putea folosi în pagina wiki MediaWiki:WikiLove.js :

// Ştergerea Acte de Bunătate Aleatorii Barnstar din lista de barnstars
delete $.wikiLoveOptions.types.barnstar.subtypes.kindness;
// Ștergeți cheeseburger-ul din lista de alimente și băuturi
delete $.wikiLoveOptions.types.food.subtypes.cheeseburger;
// Ștergeți interfața pisoiilor în întregime
delete $.wikiLoveOptions.types.kitten;

Scăpări şi probleme

Dacă pagina de discuții pe care încercați să o editați conține un cuvânt care a fost ulterior adăugat la Special:SpamRegex, încercarea de a utiliza interfața pentru a adăuga un barnstar sau alt premiu va eșua. Aceasta deoarece pagina nu poate fi editată, deoarece conține un cuvânt interzis. Eliminarea cuvântului din pagină sau din filtru va remedia problema.

Documentare API

WikiLove folosește un API special wikilove pentru a posta mesaje către paginile de discuții ale utilizatorilor. API-ul este în esență doar un ambalaj subțire în jurul unor API existente. Dacă pagina de discuții a utilizatorului este o pagină Wikitext, acesta folosește API-ul de edit . Dacă este o pagină Flow, utilizează API flow . Și dacă este o pagină LiquidThreads, folosește API-ul threadaction .

Pentru a apela API, utilizați parametrul action=wikilove.

Parametri:

  • title - Titlul paginii de discuție a utilizatorului sau a utilizatorului pentru a trimite WikiLove la (obligatoriu)
  • text - Raw wikitext pentru a adăuga în noua secțiune (necesar)
  • message - Mesajul actual introdus de utilizator în scopul înregistrării (nu include imaginea și formatarea HTML)
  • token - Editați token. Puteți obține unul dintre acestea prin prop=info (necesar)
  • subject - Antetul subiectului din noua secțiune a paginii (necesar)
  • type - Tip de WikiLove (pentru statistici); acest lucru corespunde cu un tip selectat în meniul din stânga și, opțional, cu un subtip după acesta (de exemplu, "barnstar-normal" sau "pisoi") (opțional)
  • email - Conținutul mesajului opțional de e-mail pe care îl trimiteți utilizatorului

Exemplu:

 api.php?action=wikilove&title=User:Dummy&text=Love&subject=Hi&token=%2B\

Design pentru versiunea 1.0

 
Dialogul WikiLove la prima încărcare
 
Dialogul WikiLove la selectarea unei categorii de premii
 
Dialogul WikiLove la completarea detaliilor pentru un premiu
 
Dialogul WikiLove în modul previzualizare
 
Starea de hover pentru panoul de selectare a premiilor

Acest document descrie designul și comportamentul sistemului "WikiLove" de feedback pozitiv pentru Wikipedia. Acest instrument este conceput pentru a promova răspândirea WikiLove în Wikipedia. Mai exact, face adăugarea de premii și de cadouri paginilor de discuții ale utilizatorilor la fel de simplu ca și clicurile pe câteva butoane.

Argumentare

Wikipedia, ca o comunitate, are mai multe mecanisme de indicare a nemulțumirii sau de furnizare de feedback "negativ" utilizatorilor săi. Anumite gadget-uri, cum ar fi Twinkle, sunt puternic proiectate pentru avertizare, blocare și revenire.

Din moment ce Wikipedia are nevoie de armare pozitivă, în special pentru noii utilizatori, este dorit un sistem conceput în mod specific și numai spre feedback pozitiv.

Utilizarea stilului de poveste

Sistemul are un stil greu de "capriciu" pentru designul său. Acest lucru este intenționat și este destinat să se alinieze mai aproape de așteptările utilizatorilor site-urilor moderne. Mai mult, întregul principiu al "premiilor" este în sine însuflețit (de exemplu, cookie-uri și pisoi).

Acest stil poate fi abandonat pe baza feedback-ului utilizatorului.

Notă privind Nomenclatura

Unele tipuri de șabloane, cum ar fi șabloane de "Bine ați venit", tehnic nu sunt "premi".

Acest document foloșește termenul de "premiu" interschimbabil cu "format". Cum sistemul este focusat pe utilizator și nu este destinat direct utilizatorilor cu experiență, a fost folosit de catre utilizator orientat spre nomenclatura.

Proces

Comportamentul dialogului

Dialogul WikiLove este modal. Inițierea acestuia (de oriunde) îi va determina să apară peste textul paginii. Acesta poate fi respins cu un simplu click.

Sistemul WikiLove necesită Javascript.

Utilizatorul va primi inițial un set scurt de instrucțiuni ușor de înțeles și o listă cu "categorii de atribuire" disponibile.

După selectarea unui tip de atribuire, utilizatorul are o secțiune în care poate adăuga detalii despre premiu (cum ar fi un mesaj scurt).

Rețineți că anumite categorii de premii (de exemplu, "cookie") nu vor avea un pas secundar de creare a premiului și vor merge direct la "Previzualizare".

Utilizatorul dă apoi click pe butonul "previzualizare", care va încărca o previzualizare a premiului, astfel încât să poată vedea cum va arăta în pagina de discuții a utilizatorului.

Odată ce utilizatorul este mulțumit, aceștia pot face click pe butonul "Trimiteți WikiLove". În acest moment, apelurile AJAX către serverul API vor fi concediate, adăugând formatul în pagina de discuții a utilizatorului.

Notificare email

Deoarece pentru majoritatea utilizatorilor noi este puțin probabil să știe că chiar au pagini de discuții, este posibil să nu știe că au primit WikiLove-ul în cauză.

În consecință, serverul va trimite prin e-mail destinatarului (dacă și-a furnizat o adresă de e-mail) informându-l despre WikiLove, precum și instrucțiuni scurte despre cum să acceseze pagina de discuții.

Configurare site

Inițial, premiile care pot fi acordate trebuie să fie definite în gadget-ul propriu-zis. Dacă acest sistem este ridicat la o extensie, atunci numele premiilor și formatelor ar trebui să fie definite în LocalSettings.php.

Alternativ, astfel de informații pot fi stocate în baza de date. O consolă de administrare ar fi necesară pentru a adăuga sau a scădea premiile și categoriile de premii disponibile.

Stocare date

Pentru colectarea de statistici se propune, de fiecare dată ca un premiu sa fie acordat, ca datele sa fie urmărite şi stocate în baza de date. Un simplu tabel, scris prin API, este tot ce trebuie cerut:

  • "De la Utilizator” - Numele de utilizator al persoanei căreia îi este oferit premiul
  • ”Către Utilizator” - Numele de utilizator al persoanei care primeşte premiul
  • ”Format” - Numele formatului care a fost premiat
  • ”Timestamp” - atunci cand premiul a fost acordat
  • ”Text Premiu” - Opţional; acesta va fi textul premiului

Special:Statistica WikiLove

În viitor, ar trebui să fie posibilă crearea unei pagini, Special: WikiLoveStatistics, care ar putea fi utilizată pentru a vedea cât de des este folosit sistemul, precum și pentru a oferi o perspectivă asupra cui dă cea mai mare dragoste,care premii sunt cele mai populare și care primește cele mai multe premii.

Acest lucru va contribui la furnizarea unei imagini globale asupra sănătății comunității. Cu cât sunt acordate mai multe premii, cu atât este mai sănătoasă comunitatea.

Gândirea viitoare

Etapa a doua a acestui proiect ar putea duce la adăugarea dinamică a legăturilor "Trimiteți WikiLove" la semnăturile din paginile de discuții. Acest lucru ar permite ca WikiLove să fie trimise într-un mod mult mai ușor, direct de la alte pagini de discuții.

Vezi și