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 return $this->data
[$name] ??
$default;
84 * @deprecated since 1.31 This function is a now-redundant optimisation intended
85 * for very old versions of PHP. The use of references here makes the code
86 * more fragile and is incompatible with plans like T140664. Use set() instead.
88 * @param mixed &$value
90 public function setRef( $name, &$value ) {
91 wfDeprecated( __METHOD__
, '1.31' );
92 $this->data
[$name] =& $value;
96 * Main function, used by classes that subclass QuickTemplate
97 * to show the actual HTML output
99 abstract public function execute();
105 function text( $str ) {
106 echo htmlspecialchars( $this->data
[$str] );
113 function html( $str ) {
114 echo $this->data
[$str];
119 * @param string $msgKey
121 function msg( $msgKey ) {
122 echo htmlspecialchars( wfMessage( $msgKey )->text() );
127 * @param string $msgKey
129 function msgHtml( $msgKey ) {
130 echo wfMessage( $msgKey )->text();
134 * An ugly, ugly hack.
136 * @param string $msgKey
138 function msgWiki( $msgKey ) {
141 $text = wfMessage( $msgKey )->text();
142 echo $wgOut->parse( $text );
150 function haveData( $str ) {
151 return isset( $this->data
[$str] );
157 * @param string $msgKey
160 function haveMsg( $msgKey ) {
161 $msg = wfMessage( $msgKey );
162 return $msg->exists() && !$msg->isDisabled();
166 * Get the Skin object related to this object
170 public function getSkin() {
171 return $this->data
['skin'];
175 * Fetch the output of a QuickTemplate and return it
180 public function getHTML() {
183 $html = ob_get_contents();