Extension:FlaggedRevs
La extensión Flagged Revisions permite que los usuarios que pertenecen a los grupos de Editores y Revisores evaluar los cambios que se realizan en los artículos y establecerlas como verificadas para que sean mostradas en la página. Esto hace que MediaWiki actúe como un Sistema de Gestión de Contenido (CMS).
Instalación
- Descarga y extrae los archivos en un directorio denominado «
FlaggedRevs
» dentro de la carpetaextensions/
.
Developers and code contributors should install the extension from Git instead, using:cd extensions/
git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/FlaggedRevs - Añade el siguiente código en la parte final de tu archivo LocalSettings.php :
wfLoadExtension( 'FlaggedRevs' );
- Ejecuta la secuencia de actualización, que creará automáticamente las tablas de la base de datos que necesita esta extensión.
- Configurar como sea necesario.
- Hecho – Navega a Special:Version en el wiki para verificar que la extensión se haya instalado correctamente.
Instalación
AllowEncodedSlashes
If you are using Apache 2.3.12 or later, you should set AllowEncodedSlashes to "NoDecode".
Add the following line to your <VirtualHost>
or, if you don't have one, at the end of your httpd.conf file:
AllowEncodedSlashes NoDecode
After you edited httpd.conf, Apache needs to be restarted.
Alter your .htaccess (if needed)
If you are shortening your URLs , you need to add an exception to .htaccess to allow the use of the REST API .
FlaggedRevs calls on rest.php . For example:
https://[domain]/w/rest.php/flaggedrevs/internal/review/Main_Page
If the .htaccess conditions are not properly set when the above url is called, FlaggedRevs will literally try to access an article named "W/rest.php/flaggedrevs/internal/review/Main Page
".
Here is one way to add an exception to .htaccess, emphasis added:
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]
Promote users to reviewers
Después que FlaggedRevs es instalado, ningún usuario que posea los permisos de revisor podrá ver el widget. Para fijar esto, inicia sesión en una wiki en que seas burócrata y dirígete a Special:UserRights y otorga los derechos de revisor a uno o más usuarios. Los revisores verán el widget al fondo de una página que sea editable.
Article review statistics (optional)
/var/www/mediawiki
.Crear un cron de trabajo para correr extensions/FlaggedRevs/maintenance/updateStats.php
en un intervalo regular.
Ejecutar time php updateStats.php
para ver cuánto tiempo toma el guión para correr y poner su cron con intervalos de trabajos aproximados.
Por ejemplo, para crear un cron de trabajo de carreras updateStats.php
con www-data
cada hora:
@hourly php /var/www/mediawiki/extensions/FlaggedRevs/maintenance/updateStats.php
Configuración
Partes de esta página (aquellas relacionadas con funcionalidades eliminadas en la versión maestra) están desactualizadas. |
Derechos y grupos de usuario
Por defecto, nadie puede revisar cualquier página, así que el primer paso es instalar los derechos de usuario.
Grupos de usuario | Derechos de usuario |
---|---|
reviewer | validate |
review | |
editor | |
autoreview | |
unreviewedpages |
Derechos de usuario
FlaggedRevs crea los siguientes derechos de usuario:
review
– El usuario puede revisar las revisionesvalidate
– El usuario puede revisar las revisiones y puede poner todas las etiquetas a todos los nivelesautoreview
– Las revisiones nuevas hechas por el usuario son automáticamente marcadas como revisadas.autoreviewrestore
– autorevisión de las reversiones realizadas por el usuario.unreviewedpages
– El usuario puede ver la página Special:UnreviewedPagesstablesettings
– El usuario puede cambiar las configuraciones de las versiones estables de cualquier páginamovestable
– El usuario puede mover páginas con versiones estables
Grupos de usuario
FlaggedRevs crea los siguientes grupos de usuario:
editor
– Recibeautoreview, review, unreviewedpages
, más el derecho estandar de MediaWikiautoconfirmed, editsemiprotected
reviewer
– Recibeautoreview, review, unreviewedpages, validate
, más el derecho estandar de MediaWikiautoconfirmed, editsemiprotected
autoreview
– Recibeautoreview
¿Cómo puedo asignar derechos de usuario?
Los derechos de usuario pueden ser asignados de dos maneras:
- Asignando los derechos a los grupos de usuario
Asignar estos derechos de usuario a existir en los grupos de usuario enLocalSettings.php
:
$wgGroupPermissions['sysop']['review'] = true; //allow administrators to review revisions
- Asignar los derechos a usuarios específicos
Agregar de manera manual cuentas a los grupos apropiados mediante Special:UserRights.
- Por defecto:
- Los burócratas pueden añadir y retirar el derecho de Revisores.
- Los administradores pueden añadir o retirar los derechos de Autorevisado y Editores.
Configuración básica
FlaggedRevs.php
viene con un número de configuraciones variables.
Estos tendrán que ser configurados en LocalSettings.php
.
$wgFlaggedRevsNamespaces
– Pone los espacios de nombres que deben estar sujetos a revisión. Se trata de una matriz de enteros. Mira el comienzo de Manual:Constantes de espacios de nombres para ver qué espacio de nombres por defecto y utiliza las constantes definidas para facilitar la lectura.$wgFlaggedRevsTags
– Pone las etiquetas y sus tres configuraciones: 'levels', $2 y $3- Definición
$wgFlaggedRevsTags
es una matriz asociativa con claves correspondientes a cada uno de los nombres de etiquetas. The only meaningful value of the array is 'levels', which controls the number of review levels, and the array can only have one element.- Etiquetado
- Cada etiqueta puede ser etiquetada editando la página MediaWiki:revreview-<tag-name>.
- Cada nivel de etiqueta puede ser etiquetado editando la página MediaWiki:revreview-<tag-name>-<level-number>.
- Por defecto, las etiquetas sean etiquetadas cuando esten puestas en
$wgFlaggedRevsTags
. Por ejemplo, para mostrar etiquetas con su nombre capitalizado, el administrador tiene que editar estas páginas con el contenido mostrado:
- Los etiquetar los niveles de etiqueta, el administrador tiene que crear estas páginas con el contenido mostrado:
etiqueta nivel etiquetando páginas contenido accuracy 0 MediaWiki:revreview-accuracy-0 Inadecuada 1 MediaWiki:revreview-accuracy-1 Vista 2 MediaWiki:revreview-accuracy-2 Precisa
- El resultado de la instalación será:
Nombres de las etiquetas Nombres de los niveles Precisión Inadecuada Vista Precisa
$wgFlaggedRevsOverride
– Si la versión estable es el contenido por defecto para las páginas.- Las páginas individuales pueden ser configuradas para tener la versión estable o de borrador por defecto para los administradores.
$wgFlaggedRevsTagsRestrictions
– Una matriz con teclas correspondientes a cada tipo de flag, y los valores que son conjuntos de derechos y cómo los usuarios con altos niveles se pueden evaluar los flags (nivel de etiqueta integral).- Ejemplo
$wgFlaggedRevsTagsRestrictions = [ 'accuracy' => [ 'review' => 1 ], ];
Interfaz de usuario
$wgSimpleFlaggedRevsUI
– Cuándo esta habilitado, es más sencillo, el icono UI basado se utiliza. No afecta las etiquetas mostradas en el modo de edición.$wgFlaggedRevsLowProfile
– Este ajuste se esconde en la caja de estado de revisión de la barra de páginas que son revisados en su versión más reciente. El texto explicativo es también extraido de algunos sitios.
Flujos de trabajo
$wgFlaggedRevsAutoReview
– Si está activado, cada edición por un usuario con los derechos de 'autoreview' se revisa automáticamente al guardar. No hay necesidad de apretar el botón "Enviar revisión". Esta característica requiere que la revisión anterior haya sido revisada previamente: otherwise, autorevisado.$wgFlaggedRevsTagsAuto
– SiwgFlaggedRevsAutoReview
está habilitado, las configuraciones controlan que cada etiqueta sea revisada. Si se permite, las etiquetas autorevisado será revisadas al mismo nivel de revisión que eran las etiquetas anteriores. Este es un arreglo asociativo; cada tecla es una etiqueta y cada valor es un nivel de etiqueta.- Ejemplo
$wgFlaggedRevsTagsAuto = [ 'accuracy' => 1 ];
- Los cambios en las plantillas y las imágenes son de autorevisados (por página). Esto posiblemente podría causar versiones defectuosas para ser revisadas. Los usuarios tendrían que ser incentivados a que revisen la previsualización de sus cambios antes de guardar. Es posible que desee ajustar la $1 y
$wgNamespaceProtection[NS_TEMPLATE]
como[ 'editor' ]
o[ 'autoconfirmed' ]
Promoción de usuario automática
$wgFlaggedRevsAutopromote
– Una matriz con teclas durante días, ediciones espaciado temporal, puntos de referencia, confirmación de correo, las ediciones recientes de una página, ediciones totales del contenido, páginas de contenido editado, los resúmenes de edición utilizados, IP única y la existencia de páginas de usuario como teclas. Los valores corresponden a cuántos días necesita el usuario para ser promocionado automáticamente al estado de Editor, tienen que tener confirmado su correo electrónico y tener una página de usuario. El usuario tiene que haber hecho X ediciones o tener Y días registrados, donde X es el número de ediciones y Y es el tiempo requerido. Establecer esta variable en false para desactivar esta complemento.- Si al usuario se le revoca el estado de Editor, ellos no recuperarán sus derechos automáticamente (el registro del estado de editor está comprobado para revocaciones).
- Algunos de estas cuentas no son retroactivas, así que puedes notar un retraso en las promociones.
- Ejemplo
- Para
$wgFlaggedRevsAutopromote
, uno podría tener: $wgFlaggedRevsAutopromote['days'] = 60; # Días desde su registro $wgFlaggedRevsAutopromote['edits'] = 150; # Total de ediciones en la cuenta $wgFlaggedRevsAutopromote['excludeDeleted'] = true; # excluir ediciones borradas del recuento de 'edits' anteriores? $wgFlaggedRevsAutopromote['spacing'] = 3; # Intervalos de ediciones en el espacio $wgFlaggedRevsAutopromote['benchmarks'] = 15; # ¿Cuántos intervalos de edición son necesarios? $wgFlaggedRevsAutopromote['recentContentEdits'] = 10; # $wgContentNamespaces Ediciones en cambios recientes $wgFlaggedRevsAutopromote['totalContentEdits'] = 30; # $wgContentNamespaces ediciones $wgFlaggedRevsAutopromote['uniqueContentPages'] = 10; # $wgContentNamespaces Únicas páginas editadas $wgFlaggedRevsAutopromote['editComments'] = 5; # ¿Cuántas ediciones en los comentarios fueron utilizadas? $wgFlaggedRevsAutopromote['email'] = true; # ¿El usuario tiene que ser autoconfirmado? $wgFlaggedRevsAutopromote['userpageBytes'] = 0; # si se necesita una página de usuario, ¿cuál es el tamaño mínimo?
Avanzado
$wgFlaggedRevsRestrictionLevels
- Restriction levels forautoreview
/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 (Help:Pending changes ), rather than the standard configuration.$wgFlaggedRevsAutoConfirm
- Define when users get to have their own edits auto-reviewed. Set tofalse
to disable.$wgFlaggedRevsHandleIncludes
- Whether to use stable versions of templates when rendering the stable version of a page.
Para tener una wiki donde los usuarios no registrados puedan ver sólo la versión estable de los artículos, véase Extension:FlaggedRevs/Restricting unapproved revisions .
Uso
- Véase también: Help:FlaggedRevs
Aprobando páginas
Los usuarios con un cierto nivel de estado de revisión tendrán un pequeño formulario de evaluación en vista de la página (en la parte inferior de la página) y diferenciaciones (en la parte superior de la página) que les permite revisar las ediciones. Cada etiqueta debe cumplir al menos el nivel mínimo de aprobación. Los usuarios deben mirar toda la página, incluidas las plantillas y las imágenes, antes de la revisión. El (diff estable), el enlace es muy útil para solicitar este proceso.
Los usuarios no pueden revisar una página que no pueden editar. No pueden disminuir el nivel de una revisión de un nivel que no pueden establecer. Los usuarios bloqueados no pueden hacer nada.
Mantenimiento
En Special:UnreviewedPages, hay una lista, solo para editores, de páginas que aún no se han revisado. Un espacio de nombres debe ser seleccionado y un filtro de categorías opcional también está presente.
En Special:OldReviewedPages, hay una lista de páginas que han sido revisadas, pero que tienen ediciones pendientes. Esto es solamente para Editores. Un filtro opcional de categoría esta también presente.
Páginas que no puedan ser revisadas todavía, pueden ser patrulladas por los Editores para evitar acciones vandálicas.
Registros
Todas las acciones pertinentes se registran de forma permanente, por lo que todo se pueden seguir y supervisar adecuadamente.
- Un registro de la promoción/descenso de categoría de los editores y las razones se mantiene en el Special:Log/userrights.
- Un registro de las aprobaciones/desaprobaciones de las revisones se mantienen en el Special:Log/review.
- Un registro de cambios en las versiones estables quedan registradas en el Special:Log/stable.
Notas
$wgUseRCPatrol
esta habilitado con la extensión. El patrullaje de páginas revisables está desactivada, pero las revisiones son marcadas como revisadas automáticamente en cambios recientes. Esto significa que la única forma de patrullar una revisión revisable es marcarla. Las páginas que no son revisables todavía se comportan de manera normal (dependiendo de la configuración de su sitio).
- Los administradores pueden cambiar si la revisión de la calidad tiene prioridad o si la versión estable se muestra por defecto para las páginas específicas.
Para inutilizar esta opción, añade $wgGroupPermissions['sysop']['stablesettings'] = false;
en LocalSettings.php
.
- Los enlaces de la página, categoría, imagen, plantilla, el idioma, y enlaces externos se basan todavía en la versión actual de las páginas.
- Los usuarios no pueden mover páginas que no puedan revisar. Esto es deliberado; ver task T15994. Para inutilizar esta opción, añade $code en LocalSettings.php
- Puede degradar Editores de forma temporal mediante el bloqueo de ellos o de forma permanente a través de Special:UserRights. Un elemento de anotación DE descenso adicional aparecerá con fines de seguimiento.
API
FlaggedRevs añade módulos API para la revisión de las revisiones y configuración de "estabilización" de páginas, un módulo para recuperar la configuración de la bandera, y tres módulos de la lista correspondientes a las páginas especiales para páginas revisados, sin revisar páginas y páginas "antiguas" revisadas.
action=review
Revisa una página.
- Parámetros
revid
: El ID de revisión para marcar la página para revisióntoken
: Un token de csrf recuperado desde action=query&meta=tokenscomment
: Comentarios de la revisión (opcional)flag_accuracy
: Establecer el indicador llamado "precisión" en el valor especificado; (Sustituir "precisión" con el nombre del pabellón que establezca otra plantilla)unapprove
: If set, revision will be unapproved rather than approved
- Ejemplo
Resultado |
---|
<api>
<review revid="12345" />
</api>
|
action=stabilize
Cambiar configuración de la estabilización de la página.
- Parámetros
title
: Título de la página a estabilizarreason
: Razón de la estabilizaciónexpiry
: Expiración de la estabilización. Por defecto: infinitoreview
: Ya sea para autorevisar la páginawatch
: Para mirar la páginatoken
: Un token de edición recuperado a través de action=query&meta=tokens- Para las configuraciones del estilo de protección (
$wgFlaggedRevsProtection=true
):protectlevel
: Los usuarios deben tener derecho a fin de que sus ediciones a no requieran revisión.
- De otra manera (
$wgFlaggedRevsProtection=false
):default
: Revisión a mostrar por defecto (Versión reciente|Versión estable)autoreview
: Nivel de restricción para el derecho de 'autorevisado' (Administrador|Ninguno). Por defecto: Ninguno
- Ejemplo
Resultado |
---|
<api>
<stabilize title="Foo" default="stable" autoreview="none" expiry="infinite" />
</api>
|
action=flagconfig
Muestra información sobre la configuración del flag.
Los parámetros siguientes están registrados para cada etiqueta:
name
: El nombre del flaglevels
: El número posible de niveles del flag (no contando el nivel "no revisado")
El nombre que se muestra para cada indicador y los diferentes nombres de nivel para cada indicador son mensajes de MediaWiki, por lo que se pueden modificar y obtener a través de la página apropiada; por ejemplo, el nombre para el primer nivel de la bandera de "precisión" se encuentra en MediaWiki:revreview-accuracy-1
- Ejemplo
Resultado |
---|
<api>
<flagconfig>
<tag name="value" levels="3" tier1="1" />
</flagconfig>
</api>
|
list=unreviewedpages
Lista páginas qué nunca ha sido revisadas.
- Parámetros
urstart
: Empezar la lista en este ID de página.urend
: Finalizar la lista en este ID de página.urnamespace
: Los espacios de nombres para enumerar.urfilterredir
: Filtrar Redireccionesurfilterlevel
: Filtrar por calidad (0=sighted,1=quality)urlimit
: El número de páginas totales para regresar.
- Ejemplo
Resultado |
---|
<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
Listado de páginas que en algún momento hayan sido revisadas, pero para los cuales no se revisa la versi más reciente.
- Parámetros
orstart
: Empezar a listar desde esta fecha y horaorend
: Finalizar la lista en esta fecha y hora.ordir
: La direcci´para listar.ornamespace
: Los espacios de nombre para enumerar.orfilterredir
: Filtrar las redireccionesorlimit
: El número de páginas totales para retornar.
- Ejemplo
Resultado |
---|
<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
Utilice action=query&prop=flagged para obtener información sobre el estado de marcado de las páginas dadas.
Limitaciones
- Transclusiones a través de wikis no estabilizadas
Desinstalación
- Remover la línea
require_once
owfLoadExtension
deLocalSettings.php
- Elimina las tablas en
FlaggedRevs.sql
- Elimina las columnas
page_ext_reviewed
,page_ext_quality
ypage_ext_stable
, y el indexext_namespace_reviewed
de la tablapage
(si existen; versiones mas viejas y únicas de FlaggedRevs, utiliza estos) - Ejecuta
maintenance/refreshLinks.php
en la línea de comandos del flush fuera de los enlaces de las versiones estables - Ejecuta
maintenance/rebuildFileCache.php 0 overwrite
en la línea de comandos si utilizas$wgFileCache
Probando plataformas
Véase también
- Ayuda:Ediciones verificadas
- Extension:FlaggedRevs/Specifications
- Extensión:Approved Revs - allows administrators to mark a specific revision of a page as "approved"
- Extension:ContentStabilization - allows users to mark pages as "approved" or "draft" and to view the most recent approved version of a page
- Extensión:Moderación – Las ediciones quedan privadas hasta que sean aprobadas
- Extension:Page Approvals - allows users to approve pages and automatically revokes them in case of content changes
- Flagged Revisions on Wikimedia projects
- Project:Editor – Documentación sobre los grupos de usuario y los derechos creados por esta extensión, mientras se use en mediawiki.org
Enlaces externos
- Garantía de calidad en un Proyecto Abierto – Publicación en el blog de Wikimedia 2008
- Imágenes de Flagged Revisions – Wikimedia Commons
- Acerca de Flagged Revisions – Meta-Wiki
Licencia
© GPL, Aaron Schulz, Joerg Baach, 2007
Esta extensión está siendo usada en uno o más proyectos de Wikimedia. Esto significa probablemente que la extensión es estable y funciona lo suficientemente bien como para ser usada en sitios con gran cantidad de visitas. Puedes buscar el nombre de esta extensión en los archivos CommonSettings.php e InitialiseSettings.php de Wikimedia para ver dónde se instala. Encontrarás la lista completa de extensiones instaladas en un wiki en particular en la página Special:Version del wiki. |
Esta extensión está incluida en los siguientes anfitriones/granjas wiki y/o paquetes: No se trata de una lista oficial. Algunas granjas/hosts wiki y/o paquetes pueden tener disponible esta extensión aunque no estén listados aquí. Siempre compruébelo con su anfitrión o granja wiki para confirmarlo. |
Esta obra es software libre; puede redistribuirse y/o modificarse de acuerdo con los términos de la Licencia Pública General GNU publicada por la Free Software Foundation, en la versión 2 de la licencia o cualquier otra posterior. Esta obra se distribuye con la esperanza de que pueda ser útil, pero sin garantía alguna; ni siquiera la garantía implícita de comercialización o adecuación a una finalidad específica. Véase la versión 2 y la versión 3 de la Licencia Pública General GNU para conocer más detalles. |