Improve docs for Title::getInternalURL/getCanonicalURL
[lhc/web/wiklou.git] / includes / specials / SpecialMyRedirectPages.php
1 <?php
2 /**
3 * Special pages that are used to get user independent links pointing to
4 * current user's pages (user page, talk page, contributions, etc.).
5 * This can let us cache a single copy of some generated content for all
6 * users or be linked in wikitext help pages.
7 *
8 * This program is free software; you can redistribute it and/or modify
9 * it under the terms of the GNU General Public License as published by
10 * the Free Software Foundation; either version 2 of the License, or
11 * (at your option) any later version.
12 *
13 * This program is distributed in the hope that it will be useful,
14 * but WITHOUT ANY WARRANTY; without even the implied warranty of
15 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
16 * GNU General Public License for more details.
17 *
18 * You should have received a copy of the GNU General Public License along
19 * with this program; if not, write to the Free Software Foundation, Inc.,
20 * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
21 * http://www.gnu.org/copyleft/gpl.html
22 *
23 * @file
24 * @ingroup SpecialPage
25 */
26
27 /**
28 * Special page pointing to current user's user page.
29 *
30 * @ingroup SpecialPage
31 */
32 class SpecialMypage extends RedirectSpecialArticle {
33 public function __construct() {
34 parent::__construct( 'Mypage' );
35 }
36
37 /**
38 * @param string|null $subpage
39 * @return Title
40 */
41 public function getRedirect( $subpage ) {
42 if ( $subpage === null || $subpage === '' ) {
43 return Title::makeTitle( NS_USER, $this->getUser()->getName() );
44 }
45
46 return Title::makeTitle( NS_USER, $this->getUser()->getName() . '/' . $subpage );
47 }
48
49 /**
50 * Target identifies a specific User. See T109724.
51 *
52 * @since 1.27
53 * @return bool
54 */
55 public function personallyIdentifiableTarget() {
56 return true;
57 }
58 }
59
60 /**
61 * Special page pointing to current user's talk page.
62 *
63 * @ingroup SpecialPage
64 */
65 class SpecialMytalk extends RedirectSpecialArticle {
66 public function __construct() {
67 parent::__construct( 'Mytalk' );
68 }
69
70 /**
71 * @param string|null $subpage
72 * @return Title
73 */
74 public function getRedirect( $subpage ) {
75 if ( $subpage === null || $subpage === '' ) {
76 return Title::makeTitle( NS_USER_TALK, $this->getUser()->getName() );
77 }
78
79 return Title::makeTitle( NS_USER_TALK, $this->getUser()->getName() . '/' . $subpage );
80 }
81
82 /**
83 * Target identifies a specific User. See T109724.
84 *
85 * @since 1.27
86 * @return bool
87 */
88 public function personallyIdentifiableTarget() {
89 return true;
90 }
91 }
92
93 /**
94 * Special page pointing to current user's contributions.
95 *
96 * @ingroup SpecialPage
97 */
98 class SpecialMycontributions extends RedirectSpecialPage {
99 public function __construct() {
100 parent::__construct( 'Mycontributions' );
101 $this->mAllowedRedirectParams = [ 'limit', 'namespace', 'tagfilter',
102 'offset', 'dir', 'year', 'month', 'feed', 'deletedOnly',
103 'nsInvert', 'associated', 'newOnly', 'topOnly', 'start', 'end' ];
104 }
105
106 /**
107 * @param string|null $subpage
108 * @return Title
109 */
110 public function getRedirect( $subpage ) {
111 return SpecialPage::getTitleFor( 'Contributions', $this->getUser()->getName() );
112 }
113
114 /**
115 * Target identifies a specific User. See T109724.
116 *
117 * @since 1.27
118 * @return bool
119 */
120 public function personallyIdentifiableTarget() {
121 return true;
122 }
123 }
124
125 /**
126 * Special page pointing to current user's uploaded files.
127 *
128 * @ingroup SpecialPage
129 */
130 class SpecialMyuploads extends RedirectSpecialPage {
131 public function __construct() {
132 parent::__construct( 'Myuploads' );
133 $this->mAllowedRedirectParams = [ 'limit', 'ilshowall', 'ilsearch' ];
134 }
135
136 /**
137 * @param string|null $subpage
138 * @return Title
139 */
140 public function getRedirect( $subpage ) {
141 return SpecialPage::getTitleFor( 'Listfiles', $this->getUser()->getName() );
142 }
143
144 /**
145 * Target identifies a specific User. See T109724.
146 *
147 * @since 1.27
148 * @return bool
149 */
150 public function personallyIdentifiableTarget() {
151 return true;
152 }
153 }
154
155 /**
156 * Special page pointing to current user's uploaded files (including old versions).
157 *
158 * @ingroup SpecialPage
159 */
160 class SpecialAllMyUploads extends RedirectSpecialPage {
161 public function __construct() {
162 parent::__construct( 'AllMyUploads' );
163 $this->mAllowedRedirectParams = [ 'limit', 'ilsearch' ];
164 }
165
166 /**
167 * @param string|null $subpage
168 * @return Title
169 */
170 public function getRedirect( $subpage ) {
171 $this->mAddedRedirectParams['ilshowall'] = 1;
172
173 return SpecialPage::getTitleFor( 'Listfiles', $this->getUser()->getName() );
174 }
175
176 /**
177 * Target identifies a specific User. See T109724.
178 *
179 * @since 1.27
180 * @return bool
181 */
182 public function personallyIdentifiableTarget() {
183 return true;
184 }
185 }