Merge "Improve the wording of apihelp-parse-param-section"
[mediawiki.git] / includes / content / CssContent.php
blobb4f5196de61ca1b56eaf1135b411e23ad7b2bec8
1 <?php
2 /**
3 * Content object for CSS pages.
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.
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.
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
20 * @since 1.21
22 * @file
23 * @ingroup Content
25 * @author Daniel Kinzler
28 /**
29 * Content object for CSS pages.
31 * @ingroup Content
33 class CssContent extends TextContent {
35 /**
36 * @var bool|Title|null
38 private $redirectTarget = false;
40 /**
41 * @param string $text CSS code.
42 * @param string $modelId the content content model
44 public function __construct( $text, $modelId = CONTENT_MODEL_CSS ) {
45 parent::__construct( $text, $modelId );
48 /**
49 * Returns a Content object with pre-save transformations applied using
50 * Parser::preSaveTransform().
52 * @param Title $title
53 * @param User $user
54 * @param ParserOptions $popts
56 * @return CssContent
58 * @see TextContent::preSaveTransform
60 public function preSaveTransform( Title $title, User $user, ParserOptions $popts ) {
61 global $wgParser;
62 // @todo Make pre-save transformation optional for script pages
64 $text = $this->getNativeData();
65 $pst = $wgParser->preSaveTransform( $text, $title, $user, $popts );
67 return new static( $pst );
70 /**
71 * @return string CSS wrapped in a <pre> tag.
73 protected function getHtml() {
74 $html = "";
75 $html .= "<pre class=\"mw-code mw-css\" dir=\"ltr\">\n";
76 $html .= htmlspecialchars( $this->getNativeData() );
77 $html .= "\n</pre>\n";
79 return $html;
82 /**
83 * @param Title $target
84 * @return CssContent
86 public function updateRedirect( Title $target ) {
87 if ( !$this->isRedirect() ) {
88 return $this;
91 return $this->getContentHandler()->makeRedirectContent( $target );
94 /**
95 * @return Title|null
97 public function getRedirectTarget() {
98 if ( $this->redirectTarget !== false ) {
99 return $this->redirectTarget;
101 $this->redirectTarget = null;
102 $text = $this->getNativeData();
103 if ( strpos( $text, '/* #REDIRECT */' ) === 0 ) {
104 // Extract the title from the url
105 preg_match( '/title=(.*?)&action=raw/', $text, $matches );
106 if ( isset( $matches[1] ) ) {
107 $title = Title::newFromText( $matches[1] );
108 if ( $title ) {
109 // Have a title, check that the current content equals what
110 // the redirect content should be
111 if ( $this->equals( $this->getContentHandler()->makeRedirectContent( $title ) ) ) {
112 $this->redirectTarget = $title;
118 return $this->redirectTarget;