return str_replace( "\n", ' ', $prefix . $s . $postfix );
}
- /**
- * See makeImageLink()
- * When this function is removed, remove if( $parser instanceof Parser ) check there too
- * @deprecated since 1.20
- */
- public static function makeImageLink2( Title $title, $file, $frameParams = array(),
- $handlerParams = array(), $time = false, $query = "", $widthOption = null ) {
- return self::makeImageLink( null, $title, $file, $frameParams,
- $handlerParams, $time, $query, $widthOption );
- }
-
/**
* Get the link parameters for MediaTransformOutput::toHtml() from given
* frame parameters supplied by the Parser.
* is ignored
*
* @todo FIXME: Doesn't handle sub-links as in image thumb texts like the main parser
- * @param string $comment Text to format links in
+ * @param string $comment Text to format links in. WARNING! Since the output of this
+ * function is html, $comment must be sanitized for use as html. You probably want
+ * to pass $comment through Sanitizer::escapeHtmlAllowEntities() before calling
+ * this function.
* @param Title|null $title An optional title object used to links to sections
* @param bool $local Whether section links should refer to local page
* @param string|null $wikiId Id of the wiki to link to (if not the local wiki),
/* Deprecated methods */
- /**
- * @deprecated since 1.16 Use link(); warnings since 1.21
- *
- * Make a link for a title which may or may not be in the database. If you need to
- * call this lots of times, pre-fill the link cache with a LinkBatch, otherwise each
- * call to this will result in a DB query.
- *
- * @param Title $nt The title object to make the link from, e.g. from Title::newFromText.
- * @param string $text Link text
- * @param string $query Optional query part
- * @param string $trail Optional trail. Alphabetic characters at the start of this string will
- * be included in the link text. Other characters will be appended after
- * the end of the link.
- * @param string $prefix Optional prefix. As trail, only before instead of after.
- * @return string
- */
- static function makeLinkObj( $nt, $text = '', $query = '', $trail = '', $prefix = '' ) {
- wfDeprecated( __METHOD__, '1.21' );
-
- $query = wfCgiToArray( $query );
- list( $inside, $trail ) = self::splitTrail( $trail );
- if ( $text === '' ) {
- $text = self::linkText( $nt );
- }
-
- $ret = self::link( $nt, "$prefix$text$inside", array(), $query ) . $trail;
-
- return $ret;
- }
-
- /**
- * @deprecated since 1.16 Use link(); warnings since 1.21
- *
- * Make a link for a title which definitely exists. This is faster than makeLinkObj because
- * it doesn't have to do a database query. It's also valid for interwiki titles and special
- * pages.
- *
- * @param Title $title Title object of target page
- * @param string $text Text to replace the title
- * @param string $query Link target
- * @param string $trail Text after link
- * @param string $prefix Text before link text
- * @param string $aprops Extra attributes to the a-element
- * @param string $style Style to apply - if empty, use getInternalLinkAttributesObj instead
- * @return string The a-element
- */
- static function makeKnownLinkObj(
- $title, $text = '', $query = '', $trail = '', $prefix = '', $aprops = '', $style = ''
- ) {
- wfDeprecated( __METHOD__, '1.21' );
-
- if ( $text == '' ) {
- $text = self::linkText( $title );
- }
- $attribs = Sanitizer::mergeAttributes(
- Sanitizer::decodeTagAttributes( $aprops ),
- Sanitizer::decodeTagAttributes( $style )
- );
- $query = wfCgiToArray( $query );
- list( $inside, $trail ) = self::splitTrail( $trail );
-
- $ret = self::link( $title, "$prefix$text$inside", $attribs, $query,
- array( 'known', 'noclasses' ) ) . $trail;
-
- return $ret;
- }
-
/**
* Returns the attributes for the tooltip and access key.
* @param string $name