/**
* Get an HTMLForm descriptor array
- * @return Array
+ * @return array
*/
abstract protected function getFormFields();
/**
* Add pre-text to the form
- * @return String HTML which will be sent to $form->addPreText()
+ * @return string HTML which will be sent to $form->addPreText()
*/
protected function preText() {
return '';
/**
* Add post-text to the form
- * @return String HTML which will be sent to $form->addPostText()
+ * @return string HTML which will be sent to $form->addPostText()
*/
protected function postText() {
return '';
/**
* Play with the HTMLForm if you need to more substantially
- * @param $form HTMLForm
+ * @param HTMLForm $form
*/
protected function alterForm( HTMLForm $form ) {
}
/**
* Process the form on POST submission.
- * @param $data Array
- * @return Bool|Array true for success, false for didn't-try, array of errors on failure
+ * @param array $data
+ * @return bool|array True for success, false for didn't-try, array of errors on failure
*/
abstract public function onSubmit( array $data );
/**
* Called from execute() to check if the given user can perform this action.
* Failures here must throw subclasses of ErrorPageError.
- * @param $user User
+ * @param User $user
* @throws UserBlockedError
- * @return Bool true
+ * @return bool True
*/
protected function checkExecutePermissions( User $user ) {
$this->checkPermissions();
/**
* Whether this action requires the wiki not to be locked
- * @return Bool
+ * @return bool
*/
public function requiresWrite() {
return true;
/**
* Whether this action cannot be executed by a blocked user
- * @return Bool
+ * @return bool
*/
public function requiresUnblock() {
return true;