AllowEncodedSlashes

Pokud používáte Apache 2.3.12 nebo novější, měli byste nastavit [$url 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

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".

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; # days since registration
  $wgFlaggedRevsAutopromote['edits'] = 150; # total edit count
  $wgFlaggedRevsAutopromote['excludeDeleted'] = true; # exclude deleted edits from 'edits' count above?
  $wgFlaggedRevsAutopromote['spacing'] = 3; # spacing of edit intervals
  $wgFlaggedRevsAutopromote['benchmarks'] = 15; # how many edit intervals are needed?
  $wgFlaggedRevsAutopromote['recentContentEdits'] = 10; # $wgContentNamespaces edits in recent changes
  $wgFlaggedRevsAutopromote['totalContentEdits'] = 30; # $wgContentNamespaces edits
  $wgFlaggedRevsAutopromote['uniqueContentPages'] = 10; # $wgContentNamespaces unique pages edited
  $wgFlaggedRevsAutopromote['editComments'] = 5; # how many edit comments used?
  $wgFlaggedRevsAutopromote['email'] = true; # user must be emailconfirmed?
  $wgFlaggedRevsAutopromote['userpageBytes'] = 0; # if userpage is needed, what is the min size?
  

• $wgFlaggedRevsRestrictionLevels - Restriction levels for autoreview/review rights. When a level is selected for a page, an edit made by a user will not be auto-reviewed if the user lacks the specified permission. Levels are set at Special:Stabilization.
• $wgFlaggedRevsProtection - Set this to use FlaggedRevs only as a protection-like mechanism (Nápověda:Změny ke schválení ), rather than the standard configuration.
• $wgFlaggedRevsAutoConfirm - Define when users get to have their own edits auto-reviewed. Set to false to disable.
• $wgFlaggedRevsHandleIncludes - Whether to use stable versions of templates when rendering the stable version of a page.

action=review

Parameters

• revid: The revision ID for which to set the flags
• token: A csrf token retrieved through action=query&meta=tokens
• comment: Comment for the review (optional)
• flag_accuracy: Set the flag named "accuracy" to the specified value; (replace "accuracy" with the flag name to set another flag)
• unapprove: If set, revision will be unapproved rather than approved

Example

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

action=stabilize

Parameters

• title: Title of page to be stabilized
• reason: Reason for stabilization
• expiry: Stabilization expiry. Default: infinite
• review: Whether to auto-review the page
• watch: Whether to watch the page
• token: An edit token retrieved through action=query&meta=tokens

• protectlevel: The right users must have in order for their edits to not require review.

• default: Default revision to show (latest | stable)

  autoreview: Restriction level for the autoreview right (sysop | none). Default: none

Example

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

action=flagconfig

• name: the name of the flag
• levels: the number of possible levels the flag has (not counting the "unreviewed" level)

Example

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

list=unreviewedpages

Parameters

• urstart: Start listing at this page title.
• urend: Stop listing at this page title.
• urnamespace: The namespaces to enumerate.
• urfilterredir: How to filter for redirects
• urfilterlevel: How to filter by quality (0=sighted,1=quality)
• urlimit: How many total pages to return.

Example

<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

Parameters

• orstart: Start listing from this timestamp
• orend: Stop listing at this timestamp.
• ordir: In which direction to list.
• ornamespace: The namespaces to enumerate.
• orfilterredir: How to filter for redirects
• orlimit: How many total pages to return.

Example

<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