Update doc-blocks and small fixes according to coding standards

apps/advanced/common/models/User.php

@@ -27,6 +27,12 @@ class User extends ActiveRecord implements IdentityInterface
 
 	const ROLE_USER = 10;
 
+	/**
+	 * Creates a new user
+	 *
+	 * @param $attributes
+	 * @return static|null
+	 */
 	public static function create($attributes)
 	{
 		/** @var User $user */
@@ -69,18 +75,18 @@ class User extends ActiveRecord implements IdentityInterface
 	 * Finds user by username
 	 *
 	 * @param string $username
-	 * @return self
+	 * @return static|null
 	 */
 	public static function findByUsername($username)
 	{
-		return static::find(['username' => $username, 'status' => static::STATUS_ACTIVE]);
+		return static::find(['username' => $username, 'status' => self::STATUS_ACTIVE]);
 	}
 
 	/**
 	 * Finds user by password reset token
 	 *
 	 * @param string $token password reset token
-	 * @return self
+	 * @return static|null
 	 */
 	public static function findByPasswordResetToken($token)
 	{
@@ -92,9 +98,9 @@ class User extends ActiveRecord implements IdentityInterface
 			return null;
 		}
 
-		return User::find([
+		return static::find([
 			'password_reset_token' => $token,
-			'status' => User::STATUS_ACTIVE,
+			'status' => self::STATUS_ACTIVE,
 		]);
 	}
 

apps/advanced/frontend/controllers/SiteController.php

@@ -86,7 +86,7 @@ class SiteController extends Controller
 
 	public function actionContact()
 	{
-		$model = new ContactForm;
+		$model = new ContactForm();
 		if ($model->load(Yii::$app->request->post()) && $model->contact(Yii::$app->params['adminEmail'])) {
 			Yii::$app->session->setFlash('success', 'Thank you for contacting us. We will respond to you as soon as possible.');
 			return $this->refresh();

apps/advanced/frontend/models/ContactForm.php

@@ -17,7 +17,7 @@ class ContactForm extends Model
 	public $verifyCode;
 
 	/**
-	 * @return array the validation rules.
+	 * @inheritdoc
 	 */
 	public function rules()
 	{
@@ -32,7 +32,7 @@ class ContactForm extends Model
 	}
 
 	/**
-	 * @return array customized attribute labels
+	 * @inheritdoc
 	 */
 	public function attributeLabels()
 	{
@@ -43,6 +43,7 @@ class ContactForm extends Model
 
 	/**
 	 * Sends an email to the specified email address using the information collected by this model.
+	 *
 	 * @param string $email the target email address
 	 * @return boolean whether the model passes validation
 	 */

apps/advanced/frontend/models/PasswordResetRequestForm.php

@@ -25,8 +25,9 @@ class PasswordResetRequestForm extends Model
 	}
 
 	/**
+	 * Sends an email with a link, for resetting the password.
 	 *
-	 * @return boolean sends an email
+	 * @return boolean whether the email was send
 	 */
 	public function sendEmail()
 	{
@@ -52,4 +53,3 @@ class PasswordResetRequestForm extends Model
 		return false;
 	}
 }
\ No newline at end of file
- 
\ No newline at end of file

apps/advanced/frontend/models/ResetPasswordForm.php

@@ -19,7 +19,7 @@ class ResetPasswordForm extends Model
 	private $_user;
 
 	/**
-	 * Creates a form model given a token
+	 * Creates a form model given a token.
 	 *
 	 * @param string $token
 	 * @param array $config name-value pairs that will be used to initialize the object properties
@@ -38,7 +38,7 @@ class ResetPasswordForm extends Model
 	}
 
 	/**
-	 * @return array the validation rules.
+	 * @inheritdoc
 	 */
 	public function rules()
 	{
@@ -50,6 +50,7 @@ class ResetPasswordForm extends Model
 
 	/**
 	 * Resets password.
+	 *
 	 * @return boolean if password was reset.
 	 */
 	public function resetPassword()
@@ -60,4 +61,3 @@ class ResetPasswordForm extends Model
 		return $user->save();
 	}
 }
\ No newline at end of file
- 
\ No newline at end of file

apps/advanced/frontend/models/SignupForm.php

@@ -36,7 +36,8 @@ class SignupForm extends Model
 
 	/**
 	 * Signs user up.
-	 * @return User saved model
+	 *
+	 * @return User|null the saved model or null if saving fails
 	 */
 	public function signup()
 	{
@@ -46,4 +47,3 @@ class SignupForm extends Model
 		return null;
 	}
 }
\ No newline at end of file
- 
\ No newline at end of file

apps/basic/controllers/SiteController.php

@@ -76,7 +76,7 @@ class SiteController extends Controller
 
 	public function actionContact()
 	{
-		$model = new ContactForm;
+		$model = new ContactForm();
 		if ($model->load(Yii::$app->request->post()) && $model->contact(Yii::$app->params['adminEmail'])) {
 			Yii::$app->session->setFlash('contactFormSubmitted');
 			return $this->refresh();

apps/basic/models/User.php

@@ -24,11 +24,20 @@ class User extends \yii\base\Object implements \yii\web\IdentityInterface
 		],
 	];
 
+	/**
+	 * @inheritdoc
+	 */
 	public static function findIdentity($id)
 	{
 		return isset(self::$users[$id]) ? new static(self::$users[$id]) : null;
 	}
 
+	/**
+	 * Finds user by username
+	 *
+	 * @param string $username
+	 * @return static|null
+	 */
 	public static function findByUsername($username)
 	{
 		foreach (self::$users as $user) {
@@ -39,21 +48,36 @@ class User extends \yii\base\Object implements \yii\web\IdentityInterface
 		return null;
 	}
 
+	/**
+	 * @inheritdoc
+	 */
 	public function getId()
 	{
 		return $this->id;
 	}
 
+	/**
+	 * @inheritdoc
+	 */
 	public function getAuthKey()
 	{
 		return $this->authKey;
 	}
 
+	/**
+	 * @inheritdoc
+	 */
 	public function validateAuthKey($authKey)
 	{
 		return $this->authKey === $authKey;
 	}
 
+	/**
+	 * Validates password
+	 *
+	 * @param string $password password to validate
+	 * @return bool if password provided is valid for current user
+	 */
 	public function validatePassword($password)
 	{
 		return $this->password === $password;