MediaWiki master
CategoryPage.php
Go to the documentation of this file.
1<?php
24
32class CategoryPage extends Article {
34 protected $mCategoryViewerClass = CategoryViewer::class;
35
40 protected function newPage( Title $title ) {
41 // Overload mPage with a category-specific page
42 return new WikiCategoryPage( $title );
43 }
44
45 public function view() {
46 $request = $this->getContext()->getRequest();
47 $diff = $request->getVal( 'diff' );
48
49 if ( $diff !== null && $this->isDiffOnlyView() ) {
50 parent::view();
51 return;
52 }
53
54 if ( !$this->getHookRunner()->onCategoryPageView( $this ) ) {
55 return;
56 }
57
58 $title = $this->getTitle();
59 if ( $title->inNamespace( NS_CATEGORY ) ) {
60 $this->openShowCategory();
61 }
62
63 parent::view();
64
65 if ( $title->inNamespace( NS_CATEGORY ) ) {
66 $this->closeShowCategory();
67 }
68
69 # Use adaptive TTLs for CDN so delayed/failed purges are noticed less often
70 $outputPage = $this->getContext()->getOutput();
71 $outputPage->adaptCdnTTL(
72 $this->getPage()->getTouched(),
73 ExpirationAwareness::TTL_MINUTE
74 );
75 }
76
77 public function openShowCategory() {
78 # For overloading
79 }
80
81 public function closeShowCategory() {
82 // Use these as defaults for back compat --catrope
83 $request = $this->getContext()->getRequest();
84 $oldFrom = $request->getVal( 'from' );
85 $oldUntil = $request->getVal( 'until' );
86
87 $reqArray = $request->getValues();
88
89 $from = $until = [];
90 foreach ( [ 'page', 'subcat', 'file' ] as $type ) {
91 $from[$type] = $request->getVal( "{$type}from", $oldFrom );
92 $until[$type] = $request->getVal( "{$type}until", $oldUntil );
93
94 // Do not want old-style from/until propagating in nav links.
95 if ( !isset( $reqArray["{$type}from"] ) && isset( $reqArray["from"] ) ) {
96 $reqArray["{$type}from"] = $reqArray["from"];
97 }
98 if ( !isset( $reqArray["{$type}to"] ) && isset( $reqArray["to"] ) ) {
99 $reqArray["{$type}to"] = $reqArray["to"];
100 }
101 }
102
103 unset( $reqArray["from"] );
104 unset( $reqArray["to"] );
105
106 $viewer = new $this->mCategoryViewerClass(
107 $this->getPage(),
108 $this->getContext(),
109 $from,
110 $until,
111 $reqArray
112 );
113 $out = $this->getContext()->getOutput();
114 $out->addHTML( $viewer->getHTML() );
115 $this->addHelpLink( 'Help:Categories' );
116 }
117}
const NS_CATEGORY
Definition Defines.php:78
getContext()
Legacy class representing an editable page and handling UI for some page actions.
Definition Article.php:67
isDiffOnlyView()
Definition Article.php:1013
getPage()
Get the WikiPage object of this instance.
Definition Article.php:277
addHelpLink( $to, $overrideBaseUrl=false)
Adds help link with an icon via page indicators.
Definition Article.php:1844
Special handling for category description pages.
string $mCategoryViewerClass
Subclasses can change this to override the viewer class.
newPage(Title $title)
view()
This is the default action of the index.php entry point: just view the page of the given title.
Represents a title within MediaWiki.
Definition Title.php:78
Special handling for representing category pages.
Generic interface providing Time-To-Live constants for expirable object storage.