3 * Special handling for category description pages.
4 * Modelled after ImagePage.php.
6 * This program is free software; you can redistribute it and/or modify
7 * it under the terms of the GNU General Public License as published by
8 * the Free Software Foundation; either version 2 of the License, or
9 * (at your option) any later version.
11 * This program is distributed in the hope that it will be useful,
12 * but WITHOUT ANY WARRANTY; without even the implied warranty of
13 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14 * GNU General Public License for more details.
16 * You should have received a copy of the GNU General Public License along
17 * with this program; if not, write to the Free Software Foundation, Inc.,
18 * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
19 * http://www.gnu.org/copyleft/gpl.html
25 * Special handling for category description pages, showing pages,
26 * subcategories and file that belong to the category
28 class CategoryPage
extends Article
{
29 # Subclasses can change this to override the viewer class.
30 protected $mCategoryViewerClass = 'CategoryViewer';
33 * @var WikiCategoryPage
39 * @return WikiCategoryPage
41 protected function newPage( Title
$title ) {
42 // Overload mPage with a category-specific page
43 return new WikiCategoryPage( $title );
47 $request = $this->getContext()->getRequest();
48 $diff = $request->getVal( 'diff' );
49 $diffOnly = $request->getBool( 'diffonly',
50 $this->getContext()->getUser()->getOption( 'diffonly' ) );
52 if ( $diff !== null && $diffOnly ) {
57 if ( !Hooks
::run( 'CategoryPageView', [ &$this ] ) ) {
61 $title = $this->getTitle();
62 if ( $title->inNamespace( NS_CATEGORY
) ) {
63 $this->openShowCategory();
68 if ( $title->inNamespace( NS_CATEGORY
) ) {
69 $this->closeShowCategory();
73 function openShowCategory() {
77 function closeShowCategory() {
78 // Use these as defaults for back compat --catrope
79 $request = $this->getContext()->getRequest();
80 $oldFrom = $request->getVal( 'from' );
81 $oldUntil = $request->getVal( 'until' );
83 $reqArray = $request->getValues();
86 foreach ( [ 'page', 'subcat', 'file' ] as $type ) {
87 $from[$type] = $request->getVal( "{$type}from", $oldFrom );
88 $until[$type] = $request->getVal( "{$type}until", $oldUntil );
90 // Do not want old-style from/until propagating in nav links.
91 if ( !isset( $reqArray["{$type}from"] ) && isset( $reqArray["from"] ) ) {
92 $reqArray["{$type}from"] = $reqArray["from"];
94 if ( !isset( $reqArray["{$type}to"] ) && isset( $reqArray["to"] ) ) {
95 $reqArray["{$type}to"] = $reqArray["to"];
99 unset( $reqArray["from"] );
100 unset( $reqArray["to"] );
102 $viewer = new $this->mCategoryViewerClass(
103 $this->getContext()->getTitle(),
109 $out = $this->getContext()->getOutput();
110 $out->addHTML( $viewer->getHTML() );
111 $this->addHelpLink( 'Help:Categories' );