| Conditions | 29 |
| Paths | > 20000 |
| Total Lines | 165 |
| Code Lines | 113 |
| Lines | 0 |
| Ratio | 0 % |
| Changes | 0 | ||
Small methods make your code easier to understand, in particular if combined with a good name. Besides, if your method is small, finding a good name is usually much easier.
For example, if you find yourself adding comments to a method's body, this is usually a good sign to extract the commented part to a new method, and use the comment as a starting point when coming up with a good name for this new method.
Commonly applied refactorings include:
If many parameters/temporary variables are present:
| 1 | <?php |
||
| 113 | public function imageHistoryLine( $iscur, $file ) { |
||
| 114 | global $wgContLang; |
||
| 115 | |||
| 116 | $user = $this->getUser(); |
||
| 117 | $lang = $this->getLanguage(); |
||
| 118 | $timestamp = wfTimestamp( TS_MW, $file->getTimestamp() ); |
||
| 119 | $img = $iscur ? $file->getName() : $file->getArchiveName(); |
||
| 120 | $userId = $file->getUser( 'id' ); |
||
| 121 | $userText = $file->getUser( 'text' ); |
||
| 122 | $description = $file->getDescription( File::FOR_THIS_USER, $user ); |
||
| 123 | |||
| 124 | $local = $this->current->isLocal(); |
||
| 125 | $row = $selected = ''; |
||
| 126 | |||
| 127 | // Deletion link |
||
| 128 | if ( $local && ( $user->isAllowedAny( 'delete', 'deletedhistory' ) ) ) { |
||
| 129 | $row .= '<td>'; |
||
| 130 | # Link to remove from history |
||
| 131 | if ( $user->isAllowed( 'delete' ) ) { |
||
| 132 | $q = [ 'action' => 'delete' ]; |
||
| 133 | if ( !$iscur ) { |
||
| 134 | $q['oldimage'] = $img; |
||
| 135 | } |
||
| 136 | $row .= Linker::linkKnown( |
||
| 137 | $this->title, |
||
| 138 | $this->msg( $iscur ? 'filehist-deleteall' : 'filehist-deleteone' )->escaped(), |
||
| 139 | [], $q |
||
| 140 | ); |
||
| 141 | } |
||
| 142 | # Link to hide content. Don't show useless link to people who cannot hide revisions. |
||
| 143 | $canHide = $user->isAllowed( 'deleterevision' ); |
||
| 144 | if ( $canHide || ( $user->isAllowed( 'deletedhistory' ) && $file->getVisibility() ) ) { |
||
| 145 | if ( $user->isAllowed( 'delete' ) ) { |
||
| 146 | $row .= '<br />'; |
||
| 147 | } |
||
| 148 | // If file is top revision or locked from this user, don't link |
||
| 149 | if ( $iscur || !$file->userCan( File::DELETED_RESTRICTED, $user ) ) { |
||
| 150 | $del = Linker::revDeleteLinkDisabled( $canHide ); |
||
| 151 | } else { |
||
| 152 | list( $ts, ) = explode( '!', $img, 2 ); |
||
| 153 | $query = [ |
||
| 154 | 'type' => 'oldimage', |
||
| 155 | 'target' => $this->title->getPrefixedText(), |
||
| 156 | 'ids' => $ts, |
||
| 157 | ]; |
||
| 158 | $del = Linker::revDeleteLink( $query, |
||
| 159 | $file->isDeleted( File::DELETED_RESTRICTED ), $canHide ); |
||
| 160 | } |
||
| 161 | $row .= $del; |
||
| 162 | } |
||
| 163 | $row .= '</td>'; |
||
| 164 | } |
||
| 165 | |||
| 166 | // Reversion link/current indicator |
||
| 167 | $row .= '<td>'; |
||
| 168 | if ( $iscur ) { |
||
| 169 | $row .= $this->msg( 'filehist-current' )->escaped(); |
||
| 170 | } elseif ( $local && $this->title->quickUserCan( 'edit', $user ) |
||
| 171 | && $this->title->quickUserCan( 'upload', $user ) |
||
| 172 | ) { |
||
| 173 | if ( $file->isDeleted( File::DELETED_FILE ) ) { |
||
| 174 | $row .= $this->msg( 'filehist-revert' )->escaped(); |
||
| 175 | } else { |
||
| 176 | $row .= Linker::linkKnown( |
||
| 177 | $this->title, |
||
| 178 | $this->msg( 'filehist-revert' )->escaped(), |
||
| 179 | [], |
||
| 180 | [ |
||
| 181 | 'action' => 'revert', |
||
| 182 | 'oldimage' => $img, |
||
| 183 | 'wpEditToken' => $user->getEditToken( $img ) |
||
| 184 | ] |
||
| 185 | ); |
||
| 186 | } |
||
| 187 | } |
||
| 188 | $row .= '</td>'; |
||
| 189 | |||
| 190 | // Date/time and image link |
||
| 191 | if ( $file->getTimestamp() === $this->img->getTimestamp() ) { |
||
| 192 | $selected = "class='filehistory-selected'"; |
||
| 193 | } |
||
| 194 | $row .= "<td $selected style='white-space: nowrap;'>"; |
||
| 195 | if ( !$file->userCan( File::DELETED_FILE, $user ) ) { |
||
| 196 | # Don't link to unviewable files |
||
| 197 | $row .= '<span class="history-deleted">' |
||
| 198 | . $lang->userTimeAndDate( $timestamp, $user ) . '</span>'; |
||
| 199 | } elseif ( $file->isDeleted( File::DELETED_FILE ) ) { |
||
| 200 | if ( $local ) { |
||
| 201 | $this->preventClickjacking(); |
||
| 202 | $revdel = SpecialPage::getTitleFor( 'Revisiondelete' ); |
||
| 203 | # Make a link to review the image |
||
| 204 | $url = Linker::linkKnown( |
||
| 205 | $revdel, |
||
| 206 | $lang->userTimeAndDate( $timestamp, $user ), |
||
| 207 | [], |
||
| 208 | [ |
||
| 209 | 'target' => $this->title->getPrefixedText(), |
||
| 210 | 'file' => $img, |
||
| 211 | 'token' => $user->getEditToken( $img ) |
||
| 212 | ] |
||
| 213 | ); |
||
| 214 | } else { |
||
| 215 | $url = $lang->userTimeAndDate( $timestamp, $user ); |
||
| 216 | } |
||
| 217 | $row .= '<span class="history-deleted">' . $url . '</span>'; |
||
| 218 | } elseif ( !$file->exists() ) { |
||
| 219 | $row .= '<span class="mw-file-missing">' |
||
| 220 | . $lang->userTimeAndDate( $timestamp, $user ) . '</span>'; |
||
| 221 | } else { |
||
| 222 | $url = $iscur ? $this->current->getUrl() : $this->current->getArchiveUrl( $img ); |
||
| 223 | $row .= Xml::element( |
||
| 224 | 'a', |
||
| 225 | [ 'href' => $url ], |
||
| 226 | $lang->userTimeAndDate( $timestamp, $user ) |
||
| 227 | ); |
||
| 228 | } |
||
| 229 | $row .= "</td>"; |
||
| 230 | |||
| 231 | // Thumbnail |
||
| 232 | if ( $this->showThumb ) { |
||
| 233 | $row .= '<td>' . $this->getThumbForLine( $file ) . '</td>'; |
||
| 234 | } |
||
| 235 | |||
| 236 | // Image dimensions + size |
||
| 237 | $row .= '<td>'; |
||
| 238 | $row .= htmlspecialchars( $file->getDimensionsString() ); |
||
| 239 | $row .= $this->msg( 'word-separator' )->escaped(); |
||
| 240 | $row .= '<span style="white-space: nowrap;">'; |
||
| 241 | $row .= $this->msg( 'parentheses' )->sizeParams( $file->getSize() )->escaped(); |
||
| 242 | $row .= '</span>'; |
||
| 243 | $row .= '</td>'; |
||
| 244 | |||
| 245 | // Uploading user |
||
| 246 | $row .= '<td>'; |
||
| 247 | // Hide deleted usernames |
||
| 248 | if ( $file->isDeleted( File::DELETED_USER ) ) { |
||
| 249 | $row .= '<span class="history-deleted">' |
||
| 250 | . $this->msg( 'rev-deleted-user' )->escaped() . '</span>'; |
||
| 251 | } else { |
||
| 252 | if ( $local ) { |
||
| 253 | $row .= Linker::userLink( $userId, $userText ); |
||
| 254 | $row .= '<span style="white-space: nowrap;">'; |
||
| 255 | $row .= Linker::userToolLinks( $userId, $userText ); |
||
| 256 | $row .= '</span>'; |
||
| 257 | } else { |
||
| 258 | $row .= htmlspecialchars( $userText ); |
||
| 259 | } |
||
| 260 | } |
||
| 261 | $row .= '</td>'; |
||
| 262 | |||
| 263 | // Don't show deleted descriptions |
||
| 264 | if ( $file->isDeleted( File::DELETED_COMMENT ) ) { |
||
| 265 | $row .= '<td><span class="history-deleted">' . |
||
| 266 | $this->msg( 'rev-deleted-comment' )->escaped() . '</span></td>'; |
||
| 267 | } else { |
||
| 268 | $row .= '<td dir="' . $wgContLang->getDir() . '">' . |
||
| 269 | Linker::formatComment( $description, $this->title ) . '</td>'; |
||
| 270 | } |
||
| 271 | |||
| 272 | $rowClass = null; |
||
| 273 | Hooks::run( 'ImagePageFileHistoryLine', [ $this, $file, &$row, &$rowClass ] ); |
||
| 274 | $classAttr = $rowClass ? " class='$rowClass'" : ''; |
||
| 275 | |||
| 276 | return "<tr{$classAttr}>{$row}</tr>\n"; |
||
| 277 | } |
||
| 278 | |||
| 328 |
Only declaring a single property per statement allows you to later on add doc comments more easily.
It is also recommended by PSR2, so it is a common style that many people expect.