Jump to content
Main menu
Main menu
move to sidebar
hide
Navigation
Main page
Get MediaWiki
Get extensions
Tech blog
Contribute
Support
User help
FAQ
Technical manual
Support desk
Communication
Development
Developer portal
Code statistics
mediawiki.org
Community portal
Recent changes
Translate content
Random page
Village pump
Sandbox
Search
English
Create account
Log in
Personal tools
Create account
Log in
Pages for logged out editors
learn more
Contributions
Talk
Export translations
Translate
English
Language statistics
Message group statistics
Export
Tools
Tools
move to sidebar
hide
Actions
Language statistics
Message group statistics
Export
General
Upload file
Special pages
Printable version
Get shortened URL
Download QR code
{{DISPLAYTITLE:Extensão:FlaggedRevs}}<languages/> {{Warning|1=<span lang="en" dir="ltr" class="mw-content-ltr">Flagged Revisions is very clunky, complex and not recommended for production use, despite the "stable" tag.</span> <span lang="en" dir="ltr" class="mw-content-ltr">See [[phab:T185664]].</span> <span lang="en" dir="ltr" class="mw-content-ltr">This extension has not been installed on any new WMF wikis [[m:Special:MyLanguage/Flagged Revisions#Enabling|since 2014]].</span>}} {{Extension |name = Flagged Revisions |status = stable |type1 = interface |type2 = special |type3 = user rights |type4 = database |type5 = ajax |type6 = api |newhook1 = FlaggedRevsRevisionReviewFormAfterDoSubmit |author = [[User:Aaron Schulz|Aaron Schulz]], [[User:Jbaach|Joerg Baach]] |image = |compatibility policy = rel |mediawiki = 1.21+ |download = {{WikimediaDownload|FlaggedRevs|phab=EFLR}} |readme = |changelog = |description = <span lang="en" dir="ltr" class="mw-content-ltr">Allows for article content management by "editor" and "reviewer" classes.</span> |parameters= |example = |bugzilla = FlaggedRevs |translate = ext-flaggedrevs-0-all |table1 = flaggedpages |table2 = flaggedpage_pending |table3 = flaggedrevs |table4 = flaggedpage_config |table5 = flaggedrevs_tracking |table6 = flaggedrevs_promote |table7 = flaggedrevs_statistics |rights = <nowiki/> *review *validate *autoreview *autoreviewrestore *unreviewedpages *stablesettings *movestable }} <span lang="en" dir="ltr" class="mw-content-ltr">The '''Flagged Revisions''' extension allows for '''Editor''' and '''Reviewer''' users to rate revisions of articles and set those revisions as the default revision to show upon normal page view.</span> <span lang="en" dir="ltr" class="mw-content-ltr">This allows for MediaWiki to act more like a [[w:Content management system|Content Management System]] (CMS).</span> <div lang="en" dir="ltr" class="mw-content-ltr"> ==Installation== </div> {{ExtensionInstall |repo-name=FlaggedRevs |db-update=1 |registration=yes |no-registration-version=1.33 |custom-steps=* [[#Configuration|<span lang="en" dir="ltr" class="mw-content-ltr">Configure as required.</span>]] }} <span id="Setup"></span> == Configuração == ===AllowEncodedSlashes=== <span lang="en" dir="ltr" class="mw-content-ltr">If you are using Apache 2.3.12 or later, you should set [https://httpd.apache.org/docs/2.4/mod/core.html#allowencodedslashes AllowEncodedSlashes] to "NoDecode".</span> <span lang="en" dir="ltr" class="mw-content-ltr">Add the following line to your {{tag|VirtualHost|open}} or, if you don't have one, at the end of your httpd.conf file:</span> AllowEncodedSlashes NoDecode <span lang="en" dir="ltr" class="mw-content-ltr">After you edited httpd.conf, Apache needs to be restarted.</span> ===Alter your .htaccess (if needed)=== <div lang="en" dir="ltr" class="mw-content-ltr"> If you are {{ll|Manual:Short URL|shortening your URLs}}, you need to add an exception to .htaccess to allow the use of the {{ll|API:REST API|REST API}}. </div> <div lang="en" dir="ltr" class="mw-content-ltr"> FlaggedRevs calls on {{ll|Manual:rest.php|rest.php}}. For example: </div> https://[domain]/w/rest.php/flaggedrevs/internal/review/Main_Page <div lang="en" dir="ltr" class="mw-content-ltr"> If the .htaccess conditions are not properly set when the above url is called, FlaggedRevs will ''literally'' try to access an article named "<code>W/rest.php/flaggedrevs/internal/review/Main Page</code>". </div> <div lang="en" dir="ltr" class="mw-content-ltr"> Here is one way to add an exception to .htaccess, emphasis added: </div> 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] <div lang="en" dir="ltr" class="mw-content-ltr"> ===Promote users to reviewers=== </div> <span lang="en" dir="ltr" class="mw-content-ltr">After FlaggedRevs is first installed, no user can see the reviewer's widget.</span> <span lang="en" dir="ltr" class="mw-content-ltr">To fix this, login as a wiki bureaucrat and go to [[Special:UserRights]], then grant review rights to one or more users.</span> <span lang="en" dir="ltr" class="mw-content-ltr">Reviewers will see the reviewer's widget on the bottom of an editable page.</span> <div lang="en" dir="ltr" class="mw-content-ltr"> ===Article review statistics (optional)=== </div> {{note|1=<span lang="en" dir="ltr" class="mw-content-ltr">This applies to Unix-like systems and assumes that MediaWiki is installed in <code>/var/www/mediawiki</code>.</span>}} <span lang="en" dir="ltr" class="mw-content-ltr">For a scheduled collection of article review statistics, create a [[w:cron|cron]] job to run <code>extensions/FlaggedRevs/maintenance/updateStats.php</code> at a regular interval.</span> <span lang="en" dir="ltr" class="mw-content-ltr">Run <code>time php updateStats.php</code> to see how long the script takes to run and set your cron jobs interval appropriately.</span> <span lang="en" dir="ltr" class="mw-content-ltr">For example, to create a cron job that runs <code>updateStats.php</code> as user <code>www-data</code> every hour:</span> echo "@hourly php /var/www/mediawiki/extensions/FlaggedRevs/maintenance/updateStats.php" | crontab -u www-data - {{Warning|1=<span lang="en" dir="ltr" class="mw-content-ltr">This will delete all existing cron jobs for the user.</span>}} <span id="Configuration"></span> == Configuração == {{update|1=<span lang="en" dir="ltr" class="mw-content-ltr">features removed in master version</span>}} <span id="User_rights_and_user_groups"></span> === Direitos do utilizador e grupos do utilizador === Por padrão, ninguém pode rever nada, por isso o primeiro passo é definir os direitos de utilizador. {|class="wikitable" style="float:{{dir|{{PAGELANGUAGE}}|left|right}}" ! Grupos de utilizadores ! Direitos de utilizador |- | rowspan=2 | reviewer || validate |- | rowspan=2 | review |- | rowspan=3 | editor |- | autoreview |- | unreviewedpages |} <span id="User_rights"></span> == Direitos do utilizador == <div lang="en" dir="ltr" class="mw-content-ltr"> FlaggedRevs creates the following new user rights: </div> * <code>review</code> – <span lang="en" dir="ltr" class="mw-content-ltr">user can review revisions</span> * <code>validate</code> – <span lang="en" dir="ltr" class="mw-content-ltr">user can review revisions and can set all tags to all levels</span> * <code>autoreview</code> – <span lang="en" dir="ltr" class="mw-content-ltr">any new revisions made by the user are automatically marked as sighted</span> * <code>autoreviewrestore</code> – <span lang="en" dir="ltr" class="mw-content-ltr">autoreview of the rollbacks made by the user.</span> * <code>unreviewedpages</code> – <span lang="en" dir="ltr" class="mw-content-ltr">user can view '''Special:UnreviewedPages'''</span> * <code>stablesettings</code> – <span lang="en" dir="ltr" class="mw-content-ltr">user can changes the settings of stable revisions of any page</span> * <code>movestable</code> – <span lang="en" dir="ltr" class="mw-content-ltr">user can move pages with stable revisions</span> <span id="User_groups"></span> ==== Grupos de utilizadores ==== <div lang="en" dir="ltr" class="mw-content-ltr"> FlaggedRevs creates the following new user groups: </div> * <code>editor</code> – <span lang="en" dir="ltr" class="mw-content-ltr">receive <code>autoreview, review, unreviewedpages</code>, plus the [[Special:MyLanguage/Manual:User rights|standard MediaWiki user rights]] <code>autoconfirmed, editsemiprotected</code></span> * <code>reviewer</code> – <span lang="en" dir="ltr" class="mw-content-ltr">receive <code>autoreview, review, unreviewedpages, validate</code>, plus the [[Special:MyLanguage/Manual:User rights|standard MediaWiki user rights]] <code>autoconfirmed, editsemiprotected</code></span> * <code>autoreview</code> – <span lang="en" dir="ltr" class="mw-content-ltr">receive <code>autoreview</code></span> <span id="How_to_assign_user_rights"></span> ==== Como atribuir direitos de utilizador ==== Os direitos de utilizador podem ser atribuídos de duas maneiras: * Atribuindo os direitos aos grupos de utilizadores<br />Atribuir estes direitos de utilizador a grupos de utilizadores existentes em <code>{{ll|Manual:LocalSettings.php|LocalSettings.php}}</code>: : <syntaxhighlight lang="php">$wgGroupPermissions['sysop']['review'] = true; //allow administrators to review revisions</syntaxhighlight> * Atribuir os direitos a utilizadores específicos<br /><span lang="en" dir="ltr" class="mw-content-ltr">Manually add user accounts to the appropriate groups via [[Special:UserRights]].</span> : Por predefinição: :* Os burocratas podem adicionar/remover Revisores. :* Os administradores podem adicionar/remover os Revisores Automáticos e os Editores. <span id="Basic_settings"></span> === Definições básicas === <span lang="en" dir="ltr" class="mw-content-ltr"><code>FlaggedRevs.php</code> comes with a number of configurable variables.</span> <span lang="en" dir="ltr" class="mw-content-ltr">These should be configured in <code>LocalSettings.php</code>.</span> *{{phpi|$wgFlaggedRevsNamespaces}} – <span lang="en" dir="ltr" class="mw-content-ltr">Sets what namespaces may be subject to the review process.</span> <span lang="en" dir="ltr" class="mw-content-ltr">This is an array of integers.</span> <span lang="en" dir="ltr" class="mw-content-ltr">See {{ll|Manual:Namespace constants}} to see what integer the default namespaces map to and use the defined constants for readability.</span> *{{phpi|$wgFlaggedRevsTags}} – <span lang="en" dir="ltr" class="mw-content-ltr">Sets the tags and their 'levels' setting.</span> *: '''Definição''' *: <span lang="en" dir="ltr" class="mw-content-ltr">{{phpi|$wgFlaggedRevsTags}} is an associative array with keys corresponding to each tag name.</span> <span lang="en" dir="ltr" class="mw-content-ltr">The only meaningful value of the array is 'levels', which controls the number of review levels, and the array can only have one element.</span> *: '''Etiquetagem''' *:* <span lang="en" dir="ltr" class="mw-content-ltr">Each tag can be labeled editing the page ''MediaWiki:revreview-<tag-name>''.</span> *:* <span lang="en" dir="ltr" class="mw-content-ltr">Each tag level can be labeled editing the page ''MediaWiki:revreview-<tag-name>-<level-number>''.</span> *: <span lang="en" dir="ltr" class="mw-content-ltr">By default, the tag is labeled as it appears in the {{phpi|$wgFlaggedRevsTags}} array.</span> <span lang="en" dir="ltr" class="mw-content-ltr">To override this, and show tags for example as their capitalized name, the admins have to edit these pages with the shown content, for example changing the content of [[MediaWiki:revreview-accuracy]]</span> :: <span lang="en" dir="ltr" class="mw-content-ltr">To label the tag levels, the admins have to create these pages with the shown content:</span> ::{|class="wikitable" |- !etiqueta !nível !etiquetar página !conteúdo |- |rowspan=3|accuracy |0 |MediaWiki:revreview-accuracy-0 |{{int|revreview-accuracy-0}} |- |1 |MediaWiki:revreview-accuracy-1 |{{int|revreview-accuracy-1}} |- |2 |MediaWiki:revreview-accuracy-2 |{{int|revreview-accuracy-2}} |} :: <span lang="en" dir="ltr" class="mw-content-ltr">The resulting setup will be:</span> ::{|class="wikitable" |- !<span lang="en" dir="ltr" class="mw-content-ltr">tag names</span> !colspan=3|<span lang="en" dir="ltr" class="mw-content-ltr">level names</span> |- |{{int|revreview-accuracy}} |{{int|revreview-accuracy-0}} |{{int|revreview-accuracy-1}} |{{int|revreview-accuracy-2}} |} *{{phpi|$wgFlaggedRevsOverride}} – <span lang="en" dir="ltr" class="mw-content-ltr">Whether the stable version is the default content for pages.</span> *:{{Note|1=<span lang="en" dir="ltr" class="mw-content-ltr">Individual pages can be configured to have the stable or draft version as the default content by administrators.</span>}} *{{phpi|$wgFlaggedRevsTagsRestrictions}} – <span lang="en" dir="ltr" class="mw-content-ltr">An array with keys corresponding to each flag type, and values that are arrays of rights and how high users with it can rate the flags (integral tag level).</span> *: '''Exemplo''' *:<div><syntaxhighlight lang="php"> $wgFlaggedRevsTagsRestrictions = [ 'accuracy' => [ 'review' => 1 ], ]; </syntaxhighlight></div> <span id="User_interface"></span> === Interface do utilizador === *{{phpi|$wgSimpleFlaggedRevsUI}} – <span lang="en" dir="ltr" class="mw-content-ltr">When enabled, a simpler, icon based UI is used.</span> <span lang="en" dir="ltr" class="mw-content-ltr">Does not affect the tags shown in edit mode.</span> *{{phpi|$wgFlaggedRevsLowProfile}} – <span lang="en" dir="ltr" class="mw-content-ltr">This setting hides the review status box/bar for pages that are reviewed in their latest version.</span> <span lang="en" dir="ltr" class="mw-content-ltr">Explanatory text is also removed from some places.</span> <span id="Workflow"></span> === Fluxo de trabalho === *{{phpi|$wgFlaggedRevsAutoReview}} – <span lang="en" dir="ltr" class="mw-content-ltr">If enabled, every edit by a user with 'autoreview' rights is automatically reviewed upon save.</span> <span lang="en" dir="ltr" class="mw-content-ltr">There is no need to hit the "submit review" button.</span> <span lang="en" dir="ltr" class="mw-content-ltr">This feature requires that the previous revision was also reviewed; otherwise, auto-review will not occur.</span> *{{phpi|$wgFlaggedRevsTagsAuto}} – <span lang="en" dir="ltr" class="mw-content-ltr">If <code>wgFlaggedRevsAutoReview</code> is enabled, this settings controls how high each tag can be auto-reviewed.</span> <span lang="en" dir="ltr" class="mw-content-ltr">If allowed, tags will be auto-reviewed to the same level the previous revision tags were.</span> <span lang="en" dir="ltr" class="mw-content-ltr">This is an associative array; each key is a tag and each value is a tag level.</span> *:'''Exemplo''' *:<div><syntaxhighlight lang="php"> $wgFlaggedRevsTagsAuto = [ 'accuracy' => 1 ]; </syntaxhighlight></div> ::{{Note|1=<span lang="en" dir="ltr" class="mw-content-ltr">Changes in templates are auto-reviewed (per-page).</span> <span lang="en" dir="ltr" class="mw-content-ltr">This could possibly cause bad versions to be reviewed.</span> <span lang="en" dir="ltr" class="mw-content-ltr">Users should be encouraged to use preview or review the page after saving.</span> <span lang="en" dir="ltr" class="mw-content-ltr">You may want to set <syntaxhighlight lang="php" inline>$wgNamespaceProtection[NS_TEMPLATE]</syntaxhighlight> as <syntaxhighlight lang="php" inline>[ 'editor' ]</syntaxhighlight> or <syntaxhighlight lang="php" inline>[ 'autoconfirmed' ]</syntaxhighlight></span>}} <span id="Automatic_user_promotion"></span> === Promoção automática do utilizador === *{{phpi|$wgFlaggedRevsAutopromote}} – <span lang="en" dir="ltr" class="mw-content-ltr">An array with keys for days, edits, time spacing, benchmarks, emailconfirmed, recent content page edits, total content edits, content pages edited, edit summaries used, IP uniqueness, and userpage existence as keys.</span> <span lang="en" dir="ltr" class="mw-content-ltr">The values correspond to how many days/edits are needed for a user account to be autopromoted to '''Editor''' status and whether they must be emailconfirmed and have a user page do so.</span> <span lang="en" dir="ltr" class="mw-content-ltr">The user must have at least X edits that are Y or more days apart, where X is the number of benchmarks and Y is the time spacing.</span> <span lang="en" dir="ltr" class="mw-content-ltr">Set this variable to false to disable this entirely.</span> **{{Note|1=<span lang="en" dir="ltr" class="mw-content-ltr">If a user has their '''Editor''' rights removed, they will not automatically be re-granted (the editor status log is checked for revocations).</span>}} **{{Note|1=<span lang="en" dir="ltr" class="mw-content-ltr">Some of these counts are not retroactive, so you may notice a delay in promotions.</span>}} *: '''Exemplo''' *: <span lang="en" dir="ltr" class="mw-content-ltr">For {{phpi|$wgFlaggedRevsAutopromote}}, one might have:</span> *: <div><syntaxhighlight lang="php"> $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? </syntaxhighlight></div> <span id="Advanced"></span> === Avançadas === * {{phpi|$wgFlaggedRevsRestrictionLevels}} - <span lang="en" dir="ltr" class="mw-content-ltr">Restriction levels for <code>autoreview</code>/<code>review</code> rights.</span> <span lang="en" dir="ltr" class="mw-content-ltr">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.</span> <span lang="en" dir="ltr" class="mw-content-ltr">Levels are set at Special:Stabilization.</span> * {{phpi|$wgFlaggedRevsProtection}} - <span lang="en" dir="ltr" class="mw-content-ltr">Set this to use FlaggedRevs <i>only</i> as a protection-like mechanism ([[Special:MyLanguage/Help:Pending changes|Help:Pending changes]]), rather than the standard configuration.</span> * {{phpi|$wgFlaggedRevsAutoConfirm}} - <span lang="en" dir="ltr" class="mw-content-ltr">Define when users get to have their own edits auto-reviewed.</span> <span lang="en" dir="ltr" class="mw-content-ltr">Set to <code>false</code> to disable.</span> * {{phpi|$wgFlaggedRevsHandleIncludes}} - <span lang="en" dir="ltr" class="mw-content-ltr">Whether to use stable versions of templates when rendering the stable version of a page.</span> <div lang="en" dir="ltr" class="mw-content-ltr"> To have a wiki where non-users can ''only'' see the stable version of articles, see {{ll|Extension:FlaggedRevs/Restricting unapproved revisions}}. </div> <span id="Use"></span> == Utilização == : ''Ver também: {{ll|Help:FlaggedRevs}}'' <span id="Approving_pages"></span> === Aprovação de páginas === <span lang="en" dir="ltr" class="mw-content-ltr">Users with some level of review status will have a small rating form on page view (at the bottom of the page) and diffs (at the top of the page) that lets them review revisions.</span> <span lang="en" dir="ltr" class="mw-content-ltr">Each tag must at least meet the minimal level of approval.</span> <span lang="en" dir="ltr" class="mw-content-ltr">Users should look at the whole page, included templates and images, before reviewing.</span> <span lang="en" dir="ltr" class="mw-content-ltr">The (diff to stable) link is very useful for speeding up this process.</span> <span lang="en" dir="ltr" class="mw-content-ltr">Users cannot review a page which they cannot edit.</span> <span lang="en" dir="ltr" class="mw-content-ltr">They cannot lower the level of a revision from a level they cannot set.</span> <span lang="en" dir="ltr" class="mw-content-ltr">Blocked users cannot do anything.</span> [[File:FlaggedRevs - Review2.png|650px]] <span id="Upkeep"></span> === Manutenção === <span lang="en" dir="ltr" class="mw-content-ltr">At '''Special:UnreviewedPages''', there is a list of pages that have not yet been reviewed, for '''Editors''' only.</span> <span lang="en" dir="ltr" class="mw-content-ltr">A namespace must be selected and an optional category filter is also present.</span> [[File:FlaggedRevs - UnreviewedPages.png|650px]] <span lang="en" dir="ltr" class="mw-content-ltr">At '''Special:OldReviewedPages''', there is a list of pages that have been reviewed, but have edits pending.</span> Isto é apenas para os '''Editores'''. Também está presente um filtro de categoria opcional. [[File:FlaggedRevs - OldReviewedPages.png|650px]] <div lang="en" dir="ltr" class="mw-content-ltr"> Pages that cannot be reviewed can still be patrolled for anti-vandalism purposes by '''Editors''' to see what has been checked already. </div> <span id="Logging"></span> === Registos === <div lang="en" dir="ltr" class="mw-content-ltr"> All relevant actions are permanently logged, so everything can be tracked and overseen properly. </div> <div lang="en" dir="ltr" class="mw-content-ltr"> *A log of promotion/demotion of editors and the reasons is kept at '''[[Special:Log/userrights]]'''. </div> <div lang="en" dir="ltr" class="mw-content-ltr"> *A log of the approval/unapproval of revisions is kept at '''[[Special:Log/review]]'''. </div> <div lang="en" dir="ltr" class="mw-content-ltr"> *A log of changes to the stable versioning configuration to pages is logged at '''[[Special:Log/stable]]'''. </div> <span id="Notes"></span> == Notas == <div lang="en" dir="ltr" class="mw-content-ltr"> * <code>{{ll|Manual:$wgUseRCPatrol|$wgUseRCPatrol}}</code> is enabled with the extension. </div> <span lang="en" dir="ltr" class="mw-content-ltr">Patrolling of reviewable pages is disabled, but ''flagged'' revisions are marked as patrolled in Recent Changes.</span> <span lang="en" dir="ltr" class="mw-content-ltr">This will mean that the only way to patrol a reviewable revision is to flag it.</span> <span lang="en" dir="ltr" class="mw-content-ltr">Non-reviewable pages still behave as normal (depending on site patrol settings).</span> <div lang="en" dir="ltr" class="mw-content-ltr"> * Sysops can change whether the stable version is shown by default for specific pages. </div> <span lang="en" dir="ltr" class="mw-content-ltr">To disable this, add <syntaxhighlight lang="php" inline>$wgGroupPermissions['sysop']['stablesettings'] = false;</syntaxhighlight> to <code>LocalSettings.php</code>.</span> <div lang="en" dir="ltr" class="mw-content-ltr"> * Page links, category, image, template, language, and external links are still based on the current version of pages. </div> <div lang="en" dir="ltr" class="mw-content-ltr"> * Users cannot move pages they cannot review. </div> <span lang="en" dir="ltr" class="mw-content-ltr">This is deliberate; see {{task|T15994}}.</span> <span lang="en" dir="ltr" class="mw-content-ltr">To work around this, add <syntaxhighlight lang="php" inline>$wgGroupPermissions['autoconfirmed']['movestable'] = true;</syntaxhighlight> to LocalSettings.php</span> <div lang="en" dir="ltr" class="mw-content-ltr"> * You can demote '''Editors''' either temporarily by blocking them or permanently via '''[[Special:UserRights]]'''. </div> <span lang="en" dir="ltr" class="mw-content-ltr">An extra demotion log item will appear for tracking purposes.</span> == API == <div lang="en" dir="ltr" class="mw-content-ltr"> FlaggedRevs adds API modules for reviewing revisions and configuring "stabilization" of pages, a module for retrieving flag configuration, and two list modules corresponding to the special pages for unreviewed pages and "old" reviewed pages. </div> === action{{=}}review === Revê uma página. ; Parâmetros *<code>revid</code>: <span lang="en" dir="ltr" class="mw-content-ltr">The revision ID for which to set the flags</span> *<code>token</code>: <span lang="en" dir="ltr" class="mw-content-ltr">A csrf token retrieved through {{ll|API:Tokens|action{{=}}query&meta{{=}}tokens}}</span> *<code>comment</code>: <span lang="en" dir="ltr" class="mw-content-ltr">Comment for the review (optional)</span> *<code>flag_accuracy</code>: <span lang="en" dir="ltr" class="mw-content-ltr">Set the flag named "accuracy" to the specified value; (replace "accuracy" with the flag name to set another flag)</span> *<code>unapprove</code>: <span lang="en" dir="ltr" class="mw-content-ltr">If set, revision will be unapproved rather than approved</span> ; Exemplo {{ApiEx |desc=<span lang="en" dir="ltr" class="mw-content-ltr">Review revision 12345</span> |p1=action=review |p2=revid=12345 |p3=token=123ABC |p4=flag_accuracy=1 |p5=comment=OK |result= <syntaxhighlight lang="xml"> <api> <review revid="12345" /> </api> </syntaxhighlight>}} === action{{=}}stabilize === <div lang="en" dir="ltr" class="mw-content-ltr"> Changes page stabilization settings. </div> ; Parâmetros * <code>title</code>: <span lang="en" dir="ltr" class="mw-content-ltr">Title of page to be stabilized</span> * <code>reason</code>: <span lang="en" dir="ltr" class="mw-content-ltr">Reason for stabilization</span> * <code>expiry</code>: <span lang="en" dir="ltr" class="mw-content-ltr">Stabilization expiry. Default: infinite</span> * <code>review</code>: <span lang="en" dir="ltr" class="mw-content-ltr">Whether to auto-review the page</span> * <code>watch</code>: <span lang="en" dir="ltr" class="mw-content-ltr">Whether to watch the page</span> * <code>token</code>: <span lang="en" dir="ltr" class="mw-content-ltr">An edit token retrieved through {{ll|API:Tokens|action{{=}}query&meta{{=}}tokens}}</span> <div lang="en" dir="ltr" class="mw-content-ltr"> * For protection-like configurations (<syntaxhighlight lang="php" inline>$wgFlaggedRevsProtection=true</syntaxhighlight>): </div> *: <code>protectlevel</code>: <span lang="en" dir="ltr" class="mw-content-ltr">The right users must have in order for their edits to ''not'' require review.</span> <div lang="en" dir="ltr" class="mw-content-ltr"> * Otherwise (<syntaxhighlight lang="php" inline>$wgFlaggedRevsProtection=false</syntaxhighlight>): </div> *: <code>default</code>: <span lang="en" dir="ltr" class="mw-content-ltr">Default revision to show (latest | stable)</span> *: <code>autoreview</code>: <span lang="en" dir="ltr" class="mw-content-ltr">Restriction level for the 'autoreview' right (sysop | none). Default: none</span> ;Exemplo {{ApiEx |desc=<span lang="en" dir="ltr" class="mw-content-ltr">Configure the page "Foo" such that only reviewed revisions are shown by default</span> |p1=action=stabilize |p2=title=Foo |p3=reason=Because_I_can |p5=default=stable |p6=token=abc123 |result= <syntaxhighlight lang="xml"> <api> <stabilize title="Foo" default="stable" autoreview="none" expiry="infinite" /> </api> </syntaxhighlight>}} === action{{=}}flagconfig === <div lang="en" dir="ltr" class="mw-content-ltr"> Shows information about review flag configuration. </div> <div lang="en" dir="ltr" class="mw-content-ltr"> The following parameters are returned for each tag: </div> * <code>name</code>: <span lang="en" dir="ltr" class="mw-content-ltr">the name of the flag</span> * <code>levels</code>: <span lang="en" dir="ltr" class="mw-content-ltr">the number of possible levels the flag has (not counting the "unreviewed" level)</span> <div lang="en" dir="ltr" class="mw-content-ltr"> The displayed name for each flag and the different level names for each flag are MediaWiki messages, so can be set and retrieved through the appropriate page; for example the name for the first level of the "accuracy" flag is located at [[MediaWiki:revreview-accuracy-1]]. </div> ; Exemplo {{ApiEx |desc=<span lang="en" dir="ltr" class="mw-content-ltr">Retrieve flag configuration</span> |p1=action=flagconfig |result= <syntaxhighlight lang="xml"> <api> <flagconfig> <tag name="value" levels="3" tier1="1" /> </flagconfig> </api> </syntaxhighlight>}} === list{{=}}unreviewedpages === <div lang="en" dir="ltr" class="mw-content-ltr"> Lists pages which have never been reviewed. </div> ; Parâmetros *<code>urstart</code>: <span lang="en" dir="ltr" class="mw-content-ltr">Start listing at this page title.</span> *<code>urend</code>: <span lang="en" dir="ltr" class="mw-content-ltr">Stop listing at this page title.</span> *<code>urnamespace</code>: <span lang="en" dir="ltr" class="mw-content-ltr">The namespaces to enumerate.</span> *<code>urfilterredir</code>: <span lang="en" dir="ltr" class="mw-content-ltr">How to filter for redirects</span> *<code>urfilterlevel</code>: <span lang="en" dir="ltr" class="mw-content-ltr">How to filter by quality</span> (0=sighted,1=quality) *<code>urlimit</code>: <span lang="en" dir="ltr" class="mw-content-ltr">How many total pages to return.</span> ; Exemplo {{ApiEx |desc=<span lang="en" dir="ltr" class="mw-content-ltr">List pages in the main namespace that have not been "sighted"</span> |p1=action=query |p2=list=unreviewedpages |p3=urnamespace=0 |p4=urfilterlevel=0 |result= <syntaxhighlight lang="xml"> <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> </syntaxhighlight>}} === list{{=}}oldreviewedpages === <div lang="en" dir="ltr" class="mw-content-ltr"> Lists pages that have at some point been reviewed, but for which the most recent revision is not reviewed. </div> ;Parâmetros *<code>orstart</code>: <span lang="en" dir="ltr" class="mw-content-ltr">Start listing from this timestamp</span> *<code>orend</code>: <span lang="en" dir="ltr" class="mw-content-ltr">Stop listing at this timestamp.</span> *<code>ordir</code>: <span lang="en" dir="ltr" class="mw-content-ltr">In which direction to list.</span> *<code>ornamespace</code>: <span lang="en" dir="ltr" class="mw-content-ltr">The namespaces to enumerate.</span> *<code>orfilterredir</code>: <span lang="en" dir="ltr" class="mw-content-ltr">How to filter for redirects</span> *<code>orlimit</code>: <span lang="en" dir="ltr" class="mw-content-ltr">How many total pages to return.</span> ;Exemplo {{ApiEx |desc=<span lang="en" dir="ltr" class="mw-content-ltr">List pages in the main namespace with recent unreviewed revisions</span> |p1=action=query |p2=list=oldreviewedpages |p3=ornamespace=0 |result= <syntaxhighlight lang="xml"> <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> </syntaxhighlight>}} === prop{{=}}flagged === <div lang="en" dir="ltr" class="mw-content-ltr"> Use [https://en.wikipedia.org/w/api.php?action=help&modules=query%2Bflagged action=query&prop=flagged] to get information about the flagging status of the given pages. </div> <span id="Limitations"></span> == Limitações == <div lang="en" dir="ltr" class="mw-content-ltr"> * Transclusions across wikis are not stabilized </div> <span id="Uninstalling"></span> == Desinstalação == <div lang="en" dir="ltr" class="mw-content-ltr"> # Remove the <code>require_once</code> or <code>wfLoadExtension</code> line from <code>LocalSettings.php</code> </div> <div lang="en" dir="ltr" class="mw-content-ltr"> # Drop the tables in <code>FlaggedRevs.sql</code> </div> <div lang="en" dir="ltr" class="mw-content-ltr"> # Drop the columns <code>page_ext_reviewed</code>, <code>page_ext_quality</code>, and <code>page_ext_stable</code>, and the index <code>ext_namespace_reviewed</code> from the <code>page</code> table (if they exist; only older versions of FlaggedRevs used these) </div> <div lang="en" dir="ltr" class="mw-content-ltr"> # Run <code>maintenance/refreshLinks.php</code> from the command line to flush out the stable version links </div> <div lang="en" dir="ltr" class="mw-content-ltr"> # Run <code>maintenance/rebuildFileCache.php 0 overwrite</code> from the command line if you use {{phpi|$wgFileCache}} </div> <span id="Testing_platforms"></span> == Testar plataformas == *[https://en.wikipedia.beta.wmflabs.org {{#language:en|{{PAGELANGUAGE}}}}] *[https://de.wikipedia.beta.wmflabs.org {{#language:de|{{PAGELANGUAGE}}}}] <div lang="en" dir="ltr" class="mw-content-ltr"> == See also == </div> * {{ll|Help:Patrolled edits}} * {{ll|Extension:FlaggedRevs/Specifications}} * {{ll|Extension:Approved Revs}} * {{ll|Extension:ContentStabilization}} * {{ll|Extension:Moderation}} – <span lang="en" dir="ltr" class="mw-content-ltr">edits remain private until they're approved</span> * [[meta:Flagged Revisions#Flagged Revisions on Wikimedia projects|<span lang="en" dir="ltr" class="mw-content-ltr">Flagged Revisions on Wikimedia projects</span>]] * {{ll|Project:Editor}} – <span lang="en" dir="ltr" class="mw-content-ltr">documentation about the user groups and rights created by this extension, while it was at use on mediawiki.org</span> <span id="External_links"></span> == Hiperligações externas == * ''[[WMFBlog:2008/07/30/quality-assurance-in-an-open-project/|Garantia de Qualidade num Projeto Aberto]]'' – Publicação no blogue da Wikimedia 2008 * [[commons:Category:Flagged Revisions|<span lang="en" dir="ltr" class="mw-content-ltr">Images of Flagged Revisions</span>]] – <span lang="en" dir="ltr" class="mw-content-ltr">Wikimedia Commons</span> * [[meta:Flagged Revisions|<span lang="en" dir="ltr" class="mw-content-ltr">About Flagged Revisions</span>]] – <span lang="en" dir="ltr" class="mw-content-ltr">Meta-Wiki</span> <span id="Licensing"></span> == Licença == © GPL, Aaron Schulz, Joerg Baach, 2007 {{OnWikimedia}} {{Used by}} {{GPL}} [[Category:Revision management extensions{{#translation:}}]] [[Category:Extensions requiring shell access{{#translation:}}]] [[Category:Rating extensions{{#translation:}}]]
Toggle limited content width