Jump to content

Extensión:Evaluaciones de páginas

From mediawiki.org
Revision as of 23:04, 18 September 2024 by USB4215 (talk | contribs) (Created page with "==API==")
Manual de extensiones de MediaWiki
PageAssessments
Estado de lanzamiento: estable
Implementación Función del analizador , Base de datos
Descripción Una extensión para almacenar las evaluaciones de artículos (por ejemplo, para WikiProjects) en una nueva tabla de base de datos
Autor(es) Niharika Kohli
Frances Hocutt
Ryan Kaldari
Última versión 1.1.0 (2016-01-11)
MediaWiki >= 1.43
Cambios de la base de datos
Tablas page_assessments
page_assessments_projects
Licencia GNU Licencia Pública general 2.0 o posterior
Descarga
  • $wgPageAssessmentsOnTalkPages
  • $wgPageAssessmentsSubprojects
Descargas trimestrales 4 (Ranked 123rd)
Traduce la extensión PageAssessments si está disponible en translatewiki.net
Asuntos Tareas abiertas · Reportar un bug

Esta extensión es para almacenar las evaluaciones de artículos (por ejemplo, para WikiProjects) de una manera estructurada y consultable. Para ver un ejemplo de cómo se realizan las evaluaciones de artículos, consulte las directrices en Wikipedia.

Instalación

  • Descarga y extrae los archivos en un directorio denominado «PageAssessments» dentro de la carpeta extensions/.
    Developers and code contributors should install the extension from Git instead, using:cd extensions/
    git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/PageAssessments
  • Añade el siguiente código en la parte final de tu archivo LocalSettings.php :
    wfLoadExtension( 'PageAssessments' );
    
  • Ejecuta la secuencia de actualización, que creará automáticamente las tablas de la base de datos que necesita esta extensión.
  • Yes Hecho – Navega a Special:Version en el wiki para verificar que la extensión se haya instalado correctamente.

También puede utilizar estas opciones de configuración en su LocalSettings.php:

  • $wgPageAssessmentsOnTalkPages — Si las evaluaciones se registran normalmente en las páginas en sí mismas en lugar de en las págines de conversación, establezca esto en false (default: true).
  • $wgPageAssessmentsSubprojects — Si los proyectos de su wiki tienen subproyectos o grupos de trabajo para los que desea registrar evaluaciones separadas, establezca esto en true (default: false).

Uso

La función del parser para crear una nueva evaluación es: {{#assessment: <nombre del proyecto wikipédico> | <clase> | <importancia>}}

  • name of the wikiproject — un nombre corto para el proyecto que evalúa el artículo, por ejemplo, "Medicine" o "Hungarian culture". Puede tener hasta 128 caracteres de largo.
  • class — una clasificación de calidad, por ejemplo, "B" o "FA" Consulte las calificaciones de clase en Wikipedia para obtener un ejemplo más completo. Puede tener hasta 20 caracteres de largo.
  • importance — un ranking de la importancia del artículo para el proyecto, por ejemplo, "Low" o "High" Puede tener hasta 20 caracteres de largo.

Se espera que la función assessment parser esté en la página de discusión de la página en revisión, sin embargo, puede incluirse en la página misma si $wgPageAssessmentsOnTalkPages está configurado para false. Una página puede tener más de una función de evaluación para diferentes proyectos.

Si una plantilla de evaluación ya está en uso en varias páginas, la función de parser se puede incorporar dentro de la plantilla en lugar de tener que editar la página de discusión de cada artículo individual.

Ejemplo de uso

La importancia/prioridad de un artículo puede ser diferente dependiendo del WikiProject:

{{#assessment:Medicine|A|Low}}
{{#assessment:Biology|B|High}}

Explicación:

Utilizando este ejemplo en una página de discusión, declara la página actual dentro del proyecto Medicina, con calidad A, y con poca importancia.

También declara la página actual del proyecto Biología, con calidad B, y con alta importancia.

API

The PageAssessments extension includes three API query modules: pageassessments, projectpages, and projects.

Pageassessments

pageassessments is a new property query for the MediaWiki Action API. It is used to retrieve assessment metadata for one or more pages.

Examples

Get project and assessment data for page "Apple".

api.php?action=query&prop=pageassessments&titles=Apple

Get project and assessment data for pages "Apple" and Pear, using the newer API result format.

api.php?action=query&prop=pageassessments&titles=Apple|Pear&formatversion=2

Get project and assessment data for page "Apple", including subprojects and task forces (only available if $wgPageAssessmentsSubprojects is true).

api.php?action=query&prop=pageassessments&titles=Apple&pasubprojects=true

Projectpages

projectpages is a new list query. It is used to retrieve all the pages assessed by a particular WikiProject. This query can be used as a generator. By adding wppassessments=true, you can also get the assessment metadata for each of the pages.

Examples

Get first 10 pages associated with any WikiProject:

Get first 10 pages associated with WikiProject Medicine, including assessment data:

Get page info for first 10 pages associated with WikiProject Textile Arts:

Projects

projects is a new list query. It is used to retrieve a list of all the WikiProjects on a wiki. The results are returned as an array of project names.

Examples

Get a list of all the WikiProjects.

api.php?action=query&list=projects

Get a list of all the WikiProjects, including subprojects and task forces (only available if $wgPageAssessmentsSubprojects is true).

api.php?action=query&list=projects&pjsubprojects=true

Special page

PageAssessments also provides an on-wiki interface for retrieving assessment data at Special:PageAssessments.

Database tables

PageAssessments creates two new database tables:

page_assessments stores the assessment metadata, while page_assessments_projects stores the names of WikiProjects (so that they don't have to be recorded in full as part of each assessment record in the page_assessments table). Both tables are required for proper functioning of the parser function and APIs. The tables should exist on any wiki that has the PageAssessments extension installed. If PageAssessments is uninstalled, both tables can be dropped safely.

The purgeUnusedProjects.php maintenance script can be run to remove projects from the page_assessments_projects table that are no longer used by any assessments.

See also