mirror of
https://github.com/diocloid/LinkTitles.git
synced 2025-07-13 17:59:29 +02:00
227 lines
11 KiB
PHP
Executable File
227 lines
11 KiB
PHP
Executable File
<?php
|
|
/*
|
|
* Copyright 2012-2014 Daniel Kraus <krada@gmx.net> ('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.
|
|
*/
|
|
|
|
/// @file
|
|
/// This file will be loaded by MediaWiki if the extension is included in
|
|
/// `LocalSettings.php`. It sets up the classes for auto-loading,
|
|
/// announces metadata, and defines a number of @link config configuration
|
|
/// variables @endlink.
|
|
|
|
/// @cond
|
|
if ( !defined( 'MEDIAWIKI' ) ) {
|
|
die( 'Not an entry point.' );
|
|
}
|
|
/// @endcond
|
|
|
|
/*
|
|
error_reporting(E_ALL);
|
|
ini_set('display_errors', 'On');
|
|
ini_set('error_log', 'php://stderr');
|
|
$wgMainCacheType = CACHE_NONE;
|
|
$wgCacheDirectory = false;
|
|
*/
|
|
|
|
/// @defgroup config Configuration
|
|
/// The global configuration variables can be overriden in the local
|
|
/// `LocalSettings.php` file just like with any other extension.
|
|
/// These variables are all defined in LinkTitles.php.
|
|
|
|
/// Controls precedence of page titles. If true, pages with shorter titles
|
|
/// are given preference over pages with longer titles (e.g., link to
|
|
/// 'Media' rather than 'MediaWiki'). If false (default), longer titles
|
|
/// (which tend to be more specific) are given precedence (e.g., link to
|
|
/// 'MediaWiki' rather than 'Media' if both pages exist).
|
|
/// @ingroup config
|
|
$wgLinkTitlesPreferShortTitles = false;
|
|
|
|
/// The minimum number of characters in a title that is required for it to
|
|
/// be automatically linked to.
|
|
/// @ingroup config
|
|
$wgLinkTitlesMinimumTitleLength = 3;
|
|
|
|
/// Determines whether or not to insert links into headings.
|
|
/// @ingroup config
|
|
$wgLinkTitlesParseHeadings = false;
|
|
|
|
/// Important configuration variable that determines when the extension
|
|
/// will process a page. If set to true in `LocalSettings.php`, links will
|
|
/// be inserted whenever a page is edited and saved (unless 'minor
|
|
/// modifications' is checked). If set to false, the extension will not do
|
|
/// anything when a page is edited and saved. Because saving a page
|
|
/// automatically invalidates the cache, the next time the page is
|
|
/// displayed (i.e., immediately after saving it), the extension might add
|
|
/// links if $wgLinkTitlesParseOnRender is set to true.
|
|
/// @ingroup config
|
|
$wgLinkTitlesParseOnEdit = true;
|
|
|
|
/// Important configuration variable that determines when the
|
|
/// extension will process a page. If set to true in LocalSettings.php,
|
|
/// links will be added whenever a page is rendered for viewing, after
|
|
/// templates have been expanded.
|
|
/// @note Since pages are cached, links may not appear immediately.
|
|
/// When links are added during the rendering process, they do not appear
|
|
/// as markup when the page is edited. This may or may not be the behavior
|
|
/// that you desire. Also note that if lots of templates or parser
|
|
/// functions are included, processing time may increase quite a bit,
|
|
/// causing gateway time-out errors of the web server.
|
|
/// @ingroup config
|
|
$wgLinkTitlesParseOnRender = false;
|
|
|
|
/// Determines whether to parse text inside templates. If this is set to
|
|
/// true in LocalSettings.php, the parameters in a template will be parsed
|
|
/// (e.g., {{myTemplate|template parameter that may contain a page
|
|
/// title}}).
|
|
/// @note If pages are parsed when they are rendered (see
|
|
/// $wgLinkTitlesParseOnRender setting), this setting does not take
|
|
/// effect.
|
|
/// @ingroup config
|
|
$wgLinkTitlesSkipTemplates = false;
|
|
|
|
/// Blacklist of page titles that should never be linked.
|
|
/// @note See also: __NOAUTOLINKTARGET__ magic word to allow wiki users to
|
|
/// blacklist a page dynamically.
|
|
/// @ingroup config
|
|
$wgLinkTitlesBlackList = array();
|
|
|
|
/// Determines whether to link only the first occurrence of a page
|
|
/// title on a page or all occurrences. Default is false: All occurrences
|
|
/// on a page are linked.
|
|
/// @ingroup config
|
|
$wgLinkTitlesFirstOnly = false;
|
|
|
|
/// Determines whether a page title must occur at the start of a word in
|
|
/// order for it to be linked. Example: Given a page 'Media' and an
|
|
/// article that contains the word 'Multimedia', the default setting
|
|
/// (`true`) will prevent the page from being linked. If this setting is
|
|
/// overriden in `LocalSettings.php` to be `false`, a link would be
|
|
/// inserted: `Multi[[media]]`.
|
|
/// @note If both $wgLinkTitlesWordStartOnly and $wgLinkTitlesWordEndOnly
|
|
/// are overriden to `false` in `LocalSettings.php`, you may get weird
|
|
/// linking. As a (contrieved) example, consider a wiki that has a page
|
|
/// "spa", then the word "namespace" in a technical article would be
|
|
/// linked as `name[[spa]]ce`, which is likely not what you want.
|
|
/// @ingroup config
|
|
$wgLinkTitlesWordStartOnly = true;
|
|
|
|
/// Determines whether a page title must end with the end of a word in
|
|
/// order for it to be linked. Example: Given a page 'Media' and an
|
|
/// article that contains the word 'MediaWiki', the default setting
|
|
/// (`true`) will prevent the page from being linked, because both words
|
|
/// have different endings. If this setting is overriden in
|
|
/// `LocalSettings.php` to be `false`, a link would be inserted:
|
|
/// `[[Media]]wiki`.
|
|
/// @note Setting this to false may have undesired effects because there
|
|
/// are many short words that may randomly occur in longer words, but are
|
|
/// semantically unrelated.
|
|
/// @note If both $wgLinkTitlesWordStartOnly and $wgLinkTitlesWordEndOnly
|
|
/// are overriden to `false` in `LocalSettings.php`, you may get weird
|
|
/// linking. As a (contrieved) example, consider a wiki that has a page
|
|
/// "spa", then the word "namespace" in a technical article would be
|
|
/// linked as `name[[spa]]ce`, which is likely not what you want.
|
|
/// @ingroup config
|
|
$wgLinkTitlesWordEndOnly = true;
|
|
|
|
/// Important setting that controls the extension's smart mode of
|
|
/// operation. With smart mode turned on (default), the extension will
|
|
/// first link all occurrences of a page title on a page in a
|
|
/// case-sensitive manner (but see note). It will then perform a second
|
|
/// pass in a case-__in__sensitive manner. For example, if you have a page
|
|
/// called "IgAN" (abbreviation for IgA nephritis, a kidney disease) and
|
|
/// someone writes the alternative form "Igan" in their article, then the
|
|
/// page would not be linked if smart mode is turned off.
|
|
/// @note Because smart mode constitutes two-pass processing of a page,
|
|
/// rather than single-pass, the processing time will increase. This may
|
|
/// not be noticeable on single page saves, but may play a role during
|
|
/// @link batch batch processing @endlink.
|
|
/// @ingroup config
|
|
$wgLinkTitlesSmartMode = true;
|
|
|
|
/// Determines whether or not to check if a page redirects to the current
|
|
/// page. This check requires that the extension fetches the page content
|
|
/// of a potential target page from the database, which costs time.
|
|
/// @note For maximum performance, set both $wgLinkTitlesCheckRedirect and
|
|
/// $wgLinkTitlesEnableNoTargetMagicWord to false in LocalSettings.php.
|
|
/// On the developer's machine, fetching the target page content increased
|
|
/// the run time from about 50 ms to about 500 ms on a wiki with 90 pages
|
|
/// (Intel Core i5-3320M, 2x 2.6 GHz, 16 GB RAM, PHP 5.5.9, Apache 2.4.7,
|
|
/// MySQL 5.5.37, MediaWiki 1.23.0). If any of the two mentioned variables
|
|
/// is set to true, a page content request will be performed for every
|
|
/// page whose title occurs on a given page.
|
|
/// @ingroup config
|
|
$wgLinkTitlesCheckRedirect = true;
|
|
|
|
/// Determines whether or not the magic word __NOAUTOLINKTARGET__ is
|
|
/// enabled or not. If __NOAUTOLINKTARGET__ is included in a page, this
|
|
/// page will never be linked to by the extension. The default is enabled
|
|
/// (true), but it comes at the cost of performance.
|
|
/// @note For maximum performance, set both $wgLinkTitlesCheckRedirect and
|
|
/// $wgLinkTitlesEnableNoTargetMagicWord to false in LocalSettings.php.
|
|
/// On the developer's machine, fetching the target page content increased
|
|
/// the run time from about 50 ms to about 500 ms on a wiki with 90 pages
|
|
/// (Intel Core i5-3320M, 2x 2.6 GHz, 16 GB RAM, PHP 5.5.9, Apache 2.4.7,
|
|
/// MySQL 5.5.37, MediaWiki 1.23.0). If any of the two mentioned variables
|
|
/// is set to true, a page content request will be performed for every
|
|
/// page whose title occurs on a given page.
|
|
/// @ingroup config
|
|
$wgLinkTitlesEnableNoTargetMagicWord = true;
|
|
|
|
/// Time limit for online batch processing. This determines the maximum
|
|
/// amount of time in seconds that page processing will take before a
|
|
/// refresh of the special page is issued.
|
|
/// @note See SpecialLinkTitles class.
|
|
/// @ingroup config
|
|
$wgLinkTitlesTimeLimit = 0.2;
|
|
|
|
/// @cond
|
|
$wgExtensionCredits['parserhook'][] = array(
|
|
'path' => __FILE__,
|
|
'name' => 'LinkTitles',
|
|
'author' => '[https://www.mediawiki.org/wiki/User:Bovender Daniel Kraus]',
|
|
'url' => 'https://www.mediawiki.org/wiki/Extension:LinkTitles',
|
|
'version' => '3.1.0',
|
|
'descriptionmsg' => 'linktitles-desc'
|
|
);
|
|
|
|
$wgExtensionMessagesFiles['LinkTitles'] = dirname( __FILE__ ) . '/LinkTitles.i18n.php';
|
|
$wgExtensionMessagesFiles['LinkTitlesMagic'] = dirname( __FILE__ ) . '/LinkTitles.i18n.magic.php';
|
|
$wgAutoloadClasses['LinkTitles'] = dirname( __FILE__ ) . '/LinkTitles.body.php';
|
|
$wgAutoloadClasses['SpecialLinkTitles'] = dirname( __FILE__ ) . '/SpecialLinkTitles.php';
|
|
$wgExtensionFunctions[] = 'LinkTitles::setup';
|
|
|
|
// Settings for the batch-processing special page
|
|
$wgSpecialPages['LinkTitles'] = 'SpecialLinkTitles';
|
|
$wgSpecialPageGroups['LinkTitles'] = 'other';
|
|
/// @endcond
|
|
|
|
/// The @link SpecialLinkTitles special page @endlink provides a distinct
|
|
/// right `linktitles-batch`. A user must be granted this right in order
|
|
/// to be able to visit this page.
|
|
$wgAvailableRights[] = 'linktitles-batch';
|
|
|
|
/// Grants the `linktitles-batch` right to sysops by default.
|
|
/// Override this only with care. If anybody can execute the
|
|
/// @link SpecialLinkTitles special page @endlink the server might
|
|
/// experience high loads.
|
|
/// @ingroup config
|
|
$wgGroupPermissions['sysop']['linktitles-batch'] = true;
|
|
|
|
// vim: ts=2:sw=2:noet:comments^=\:///
|
|
|