AllowEncodedSlashes

Pokud používáte Apache 2.3.12 nebo novější, měli byste nastavit AllowEncodedSlashes na ""NoDecode"". Přidejte následující řádek do vašeho souboru ‎<VirtualHost> nebo, pokud jej nemáte, na konec souboru httpd.conf:

AllowEncodedSlashes NoDecode

Po úpravě souboru httpd.conf je třeba restartovat Apache.

Upravte svůj .htaccess (pokud je to potřeba)

Pokud zkracujete URL adresy , musíte do souboru .htaccess přidat výjimku, která umožní použití REST API .

Funkce FlaggedRevs volá při hodnotě rest.php . Například:

https://[domain]/w/rest.php/flaggedrevs/internal/review/Main_Page

Pokud podmínky .htaccess nejsou při volání výše uvedené adresy URL správně nastaveny, FlaggedRevs se doslova pokusí o přístup k článku s názvem "W/rest.php/flaggedrevs/internal/review/Main Page".

Zde je jeden způsob, jak přidat výjimku do .htaccess, zvýraznění přidáno:

RewriteEngine On

RewriteCond %{REQUEST_URI} !^/w/rest\.php
RewriteCond %{DOCUMENT_ROOT}%{REQUEST_URI} !-f
RewriteCond %{DOCUMENT_ROOT}%{REQUEST_URI} !-d

RewriteRule ^(.*)$ w/index.php?title=$1 [L,QSA]
RewriteRule ^$ w/index.php [L,QSA]

Povýšení uživatele na recenzenty

Po první instalaci FlaggedRevs žádný uživatel neuvidí widget recenzenta. Chcete-li to vyřešit, přihlaste se jako wiki byrokrat a přejděte na stránku Special:UserRights, kde udělte práva k revizi jednomu nebo více uživatelům. Recenzenti uvidí widget recenzenta v dolní části upravitelné stránky.

Statistiky recenzí článků (volitelné)

Pro plánovaný sběr statistik recenzí článků (k zobrazení na Special:ValidationStatistics) vytvořte úlohu cron, která bude pravidelně spouštět extensions/FlaggedRevs/maintenance/updateStats.php. Spusťte příkaz time php updateStats.php, abyste viděli, jak dlouho trvá spuštění skriptu, a nastavte odpovídající interval spouštění úloh cron. Například chcete-li vytvořit úlohu cron, která bude každou hodinu spouštět updateStats.php, přidejte do crontabu pro uživatele, který spouští webový server (např. www-data), následující kód:

@hourly php /var/www/mediawiki/extensions/FlaggedRevs/maintenance/updateStats.php

Uživatelská práva a uživatelské skupiny

Ve výchozím nastavení nikdo nemůže nic kontrolovat, takže prvním krokem je nastavení uživatelských práv.

Základní nastavení

FlaggedRevs.php má řadu konfigurovatelných proměnných. Tyto by měly být nakonfigurovány v LocalSettings.php.

• $wgFlaggedRevsNamespaces – nastavuje, které jmenné prostory mohou být předmětem procesu kontroly. Toto je pole celých čísel. Na stránce Příručka:Konstanty jmenných prostorů se dozvíte, na jaké celé číslo se mapují výchozí jmenné prostory, a pro lepší čitelnost použijte definované konstanty.
• $wgFlaggedRevsTags – nastaví tagy a jejich hodnotu levels.

  Definice

  $wgFlaggedRevsTags je asociativní pole s klíči odpovídajícími každému názvu tagu. Jedinou smysluplnou hodnotou pole je levels, která určuje počet úrovní recenzí, a pole může mít pouze jeden prvek.

  Označování

  • Každý tag lze označit úpravou stránky MediaWiki:revreview-<název-značky>.
  • Každou úroveň tagu lze označit úpravou stránky MediaWiki:revreview-<název-tagu>-<číslo-úrovně>.

  Ve výchozím nastavení je tag označen tak, jak se zobrazuje v poli $wgFlaggedRevsTags. Aby se toto potlačilo a zobrazovaly se například tagy s velkými písmeny, musí administrátoři tyto stránky upravit se zobrazeným obsahem, například změnit obsah stránky MediaWiki:revreview-accuracy.

Pro označení úrovní tagů musí administrátoři vytvořit tyto stránky se zobrazeným obsahem:

značka	úroveň	stránka s popisky	obsah
accuracy	0	MediaWiki:revreview-accuracy-0	Nedostačující
	1	MediaWiki:revreview-accuracy-1	Prohlédnuto
	2	MediaWiki:revreview-accuracy-2	překontrolováno

Výsledné nastavení bude:

název značky	název úrovně
Stav	Nedostačující	Prohlédnuto	překontrolováno

• $wgFlaggedRevsOverride – zda je stabilní verze výchozím obsahem stránek.

  Administrátoři mohou jednotlivé stránky nakonfigurovat tak, aby jako výchozí obsah měly stabilní nebo konceptovou verzi.

• $wgFlaggedRevsTagsRestrictions – pole s klíči odpovídajícími každému typu příznaku a hodnotami, které jsou poli práv a toho, jak vysoko mohou uživatelé s nimi ohodnotit příznaky (úroveň integrálního tagu).

  Příklad

  $wgFlaggedRevsTagsRestrictions = [
  	'accuracy' => [ 'review' => 1 ],
  ];
  

Uživatelské rozhraní

• $wgSimpleFlaggedRevsUI – je-li povoleno, používá se jednodušší uživatelské rozhraní založené na ikonách. Neovlivňuje tagy zobrazené v režimu úprav.
• $wgFlaggedRevsLowProfile – nastavení skryje pole/panel se stavem kontroly u stránek, které jsou recenzovány v jejich nejnovější verzi. Vysvětlující text je také na některých místech odstraněn.

Pracovní postup

• $wgFlaggedRevsAutoReview – pokud je povoleno, každá úprava provedená uživatelem s právy 'autoreview' je při uložení automaticky zkontrolována. Není třeba stisknout tlačítko "odeslat recenzi". Tato funkce vyžaduje, aby byla zkontrolována i předchozí revize. Jinak k automatické kontrole nedojde.
• $wgFlaggedRevsTagsAuto – pokud je povolena možnost wgFlaggedRevsAutoReview, toto nastavení určuje, jak vysoko může být každý štítek automaticky zkontrolován. Pokud je to povoleno, štítky budou automaticky zkontrolovány na stejné úrovni jako předchozí štítky revizí. Toto je asociativní pole. Každý klíč je tag a každá hodnota je úroveň tagu.

  Příklad

  $wgFlaggedRevsTagsAuto = [
  	'accuracy' => 1
  ];
  

Změny v šablonách jsou automaticky kontrolovány (pro každou stránku). To by mohlo vést k revizi špatných verzí. Uživatelé by měli být povzbuzováni k použití náhledu nebo kontroly stránky po uložení. Možná budete chtít nastavit $wgNamespaceProtection[NS_TEMPLATE] jako [ 'editor' ] nebo [ 'autoconfirmed' ].

Automatická propagace uživatelů

• $wgFlaggedRevsAutopromote – pole s klíči pro dny, úpravy, časový odstup, benchmarky, emailconfirmed, nedávné úpravy obsahu, celkový počet úprav obsahu, upravené stránky obsahu, použité souhrny úprav, jedinečnost IP adresy a existenci uživatelské stránky jako klíče. Hodnoty odpovídají počtu dní/úprav, které jsou potřeba k automatickému povýšení uživatelského účtu na status Editor, a také k tomu, zda musí být uživatel potvrzen e-mailem a zda k tomu musí být k dispozici uživatelská stránka. Uživatel musí mít alespoň X úprav, které jsou od sebe vzdáleny Y nebo více dní, kde X je počet srovnávacích testů a Y je časový odstup. Chcete-li tuto funkci zcela zakázat, nastavte tuto proměnnou na hodnotu false.
  • Pokud jsou uživateli odebrána práva Editor, nebudou mu automaticky znovu udělena (protokol stavu editora se kontroluje, zda nedošlo k odebrání práv).
  • Některé z těchto účtů nejsou zpětně platné, takže si možná všimnete zpoždění v propagačních akcích.

  Příklad

  Na $wgFlaggedRevsAutopromote by se dalo získat:

  $wgFlaggedRevsAutopromote['days'] = 60; # dní od registrace
  $wgFlaggedRevsAutopromote['edits'] = 150; # celkový počet úprav
  $wgFlaggedRevsAutopromote['excludeDeleted'] = true; # Vyloučit smazané úpravy z výše uvedeného počtu 'edits'?
  $wgFlaggedRevsAutopromote['spacing'] = 3; # rozteč editačních intervalů
  $wgFlaggedRevsAutopromote['benchmarks'] = 15; # Kolik intervalů úprav je potřeba?
  $wgFlaggedRevsAutopromote['recentContentEdits'] = 10; # $wgContentNamespaces úprav v posledních změnách
  $wgFlaggedRevsAutopromote['totalContentEdits'] = 30; # $wgContentNamespaces úprav
  $wgFlaggedRevsAutopromote['uniqueContentPages'] = 10; # Upraveno $wgContentNamespaces unikátních stránek
  $wgFlaggedRevsAutopromote['editComments'] = 5; # Kolik komentářů k úpravám bylo použito?
  $wgFlaggedRevsAutopromote['email'] = true; # Musí být uživatel potvrzen e-mailem?
  $wgFlaggedRevsAutopromote['userpageBytes'] = 0; # Pokud je potřeba uživatelská stránka, jaká je minimální velikost?
  

Pokročilé

• $wgFlaggedRevsRestrictionLevels - úrovně omezení pro práva v hodnotě autoreview/review. Pokud je pro stránku vybrána úroveň, úprava provedená uživatelem nebude automaticky zkontrolována, pokud uživatel nemá zadané oprávnění. Úrovně jsou nastaveny v sekci Special:Stabilization.
• $wgFlaggedRevsProtection - nastavení tak, aby se jako ochranný mechanismus používal pouze FlaggedRevs (Nápověda:Změny ke schválení ), namísto standardní konfigurace.
• $wgFlaggedRevsAutoConfirm - definování, kdy se úpravy uživatelů automaticky kontrolují. Pro deaktivaci nastavte na false.
• $wgFlaggedRevsHandleIncludes - zda se mají při vykreslování stabilní verze stránky používat stabilní verze šablon.

Chcete-li mít wiki, kde si neuživatelé mohou prohlížet pouze stabilní verzi článků, podívejte se na Extension:FlaggedRevs/Restricting unapproved revisions .

Schvalování stránek

Uživatelé s určitou úrovní stavu kontroly budou mít při zobrazení stránky (v dolní části stránky) malý formulář pro hodnocení a v horní části stránky možnost zobrazit rozdíly, které jim umožní zkontrolovat revize. Každá značka musí splňovat alespoň minimální úroveň schválení. Uživatelé by si měli před kontrolou prohlédnout celou stránku, včetně šablon a obrázků. Odkaz (diff to stable (rozdílné až stabilní)) je velmi užitečný pro urychlení tohoto procesu.

Uživatelé nemohou recenzovat stránku, kterou nemohou upravovat. Nemohou snížit úroveň revize z úrovně, kterou nemohou nastavit. Zablokovaní uživatelé nemohou dělat nic.

Údržba

Na adrese Special:UnreviewedPages se nachází seznam stránek, které dosud nebyly zkontrolovány, pouze pro editory. Musí být vybrán jmenný prostor a k dispozici je také volitelný filtr kategorií.

Na adrese Special:OldReviewedPages je seznam stránek, které byly zkontrolovány, ale čekají na úpravy. Toto je pouze pro editory. K dispozici je také volitelný filtr kategorií.

Stránky, které nelze zkontrolovat, mohou být i nadále kontrolovány editory z důvodu ochrany před vandalismem, aby se zjistilo, co již bylo zkontrolováno.

Záznam

Všechny relevantní akce jsou trvale zaznamenávány, takže vše lze řádně sledovat a kontrolovat.

• Záznam o povýšení/degradaci editorů a důvodech je veden v souboru Special:Log/rights.
• Záznam o schválení/neschválení revizí je veden v souboru Special:Log/review.
• Záznam změn v konfiguraci stabilního verzování stránek je zaznamenáván do souboru Special:Log/stable.

action=review

Recenzuje stránku.

Parametry

• revid: ID revize, pro kterou se mají nastavit příznaky
• token: token csrf načtený prostřednictvím action=query&meta=tokens
• comment: komentář k recenzi (volitelné)
• flag_accuracy: nastaví příznak s názvem "accuracy" (přesnost) na zadanou hodnotu. (nahraďte "accuracy" názvem příznaku pro nastavení jiného příznaku)
• unapprove: pokud je nastaveno, revize bude spíše neschválena než schválena.

Příklad

<api>
  <review revid="12345" />
</api>

action=stabilize

Změní nastavení stabilizace stránky.

Parametry

• title – název stránky, která má být stabilizována
• reason – důvod stabilizace
• expiry – platnost stabilizace. Výchozí: infinite (nekonečno)
• review – zda se má stránka automaticky zkontrolovat
• watch – zda sledovat stránku
• token – token pro úpravy načtený prostřednictvím action=query&meta=tokens
• Pro konfigurace podobné ochraně ($wgFlaggedRevsProtection=true):

  protectlevel – aby úpravy nevyžadovaly kontrolu, musí mít správní uživatelé oprávnění.

• Jinak ($wgFlaggedRevsProtection=false):

  default – výchozí revize k zobrazení (nejnovější | stabilní)

  autoreview – úroveň omezení pro oprávnění autoreview (sysop | žádná). Výchozí: žádné

Příklad

<api>
  <stabilize title="Foo" default="stable" autoreview="none" expiry="infinite" />
</api>

action=flagconfig

Zobrazuje informace o konfiguraci příznaků kontroly.

Pro každý příznak jsou vráceny následující parametry:

• name – název příznaku
• levels – počet možných úrovní, které příznak má (bez započítání "nepřezkoumané" úrovně)

Zobrazený název pro každý příznak a názvy různých úrovní pro každý příznak jsou zprávy MediaWiki, takže je lze nastavit a načíst prostřednictvím příslušné stránky. Například název pro první úroveň příznaku "accuracy" (přesnost) se nachází v adresáři MediaWiki:revreview-accuracy-1.

Příklad

<api>
  <flagconfig>
    <tag name="value" levels="3" tier1="1" />
  </flagconfig>
</api>

list=unreviewedpages

Uvádí stránky, které nikdy nebyly zkontrolovány.

Parametry

• urstart – začít s výpisem na tomto názvu stránky.
• urend – přestat vypisovat na tomto názvu stránky.
• urnamespace – jmenné prostory, které se mají vyjmenovat.
• urfilterredir – jak filtrovat přesměrování
• urfilterlevel – jak filtrovat podle kvality (0=sighted,1=quality)
• urlimit – kolik stránek celkem vrátit.

Příklad

<api>
  <query-continue>
    <unreviewedpages urstart="Arbeitgeberverband_Chemie_und_verwandte_Industrien_für_das_Land_Hessen" />
  </query-continue>
  <query>
    <unreviewedpages>
      <p pageid="4762806" ns="0" title="Aaftink" revid="65175047" />
      <p pageid="4747500" ns="0" title="Abt RS6" revid="64976429" />
      <p pageid="4749877" ns="0" title="Acht Vorlesungen über den Konstruktiven Realismus" revid="65089962" />
      <p pageid="4758156" ns="0" title="Alkylglycerole" revid="65169004" />
      <p pageid="4719044" ns="0" title="All Riot" revid="64767732" />
      <p pageid="4745418" ns="0" title="Allgäu-Panorama-Marathon" revid="64974783" />
      <p pageid="4729976" ns="0" title="An- und Einpressen" revid="64742640" />
      <p pageid="4742559" ns="0" title="Anjara I. Bartz" revid="64925772" />
      <p pageid="4740681" ns="0" title="Anthony Norris Groves" revid="65064712" />
      <p pageid="4759964" ns="0" title="Antonino Asta" revid="65169073" />
    </unreviewedpages>
  </query>
</api>

list=oldreviewedpages

Zobrazuje seznam stránek, které byly v určitém okamžiku zkontrolovány, ale u kterých nebyla zkontrolována nejnovější revize.

Parametry

• orstart – začít vypisovat od tohoto časového razítka
• orend – zastavit záznam na tomto časovém razítku.
• ordir – jakým směrem vypsat.
• ornamespace – jmenné prostory, které se mají vyjmenovat.
• orfilterredir – jak filtrovat přesměrování
• orlimit – kolik stránek celkem vrátit.

Příklad

<api>
  <query-continue>
    <oldreviewedpages orstart="2009-09-15T20:23:05Z" />
  </query-continue>
  <query>
    <oldreviewedpages>
      <p pageid="144735" ns="0" title="Two International Finance Centre" revid="64562654" stable_revid="62769201" pending_since="2009-09-15T16:16:33Z" flagged_level="0" flagged_level_text="stable" />
      <p pageid="1629949" ns="0" title="Porta San Sebastiano" revid="64791898" stable_revid="61610797" pending_since="2009-09-15T16:19:32Z" flagged_level="0" flagged_level_text="stable" />
      <p pageid="2157354" ns="0" title="Entwicklungspolitik der Europäischen Union" revid="64640078" stable_revid="59929751" pending_since="2009-09-15T16:38:33Z" flagged_level="0" flagged_level_text="stable" />
      <p pageid="971904" ns="0" title="Federpendel" revid="65142775" stable_revid="59587441" pending_since="2009-09-15T17:37:29Z" flagged_level="0" flagged_level_text="stable" />
      <p pageid="3106812" ns="0" title="Soultzbach-les-Bains" revid="64552516" stable_revid="60455707" pending_since="2009-09-15T19:04:07Z" flagged_level="0" flagged_level_text="stable" />
      <p pageid="1223029" ns="0" title="VfR Bürstadt" revid="65150048" stable_revid="62925935" pending_since="2009-09-15T19:35:30Z" flagged_level="0" flagged_level_text="stable" />
      <p pageid="829158" ns="0" title="GSP" revid="64553869" stable_revid="62913440" pending_since="2009-09-15T19:38:46Z" flagged_level="0" flagged_level_text="stable" />
      <p pageid="3453867" ns="0" title="Agios Dimitrios" revid="65103799" stable_revid="64544222" pending_since="2009-09-15T19:47:10Z" flagged_level="0" flagged_level_text="stable" />
      <p pageid="2583263" ns="0" title="Jörg Kudlich" revid="64554475" stable_revid="62429967" pending_since="2009-09-15T20:03:24Z" flagged_level="0" flagged_level_text="stable" />
      <p pageid="325478" ns="0" title="Liste deutscher Komponisten klassischer Musik" revid="65089571" stable_revid="63582610" pending_since="2009-09-15T20:21:55Z" flagged_level="0" flagged_level_text="stable" />
    </oldreviewedpages>
  </query>
</api>

prop=flagged

Pro získání informací o stavu nahlašování daných stránek použijte parametr action=query&prop=flagged.