2020-11-22 20:00:48 +00:00
|
|
|
|
<?php
|
|
|
|
|
|
/**
|
|
|
|
|
|
* DynamicPageList3
|
|
|
|
|
|
* DPL Article Class
|
|
|
|
|
|
*
|
2020-11-24 00:40:27 +00:00
|
|
|
|
* @author IlyaHaykinson, Unendlich, Dangerville, Algorithmix, Theaitetos, Alexia E. Smith, Universal Omega
|
2020-11-22 20:00:48 +00:00
|
|
|
|
* @license GPL-2.0-or-later
|
|
|
|
|
|
* @package DynamicPageList3
|
|
|
|
|
|
*
|
|
|
|
|
|
**/
|
|
|
|
|
|
namespace DPL;
|
|
|
|
|
|
|
|
|
|
|
|
use User;
|
|
|
|
|
|
|
|
|
|
|
|
class Article {
|
|
|
|
|
|
/**
|
|
|
|
|
|
* Title
|
|
|
|
|
|
*
|
|
|
|
|
|
* @var object
|
|
|
|
|
|
*/
|
|
|
|
|
|
public $mTitle = null;
|
|
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
|
|
* Namespace ID
|
|
|
|
|
|
*
|
|
|
|
|
|
* @var string
|
|
|
|
|
|
*/
|
|
|
|
|
|
public $mNamespace = -1;
|
|
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
|
|
* Page ID
|
|
|
|
|
|
*
|
|
|
|
|
|
* @var integer
|
|
|
|
|
|
*/
|
|
|
|
|
|
public $mID = 0;
|
|
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
|
|
* Selected title of initial page.
|
|
|
|
|
|
*
|
|
|
|
|
|
* @var string
|
|
|
|
|
|
*/
|
|
|
|
|
|
public $mSelTitle = null;
|
|
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
|
|
* Selected namespace ID of initial page.
|
|
|
|
|
|
*
|
|
|
|
|
|
* @var string
|
|
|
|
|
|
*/
|
|
|
|
|
|
public $mSelNamespace = -1;
|
|
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
|
|
* Selected title of image.
|
|
|
|
|
|
*
|
|
|
|
|
|
* @var string
|
|
|
|
|
|
*/
|
|
|
|
|
|
public $mImageSelTitle = null;
|
|
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
|
|
* HTML link to page.
|
|
|
|
|
|
*
|
|
|
|
|
|
* @var string
|
|
|
|
|
|
*/
|
|
|
|
|
|
public $mLink = '';
|
|
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
|
|
* External link on the page.
|
|
|
|
|
|
*
|
|
|
|
|
|
* @var string
|
|
|
|
|
|
*/
|
|
|
|
|
|
public $mExternalLink = null;
|
|
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
|
|
* First character of the page title.
|
|
|
|
|
|
*
|
|
|
|
|
|
* @var string
|
|
|
|
|
|
*/
|
|
|
|
|
|
public $mStartChar = null;
|
|
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
|
|
* Heading (link to the associated page) that page belongs to in the list (default '' means no heading)
|
|
|
|
|
|
*
|
|
|
|
|
|
* @var string
|
|
|
|
|
|
*/
|
|
|
|
|
|
public $mParentHLink = ''; // heading (link to the associated page) that page belongs to in the list (default '' means no heading)
|
|
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
|
|
* Category links on the page.
|
|
|
|
|
|
*
|
|
|
|
|
|
* @var array
|
|
|
|
|
|
*/
|
|
|
|
|
|
public $mCategoryLinks = [];
|
|
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
|
|
* Category names (without link) in the page.
|
|
|
|
|
|
*
|
|
|
|
|
|
* @var array
|
|
|
|
|
|
*/
|
|
|
|
|
|
public $mCategoryTexts = [];
|
|
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
|
|
* Number of times this page has been viewed.
|
|
|
|
|
|
*
|
|
|
|
|
|
* @var integer
|
|
|
|
|
|
*/
|
|
|
|
|
|
public $mCounter = null;
|
|
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
|
|
* Article length in bytes of wiki text
|
|
|
|
|
|
*
|
|
|
|
|
|
* @var integer
|
|
|
|
|
|
*/
|
|
|
|
|
|
public $mSize = null;
|
|
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
|
|
* Timestamp depending on the user's request (can be first/last edit, page_touched, ...)
|
|
|
|
|
|
*
|
|
|
|
|
|
* @var string
|
|
|
|
|
|
*/
|
|
|
|
|
|
public $mDate = null;
|
|
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
|
|
* Timestamp depending on the user's request, based on user format definition.
|
|
|
|
|
|
*
|
|
|
|
|
|
* @var string
|
|
|
|
|
|
*/
|
|
|
|
|
|
public $myDate = null;
|
|
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
|
|
* Revision ID
|
|
|
|
|
|
*
|
|
|
|
|
|
* @var integer
|
|
|
|
|
|
*/
|
|
|
|
|
|
public $mRevision = null;
|
|
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
|
|
* Link to editor (first/last, depending on user's request) 's page or contributions if not registered.
|
|
|
|
|
|
*
|
|
|
|
|
|
* @var string
|
|
|
|
|
|
*/
|
|
|
|
|
|
public $mUserLink = null;
|
|
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
|
|
* Name of editor (first/last, depending on user's request) or contributions if not registered.
|
|
|
|
|
|
*
|
|
|
|
|
|
* @var string
|
|
|
|
|
|
*/
|
|
|
|
|
|
public $mUser = null;
|
|
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
|
|
* Edit Summary(Revision Comment)
|
|
|
|
|
|
*
|
|
|
|
|
|
* @var string
|
|
|
|
|
|
*/
|
|
|
|
|
|
public $mComment = null;
|
|
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
|
|
* Number of bytes changed.
|
|
|
|
|
|
*
|
|
|
|
|
|
* @var integer
|
|
|
|
|
|
*/
|
|
|
|
|
|
public $mContribution = 0;
|
|
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
|
|
* Short string indicating the size of a contribution.
|
|
|
|
|
|
*
|
|
|
|
|
|
* @var string
|
|
|
|
|
|
*/
|
|
|
|
|
|
public $mContrib = '';
|
|
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
|
|
* User text of who made the changes.
|
|
|
|
|
|
*
|
|
|
|
|
|
* @var string
|
|
|
|
|
|
*/
|
|
|
|
|
|
public $mContributor = null;
|
|
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
|
|
* Article Headings - Maps heading to count (# of pages under each heading).
|
|
|
|
|
|
*
|
|
|
|
|
|
* @var array
|
|
|
|
|
|
*/
|
|
|
|
|
|
static private $headings = [];
|
|
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
|
|
* Main Constructor
|
|
|
|
|
|
*
|
|
|
|
|
|
* @access public
|
|
|
|
|
|
* @param string Title
|
|
|
|
|
|
* @param integer Namespace
|
|
|
|
|
|
* @return void
|
|
|
|
|
|
*/
|
|
|
|
|
|
public function __construct($title, $namespace) {
|
|
|
|
|
|
$this->mTitle = $title;
|
|
|
|
|
|
$this->mNamespace = $namespace;
|
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
|
|
* Initialize a new instance from a database row.
|
|
|
|
|
|
*
|
|
|
|
|
|
* @access public
|
|
|
|
|
|
* @param array Database Row
|
|
|
|
|
|
* @param object \DPL\Parameters Object
|
|
|
|
|
|
* @param object Mediawiki Title Object
|
|
|
|
|
|
* @param integer Page Namespace ID
|
|
|
|
|
|
* @param string Page Title as Selected from Query
|
|
|
|
|
|
* @return object \DPL\Article Object
|
|
|
|
|
|
*/
|
|
|
|
|
|
public static function newFromRow($row, Parameters $parameters, \Title $title, $pageNamespace, $pageTitle) {
|
|
|
|
|
|
global $wgLang, $wgContLang;
|
|
|
|
|
|
|
|
|
|
|
|
$article = new Article($title, $pageNamespace);
|
2020-11-23 04:33:40 +00:00
|
|
|
|
$revActorName = User::newFromActorId( $row['revactor_actor'] )->getName();
|
2020-11-22 20:00:48 +00:00
|
|
|
|
|
|
|
|
|
|
$titleText = $title->getText();
|
|
|
|
|
|
if ($parameters->getParameter('shownamespace') === true) {
|
|
|
|
|
|
$titleText = $title->getPrefixedText();
|
|
|
|
|
|
}
|
|
|
|
|
|
$replaceInTitle = $parameters->getParameter('replaceintitle');
|
|
|
|
|
|
if (is_array($replaceInTitle) && count($replaceInTitle) === 2) {
|
|
|
|
|
|
$titleText = preg_replace($replaceInTitle[0], $replaceInTitle[1], $titleText);
|
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
//Chop off title if longer than the 'titlemaxlen' parameter.
|
|
|
|
|
|
if ($parameters->getParameter('titlemaxlen') !== null && strlen($titleText) > $parameters->getParameter('titlemaxlen')) {
|
|
|
|
|
|
$titleText = substr($titleText, 0, $parameters->getParameter('titlemaxlen')) . '...';
|
|
|
|
|
|
}
|
|
|
|
|
|
if ($parameters->getParameter('showcurid') === true && isset($row['page_id'])) {
|
|
|
|
|
|
$articleLink = '[' . $title->getLinkURL(['curid' => $row['page_id']]) . ' ' . htmlspecialchars($titleText) . ']';
|
|
|
|
|
|
} else {
|
|
|
|
|
|
$articleLink = '[[' . ($parameters->getParameter('escapelinks') && ($pageNamespace == NS_CATEGORY || $pageNamespace == NS_FILE) ? ':' : '') . $title->getFullText() . '|' . htmlspecialchars($titleText) . ']]';
|
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
$article->mLink = $articleLink;
|
|
|
|
|
|
|
|
|
|
|
|
//get first char used for category-style output
|
|
|
|
|
|
if (isset($row['sortkey'])) {
|
|
|
|
|
|
$article->mStartChar = $wgContLang->convert($wgContLang->firstChar($row['sortkey']));
|
|
|
|
|
|
} else {
|
|
|
|
|
|
$article->mStartChar = $wgContLang->convert($wgContLang->firstChar($pageTitle));
|
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
$article->mID = intval($row['page_id']);
|
|
|
|
|
|
|
|
|
|
|
|
//External link
|
|
|
|
|
|
if (isset($row['el_to'])) {
|
|
|
|
|
|
$article->mExternalLink = $row['el_to'];
|
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
//SHOW PAGE_COUNTER
|
|
|
|
|
|
if (isset($row['page_counter'])) {
|
|
|
|
|
|
$article->mCounter = intval($row['page_counter']);
|
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
//SHOW PAGE_SIZE
|
|
|
|
|
|
if (isset($row['page_len'])) {
|
|
|
|
|
|
$article->mSize = intval($row['page_len']);
|
|
|
|
|
|
}
|
|
|
|
|
|
//STORE initially selected PAGE
|
|
|
|
|
|
if (is_array($parameters->getParameter('linksto')) && (count($parameters->getParameter('linksto')) || count($parameters->getParameter('linksfrom')))) {
|
|
|
|
|
|
if (!isset($row['sel_title'])) {
|
|
|
|
|
|
$article->mSelTitle = 'unknown page';
|
|
|
|
|
|
$article->mSelNamespace = 0;
|
|
|
|
|
|
} else {
|
|
|
|
|
|
$article->mSelTitle = $row['sel_title'];
|
|
|
|
|
|
$article->mSelNamespace = $row['sel_ns'];
|
|
|
|
|
|
}
|
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
//STORE selected image
|
|
|
|
|
|
if (is_array($parameters->getParameter('imageused')) && count($parameters->getParameter('imageused')) > 0) {
|
|
|
|
|
|
if (!isset($row['image_sel_title'])) {
|
|
|
|
|
|
$article->mImageSelTitle = 'unknown image';
|
|
|
|
|
|
} else {
|
|
|
|
|
|
$article->mImageSelTitle = $row['image_sel_title'];
|
|
|
|
|
|
}
|
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
if ($parameters->getParameter('goal') != 'categories') {
|
|
|
|
|
|
//REVISION SPECIFIED
|
|
|
|
|
|
if ($parameters->getParameter('lastrevisionbefore') || $parameters->getParameter('allrevisionsbefore') || $parameters->getParameter('firstrevisionsince') || $parameters->getParameter('allrevisionssince')) {
|
2020-11-23 04:33:40 +00:00
|
|
|
|
$article->mRevision = $row['revactor_rev'];
|
2020-11-22 20:00:48 +00:00
|
|
|
|
$article->mUser = $revActorName;
|
2020-11-23 04:33:40 +00:00
|
|
|
|
$article->mDate = $row['revactor_timestamp'];
|
2020-11-22 20:00:48 +00:00
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
//SHOW "PAGE_TOUCHED" DATE, "FIRSTCATEGORYDATE" OR (FIRST/LAST) EDIT DATE
|
|
|
|
|
|
if ($parameters->getParameter('addpagetoucheddate')) {
|
|
|
|
|
|
$article->mDate = $row['page_touched'];
|
|
|
|
|
|
} elseif ($parameters->getParameter('addfirstcategorydate')) {
|
|
|
|
|
|
$article->mDate = $row['cl_timestamp'];
|
2020-11-23 04:33:40 +00:00
|
|
|
|
} elseif ($parameters->getParameter('addeditdate') && isset($row['revactor_timestamp'])) {
|
|
|
|
|
|
$article->mDate = $row['revactor_timestamp'];
|
2020-11-22 20:00:48 +00:00
|
|
|
|
} elseif ($parameters->getParameter('addeditdate') && isset($row['page_touched'])) {
|
|
|
|
|
|
$article->mDate = $row['page_touched'];
|
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
//Time zone adjustment
|
|
|
|
|
|
if ($article->mDate) {
|
|
|
|
|
|
$article->mDate = $wgLang->userAdjust($article->mDate);
|
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
if ($article->mDate && $parameters->getParameter('userdateformat')) {
|
|
|
|
|
|
//Apply the userdateformat
|
|
|
|
|
|
$article->myDate = gmdate($parameters->getParameter('userdateformat'), wfTimeStamp(TS_UNIX, $article->mDate));
|
|
|
|
|
|
}
|
|
|
|
|
|
// CONTRIBUTION, CONTRIBUTOR
|
|
|
|
|
|
if ($parameters->getParameter('addcontribution')) {
|
|
|
|
|
|
$article->mContribution = $row['contribution'];
|
|
|
|
|
|
$article->mContributor = User::newFromActorId( $row['contributor'] )->getName();
|
|
|
|
|
|
$article->mContrib = substr('*****************', 0, (int) round(log($row['contribution'])));
|
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
//USER/AUTHOR(S)
|
|
|
|
|
|
// because we are going to do a recursive parse at the end of the output phase
|
|
|
|
|
|
// we have to generate wiki syntax for linking to a user´s homepage
|
|
|
|
|
|
if ($parameters->getParameter('adduser') || $parameters->getParameter('addauthor') || $parameters->getParameter('addlasteditor')) {
|
|
|
|
|
|
$article->mUserLink = '[[User:' . $revActorName . '|' . $revActorName . ']]';
|
|
|
|
|
|
$article->mUser = $revActorName;
|
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
//CATEGORY LINKS FROM CURRENT PAGE
|
|
|
|
|
|
if ($parameters->getParameter('addcategories') && ($row['cats'])) {
|
|
|
|
|
|
$artCatNames = explode(' | ', $row['cats']);
|
|
|
|
|
|
foreach ($artCatNames as $artCatName) {
|
|
|
|
|
|
$article->mCategoryLinks[] = '[[:Category:' . $artCatName . '|' . str_replace('_', ' ', $artCatName) . ']]';
|
|
|
|
|
|
$article->mCategoryTexts[] = str_replace('_', ' ', $artCatName);
|
|
|
|
|
|
}
|
|
|
|
|
|
}
|
|
|
|
|
|
// PARENT HEADING (category of the page, editor (user) of the page, etc. Depends on ordermethod param)
|
|
|
|
|
|
if ($parameters->getParameter('headingmode') != 'none') {
|
|
|
|
|
|
switch ($parameters->getParameter('ordermethod')[0]) {
|
|
|
|
|
|
case 'category':
|
|
|
|
|
|
//Count one more page in this heading
|
|
|
|
|
|
self::$headings[$row['cl_to']] = (isset(self::$headings[$row['cl_to']]) ? self::$headings[$row['cl_to']] + 1 : 1);
|
|
|
|
|
|
if ($row['cl_to'] == '') {
|
|
|
|
|
|
//uncategorized page (used if ordermethod=category,...)
|
|
|
|
|
|
$article->mParentHLink = '[[:Special:Uncategorizedpages|' . wfMessage('uncategorizedpages') . ']]';
|
|
|
|
|
|
} else {
|
|
|
|
|
|
$article->mParentHLink = '[[:Category:' . $row['cl_to'] . '|' . str_replace('_', ' ', $row['cl_to']) . ']]';
|
|
|
|
|
|
}
|
|
|
|
|
|
break;
|
|
|
|
|
|
case 'user':
|
|
|
|
|
|
self::$headings[$revActorName] = (isset(self::$headings[$revActorName]) ? self::$headings[$revActorName] + 1 : 1);
|
2020-11-23 04:33:40 +00:00
|
|
|
|
if ($row['revactor_actor'] == 0) { //anonymous user
|
2020-11-22 20:00:48 +00:00
|
|
|
|
$article->mParentHLink = '[[User:' . $revActorName . '|' . $revActorName . ']]';
|
|
|
|
|
|
} else {
|
|
|
|
|
|
$article->mParentHLink = '[[User:' . $revActorName . '|' . $revActorName . ']]';
|
|
|
|
|
|
}
|
|
|
|
|
|
break;
|
|
|
|
|
|
}
|
|
|
|
|
|
}
|
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
return $article;
|
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
|
|
* Returns all heading information processed from all newly instantiated article objects.
|
|
|
|
|
|
*
|
|
|
|
|
|
* @access public
|
|
|
|
|
|
* @return array Headings
|
|
|
|
|
|
*/
|
|
|
|
|
|
public static function getHeadings() {
|
|
|
|
|
|
return self::$headings;
|
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
|
|
* Reset the headings to their initial state.
|
|
|
|
|
|
* Ideally this Article class should not exist and be handled by the built in MediaWiki class.
|
|
|
|
|
|
* Bug: https://jira/browse/HYD-913
|
|
|
|
|
|
*
|
|
|
|
|
|
* @access public
|
|
|
|
|
|
* @return void
|
|
|
|
|
|
*/
|
|
|
|
|
|
public static function resetHeadings() {
|
|
|
|
|
|
self::$headings = [];
|
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
|
|
* Get the formatted date for this article if available.
|
|
|
|
|
|
*
|
|
|
|
|
|
* @access public
|
|
|
|
|
|
* @return mixed Formatted string or null for none set.
|
|
|
|
|
|
*/
|
|
|
|
|
|
public function getDate() {
|
|
|
|
|
|
global $wgLang;
|
|
|
|
|
|
if ($this->myDate !== null) {
|
|
|
|
|
|
return $this->myDate;
|
|
|
|
|
|
} elseif ($this->mDate !== null) {
|
|
|
|
|
|
return $wgLang->timeanddate($article->mDate, true);
|
|
|
|
|
|
}
|
|
|
|
|
|
return null;
|
|
|
|
|
|
}
|
2020-11-23 04:33:40 +00:00
|
|
|
|
}
|
