3 * This program is free software; you can redistribute it and/or modify
4 * it under the terms of the GNU General Public License as published by
5 * the Free Software Foundation; either version 2 of the License, or
6 * (at your option) any later version.
8 * This program is distributed in the hope that it will be useful,
9 * but WITHOUT ANY WARRANTY; without even the implied warranty of
10 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
11 * GNU General Public License for more details.
13 * You should have received a copy of the GNU General Public License along
14 * with this program; if not, write to the Free Software Foundation, Inc.,
15 * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
16 * http://www.gnu.org/copyleft/gpl.html
20 use MediaWiki\MediaWikiServices
;
23 * Generic wrapper for template functions, with interface
24 * compatible with what we use of PHPTAL 0.7.
27 abstract class QuickTemplate
{
34 /** @var Config $config */
38 * @param Config $config
40 function __construct( Config
$config = null ) {
42 if ( $config === null ) {
43 wfDebug( __METHOD__
. ' was called with no Config instance passed to it' );
44 $config = MediaWikiServices
::getInstance()->getMainConfig();
46 $this->config
= $config;
50 * Sets the value $value to $name
54 public function set( $name, $value ) {
55 $this->data
[$name] = $value;
59 * extends the value of data with name $name with the value $value
64 public function extend( $name, $value ) {
65 if ( $this->haveData( $name ) ) {
66 $this->data
[$name] = $this->data
[$name] . $value;
68 $this->data
[$name] = $value;
73 * Gets the template data requested
75 * @param string $name Key for the data
76 * @param mixed $default Optional default (or null)
77 * @return mixed The value of the data requested or the deafult
79 public function get( $name, $default = null ) {
80 if ( isset( $this->data
[$name] ) ) {
81 return $this->data
[$name];
88 * @deprecated since 1.31 This function is a now-redundant optimisation intended
89 * for very old versions of PHP. The use of references here makes the code
90 * more fragile and is incompatible with plans like T140664. Use set() instead.
92 * @param mixed &$value
94 public function setRef( $name, &$value ) {
95 wfDeprecated( __METHOD__
, '1.31' );
96 $this->data
[$name] =& $value;
100 * Main function, used by classes that subclass QuickTemplate
101 * to show the actual HTML output
103 abstract public function execute();
109 function text( $str ) {
110 echo htmlspecialchars( $this->data
[$str] );
117 function html( $str ) {
118 echo $this->data
[$str];
123 * @param string $msgKey
125 function msg( $msgKey ) {
126 echo htmlspecialchars( wfMessage( $msgKey )->text() );
131 * @param string $msgKey
133 function msgHtml( $msgKey ) {
134 echo wfMessage( $msgKey )->text();
138 * An ugly, ugly hack.
140 * @param string $msgKey
142 function msgWiki( $msgKey ) {
145 $text = wfMessage( $msgKey )->text();
146 echo $wgOut->parse( $text );
154 function haveData( $str ) {
155 return isset( $this->data
[$str] );
161 * @param string $msgKey
164 function haveMsg( $msgKey ) {
165 $msg = wfMessage( $msgKey );
166 return $msg->exists() && !$msg->isDisabled();
170 * Get the Skin object related to this object
174 public function getSkin() {
175 return $this->data
['skin'];
179 * Fetch the output of a QuickTemplate and return it
184 public function getHTML() {
187 $html = ob_get_contents();