扩展:PageAssessments
 發佈狀態： 穩定版本 |
|
|---|---|
| 实现 | 解析器函数, 数据库 |
| 描述 | 用于在一个新的数据库表中存储条目评级（例如维基专题的评级）的扩展。 |
| 作者 | Niharika Kohli Frances Hocutt Ryan Kaldari |
| 最新版本 | 1.1.0 (2016-01-11) |
| MediaWiki | >= 1.40.0 |
| 数据库更改 | 是 |
| Composer | mediawiki/page-assessments |
| 表 | page_assessments page_assessments_projects |
| 许可协议 | GNU通用公眾授權條款2.0或更新版本 |
| 下載 | |
|
|
| 季度下載量 | 10 (Ranked 163rd) |
| 翻譯PageAssessments的扩展，若在translatewiki.net可用 | |
| 問題 | 尚未完成的工作 · 报告錯誤 |
该扩展用于以结构化和可查询的方式存储条目评级（例如维基专题的评级）。 有关如何进行条目评级的示例，请参阅维基百科上的指引。
安裝
- 下载文件，并将其放置在您
extensions/文件夹中的PageAssessments目录内。 - 将下列代码放置在您的
LocalSettings.php的底部：wfLoadExtension( 'PageAssessments' );
- 运行更新脚本，它将自动创建此扩展必须依赖的数据库表。
完成 – 在您的wiki上导航至Special:Version，以验证已成功安装扩展。
致使用MediaWiki 1.24或更早版本的用户：
上面的说明介绍的是安装此扩展的新方法，它使用wfLoadExtension()。
如果您需要在早期版本（MediaWiki 1.24和更早版本）中安装此扩展，而不是wfLoadExtension( 'PageAssessments' );，您需要使用：
require_once "$IP/extensions/PageAssessments/PageAssessments.php";
你也可以在你的LocalSettings.php中使用这些配置选项：
$wgPageAssessmentsOnTalkPages— 如果评级通常被记录在页面本身而不是讨论页上，则将此设置为false（默认为true）。$wgPageAssessmentsSubprojects— 如果您的wiki上的专题有子专题或工作组，您希望为其记录单独的评级，请将其设置为true（默认为false）。
用法
创建新评级的解析器函数是：
{{#assessment: <维基专题的名称> | <等级> | <重要度>}}
name of the wikiproject— 评级该条目的专题的简短名称，例如，“Medicine”或“Hungarian culture”。 最长可以是128个字符。class— 质量评级，例如，“B”或“FA”。 参见维基百科上的质量分级以获得更详细的示例。 最长可以是20个字符。importance— 该条目对专题的重要度的评级，例如，“Low”或“High”。 最长可以是20个字符。
assessment解析器函数被期望位于被评级的页面的讨论页上，然而如果$wgPageAssessmentsOnTalkPages被设置为false，它可能被包含在页面本身。
一个页面可以有一个以上的评级功能，用于不同的专题。
用法示例
文章的重要度/优先级可能因维基专题的不同而不同：
{{#assessment:Medicine|A|Low}}
{{#assessment:Biology|B|High}}
API
PageAssessments扩展包括三个API查询模块：pageassessments，projectpages和projects。
Pageassessments
pageassessments是MediaWiki Action API的一个新的属性查询。
它用于检索一个或多个页面的评级元数据。
示例
获得“Apple”页面的专题和评级数据。
api.php?action=query&prop=pageassessments&titles=Apple
使用较新的API结果格式，获得“Apple”和Pear页面的专题和评级数据。
api.php?action=query&prop=pageassessments&titles=Apple|Pear&formatversion=2
获取“Apple”页面的专题和评级数据，包括子专题和工作组（只有在$wgPageAssessmentsSubprojects为true时才可用）。
api.php?action=query&prop=pageassessments&titles=Apple&pasubprojects=true
Projectpages
projectpages是一个新的列表查询。
它用于检索由特定维基专题评级的所有页面。
此查询可以用作生成器。
通过添加wppassessments=true，你也可以获得每个页面的评级元数据。
示例
获得与任何维基专题相关的前10个页面：
获得与Medicine专题相关的前10个页面，包括评级数据：
获取与Textile Arts专题相关的前10个页面的页面信息：
Projects
projects是一个新的列表查询。
它用于检索一个维基上的所有维基专题的列表。
结果将以专题名称的数组（array）的形式返回。
示例
获取所有维基专题的列表。
api.php?action=query&list=projects
获取所有维基专题的列表，包括子专题和工作组（只有在$wgPageAssessmentsSubprojects为true时才可用）。
api.php?action=query&list=projects&pjsubprojects=true
特殊页面
PageAssessments也提供了一个wiki上的界面用于检索的评级数据，该界面位于Special:PageAssessments。
Database tables
PageAssessments创建了两个新的数据库表：
page_assessmentspage_assessments_projects
page_assessments存储评级元数据，而page_assessments_projects存储维基专题的名称（这样它们就不必作为page_assessments表中每个评级记录的一部分被完整地记录下来）。
这两个表都是解析器功能和API的正常运行所需要的。
这些表应该存在于任何安装了PageAssessments扩展的维基上。
如果PageAssessments被卸载，这两个表都可以被安全地丢弃。
可以运行purgeUnusedProjects.php维护脚本，从page_assessments_projects表中删除不再被任何评级使用的专题。
参见
- Community Tech/PageAssessments，位于元维基
- Create new extension implementing article importance and quality
| 此扩展用于一个或多个维基媒体项目。 这可能意味着扩展足够稳定、运作足够良好，可以用在这样的高流量的网站上。 请在维基媒体的CommonSettings.php和InitialiseSettings.php配置文件中查找此扩展的名称以查看哪些网站安装了该扩展。 特定wiki上的已安装的扩展的完整列表位于Special:Version页面。 |
| 这个扩展包含在以下包和/或维基农场: 这不是一个权威的名单。一些维基农场/主机可能包含这个extension，即使它们没有在这里列出。经常检查您的维基农场/主机或包来确认。 |
| 此页面或项目由信息框中提到的多人维护。
获得帮助： |
