Page::getNamespaceName() - Code Metrics - Inspection of "Refactor PageAssessments logic; add en.wikivoyage,..." - x-tools/xtools - Measure and Improve Code Quality continuously with Scrutinizer

Passed

Push — master ( 2f87b4...a0f968 )

by MusikAnimal

created 2018-04-12 06:46 UTC

Page::getNamespaceName() A

↳ Parent: Page

Complexity

Conditions	2
Paths	2

Size

Total Lines	6
Code Lines	4

Duplication

Lines	0
Ratio	0 %

Code Coverage

Tests	5
CRAP Score	2

Importance

Changes

Metric	Value
cc	2
eloc	4
nc	2
nop	0
dl	0
loc	6
ccs	5
cts	5
cp	1
crap	2
rs	9.4285
c	0
b	0
f	0

<?php
/**
 * This file contains only the Page class.
 */

namespace Xtools;

use DateTime;

/**
 * A Page is a single wiki page in one project.
 */
class Page extends Model
{

    /** @var Project The project that this page belongs to. */
    protected $project;

    /** @var string The page name as provided at instantiation. */
    protected $unnormalizedPageName;

    /** @var string[] Metadata about this page. */
    protected $pageInfo;

    /** @var string[] Revision history of this page. */
    protected $revisions;

    /** @var int Number of revisions for this page. */
    protected $numRevisions;

    /** @var string[] List of Wikidata sitelinks for this page. */
    protected $wikidataItems;

    /** @var int Number of Wikidata sitelinks for this page. */
    protected $numWikidataItems;

    /**
     * Page constructor.
     * @param Project $project
     * @param string $pageName
     */
    public function __construct(Project $project, $pageName)
    {
        $this->project = $project;
        $this->unnormalizedPageName = $pageName;
    }

    /**
     * Unique identifier for this Page, to be used in cache keys.
     * Use of md5 ensures the cache key does not contain reserved characters.
     * @see Repository::getCacheKey()
     * @return string
     * @codeCoverageIgnore
     */
    public function getCacheKey()
    {
        return md5($this->getId());
    }

    /**
     * Get basic information about this page from the repository.
     * @return \string[]
     */
    protected function getPageInfo()
    {
        if (empty($this->pageInfo)) {
            $this->pageInfo = $this->getRepository()
                    ->getPageInfo($this->project, $this->unnormalizedPageName);
        }
        return $this->pageInfo;
    }

    /**
     * Get the page's title.
     * @param bool $useUnnormalized Use the unnormalized page title to avoid an
     *    API call. This should be used only if you fetched the page title via
     *    other means (SQL query), and is not from user input alone.
     * @return string
     */
    public function getTitle($useUnnormalized = false)
    {
        if ($useUnnormalized) {
            return $this->unnormalizedPageName;
        }
        $info = $this->getPageInfo();
        return isset($info['title']) ? $info['title'] : $this->unnormalizedPageName;
    }

    /**
     * Get the page's title without the namespace.
     * @return string
     */
    public function getTitleWithoutNamespace()
    {
        $info = $this->getPageInfo();
        $title = isset($info['title']) ? $info['title'] : $this->unnormalizedPageName;
        $nsName = $this->getNamespaceName();
        return str_replace($nsName . ':', '', $title);
    }

    /**
     * Get this page's database ID.
     * @return int
     */
    public function getId()
    {
        $info = $this->getPageInfo();
        return isset($info['pageid']) ? $info['pageid'] : null;
    }

    /**
     * Get this page's length in bytes.
     * @return int
     */
    public function getLength()
    {
        $info = $this->getPageInfo();
        return isset($info['length']) ? $info['length'] : null;
    }

    /**
     * Get HTML for the stylized display of the title.
     * The text will be the same as Page::getTitle().
     * @return string
     */
    public function getDisplayTitle()
    {
        $info = $this->getPageInfo();
        if (isset($info['displaytitle'])) {
            return $info['displaytitle'];
        }
        return $this->getTitle();
    }

    /**
     * Get the full URL of this page.
     * @return string
     */
    public function getUrl()
    {
        $info = $this->getPageInfo();
        return isset($info['fullurl']) ? $info['fullurl'] : null;
    }

    /**
     * Get the numerical ID of the namespace of this page.
     * @return int
     */
    public function getNamespace()
    {
        $info = $this->getPageInfo();
        return isset($info['ns']) ? $info['ns'] : null;
    }

    /**
     * Get the name of the namespace of this page.
     * @return string
     */
    public function getNamespaceName()
    {
        $info = $this->getPageInfo();
        return isset($info['ns'])
            ? $this->getProject()->getNamespaces()[$info['ns']]
            : null;
    }

    /**
     * Get the number of page watchers.
     * @return int
     */
    public function getWatchers()
    {
        $info = $this->getPageInfo();
        return isset($info['watchers']) ? $info['watchers'] : null;
    }

    /**
     * Get the HTML content of the body of the page.
     * @param DateTime|int $target If a DateTime object, the
     *   revision at that time will be returned. If an integer, it is
     *   assumed to be the actual revision ID.
     * @return string
     */
    public function getHTMLContent($target = null)
    {
        if (is_a($target, 'DateTime')) {
            $target = $this->getRepository()->getRevisionIdAtDate($this, $target);
        }
        return $this->getRepository()->getHTMLContent($this, $target);
    }

    /**
     * Whether or not this page exists.
     * @return bool
     */
    public function exists()
    {
        $info = $this->getPageInfo();
        return !isset($info['missing']) && !isset($info['invalid']);
    }

    /**
     * Get the Project to which this page belongs.
     * @return Project
     */
    public function getProject()
    {
        return $this->project;
    }

    /**
     * Get the language code for this page.
     * If not set, the language code for the project is returned.
     * @return string
     */
    public function getLang()
    {
        $info = $this->getPageInfo();
        if (isset($info['pagelanguage'])) {
            return $info['pagelanguage'];
        } else {
            return $this->getProject()->getLang();
        }
    }

    /**
     * Get the Wikidata ID of this page.
     * @return string
     */
    public function getWikidataId()
    {
        $info = $this->getPageInfo();
        if (isset($info['pageprops']['wikibase_item'])) {
            return $info['pageprops']['wikibase_item'];
        } else {
            return null;
        }
    }

    /**
     * Get the number of revisions the page has.
     * @param User $user Optionally limit to those of this user.
     * @param false|int $start
     * @param false|int $end
     * @return int
     */
    public function getNumRevisions(User $user = null, $start = false, $end = false)
    {
        // If a user is given, we will not cache the result via instance variable.
        if ($user !== null) {
            return (int) $this->getRepository()->getNumRevisions($this, $user, $start, $end);
        }

        // Return cached value, if present.
        if ($this->numRevisions !== null) {
            return $this->numRevisions;
        }

        // Otherwise, return the count of all revisions if already present.
        if ($this->revisions !== null) {
            $this->numRevisions = count($this->revisions);
        } else {
            // Otherwise do a COUNT in the event fetching all revisions is not desired.
            $this->numRevisions = (int) $this->getRepository()->getNumRevisions($this, null, $start, $end);
        }

        return $this->numRevisions;
    }

    /**
     * Get all edits made to this page.
     * @param User|null $user Specify to get only revisions by the given user.
     * @param false|int $start
     * @param false|int $end
     * @return array
     */
    public function getRevisions(User $user = null, $start = false, $end = false)
    {
        if ($this->revisions) {

            return $this->revisions;
        }

        $this->revisions = $this->getRepository()->getRevisions($this, $user, $start, $end);

        return $this->revisions;
    }

    /**
     * Get the full page wikitext.
     * @return string|null Null if nothing was found.
     */
    public function getWikitext()
    {
        $content = $this->getRepository()->getPagesWikitext(
            $this->getProject(),
            [ $this->getTitle() ]
        );

        return isset($content[$this->getTitle()])
            ? $content[$this->getTitle()]
            : null;
    }

    /**
     * Get the statement for a single revision, so that you can iterate row by row.
     * @see PageRepository::getRevisionsStmt()
     * @param User|null $user Specify to get only revisions by the given user.
     * @param int $limit Max number of revisions to process.
     * @param int $numRevisions Number of revisions, if known. This is used solely to determine the
     *   OFFSET if we are given a $limit. If $limit is set and $numRevisions is not set, a
     *   separate query is ran to get the nuber of revisions.
     * @param false|int $start
     * @param false|int $end
     * @return Doctrine\DBAL\Driver\PDOStatement

     */
    public function getRevisionsStmt(
        User $user = null,
        $limit = null,
        $numRevisions = null,
        $start = false,
        $end = false
    ) {
        // If we have a limit, we need to know the total number of revisions so that PageRepo
        // will properly set the OFFSET. See PageRepository::getRevisionsStmt() for more info.
        if (isset($limit) && $numRevisions === null) {
            $numRevisions = $this->getNumRevisions($user, $start, $end);
        }
        return $this->getRepository()->getRevisionsStmt($this, $user, $limit, $numRevisions, $start, $end);
    }

    /**
     * Get various basic info used in the API, including the
     *   number of revisions, unique authors, initial author
     *   and edit count of the initial author.
     * This is combined into one query for better performance.
     * Caching is intentionally disabled, because using the gadget,
     *   this will get hit for a different page constantly, where
     *   the likelihood of cache benefiting us is slim.
     * @return string[]
     */
    public function getBasicEditingInfo()
    {
        return $this->getRepository()->getBasicEditingInfo($this);
    }

    /**
     * Get CheckWiki errors for this page
     * @return string[] See getErrors() for format
     */
    public function getCheckWikiErrors()
    {
        return $this->getRepository()->getCheckWikiErrors($this);
    }

    /**
     * Get Wikidata errors for this page
     * @return string[] See getErrors() for format
     */
    public function getWikidataErrors()
    {
        $errors = [];

        if (empty($this->getWikidataId())) {
            return [];
        }

        $wikidataInfo = $this->getRepository()->getWikidataInfo($this);

        $terms = array_map(function ($entry) {
            return $entry['term'];
        }, $wikidataInfo);

        $lang = $this->getLang();

        if (!in_array('label', $terms)) {
            $errors[] = [
                'prio' => 2,
                'name' => 'Wikidata',
                'notice' => "Label for language <em>$lang</em> is missing", // FIXME: i18n
                'explanation' => "See: <a target='_blank' " .
                    "href='//www.wikidata.org/wiki/Help:Label'>Help:Label</a>",
            ];
        }

        if (!in_array('description', $terms)) {
            $errors[] = [
                'prio' => 3,
                'name' => 'Wikidata',
                'notice' => "Description for language <em>$lang</em> is missing", // FIXME: i18n
                'explanation' => "See: <a target='_blank' " .
                    "href='//www.wikidata.org/wiki/Help:Description'>Help:Description</a>",
            ];
        }

        return $errors;
    }

    /**
     * Get Wikidata and CheckWiki errors, if present
     * @return string[] List of errors in the format:
     *    [[
     *         'prio' => int,
     *         'name' => string,
     *         'notice' => string (HTML),
     *         'explanation' => string (HTML)
     *     ], ... ]
     */
    public function getErrors()
    {
        // Includes label and description
        $wikidataErrors = $this->getWikidataErrors();

        $checkWikiErrors = $this->getCheckWikiErrors();

        return array_merge($wikidataErrors, $checkWikiErrors);
    }

    /**
     * Get all wikidata items for the page, not just languages of sister projects
     * @return int Number of records.
     */
    public function getWikidataItems()
    {
        if (!is_array($this->wikidataItems)) {

            $this->wikidataItems = $this->getRepository()->getWikidataItems($this);
        }
        return $this->wikidataItems;
    }

    /**
     * Count wikidata items for the page, not just languages of sister projects
     * @return int Number of records.
     */
    public function countWikidataItems()
    {
        if (is_array($this->wikidataItems)) {

            $this->numWikidataItems = count($this->wikidataItems);
        } elseif ($this->numWikidataItems === null) {
            $this->numWikidataItems = $this->getRepository()->countWikidataItems($this);
        }
        return $this->numWikidataItems;
    }

    /**
     * Get number of in and outgoing links and redirects to this page.
     * @return string[] Counts with the keys 'links_ext_count', 'links_out_count',
     *                  'links_in_count' and 'redirects_count'
     */
    public function countLinksAndRedirects()
    {
        return $this->getRepository()->countLinksAndRedirects($this);
    }

    /**
     * Get the sum of pageviews for the given page and timeframe.
     * @param string|DateTime $start In the format YYYYMMDD
     * @param string|DateTime $end In the format YYYYMMDD
     * @return int
     */
    public function getPageviews($start, $end)
    {
        try {
            $pageviews = $this->getRepository()->getPageviews($this, $start, $end);
        } catch (\GuzzleHttp\Exception\ClientException $e) {
            // 404 means zero pageviews
            return 0;
        }

        return array_sum(array_map(function ($item) {
            return (int) $item['views'];
        }, $pageviews['items']));
    }

    /**
     * Get the sum of pageviews over the last N days
     * @param int $days Default 30
     * @return int Number of pageviews
     */
    public function getLastPageviews($days = 30)
    {
        $start = date('Ymd', strtotime("-$days days"));
        $end = date('Ymd');
        return $this->getPageviews($start, $end);
    }

    /**
     * Is the page the project's Main Page?
     * @return bool
     */
    public function isMainPage()
    {
        return $this->getProject()->getMainPage() === $this->getTitle();
    }
}


1		<?php
2		/**
3		* This file contains only the Page class.
4		*/
5
6		namespace Xtools;
7
8		use DateTime;
9
10		/**
11		* A Page is a single wiki page in one project.
12		*/
13		class Page extends Model
14		{
15
16		/** @var Project The project that this page belongs to. */
17		protected $project;
18
19		/** @var string The page name as provided at instantiation. */
20		protected $unnormalizedPageName;
21
22		/** @var string[] Metadata about this page. */
23		protected $pageInfo;
24
25		/** @var string[] Revision history of this page. */
26		protected $revisions;
27
28		/** @var int Number of revisions for this page. */
29		protected $numRevisions;
30
31		/** @var string[] List of Wikidata sitelinks for this page. */
32		protected $wikidataItems;
33
34		/** @var int Number of Wikidata sitelinks for this page. */
35		protected $numWikidataItems;
36
37		/**
38		* Page constructor.
39		* @param Project $project
40		* @param string $pageName
41		*/
42	40	public function __construct(Project $project, $pageName)
43		{
44	40	$this->project = $project;
45	40	$this->unnormalizedPageName = $pageName;
46	40	}
47
48		/**
49		* Unique identifier for this Page, to be used in cache keys.
50		* Use of md5 ensures the cache key does not contain reserved characters.
51		* @see Repository::getCacheKey()
52		* @return string
53		* @codeCoverageIgnore
54		*/
55		public function getCacheKey()
56		{
57		return md5($this->getId());
58		}
59
60		/**
61		* Get basic information about this page from the repository.
62		* @return \string[]
63		*/
64	9	protected function getPageInfo()
65		{
66	9	if (empty($this->pageInfo)) {
67	9	$this->pageInfo = $this->getRepository()
68	9	->getPageInfo($this->project, $this->unnormalizedPageName);
69		}
70	9	return $this->pageInfo;
71		}
72
73		/**
74		* Get the page's title.
75		* @param bool $useUnnormalized Use the unnormalized page title to avoid an
76		* API call. This should be used only if you fetched the page title via
77		* other means (SQL query), and is not from user input alone.
78		* @return string
79		*/
80	3	public function getTitle($useUnnormalized = false)
81		{
82	3	if ($useUnnormalized) {
83	1	return $this->unnormalizedPageName;
84		}
85	3	$info = $this->getPageInfo();
86	3	return isset($info['title']) ? $info['title'] : $this->unnormalizedPageName;
87		}
88
89		/**
90		* Get the page's title without the namespace.
91		* @return string
92		*/
93	1	public function getTitleWithoutNamespace()
94		{
95	1	$info = $this->getPageInfo();
96	1	$title = isset($info['title']) ? $info['title'] : $this->unnormalizedPageName;
97	1	$nsName = $this->getNamespaceName();
98	1	return str_replace($nsName . ':', '', $title);
99		}
100
101		/**
102		* Get this page's database ID.
103		* @return int
104		*/
105	1	public function getId()
106		{
107	1	$info = $this->getPageInfo();
108	1	return isset($info['pageid']) ? $info['pageid'] : null;
109		}
110
111		/**
112		* Get this page's length in bytes.
113		* @return int
114		*/
115	1	public function getLength()
116		{
117	1	$info = $this->getPageInfo();
118	1	return isset($info['length']) ? $info['length'] : null;
119		}
120
121		/**
122		* Get HTML for the stylized display of the title.
123		* The text will be the same as Page::getTitle().
124		* @return string
125		*/
126	1	public function getDisplayTitle()
127		{
128	1	$info = $this->getPageInfo();
129	1	if (isset($info['displaytitle'])) {
130	1	return $info['displaytitle'];
131		}
132	1	return $this->getTitle();
133		}
134
135		/**
136		* Get the full URL of this page.
137		* @return string
138		*/
139	1	public function getUrl()
140		{
141	1	$info = $this->getPageInfo();
142	1	return isset($info['fullurl']) ? $info['fullurl'] : null;
143		}
144
145		/**
146		* Get the numerical ID of the namespace of this page.
147		* @return int
148		*/
149	2	public function getNamespace()
150		{
151	2	$info = $this->getPageInfo();
152	2	return isset($info['ns']) ? $info['ns'] : null;
153		}
154
155		/**
156		* Get the name of the namespace of this page.
157		* @return string
158		*/
159	1	public function getNamespaceName()
160		{
161	1	$info = $this->getPageInfo();
162	1	return isset($info['ns'])
163	1	? $this->getProject()->getNamespaces()[$info['ns']]
164	1	: null;
165		}
166
167		/**
168		* Get the number of page watchers.
169		* @return int
170		*/
171	1	public function getWatchers()
172		{
173	1	$info = $this->getPageInfo();
174	1	return isset($info['watchers']) ? $info['watchers'] : null;
175		}
176
177		/**
178		* Get the HTML content of the body of the page.
179		* @param DateTime\|int $target If a DateTime object, the
180		* revision at that time will be returned. If an integer, it is
181		* assumed to be the actual revision ID.
182		* @return string
183		*/
184	1	public function getHTMLContent($target = null)
185		{
186	1	if (is_a($target, 'DateTime')) {
187		$target = $this->getRepository()->getRevisionIdAtDate($this, $target);
188		}
189	1	return $this->getRepository()->getHTMLContent($this, $target);
190		}
191
192		/**
193		* Whether or not this page exists.
194		* @return bool
195		*/
196	1	public function exists()
197		{
198	1	$info = $this->getPageInfo();
199	1	return !isset($info['missing']) && !isset($info['invalid']);
200		}
201
202		/**
203		* Get the Project to which this page belongs.
204		* @return Project
205		*/
206	16	public function getProject()
207		{
208	16	return $this->project;
209		}
210
211		/**
212		* Get the language code for this page.
213		* If not set, the language code for the project is returned.
214		* @return string
215		*/
216	2	public function getLang()
217		{
218	2	$info = $this->getPageInfo();
219	2	if (isset($info['pagelanguage'])) {
220	2	return $info['pagelanguage'];
221		} else {
222		return $this->getProject()->getLang();
223		}
224		}
225
226		/**
227		* Get the Wikidata ID of this page.
228		* @return string
229		*/
230	4	public function getWikidataId()
231		{
232	4	$info = $this->getPageInfo();
233	4	if (isset($info['pageprops']['wikibase_item'])) {
234	3	return $info['pageprops']['wikibase_item'];
235		} else {
236	1	return null;
237		}
238		}
239
240		/**
241		* Get the number of revisions the page has.
242		* @param User $user Optionally limit to those of this user.
243		* @param false\|int $start
244		* @param false\|int $end
245		* @return int
246		*/
247	4	public function getNumRevisions(User $user = null, $start = false, $end = false)
248		{
249		// If a user is given, we will not cache the result via instance variable.
250	4	if ($user !== null) {
251		return (int) $this->getRepository()->getNumRevisions($this, $user, $start, $end);
252		}
253
254		// Return cached value, if present.
255	4	if ($this->numRevisions !== null) {
256		return $this->numRevisions;
257		}
258
259		// Otherwise, return the count of all revisions if already present.
260	4	if ($this->revisions !== null) {
261		$this->numRevisions = count($this->revisions);
262		} else {
263		// Otherwise do a COUNT in the event fetching all revisions is not desired.
264	4	$this->numRevisions = (int) $this->getRepository()->getNumRevisions($this, null, $start, $end);
265		}
266
267	4	return $this->numRevisions;
268		}
269
270		/**
271		* Get all edits made to this page.
272		* @param User\|null $user Specify to get only revisions by the given user.
273		* @param false\|int $start
274		* @param false\|int $end
275		* @return array
276		*/
277		public function getRevisions(User $user = null, $start = false, $end = false)
278		{
279		if ($this->revisions) {
		0 ignored issues – show Bug Best Practice introduced 2017-10-24 17:54 UTC by Report Bug Copy Issue Report The expression `$this->revisions` of type `string[]` is implicitly converted to a boolean; are you sure this is intended? If so, consider using `! empty($expr)` instead to make it clear that you intend to check for an array without elements. This check marks implicit conversions of arrays to boolean values in a comparison. While in PHP an empty array is considered to be equal (but not identical) to false, this is not always apparent. Consider making the comparison explicit by using `empty(..)` or `! empty(...)` instead. Loading history...
280		return $this->revisions;
281		}
282
283		$this->revisions = $this->getRepository()->getRevisions($this, $user, $start, $end);
284
285		return $this->revisions;
286		}
287
288		/**
289		* Get the full page wikitext.
290		* @return string\|null Null if nothing was found.
291		*/
292	1	public function getWikitext()
293		{
294	1	$content = $this->getRepository()->getPagesWikitext(
295	1	$this->getProject(),
296	1	[ $this->getTitle() ]
297		);
298
299	1	return isset($content[$this->getTitle()])
300	1	? $content[$this->getTitle()]
301	1	: null;
302		}
303
304		/**
305		* Get the statement for a single revision, so that you can iterate row by row.
306		* @see PageRepository::getRevisionsStmt()
307		* @param User\|null $user Specify to get only revisions by the given user.
308		* @param int $limit Max number of revisions to process.
309		* @param int $numRevisions Number of revisions, if known. This is used solely to determine the
310		* OFFSET if we are given a $limit. If $limit is set and $numRevisions is not set, a
311		* separate query is ran to get the nuber of revisions.
312		* @param false\|int $start
313		* @param false\|int $end
314		* @return Doctrine\DBAL\Driver\PDOStatement
		0 ignored issues – show Bug introduced 2017-10-24 17:54 UTC by Report Bug Copy Issue Report The type `Xtools\Doctrine\DBAL\Driver\PDOStatement` was not found. Did you mean `Doctrine\DBAL\Driver\PDOStatement`? If so, make sure to prefix the type with `\`. Loading history...
315		*/
316		public function getRevisionsStmt(
317		User $user = null,
318		$limit = null,
319		$numRevisions = null,
320		$start = false,
321		$end = false
322		) {
323		// If we have a limit, we need to know the total number of revisions so that PageRepo
324		// will properly set the OFFSET. See PageRepository::getRevisionsStmt() for more info.
325		if (isset($limit) && $numRevisions === null) {
326		$numRevisions = $this->getNumRevisions($user, $start, $end);
327		}
328		return $this->getRepository()->getRevisionsStmt($this, $user, $limit, $numRevisions, $start, $end);
329		}
330
331		/**
332		* Get various basic info used in the API, including the
333		* number of revisions, unique authors, initial author
334		* and edit count of the initial author.
335		* This is combined into one query for better performance.
336		* Caching is intentionally disabled, because using the gadget,
337		* this will get hit for a different page constantly, where
338		* the likelihood of cache benefiting us is slim.
339		* @return string[]
340		*/
341		public function getBasicEditingInfo()
342		{
343		return $this->getRepository()->getBasicEditingInfo($this);
344		}
345
346		/**
347		* Get CheckWiki errors for this page
348		* @return string[] See getErrors() for format
349		*/
350	1	public function getCheckWikiErrors()
351		{
352	1	return $this->getRepository()->getCheckWikiErrors($this);
353		}
354
355		/**
356		* Get Wikidata errors for this page
357		* @return string[] See getErrors() for format
358		*/
359	2	public function getWikidataErrors()
360		{
361	2	$errors = [];
362
363	2	if (empty($this->getWikidataId())) {
364		return [];
365		}
366
367	2	$wikidataInfo = $this->getRepository()->getWikidataInfo($this);
368
369		$terms = array_map(function ($entry) {
370	2	return $entry['term'];
371	2	}, $wikidataInfo);
372
373	2	$lang = $this->getLang();
374
375	2	if (!in_array('label', $terms)) {
376		$errors[] = [
377		'prio' => 2,
378		'name' => 'Wikidata',
379		'notice' => "Label for language <em>$lang</em> is missing", // FIXME: i18n
380		'explanation' => "See: <a target='_blank' " .
381		"href='//www.wikidata.org/wiki/Help:Label'>Help:Label</a>",
382		];
383		}
384
385	2	if (!in_array('description', $terms)) {
386	2	$errors[] = [
387	2	'prio' => 3,
388	2	'name' => 'Wikidata',
389	2	'notice' => "Description for language <em>$lang</em> is missing", // FIXME: i18n
390		'explanation' => "See: <a target='_blank' " .
391		"href='//www.wikidata.org/wiki/Help:Description'>Help:Description</a>",
392		];
393		}
394
395	2	return $errors;
396		}
397
398		/**
399		* Get Wikidata and CheckWiki errors, if present
400		* @return string[] List of errors in the format:
401		* [[
402		* 'prio' => int,
403		* 'name' => string,
404		* 'notice' => string (HTML),
405		* 'explanation' => string (HTML)
406		* ], ... ]
407		*/
408	1	public function getErrors()
409		{
410		// Includes label and description
411	1	$wikidataErrors = $this->getWikidataErrors();
412
413	1	$checkWikiErrors = $this->getCheckWikiErrors();
414
415	1	return array_merge($wikidataErrors, $checkWikiErrors);
416		}
417
418		/**
419		* Get all wikidata items for the page, not just languages of sister projects
420		* @return int Number of records.
421		*/
422	1	public function getWikidataItems()
423		{
424	1	if (!is_array($this->wikidataItems)) {
		0 ignored issues – show introduced 2018-03-10 05:01 UTC by Report Bug Copy Issue Report The condition `is_array($this->wikidataItems)` is always `true`. Loading history...
425	1	$this->wikidataItems = $this->getRepository()->getWikidataItems($this);
426		}
427	1	return $this->wikidataItems;
428		}
429
430		/**
431		* Count wikidata items for the page, not just languages of sister projects
432		* @return int Number of records.
433		*/
434	2	public function countWikidataItems()
435		{
436	2	if (is_array($this->wikidataItems)) {
		0 ignored issues – show introduced 2018-03-10 05:01 UTC by Report Bug Copy Issue Report The condition `is_array($this->wikidataItems)` is always `true`. Loading history...
437		$this->numWikidataItems = count($this->wikidataItems);
438	2	} elseif ($this->numWikidataItems === null) {
439	2	$this->numWikidataItems = $this->getRepository()->countWikidataItems($this);
440		}
441	2	return $this->numWikidataItems;
442		}
443
444		/**
445		* Get number of in and outgoing links and redirects to this page.
446		* @return string[] Counts with the keys 'links_ext_count', 'links_out_count',
447		* 'links_in_count' and 'redirects_count'
448		*/
449	2	public function countLinksAndRedirects()
450		{
451	2	return $this->getRepository()->countLinksAndRedirects($this);
452		}
453
454		/**
455		* Get the sum of pageviews for the given page and timeframe.
456		* @param string\|DateTime $start In the format YYYYMMDD
457		* @param string\|DateTime $end In the format YYYYMMDD
458		* @return int
459		*/
460	1	public function getPageviews($start, $end)
461		{
462		try {
463	1	$pageviews = $this->getRepository()->getPageviews($this, $start, $end);
464		} catch (\GuzzleHttp\Exception\ClientException $e) {
465		// 404 means zero pageviews
466		return 0;
467		}
468
469	1	return array_sum(array_map(function ($item) {
470	1	return (int) $item['views'];
471	1	}, $pageviews['items']));
472		}
473
474		/**
475		* Get the sum of pageviews over the last N days
476		* @param int $days Default 30
477		* @return int Number of pageviews
478		*/
479	1	public function getLastPageviews($days = 30)
480		{
481	1	$start = date('Ymd', strtotime("-$days days"));
482	1	$end = date('Ymd');
483	1	return $this->getPageviews($start, $end);
484		}
485
486		/**
487		* Is the page the project's Main Page?
488		* @return bool
489		*/
490	1	public function isMainPage()
491		{
492	1	return $this->getProject()->getMainPage() === $this->getTitle();
493		}
494		}
495

x-tools / xtools

Push — master ( 2f87b4...a0f968 )

Page::getNamespaceName() A

Complexity

Size

Duplication

Code Coverage

Importance

Duplication Side-by-Side

Filter issues like