LinkTitles/includes/Target.php

<?php

/**
 * The LinkTitles\Target represents a Wiki page that is a potential link target.
 *
 * Copyright 2012-2024 Daniel Kraus <bovender@bovender.de> ('bovender')
 *
 * This program is free software; you can redistribute it and/or modify
 * it under the terms of the GNU General Public License as published by
 * the Free Software Foundation; either version 2 of the License, or
 * (at your option) any later version.
 *
 * This program is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * GNU General Public License for more details.
 *
 * You should have received a copy of the GNU General Public License
 * along with this program; if not, write to the Free Software
 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston,
 * MA 02110-1301, USA.
 *
 * @author Daniel Kraus <bovender@bovender.de>
 */
namespace LinkTitles;

use MediaWiki\MediaWikiServices;
use MediaWiki\Title\Title as MWTitle;

/**
 * Represents a page that is a potential link target.
 */
class Target {
	/**
	 * A MWTitle object for the target page currently being examined.
	 * @var MWTitle $title
	 */
	private $title;

	/**
	 * Caches the target page content as a \Content object.
	 *
	 * @var \Content $content
	 */
	private $content;

	/**
	 * Regex that matches the start of a word; this expression depends on the
	 * setting of LinkTitles\Config->wordStartOnly;
	 * @var String $wordStart
	 */
	public $wordStart;

	/**
	 * Regex that matches the end of a word; this expression depends on the
	 * setting of LinkTitles\Config->wordEndOnly;
	 * @var String $wordEnd
	 */
	public $wordEnd;

	/**
	 * LinkTitles configuration.
	 * @var Config $config
	 */
	private $config;

	private $caseSensitiveLinkValueRegex;

	private $nsText;

	/**
	 * Constructs a new Target object
	 *
	 * The parameters may be taken from database rows, for example.
	 *
	 * @param Int $namespace Name space of the target page
	 * @param String &$title Title of the target page
	 */
	public function __construct( $namespace, $title, Config &$config ) {
		$this->title = MWTitle::makeTitleSafe( $namespace, $title );
		$this->titleValue = $this->title->getTitleValue();
		$this->config = $config;

		// Use unicode character properties rather than \b escape sequences
		// to detect whole words containing non-ASCII characters as well.
		// Note that this requires a PCRE library that was compiled with
		// --enable-unicode-properties
		( $config->wordStartOnly ) ? $this->wordStart = '(?<!\pL|\pN)' : $this->wordStart = '';
		( $config->wordEndOnly ) ? $this->wordEnd = '(?!\pL|\pN)' : $this->wordEnd = '';
	}

	/**
	 * Gets the string representation of the target title.
	 * @return String title text
	 */
	public function getTitleText() {
		return $this->title->getText();
	}

	public function getPrefixedTitleText() {

		if ($this->title->getNamespace() == NS_CATEGORY)
			return ':' . $this->title->getPrefixedText();
		else
			return $this->title->getPrefixedText();
	}

	/**
	 * Gets the string representation of the target's namespace.
	 *
	 * May be false if the namespace is NS_MAIN. The value is cached.
	 * @return String|bool Target's namespace
	 */
	public function getNsText() {
		if ( $this->nsText === null ) {
			$this->nsText = $this->title->getNsText();
		}
		return $this->nsText;
	}

	/**
	 * Gets the namespace prefix. This is the namespace text followed by a colon,
	 * or an empty string if the namespace text evaluates to false (e.g. NS_MAIN).
	 * @return String namespace prefix
	 */
	public function getNsPrefix() {
		return $this->getNsText() ? $this->getNsText() . ':' : '';
	}

	/**
	 * Gets the title string with certain characters escaped that may interfere
	 * with regular expressions.
	 * @return String representation of the title, regex-safe
	 */
	public function getRegexSafeTitle() {
		return preg_quote( $this->title->getText(), '/' );
	}

	/**
	 * Builds a regular expression of the title
	 * @return String regular expression for this title.
	 */
	public function getCaseSensitiveRegex() {
		return $this->buildRegex( $this->getCaseSensitiveLinkValueRegex() );
	}

	/**
	 * Builds a regular expression pattern for the title in a case-insensitive
	 * way.
	 * @return String case-insensitive regular expression pattern for the title
	 */
	public function getCaseInsensitiveRegex() {
		return $this->buildRegex( $this->getRegexSafeTitle() ) . 'i';
	}

	/**
	 * Builds the basic regex that is used to match target page titles in a source
	 * text.
	 * @param  String $searchTerm Target page title (special characters must be quoted)
	 * @return String regular expression pattern
	 */
	private function buildRegex( $searchTerm ) {
		return '/(?<![\:\.\@\/\?\&])' . $this->wordStart . $searchTerm . $this->wordEnd . '/Su';
	}

	/**
	 * Gets the (cached) regex for the link value.
	 *
	 * Depending on the $config->capitalLinks setting, the title has to be
	 * searched for either in a strictly case-sensitive way, or in a 'fuzzy' way
	 * where the first letter of the title may be either case.
	 *
	 * @return String regular expression pattern for the link value.
	 */
	public function getCaseSensitiveLinkValueRegex() {
		if ( $this->caseSensitiveLinkValueRegex === null ) {
			$regexSafeTitle = $this->getRegexSafeTitle();
			if ( $this->config->capitalLinks && preg_match( '/[a-zA-Z]/', $regexSafeTitle[0] ) ) {
				$this->caseSensitiveLinkValueRegex = '((?i)' . $regexSafeTitle[0] . '(?-i)' . substr($regexSafeTitle, 1) . ')';
			}	else {
				$this->caseSensitiveLinkValueRegex = '(' . $regexSafeTitle . ')';
			}
		}
		return $this->caseSensitiveLinkValueRegex;
	}

	/**
	 * Returns the \Content of the target page.
	 *
	 * The value is cached.
	 * @return \Content Content of the Target page.
	 */
	public function getContent() {
		if ( $this->content === null ) {
			$this->content = static::getPageContents( $this->title );
		};
		return $this->content;
	}

	/**
	 * Examines the current target page. Returns true if it may be linked;
	 * false if not. This depends on two settings:
	 * $wgLinkTitlesCheckRedirect and $wgLinkTitlesEnableNoTargetMagicWord
	 * and whether the target page is a redirect or contains the
	 * __NOAUTOLINKTARGET__ magic word.
	 *
	 * @param Source source
	 * @return boolean
	 */
	public function mayLinkTo( Source $source ) {
		// If checking for redirects is enabled and the target page does
		// indeed redirect to the current page, return the page title as-is
		// (unlinked).
		if ( $this->config->checkRedirect && $this->redirectsTo( $source ) ) {
			return false;
		};
		// If the magic word __NOAUTOLINKTARGET__ is enabled and the target
		// page does indeed contain this magic word, return the page title
		// as-is (unlinked).
		if ( $this->config->enableNoTargetMagicWord ) {
			if ( $this->getContent()->matchMagicWord( \MediaWiki\MediaWikiServices::getInstance()->getMagicWordFactory()->get( 'MAG_LINKTITLES_NOTARGET' ) ) ) {
				return false;
			}
		};
		return true;
	}

	/**
	 * Determines if the Target's title is the same as another title.
	 * @param  Source   $source Source object.
	 * @return boolean          True if the $otherTitle is the same, false if not.
	 */
	public function isSameTitle( Source $source) {
		return $this->title->equals( $source->getTitle() );
	}

	/**
	 * Checks whether this target redirects to the source.
	 * @param  Source $source Source page.
	 * @return bool           True if the target redirects to the source.
	 */
	public function redirectsTo( $source ) {
		if ( $this->getContent() ) {
			if ( version_compare( MW_VERSION, '1.38', '>=' ) ) {
				$redirectTitle = $this->getContent()->getRedirectTarget();
			} else {
				$redirectTitle = $this->getContent()->getUltimateRedirectTarget();
			}
			return $redirectTitle && $redirectTitle->equals( $source->getTitle() );
		}
	}

	/**
 	 * Obtain a page's content.
	 * Workaround for MediaWiki 1.36+ which deprecated Wikipage::factory.
	 * @param  MWTitle $title
	 * @return Content content object of the page
	 */
	private static function getPageContents( $title ) {
		if ( method_exists( MediaWikiServices::class, 'getWikiPageFactory' ) ) {
			$wikiPageFactory = MediaWikiServices::getInstance()->getWikiPageFactory();
			$page = $wikiPageFactory->newFromTitle( $title );
		} else {
			$page = \WikiPage::factory( $title );
		}
		return $page->getContent();
	}
}