includes/content/JavaScriptContent.php

   1 <?php
   2 /**
   3  * Content for JavaScript pages.
   4  *
   5  * This program is free software; you can redistribute it and/or modify
   6  * it under the terms of the GNU General Public License as published by
   7  * the Free Software Foundation; either version 2 of the License, or
   8  * (at your option) any later version.
   9  *
  10  * This program is distributed in the hope that it will be useful,
  11  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  12  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
  13  * GNU General Public License for more details.
  14  *
  15  * You should have received a copy of the GNU General Public License along
  16  * with this program; if not, write to the Free Software Foundation, Inc.,
  17  * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
  18  * http://www.gnu.org/copyleft/gpl.html
  19  *
  20  * @since 1.21
  21  *
  22  * @file
  23  * @ingroup Content
  24  *
  25  * @author Daniel Kinzler
  26  */
  27
  28 use MediaWiki\MediaWikiServices;
  29
  30 /**
  31  * Content for JavaScript pages.
  32  *
  33  * @ingroup Content
  34  */
  35 class JavaScriptContent extends TextContent {
  36
  37         /**
  38          * @var bool|Title|null
  39          */
  40         private $redirectTarget = false;
  41
  42         /**
  43          * @param string $text JavaScript code.
  44          * @param string $modelId the content model name
  45          */
  46         public function __construct( $text, $modelId = CONTENT_MODEL_JAVASCRIPT ) {
  47                 parent::__construct( $text, $modelId );
  48         }
  49
  50         /**
  51          * Returns a Content object with pre-save transformations applied using
  52          * Parser::preSaveTransform().
  53          *
  54          * @param Title $title
  55          * @param User $user
  56          * @param ParserOptions $popts
  57          *
  58          * @return JavaScriptContent
  59          */
  60         public function preSaveTransform( Title $title, User $user, ParserOptions $popts ) {
  61                 // @todo Make pre-save transformation optional for script pages
  62                 // See T34858
  63
  64                 $text = $this->getText();
  65                 $pst = MediaWikiServices::getInstance()->getParser()
  66                         ->preSaveTransform( $text, $title, $user, $popts );
  67
  68                 return new static( $pst );
  69         }
  70
  71         /**
  72          * @return string JavaScript wrapped in a <pre> tag.
  73          */
  74         protected function getHtml() {
  75                 $html = "";
  76                 $html .= "<pre class=\"mw-code mw-js\" dir=\"ltr\">\n";
  77                 $html .= htmlspecialchars( $this->getText() );
  78                 $html .= "\n</pre>\n";
  79
  80                 return $html;
  81         }
  82
  83         /**
  84          * If this page is a redirect, return the content
  85          * if it should redirect to $target instead
  86          *
  87          * @param Title $target
  88          * @return JavaScriptContent
  89          */
  90         public function updateRedirect( Title $target ) {
  91                 if ( !$this->isRedirect() ) {
  92                         return $this;
  93                 }
  94
  95                 return $this->getContentHandler()->makeRedirectContent( $target );
  96         }
  97
  98         /**
  99          * @return Title|null
 100          */
 101         public function getRedirectTarget() {
 102                 if ( $this->redirectTarget !== false ) {
 103                         return $this->redirectTarget;
 104                 }
 105                 $this->redirectTarget = null;
 106                 $text = $this->getText();
 107                 if ( strpos( $text, '/* #REDIRECT */' ) === 0 ) {
 108                         // Extract the title from the url
 109                         preg_match( '/title=(.*?)\\\\u0026action=raw/', $text, $matches );
 110                         if ( isset( $matches[1] ) ) {
 111                                 $title = Title::newFromText( urldecode( $matches[1] ) );
 112                                 if ( $title ) {
 113                                         // Have a title, check that the current content equals what
 114                                         // the redirect content should be
 115                                         if ( $this->equals( $this->getContentHandler()->makeRedirectContent( $title ) ) ) {
 116                                                 $this->redirectTarget = $title;
 117                                         }
 118                                 }
 119                         }
 120                 }
 121
 122                 return $this->redirectTarget;
 123         }
 124
 125 }