wikimedia /
mediawiki
Duplicate code is one of the most pungent code smells. A rule that is often used is to re-structure code once it is duplicated in three or more places.
Common duplication problems, and corresponding solutions are:
Complex classes like Linker often do a lot of different things. To break such a class down, we need to identify a cohesive component within that class. A common approach to find such a component is to look for fields/methods that share the same prefixes, or suffixes. You can also have a look at the cohesion graph to spot any un-connected, or weakly-connected components.
Once you have determined the fields that belong together, you can apply the Extract Class refactoring. If the component makes sense as a sub-class, Extract Subclass is also a candidate, and is often faster.
While breaking up the class, it is a good idea to analyze how other classes use Linker, and based on these observations, apply Extract Interface, too.
| 1 | <?php |
||
| 34 | class Linker { |
||
| 35 | /** |
||
| 36 | * Flags for userToolLinks() |
||
| 37 | */ |
||
| 38 | const TOOL_LINKS_NOBLOCK = 1; |
||
| 39 | const TOOL_LINKS_EMAIL = 2; |
||
| 40 | |||
| 41 | /** |
||
| 42 | * Get the appropriate HTML attributes to add to the "a" element of an interwiki link. |
||
| 43 | * |
||
| 44 | * @since 1.16.3 |
||
| 45 | * @deprecated since 1.25 |
||
| 46 | * |
||
| 47 | * @param string $title The title text for the link, URL-encoded (???) but |
||
| 48 | * not HTML-escaped |
||
| 49 | * @param string $unused Unused |
||
| 50 | * @param string $class The contents of the class attribute; if an empty |
||
| 51 | * string is passed, which is the default value, defaults to 'external'. |
||
| 52 | * @return string |
||
| 53 | */ |
||
| 54 | static function getInterwikiLinkAttributes( $title, $unused = null, $class = 'external' ) { |
||
| 67 | |||
| 68 | /** |
||
| 69 | * Get the appropriate HTML attributes to add to the "a" element of an internal link. |
||
| 70 | * |
||
| 71 | * @since 1.16.3 |
||
| 72 | * @deprecated since 1.25 |
||
| 73 | * |
||
| 74 | * @param string $title The title text for the link, URL-encoded (???) but |
||
| 75 | * not HTML-escaped |
||
| 76 | * @param string $unused Unused |
||
| 77 | * @param string $class The contents of the class attribute, default none |
||
| 78 | * @return string |
||
| 79 | */ |
||
| 80 | static function getInternalLinkAttributes( $title, $unused = null, $class = '' ) { |
||
| 87 | |||
| 88 | /** |
||
| 89 | * Get the appropriate HTML attributes to add to the "a" element of an internal |
||
| 90 | * link, given the Title object for the page we want to link to. |
||
| 91 | * |
||
| 92 | * @since 1.16.3 |
||
| 93 | * @deprecated since 1.25 |
||
| 94 | * |
||
| 95 | * @param Title $nt |
||
| 96 | * @param string $unused Unused |
||
| 97 | * @param string $class The contents of the class attribute, default none |
||
| 98 | * @param string|bool $title Optional (unescaped) string to use in the title |
||
| 99 | * attribute; if false, default to the name of the page we're linking to |
||
| 100 | * @return string |
||
| 101 | */ |
||
| 102 | static function getInternalLinkAttributesObj( $nt, $unused = null, $class = '', $title = false ) { |
||
| 110 | |||
| 111 | /** |
||
| 112 | * Common code for getLinkAttributesX functions |
||
| 113 | * |
||
| 114 | * @since 1.16.3 |
||
| 115 | * @deprecated since 1.25 |
||
| 116 | * |
||
| 117 | * @param string $title |
||
| 118 | * @param string $class |
||
| 119 | * |
||
| 120 | * @return string |
||
| 121 | */ |
||
| 122 | private static function getLinkAttributesInternal( $title, $class ) { |
||
| 136 | |||
| 137 | /** |
||
| 138 | * Return the CSS colour of a known link |
||
| 139 | * |
||
| 140 | * @since 1.16.3 |
||
| 141 | * @param LinkTarget $t |
||
| 142 | * @param int $threshold User defined threshold |
||
| 143 | * @return string CSS class |
||
| 144 | */ |
||
| 145 | public static function getLinkColour( LinkTarget $t, $threshold ) { |
||
| 166 | |||
| 167 | /** |
||
| 168 | * This function returns an HTML link to the given target. It serves a few |
||
| 169 | * purposes: |
||
| 170 | * 1) If $target is a Title, the correct URL to link to will be figured |
||
| 171 | * out automatically. |
||
| 172 | * 2) It automatically adds the usual classes for various types of link |
||
| 173 | * targets: "new" for red links, "stub" for short articles, etc. |
||
| 174 | * 3) It escapes all attribute values safely so there's no risk of XSS. |
||
| 175 | * 4) It provides a default tooltip if the target is a Title (the page |
||
| 176 | * name of the target). |
||
| 177 | * link() replaces the old functions in the makeLink() family. |
||
| 178 | * |
||
| 179 | * @since 1.18 Method exists since 1.16 as non-static, made static in 1.18. |
||
| 180 | * |
||
| 181 | * @param Title $target Can currently only be a Title, but this may |
||
| 182 | * change to support Images, literal URLs, etc. |
||
| 183 | * @param string $html The HTML contents of the <a> element, i.e., |
||
| 184 | * the link text. This is raw HTML and will not be escaped. If null, |
||
| 185 | * defaults to the prefixed text of the Title; or if the Title is just a |
||
| 186 | * fragment, the contents of the fragment. |
||
| 187 | * @param array $customAttribs A key => value array of extra HTML attributes, |
||
| 188 | * such as title and class. (href is ignored.) Classes will be |
||
| 189 | * merged with the default classes, while other attributes will replace |
||
| 190 | * default attributes. All passed attribute values will be HTML-escaped. |
||
| 191 | * A false attribute value means to suppress that attribute. |
||
| 192 | * @param array $query The query string to append to the URL |
||
| 193 | * you're linking to, in key => value array form. Query keys and values |
||
| 194 | * will be URL-encoded. |
||
| 195 | * @param string|array $options String or array of strings: |
||
| 196 | * 'known': Page is known to exist, so don't check if it does. |
||
| 197 | * 'broken': Page is known not to exist, so don't check if it does. |
||
| 198 | * 'noclasses': Don't add any classes automatically (includes "new", |
||
| 199 | * "stub", "mw-redirect", "extiw"). Only use the class attribute |
||
| 200 | * provided, if any, so you get a simple blue link with no funny i- |
||
| 201 | * cons. |
||
| 202 | * 'forcearticlepath': Use the article path always, even with a querystring. |
||
| 203 | * Has compatibility issues on some setups, so avoid wherever possible. |
||
| 204 | * 'http': Force a full URL with http:// as the scheme. |
||
| 205 | * 'https': Force a full URL with https:// as the scheme. |
||
| 206 | * 'stubThreshold' => (int): Stub threshold to use when determining link classes. |
||
| 207 | * @return string HTML <a> attribute |
||
| 208 | */ |
||
| 209 | public static function link( |
||
| 252 | |||
| 253 | /** |
||
| 254 | * Identical to link(), except $options defaults to 'known'. |
||
| 255 | * @since 1.16.3 |
||
| 256 | * @see Linker::link |
||
| 257 | * @return string |
||
| 258 | */ |
||
| 259 | public static function linkKnown( |
||
| 265 | |||
| 266 | /** |
||
| 267 | * Make appropriate markup for a link to the current article. This is |
||
| 268 | * currently rendered as the bold link text. The calling sequence is the |
||
| 269 | * same as the other make*LinkObj static functions, despite $query not |
||
| 270 | * being used. |
||
| 271 | * |
||
| 272 | * @since 1.16.3 |
||
| 273 | * @param Title $nt |
||
| 274 | * @param string $html [optional] |
||
| 275 | * @param string $query [optional] |
||
| 276 | * @param string $trail [optional] |
||
| 277 | * @param string $prefix [optional] |
||
| 278 | * |
||
| 279 | * @return string |
||
| 280 | */ |
||
| 281 | public static function makeSelfLinkObj( $nt, $html = '', $query = '', $trail = '', $prefix = '' ) { |
||
| 293 | |||
| 294 | /** |
||
| 295 | * Get a message saying that an invalid title was encountered. |
||
| 296 | * This should be called after a method like Title::makeTitleSafe() returned |
||
| 297 | * a value indicating that the title object is invalid. |
||
| 298 | * |
||
| 299 | * @param IContextSource $context Context to use to get the messages |
||
| 300 | * @param int $namespace Namespace number |
||
| 301 | * @param string $title Text of the title, without the namespace part |
||
| 302 | * @return string |
||
| 303 | */ |
||
| 304 | public static function getInvalidTitleDescription( IContextSource $context, $namespace, $title ) { |
||
| 319 | |||
| 320 | /** |
||
| 321 | * @since 1.16.3 |
||
| 322 | * @param LinkTarget $target |
||
| 323 | * @return LinkTarget|Title You will get back the same type you passed in, or a Title object |
||
| 324 | */ |
||
| 325 | public static function normaliseSpecialPage( LinkTarget $target ) { |
||
| 337 | |||
| 338 | /** |
||
| 339 | * Returns the filename part of an url. |
||
| 340 | * Used as alternative text for external images. |
||
| 341 | * |
||
| 342 | * @param string $url |
||
| 343 | * |
||
| 344 | * @return string |
||
| 345 | */ |
||
| 346 | private static function fnamePart( $url ) { |
||
| 355 | |||
| 356 | /** |
||
| 357 | * Return the code for images which were added via external links, |
||
| 358 | * via Parser::maybeMakeExternalImage(). |
||
| 359 | * |
||
| 360 | * @since 1.16.3 |
||
| 361 | * @param string $url |
||
| 362 | * @param string $alt |
||
| 363 | * |
||
| 364 | * @return string |
||
| 365 | */ |
||
| 366 | public static function makeExternalImage( $url, $alt = '' ) { |
||
| 382 | |||
| 383 | /** |
||
| 384 | * Given parameters derived from [[Image:Foo|options...]], generate the |
||
| 385 | * HTML that that syntax inserts in the page. |
||
| 386 | * |
||
| 387 | * @param Parser $parser |
||
| 388 | * @param Title $title Title object of the file (not the currently viewed page) |
||
| 389 | * @param File $file File object, or false if it doesn't exist |
||
| 390 | * @param array $frameParams Associative array of parameters external to the media handler. |
||
| 391 | * Boolean parameters are indicated by presence or absence, the value is arbitrary and |
||
| 392 | * will often be false. |
||
| 393 | * thumbnail If present, downscale and frame |
||
| 394 | * manualthumb Image name to use as a thumbnail, instead of automatic scaling |
||
| 395 | * framed Shows image in original size in a frame |
||
| 396 | * frameless Downscale but don't frame |
||
| 397 | * upright If present, tweak default sizes for portrait orientation |
||
| 398 | * upright_factor Fudge factor for "upright" tweak (default 0.75) |
||
| 399 | * border If present, show a border around the image |
||
| 400 | * align Horizontal alignment (left, right, center, none) |
||
| 401 | * valign Vertical alignment (baseline, sub, super, top, text-top, middle, |
||
| 402 | * bottom, text-bottom) |
||
| 403 | * alt Alternate text for image (i.e. alt attribute). Plain text. |
||
| 404 | * class HTML for image classes. Plain text. |
||
| 405 | * caption HTML for image caption. |
||
| 406 | * link-url URL to link to |
||
| 407 | * link-title Title object to link to |
||
| 408 | * link-target Value for the target attribute, only with link-url |
||
| 409 | * no-link Boolean, suppress description link |
||
| 410 | * |
||
| 411 | * @param array $handlerParams Associative array of media handler parameters, to be passed |
||
| 412 | * to transform(). Typical keys are "width" and "page". |
||
| 413 | * @param string|bool $time Timestamp of the file, set as false for current |
||
| 414 | * @param string $query Query params for desc url |
||
| 415 | * @param int|null $widthOption Used by the parser to remember the user preference thumbnailsize |
||
| 416 | * @since 1.20 |
||
| 417 | * @return string HTML for an image, with links, wrappers, etc. |
||
| 418 | */ |
||
| 419 | public static function makeImageLink( Parser $parser, Title $title, |
||
| 554 | |||
| 555 | /** |
||
| 556 | * Get the link parameters for MediaTransformOutput::toHtml() from given |
||
| 557 | * frame parameters supplied by the Parser. |
||
| 558 | * @param array $frameParams The frame parameters |
||
| 559 | * @param string $query An optional query string to add to description page links |
||
| 560 | * @param Parser|null $parser |
||
| 561 | * @return array |
||
| 562 | */ |
||
| 563 | private static function getImageLinkMTOParams( $frameParams, $query = '', $parser = null ) { |
||
| 587 | |||
| 588 | /** |
||
| 589 | * Make HTML for a thumbnail including image, border and caption |
||
| 590 | * @param Title $title |
||
| 591 | * @param File|bool $file File object or false if it doesn't exist |
||
| 592 | * @param string $label |
||
| 593 | * @param string $alt |
||
| 594 | * @param string $align |
||
| 595 | * @param array $params |
||
| 596 | * @param bool $framed |
||
| 597 | * @param string $manualthumb |
||
| 598 | * @return string |
||
| 599 | */ |
||
| 600 | public static function makeThumbLinkObj( Title $title, $file, $label = '', $alt, |
||
| 616 | |||
| 617 | /** |
||
| 618 | * @param Title $title |
||
| 619 | * @param File $file |
||
| 620 | * @param array $frameParams |
||
| 621 | * @param array $handlerParams |
||
| 622 | * @param bool $time |
||
| 623 | * @param string $query |
||
| 624 | * @return string |
||
| 625 | */ |
||
| 626 | public static function makeThumbLink2( Title $title, $file, $frameParams = [], |
||
| 743 | |||
| 744 | /** |
||
| 745 | * Process responsive images: add 1.5x and 2x subimages to the thumbnail, where |
||
| 746 | * applicable. |
||
| 747 | * |
||
| 748 | * @param File $file |
||
| 749 | * @param MediaTransformOutput $thumb |
||
| 750 | * @param array $hp Image parameters |
||
| 751 | */ |
||
| 752 | public static function processResponsiveImages( $file, $thumb, $hp ) { |
||
| 774 | |||
| 775 | /** |
||
| 776 | * Make a "broken" link to an image |
||
| 777 | * |
||
| 778 | * @since 1.16.3 |
||
| 779 | * @param Title $title |
||
| 780 | * @param string $label Link label (plain text) |
||
| 781 | * @param string $query Query string |
||
| 782 | * @param string $unused1 Unused parameter kept for b/c |
||
| 783 | * @param string $unused2 Unused parameter kept for b/c |
||
| 784 | * @param bool $time A file of a certain timestamp was requested |
||
| 785 | * @return string |
||
| 786 | */ |
||
| 787 | public static function makeBrokenImageLinkObj( $title, $label = '', |
||
| 788 | $query = '', $unused1 = '', $unused2 = '', $time = false |
||
| 789 | ) { |
||
| 790 | if ( !$title instanceof Title ) { |
||
| 791 | wfWarn( __METHOD__ . ': Requires $title to be a Title object.' ); |
||
| 792 | return "<!-- ERROR -->" . htmlspecialchars( $label ); |
||
| 793 | } |
||
| 794 | |||
| 795 | global $wgEnableUploads, $wgUploadMissingFileUrl, $wgUploadNavigationUrl; |
||
| 796 | if ( $label == '' ) { |
||
| 797 | $label = $title->getPrefixedText(); |
||
| 798 | } |
||
| 799 | $encLabel = htmlspecialchars( $label ); |
||
| 800 | $currentExists = $time ? ( wfFindFile( $title ) != false ) : false; |
||
| 801 | |||
| 802 | if ( ( $wgUploadMissingFileUrl || $wgUploadNavigationUrl || $wgEnableUploads ) |
||
| 803 | && !$currentExists |
||
| 804 | ) { |
||
| 805 | $redir = RepoGroup::singleton()->getLocalRepo()->checkRedirect( $title ); |
||
| 806 | |||
| 807 | if ( $redir ) { |
||
| 808 | // We already know it's a redirect, so mark it |
||
| 809 | // accordingly |
||
| 810 | return self::link( |
||
| 811 | $title, |
||
| 812 | $encLabel, |
||
| 813 | [ 'class' => 'mw-redirect' ], |
||
| 814 | wfCgiToArray( $query ), |
||
| 815 | [ 'known', 'noclasses' ] |
||
| 816 | ); |
||
| 817 | } |
||
| 818 | |||
| 819 | $href = self::getUploadUrl( $title, $query ); |
||
| 820 | |||
| 821 | return '<a href="' . htmlspecialchars( $href ) . '" class="new" title="' . |
||
| 822 | htmlspecialchars( $title->getPrefixedText(), ENT_QUOTES ) . '">' . |
||
| 823 | $encLabel . '</a>'; |
||
| 824 | } |
||
| 825 | |||
| 826 | return self::link( $title, $encLabel, [], wfCgiToArray( $query ), [ 'known', 'noclasses' ] ); |
||
| 827 | } |
||
| 828 | |||
| 829 | /** |
||
| 830 | * Get the URL to upload a certain file |
||
| 831 | * |
||
| 832 | * @since 1.16.3 |
||
| 833 | * @param Title $destFile Title object of the file to upload |
||
| 834 | * @param string $query Urlencoded query string to prepend |
||
| 835 | * @return string Urlencoded URL |
||
| 836 | */ |
||
| 837 | protected static function getUploadUrl( $destFile, $query = '' ) { |
||
| 853 | |||
| 854 | /** |
||
| 855 | * Create a direct link to a given uploaded file. |
||
| 856 | * |
||
| 857 | * @since 1.16.3 |
||
| 858 | * @param Title $title |
||
| 859 | * @param string $html Pre-sanitized HTML |
||
| 860 | * @param string $time MW timestamp of file creation time |
||
| 861 | * @return string HTML |
||
| 862 | */ |
||
| 863 | public static function makeMediaLinkObj( $title, $html = '', $time = false ) { |
||
| 867 | |||
| 868 | /** |
||
| 869 | * Create a direct link to a given uploaded file. |
||
| 870 | * This will make a broken link if $file is false. |
||
| 871 | * |
||
| 872 | * @since 1.16.3 |
||
| 873 | * @param Title $title |
||
| 874 | * @param File|bool $file File object or false |
||
| 875 | * @param string $html Pre-sanitized HTML |
||
| 876 | * @return string HTML |
||
| 877 | * |
||
| 878 | * @todo Handle invalid or missing images better. |
||
| 879 | */ |
||
| 880 | public static function makeMediaLinkFile( Title $title, $file, $html = '' ) { |
||
| 910 | |||
| 911 | /** |
||
| 912 | * Make a link to a special page given its name and, optionally, |
||
| 913 | * a message key from the link text. |
||
| 914 | * Usage example: Linker::specialLink( 'Recentchanges' ) |
||
| 915 | * |
||
| 916 | * @since 1.16.3 |
||
| 917 | * @param string $name |
||
| 918 | * @param string $key |
||
| 919 | * @return string |
||
| 920 | */ |
||
| 921 | public static function specialLink( $name, $key = '' ) { |
||
| 928 | |||
| 929 | /** |
||
| 930 | * Make an external link |
||
| 931 | * @since 1.16.3. $title added in 1.21 |
||
| 932 | * @param string $url URL to link to |
||
| 933 | * @param string $text Text of link |
||
| 934 | * @param bool $escape Do we escape the link text? |
||
| 935 | * @param string $linktype Type of external link. Gets added to the classes |
||
| 936 | * @param array $attribs Array of extra attributes to <a> |
||
| 937 | * @param Title|null $title Title object used for title specific link attributes |
||
| 938 | * @return string |
||
| 939 | */ |
||
| 940 | public static function makeExternalLink( $url, $text, $escape = true, |
||
| 981 | |||
| 982 | /** |
||
| 983 | * Make user link (or user contributions for unregistered users) |
||
| 984 | * @param int $userId User id in database. |
||
| 985 | * @param string $userName User name in database. |
||
| 986 | * @param string $altUserName Text to display instead of the user name (optional) |
||
| 987 | * @return string HTML fragment |
||
| 988 | * @since 1.16.3. $altUserName was added in 1.19. |
||
| 989 | */ |
||
| 990 | public static function userLink( $userId, $userName, $altUserName = false ) { |
||
| 1008 | |||
| 1009 | /** |
||
| 1010 | * Generate standard user tool links (talk, contributions, block link, etc.) |
||
| 1011 | * |
||
| 1012 | * @since 1.16.3 |
||
| 1013 | * @param int $userId User identifier |
||
| 1014 | * @param string $userText User name or IP address |
||
| 1015 | * @param bool $redContribsWhenNoEdits Should the contributions link be |
||
| 1016 | * red if the user has no edits? |
||
| 1017 | * @param int $flags Customisation flags (e.g. Linker::TOOL_LINKS_NOBLOCK |
||
| 1018 | * and Linker::TOOL_LINKS_EMAIL). |
||
| 1019 | * @param int $edits User edit count (optional, for performance) |
||
| 1020 | * @return string HTML fragment |
||
| 1021 | */ |
||
| 1022 | public static function userToolLinks( |
||
| 1069 | |||
| 1070 | /** |
||
| 1071 | * Alias for userToolLinks( $userId, $userText, true ); |
||
| 1072 | * @since 1.16.3 |
||
| 1073 | * @param int $userId User identifier |
||
| 1074 | * @param string $userText User name or IP address |
||
| 1075 | * @param int $edits User edit count (optional, for performance) |
||
| 1076 | * @return string |
||
| 1077 | */ |
||
| 1078 | public static function userToolLinksRedContribs( $userId, $userText, $edits = null ) { |
||
| 1081 | |||
| 1082 | /** |
||
| 1083 | * @since 1.16.3 |
||
| 1084 | * @param int $userId User id in database. |
||
| 1085 | * @param string $userText User name in database. |
||
| 1086 | * @return string HTML fragment with user talk link |
||
| 1087 | */ |
||
| 1088 | public static function userTalkLink( $userId, $userText ) { |
||
| 1093 | |||
| 1094 | /** |
||
| 1095 | * @since 1.16.3 |
||
| 1096 | * @param int $userId Userid |
||
| 1097 | * @param string $userText User name in database. |
||
| 1098 | * @return string HTML fragment with block link |
||
| 1099 | */ |
||
| 1100 | public static function blockLink( $userId, $userText ) { |
||
| 1105 | |||
| 1106 | /** |
||
| 1107 | * @param int $userId Userid |
||
| 1108 | * @param string $userText User name in database. |
||
| 1109 | * @return string HTML fragment with e-mail user link |
||
| 1110 | */ |
||
| 1111 | public static function emailLink( $userId, $userText ) { |
||
| 1116 | |||
| 1117 | /** |
||
| 1118 | * Generate a user link if the current user is allowed to view it |
||
| 1119 | * @since 1.16.3 |
||
| 1120 | * @param Revision $rev |
||
| 1121 | * @param bool $isPublic Show only if all users can see it |
||
| 1122 | * @return string HTML fragment |
||
| 1123 | */ |
||
| 1124 | public static function revUserLink( $rev, $isPublic = false ) { |
||
| 1138 | |||
| 1139 | /** |
||
| 1140 | * Generate a user tool link cluster if the current user is allowed to view it |
||
| 1141 | * @since 1.16.3 |
||
| 1142 | * @param Revision $rev |
||
| 1143 | * @param bool $isPublic Show only if all users can see it |
||
| 1144 | * @return string HTML |
||
| 1145 | */ |
||
| 1146 | public static function revUserTools( $rev, $isPublic = false ) { |
||
| 1162 | |||
| 1163 | /** |
||
| 1164 | * This function is called by all recent changes variants, by the page history, |
||
| 1165 | * and by the user contributions list. It is responsible for formatting edit |
||
| 1166 | * summaries. It escapes any HTML in the summary, but adds some CSS to format |
||
| 1167 | * auto-generated comments (from section editing) and formats [[wikilinks]]. |
||
| 1168 | * |
||
| 1169 | * @author Erik Moeller <[email protected]> |
||
| 1170 | * @since 1.16.3. $wikiId added in 1.26 |
||
| 1171 | * |
||
| 1172 | * Note: there's not always a title to pass to this function. |
||
| 1173 | * Since you can't set a default parameter for a reference, I've turned it |
||
| 1174 | * temporarily to a value pass. Should be adjusted further. --brion |
||
| 1175 | * |
||
| 1176 | * @param string $comment |
||
| 1177 | * @param Title|null $title Title object (to generate link to the section in autocomment) |
||
| 1178 | * or null |
||
| 1179 | * @param bool $local Whether section links should refer to local page |
||
| 1180 | * @param string|null $wikiId Id (as used by WikiMap) of the wiki to generate links to. |
||
| 1181 | * For use with external changes. |
||
| 1182 | * |
||
| 1183 | * @return mixed|string |
||
| 1184 | */ |
||
| 1185 | public static function formatComment( |
||
| 1199 | |||
| 1200 | /** |
||
| 1201 | * Converts autogenerated comments in edit summaries into section links. |
||
| 1202 | * |
||
| 1203 | * The pattern for autogen comments is / * foo * /, which makes for |
||
| 1204 | * some nasty regex. |
||
| 1205 | * We look for all comments, match any text before and after the comment, |
||
| 1206 | * add a separator where needed and format the comment itself with CSS |
||
| 1207 | * Called by Linker::formatComment. |
||
| 1208 | * |
||
| 1209 | * @param string $comment Comment text |
||
| 1210 | * @param Title|null $title An optional title object used to links to sections |
||
| 1211 | * @param bool $local Whether section links should refer to local page |
||
| 1212 | * @param string|null $wikiId Id of the wiki to link to (if not the local wiki), |
||
| 1213 | * as used by WikiMap. |
||
| 1214 | * |
||
| 1215 | * @return string Formatted comment (wikitext) |
||
| 1216 | */ |
||
| 1217 | private static function formatAutocomments( |
||
| 1291 | |||
| 1292 | /** |
||
| 1293 | * Formats wiki links and media links in text; all other wiki formatting |
||
| 1294 | * is ignored |
||
| 1295 | * |
||
| 1296 | * @since 1.16.3. $wikiId added in 1.26 |
||
| 1297 | * @todo FIXME: Doesn't handle sub-links as in image thumb texts like the main parser |
||
| 1298 | * |
||
| 1299 | * @param string $comment Text to format links in. WARNING! Since the output of this |
||
| 1300 | * function is html, $comment must be sanitized for use as html. You probably want |
||
| 1301 | * to pass $comment through Sanitizer::escapeHtmlAllowEntities() before calling |
||
| 1302 | * this function. |
||
| 1303 | * @param Title|null $title An optional title object used to links to sections |
||
| 1304 | * @param bool $local Whether section links should refer to local page |
||
| 1305 | * @param string|null $wikiId Id of the wiki to link to (if not the local wiki), |
||
| 1306 | * as used by WikiMap. |
||
| 1307 | * |
||
| 1308 | * @return string |
||
| 1309 | */ |
||
| 1310 | public static function formatLinksInComment( |
||
| 1404 | |||
| 1405 | /** |
||
| 1406 | * Generates a link to the given Title |
||
| 1407 | * |
||
| 1408 | * @note This is only public for technical reasons. It's not intended for use outside Linker. |
||
| 1409 | * |
||
| 1410 | * @param Title $title |
||
| 1411 | * @param string $text |
||
| 1412 | * @param string|null $wikiId Id of the wiki to link to (if not the local wiki), |
||
| 1413 | * as used by WikiMap. |
||
| 1414 | * @param string|string[] $options See the $options parameter in Linker::link. |
||
| 1415 | * |
||
| 1416 | * @return string HTML link |
||
| 1417 | */ |
||
| 1418 | public static function makeCommentLink( |
||
| 1437 | |||
| 1438 | /** |
||
| 1439 | * @param Title $contextTitle |
||
| 1440 | * @param string $target |
||
| 1441 | * @param string $text |
||
| 1442 | * @return string |
||
| 1443 | */ |
||
| 1444 | public static function normalizeSubpageLink( $contextTitle, $target, &$text ) { |
||
| 1516 | |||
| 1517 | /** |
||
| 1518 | * Wrap a comment in standard punctuation and formatting if |
||
| 1519 | * it's non-empty, otherwise return empty string. |
||
| 1520 | * |
||
| 1521 | * @since 1.16.3. $wikiId added in 1.26 |
||
| 1522 | * @param string $comment |
||
| 1523 | * @param Title|null $title Title object (to generate link to section in autocomment) or null |
||
| 1524 | * @param bool $local Whether section links should refer to local page |
||
| 1525 | * @param string|null $wikiId Id (as used by WikiMap) of the wiki to generate links to. |
||
| 1526 | * For use with external changes. |
||
| 1527 | * |
||
| 1528 | * @return string |
||
| 1529 | */ |
||
| 1530 | public static function commentBlock( |
||
| 1544 | |||
| 1545 | /** |
||
| 1546 | * Wrap and format the given revision's comment block, if the current |
||
| 1547 | * user is allowed to view it. |
||
| 1548 | * |
||
| 1549 | * @since 1.16.3 |
||
| 1550 | * @param Revision $rev |
||
| 1551 | * @param bool $local Whether section links should refer to local page |
||
| 1552 | * @param bool $isPublic Show only if all users can see it |
||
| 1553 | * @return string HTML fragment |
||
| 1554 | */ |
||
| 1555 | public static function revComment( Revision $rev, $local = false, $isPublic = false ) { |
||
| 1572 | |||
| 1573 | /** |
||
| 1574 | * @since 1.16.3 |
||
| 1575 | * @param int $size |
||
| 1576 | * @return string |
||
| 1577 | */ |
||
| 1578 | public static function formatRevisionSize( $size ) { |
||
| 1587 | |||
| 1588 | /** |
||
| 1589 | * Add another level to the Table of Contents |
||
| 1590 | * |
||
| 1591 | * @since 1.16.3 |
||
| 1592 | * @return string |
||
| 1593 | */ |
||
| 1594 | public static function tocIndent() { |
||
| 1597 | |||
| 1598 | /** |
||
| 1599 | * Finish one or more sublevels on the Table of Contents |
||
| 1600 | * |
||
| 1601 | * @since 1.16.3 |
||
| 1602 | * @param int $level |
||
| 1603 | * @return string |
||
| 1604 | */ |
||
| 1605 | public static function tocUnindent( $level ) { |
||
| 1608 | |||
| 1609 | /** |
||
| 1610 | * parameter level defines if we are on an indentation level |
||
| 1611 | * |
||
| 1612 | * @since 1.16.3 |
||
| 1613 | * @param string $anchor |
||
| 1614 | * @param string $tocline |
||
| 1615 | * @param string $tocnumber |
||
| 1616 | * @param string $level |
||
| 1617 | * @param string|bool $sectionIndex |
||
| 1618 | * @return string |
||
| 1619 | */ |
||
| 1620 | public static function tocLine( $anchor, $tocline, $tocnumber, $level, $sectionIndex = false ) { |
||
| 1630 | |||
| 1631 | /** |
||
| 1632 | * End a Table Of Contents line. |
||
| 1633 | * tocUnindent() will be used instead if we're ending a line below |
||
| 1634 | * the new level. |
||
| 1635 | * @since 1.16.3 |
||
| 1636 | * @return string |
||
| 1637 | */ |
||
| 1638 | public static function tocLineEnd() { |
||
| 1641 | |||
| 1642 | /** |
||
| 1643 | * Wraps the TOC in a table and provides the hide/collapse javascript. |
||
| 1644 | * |
||
| 1645 | * @since 1.16.3 |
||
| 1646 | * @param string $toc Html of the Table Of Contents |
||
| 1647 | * @param string|Language|bool $lang Language for the toc title, defaults to user language |
||
| 1648 | * @return string Full html of the TOC |
||
| 1649 | */ |
||
| 1650 | public static function tocList( $toc, $lang = false ) { |
||
| 1659 | |||
| 1660 | /** |
||
| 1661 | * Generate a table of contents from a section tree. |
||
| 1662 | * |
||
| 1663 | * @since 1.16.3. $lang added in 1.17 |
||
| 1664 | * @param array $tree Return value of ParserOutput::getSections() |
||
| 1665 | * @param string|Language|bool $lang Language for the toc title, defaults to user language |
||
| 1666 | * @return string HTML fragment |
||
| 1667 | */ |
||
| 1668 | public static function generateTOC( $tree, $lang = false ) { |
||
| 1689 | |||
| 1690 | /** |
||
| 1691 | * Create a headline for content |
||
| 1692 | * |
||
| 1693 | * @since 1.16.3 |
||
| 1694 | * @param int $level The level of the headline (1-6) |
||
| 1695 | * @param string $attribs Any attributes for the headline, starting with |
||
| 1696 | * a space and ending with '>' |
||
| 1697 | * This *must* be at least '>' for no attribs |
||
| 1698 | * @param string $anchor The anchor to give the headline (the bit after the #) |
||
| 1699 | * @param string $html Html for the text of the header |
||
| 1700 | * @param string $link HTML to add for the section edit link |
||
| 1701 | * @param bool|string $legacyAnchor A second, optional anchor to give for |
||
| 1702 | * backward compatibility (false to omit) |
||
| 1703 | * |
||
| 1704 | * @return string HTML headline |
||
| 1705 | */ |
||
| 1706 | public static function makeHeadline( $level, $attribs, $anchor, $html, |
||
| 1718 | |||
| 1719 | /** |
||
| 1720 | * Split a link trail, return the "inside" portion and the remainder of the trail |
||
| 1721 | * as a two-element array |
||
| 1722 | * @param string $trail |
||
| 1723 | * @return array |
||
| 1724 | */ |
||
| 1725 | static function splitTrail( $trail ) { |
||
| 1738 | |||
| 1739 | /** |
||
| 1740 | * Generate a rollback link for a given revision. Currently it's the |
||
| 1741 | * caller's responsibility to ensure that the revision is the top one. If |
||
| 1742 | * it's not, of course, the user will get an error message. |
||
| 1743 | * |
||
| 1744 | * If the calling page is called with the parameter &bot=1, all rollback |
||
| 1745 | * links also get that parameter. It causes the edit itself and the rollback |
||
| 1746 | * to be marked as "bot" edits. Bot edits are hidden by default from recent |
||
| 1747 | * changes, so this allows sysops to combat a busy vandal without bothering |
||
| 1748 | * other users. |
||
| 1749 | * |
||
| 1750 | * If the option verify is set this function will return the link only in case the |
||
| 1751 | * revision can be reverted. Please note that due to performance limitations |
||
| 1752 | * it might be assumed that a user isn't the only contributor of a page while |
||
| 1753 | * (s)he is, which will lead to useless rollback links. Furthermore this wont |
||
| 1754 | * work if $wgShowRollbackEditCount is disabled, so this can only function |
||
| 1755 | * as an additional check. |
||
| 1756 | * |
||
| 1757 | * If the option noBrackets is set the rollback link wont be enclosed in "[]". |
||
| 1758 | * |
||
| 1759 | * @since 1.16.3. $context added in 1.20. $options added in 1.21 |
||
| 1760 | * |
||
| 1761 | * @param Revision $rev |
||
| 1762 | * @param IContextSource $context Context to use or null for the main context. |
||
| 1763 | * @param array $options |
||
| 1764 | * @return string |
||
| 1765 | */ |
||
| 1766 | public static function generateRollback( $rev, IContextSource $context = null, |
||
| 1789 | |||
| 1790 | /** |
||
| 1791 | * This function will return the number of revisions which a rollback |
||
| 1792 | * would revert and, if $verify is set it will verify that a revision |
||
| 1793 | * can be reverted (that the user isn't the only contributor and the |
||
| 1794 | * revision we might rollback to isn't deleted). These checks can only |
||
| 1795 | * function as an additional check as this function only checks against |
||
| 1796 | * the last $wgShowRollbackEditCount edits. |
||
| 1797 | * |
||
| 1798 | * Returns null if $wgShowRollbackEditCount is disabled or false if $verify |
||
| 1799 | * is set and the user is the only contributor of the page. |
||
| 1800 | * |
||
| 1801 | * @param Revision $rev |
||
| 1802 | * @param bool $verify Try to verify that this revision can really be rolled back |
||
| 1803 | * @return int|bool|null |
||
| 1804 | */ |
||
| 1805 | public static function getRollbackEditCount( $rev, $verify ) { |
||
| 1855 | |||
| 1856 | /** |
||
| 1857 | * Build a raw rollback link, useful for collections of "tool" links |
||
| 1858 | * |
||
| 1859 | * @since 1.16.3. $context added in 1.20. $editCount added in 1.21 |
||
| 1860 | * @param Revision $rev |
||
| 1861 | * @param IContextSource|null $context Context to use or null for the main context. |
||
| 1862 | * @param int $editCount Number of edits that would be reverted |
||
| 1863 | * @return string HTML fragment |
||
| 1864 | */ |
||
| 1865 | public static function buildRollbackLink( $rev, IContextSource $context = null, |
||
| 1925 | |||
| 1926 | /** |
||
| 1927 | * Returns HTML for the "templates used on this page" list. |
||
| 1928 | * |
||
| 1929 | * Make an HTML list of templates, and then add a "More..." link at |
||
| 1930 | * the bottom. If $more is null, do not add a "More..." link. If $more |
||
| 1931 | * is a Title, make a link to that title and use it. If $more is a string, |
||
| 1932 | * directly paste it in as the link (escaping needs to be done manually). |
||
| 1933 | * Finally, if $more is a Message, call toString(). |
||
| 1934 | * |
||
| 1935 | * @since 1.16.3. $more added in 1.21 |
||
| 1936 | * @param Title[] $templates Array of templates |
||
| 1937 | * @param bool $preview Whether this is for a preview |
||
| 1938 | * @param bool $section Whether this is for a section edit |
||
| 1939 | * @param Title|Message|string|null $more An escaped link for "More..." of the templates |
||
| 1940 | * @return string HTML output |
||
| 1941 | */ |
||
| 1942 | public static function formatTemplates( $templates, $preview = false, |
||
| 2027 | |||
| 2028 | /** |
||
| 2029 | * Returns HTML for the "hidden categories on this page" list. |
||
| 2030 | * |
||
| 2031 | * @since 1.16.3 |
||
| 2032 | * @param array $hiddencats Array of hidden categories from Article::getHiddenCategories |
||
| 2033 | * or similar |
||
| 2034 | * @return string HTML output |
||
| 2035 | */ |
||
| 2036 | public static function formatHiddenCategories( $hiddencats ) { |
||
| 2055 | |||
| 2056 | /** |
||
| 2057 | * Format a size in bytes for output, using an appropriate |
||
| 2058 | * unit (B, KB, MB or GB) according to the magnitude in question |
||
| 2059 | * |
||
| 2060 | * @since 1.16.3 |
||
| 2061 | * @param int $size Size to format |
||
| 2062 | * @return string |
||
| 2063 | */ |
||
| 2064 | public static function formatSize( $size ) { |
||
| 2068 | |||
| 2069 | /** |
||
| 2070 | * Given the id of an interface element, constructs the appropriate title |
||
| 2071 | * attribute from the system messages. (Note, this is usually the id but |
||
| 2072 | * isn't always, because sometimes the accesskey needs to go on a different |
||
| 2073 | * element than the id, for reverse-compatibility, etc.) |
||
| 2074 | * |
||
| 2075 | * @since 1.16.3 $msgParams added in 1.27 |
||
| 2076 | * @param string $name Id of the element, minus prefixes. |
||
| 2077 | * @param string|null $options Null or the string 'withaccess' to add an access- |
||
| 2078 | * key hint |
||
| 2079 | * @param array $msgParams Parameters to pass to the message |
||
| 2080 | * |
||
| 2081 | * @return string Contents of the title attribute (which you must HTML- |
||
| 2082 | * escape), or false for no title attribute |
||
| 2083 | */ |
||
| 2084 | public static function titleAttrib( $name, $options = null, array $msgParams = [] ) { |
||
| 2113 | |||
| 2114 | public static $accesskeycache; |
||
| 2115 | |||
| 2116 | /** |
||
| 2117 | * Given the id of an interface element, constructs the appropriate |
||
| 2118 | * accesskey attribute from the system messages. (Note, this is usually |
||
| 2119 | * the id but isn't always, because sometimes the accesskey needs to go on |
||
| 2120 | * a different element than the id, for reverse-compatibility, etc.) |
||
| 2121 | * |
||
| 2122 | * @since 1.16.3 |
||
| 2123 | * @param string $name Id of the element, minus prefixes. |
||
| 2124 | * @return string Contents of the accesskey attribute (which you must HTML- |
||
| 2125 | * escape), or false for no accesskey attribute |
||
| 2126 | */ |
||
| 2127 | public static function accesskey( $name ) { |
||
| 2149 | |||
| 2150 | /** |
||
| 2151 | * Get a revision-deletion link, or disabled link, or nothing, depending |
||
| 2152 | * on user permissions & the settings on the revision. |
||
| 2153 | * |
||
| 2154 | * Will use forward-compatible revision ID in the Special:RevDelete link |
||
| 2155 | * if possible, otherwise the timestamp-based ID which may break after |
||
| 2156 | * undeletion. |
||
| 2157 | * |
||
| 2158 | * @param User $user |
||
| 2159 | * @param Revision $rev |
||
| 2160 | * @param Title $title |
||
| 2161 | * @return string HTML fragment |
||
| 2162 | */ |
||
| 2163 | public static function getRevDeleteLink( User $user, Revision $rev, Title $title ) { |
||
| 2193 | |||
| 2194 | /** |
||
| 2195 | * Creates a (show/hide) link for deleting revisions/log entries |
||
| 2196 | * |
||
| 2197 | * @param array $query Query parameters to be passed to link() |
||
| 2198 | * @param bool $restricted Set to true to use a "<strong>" instead of a "<span>" |
||
| 2199 | * @param bool $delete Set to true to use (show/hide) rather than (show) |
||
| 2200 | * |
||
| 2201 | * @return string HTML "<a>" link to Special:Revisiondelete, wrapped in a |
||
| 2202 | * span to allow for customization of appearance with CSS |
||
| 2203 | */ |
||
| 2204 | public static function revDeleteLink( $query = [], $restricted = false, $delete = true ) { |
||
| 2216 | |||
| 2217 | /** |
||
| 2218 | * Creates a dead (show/hide) link for deleting revisions/log entries |
||
| 2219 | * |
||
| 2220 | * @since 1.16.3 |
||
| 2221 | * @param bool $delete Set to true to use (show/hide) rather than (show) |
||
| 2222 | * |
||
| 2223 | * @return string HTML text wrapped in a span to allow for customization |
||
| 2224 | * of appearance with CSS |
||
| 2225 | */ |
||
| 2226 | public static function revDeleteLinkDisabled( $delete = true ) { |
||
| 2232 | |||
| 2233 | /* Deprecated methods */ |
||
| 2234 | |||
| 2235 | /** |
||
| 2236 | * Returns the attributes for the tooltip and access key. |
||
| 2237 | * |
||
| 2238 | * @since 1.16.3. $msgParams introduced in 1.27 |
||
| 2239 | * @param string $name |
||
| 2240 | * @param array $msgParams Params for constructing the message |
||
| 2241 | * |
||
| 2242 | * @return array |
||
| 2243 | */ |
||
| 2244 | public static function tooltipAndAccesskeyAttribs( $name, array $msgParams = [] ) { |
||
| 2260 | |||
| 2261 | /** |
||
| 2262 | * Returns raw bits of HTML, use titleAttrib() |
||
| 2263 | * @since 1.16.3 |
||
| 2264 | * @param string $name |
||
| 2265 | * @param array|null $options |
||
| 2266 | * @return null|string |
||
| 2267 | */ |
||
| 2268 | public static function tooltip( $name, $options = null ) { |
||
| 2280 | |||
| 2281 | } |
||
| 2282 | |||
| 2283 |
Loading history...
This method has been deprecated. The supplier of the class has supplied an explanatory message.
The explanatory message should give you some clue as to whether and when the method will be removed from the class and what other method or class to use instead.