MessageTrait::setReadAt() - Code Metrics - Inspection of "2.0.0.20160301-nightly-patch1" - vistart/yii2-models - Measure and Improve Code Quality continuously with Scrutinizer

Completed

Push — master ( 53d264...0a50d5 )

by vistart

created 2016-03-01 11:35 UTC

MessageTrait::setReadAt() A

↳ Parent: MessageTrait

Complexity

Conditions	2
Paths	2

Size

Total Lines	8
Code Lines	5

Duplication

Lines	0
Ratio	0 %

Code Coverage

Tests	4
CRAP Score	2.032

Importance

Changes	1
Bugs	0	Features	0

Metric	Value
c	1
b	0
f	0
dl	0
loc	8
ccs	4
cts	5
cp	0.8
rs	9.4285
cc	2
eloc	5
nc	2
nop	1
crap	2.032

<?php

/**
 *  _   __ __ _____ _____ ___  ____  _____
 * | | / // // ___//_  _//   ||  __||_   _|
 * | |/ // /(__  )  / / / /| || |     | |
 * |___//_//____/  /_/ /_/ |_||_|     |_|
 * @link https://vistart.name/
 * @copyright Copyright (c) 2016 vistart
 * @license https://vistart.name/license/
 */

namespace vistart\Models\traits;

/**
 * This trait should be used in models extended from models used BlameableTrait.
 * Notice: The models used BlameableTrait are also models used EntityTrait.
 *
 * @property $recipient
 * @version 2.0
 * @author vistart <[email protected]>
 */
trait MessageTrait
{
    use MutualTrait;

    public $attachmentAttribute = 'attachment';
    public $receivedAtAttribute = 'received_at';
    public $readAtAttribute = 'read_at';
    public static $eventMessageReceived = 'messageReceived';
    public static $eventMessageRead = 'messageRead';
    public $permitChangeContent = false;
    public $permitChangeReceivedAt = false;
    public $permitChangeReadAt = false;

    public function hasBeenReceived()
    {
        return is_string($this->receivedAtAttribute) ? !$this->isInitDatetime($this->getReceivedAt()) : false;
trait Idable {
    public function equalIds(Idable $other) {
        return $this->getId() === $other->getId();
    }
}
    }

    public function hasBeenRead()
    {
        return is_string($this->readAtAttribute) ? !$this->isInitDatetime($this->getReadAt()) : false;
trait Idable {
    public function equalIds(Idable $other) {
        return $this->getId() === $other->getId();
    }
}
    }

    public function touchReceived()
    {
        return $this->setReceivedAt(static::currentDatetime());
    }

    public function touchRead()
    {
        return $this->setReadAt(static::currentDatetime());
    }

    public function getReceivedAt()
    {
        if (is_string($this->receivedAtAttribute)) {
            $raAttribute = $this->receivedAtAttribute;
            return $this->$raAttribute;
        }
        return null;
    }

    public function setReceivedAt($receivedAt)
    {
        if (is_string($this->receivedAtAttribute)) {
            $raAttribute = $this->receivedAtAttribute;
            return $this->$raAttribute = $receivedAt;
        }
        return null;
    }

    public function getReadAt()
    {
        if (is_string($this->readAtAttribute)) {
            $raAttribute = $this->readAtAttribute;
            return $this->$raAttribute;
        }
        return null;
    }

    public function setReadAt($readAt)
    {
        if (is_string($this->readAtAttribute)) {
            $raAttribute = $this->readAtAttribute;
            return $this->$raAttribute = $readAt;
        }
        return null;
    }

    /**
     * @param \yii\base\ModelEvent $event
     */
    public function onInitReceivedAtAttribute($event)
    {
        $sender = $event->sender;
        /* @var $sender static */
        $sender->setReceivedAt(static::getInitDatetime($event));
    }

    /**
     * @param \yii\base\ModelEvent $event
     */
    public function onInitReadAtAttribute($event)
    {
        $sender = $event->sender;
        /* @var $sender static */
        $sender->setReadAt(static::getInitDatetime($event));
    }

    /**
     * We consider you have received the message if you read it.
     * @param \yii\base\ModelEvent $event
     */
    public function onReadAtChanged($event)
    {
        $sender = $event->sender;
        $raAttribute = $sender->readAtAttribute;
        if (!is_string($raAttribute)) {
            return;
        }
        $reaAttribute = $sender->receivedAtAttribute;
        if (is_string($reaAttribute) && !$sender->isInitDatetime($sender->$raAttribute) && $sender->isInitDatetime($sender->$reaAttribute)) {
            $sender->$reaAttribute = $sender->currentDatetime();
        }
        if ($sender->permitChangeReadAt) {
            return;
        }
        $oldRa = $sender->getOldAttribute($raAttribute);
        if ($oldRa != null && !$sender->isInitDatetime($oldRa) && $sender->$raAttribute != $oldRa) {
            $sender->$raAttribute = $oldRa;
            return;
        }
    }

    /**
     * You are not allowed to change receive time if you have received it.
     * @param \yii\base\ModelEvent $event
     */
    public function onReceivedAtChanged($event)
    {
        $sender = $event->sender;
        $raAttribute = $sender->receivedAtAttribute;
        if (!is_string($raAttribute)) {
            return;
        }
        if ($sender->permitChangeReceivedAt) {
            return;
        }
        $oldRa = $sender->getOldAttribute($raAttribute);
        if ($oldRa != null && !$sender->isInitDatetime($oldRa) && $sender->$raAttribute != $oldRa) {
            $sender->$raAttribute = $oldRa;
            return;
        }
    }

    /**
     * You are not allowed to change the content if it is not new message.
     * @param \yii\base\ModelEvent $event
     */
    public function onContentChanged($event)
    {
        $sender = $event->sender;
        if ($sender->permitChangeContent) {
            return;
        }
        $cAttribute = $sender->contentAttribute;
        $oldContent = $sender->getOldAttribute($cAttribute);
        if ($oldContent != $sender->$cAttribute) {
            $sender->$cAttribute = $oldContent;
        }
    }

    /**
     * Trigger message received or read events.
     * @param \yii\db\AfterSaveEvent $event
     */
    public function onMessageUpdated($event)
    {
        $sender = $event->sender;
        $reaAttribute = $sender->receivedAtAttribute;
        if (isset($event->changedAttributes[$reaAttribute]) && $event->changedAttributes[$reaAttribute] != $sender->$reaAttribute) {
            $sender->trigger(static::$eventMessageReceived);
        }
        $raAttribute = $sender->readAtAttribute;
        if (isset($event->changedAttributes[$raAttribute]) && $event->changedAttributes[$raAttribute] != $sender->$raAttribute) {
            $sender->trigger(static::$eventMessageRead);
        }
    }

    public function initMessageEvents()
    {
        $this->on(static::EVENT_BEFORE_INSERT, [$this, 'onInitReceivedAtAttribute']);
trait Idable {
    public function equalIds(Idable $other) {
        return $this->getId() === $other->getId();
    }
}
        $this->on(static::EVENT_BEFORE_INSERT, [$this, 'onInitReadAtAttribute']);
trait Idable {
    public function equalIds(Idable $other) {
        return $this->getId() === $other->getId();
    }
}
        $this->on(static::EVENT_BEFORE_UPDATE, [$this, 'onReceivedAtChanged']);
trait Idable {
    public function equalIds(Idable $other) {
        return $this->getId() === $other->getId();
    }
}
        $this->on(static::EVENT_BEFORE_UPDATE, [$this, 'onReadAtChanged']);
trait Idable {
    public function equalIds(Idable $other) {
        return $this->getId() === $other->getId();
    }
}
        $this->on(static::EVENT_BEFORE_UPDATE, [$this, 'onContentChanged']);
trait Idable {
    public function equalIds(Idable $other) {
        return $this->getId() === $other->getId();
    }
}
        $this->on(static::EVENT_AFTER_UPDATE, [$this, 'onMessageUpdated']);
trait Idable {
    public function equalIds(Idable $other) {
        return $this->getId() === $other->getId();
    }
}
    }

    public function getMessageRules()
    {
        $rules = [];
        $rules = array_merge($rules, $this->getMutualRules());
        if (is_string($this->attachmentAttribute)) {
            $rules[] = [$this->attachmentAttribute, 'safe'];
        }
        if (is_string($this->receivedAtAttribute)) {
            $rules[] = [$this->receivedAtAttribute, 'safe'];
        }
        if (is_string($this->readAtAttribute)) {
            $rules[] = [$this->readAtAttribute, 'safe'];
        }
        return $rules;
    }

    public function rules()
    {
        return array_merge(parent::rules(), $this->getMessageRules());
    }

    public function enabledFields()
    {
        $fields = parent::enabledFields();
        if (is_string($this->otherGuidAttribute)) {
            $fields[] = $this->otherGuidAttribute;
        }
        if (is_string($this->attachmentAttribute)) {
            $fields[] = $this->attachmentAttribute;
        }
        if (is_string($this->receivedAtAttribute)) {
            $fields[] = $this->receivedAtAttribute;
        }
        if (is_string($this->readAtAttribute)) {
            $fields[] = $this->readAtAttribute;
        }
        return $fields;
    }
}


1		<?php
2
3		/**
4		* _ __ __ _____ _____ ___ ____ _____
5		* \| \| / // // ___//_ _// \|\| __\|\|_ _\|
6		* \| \|/ // /(__ ) / / / /\| \|\| \| \| \|
7		* \|___//_//____/ /_/ /_/ \|_\|\|_\| \|_\|
8		* @link https://vistart.name/
9		* @copyright Copyright (c) 2016 vistart
10		* @license https://vistart.name/license/
11		*/
12
13		namespace vistart\Models\traits;
14
15		/**
16		* This trait should be used in models extended from models used BlameableTrait.
17		* Notice: The models used BlameableTrait are also models used EntityTrait.
18		*
19		* @property $recipient
20		* @version 2.0
21		* @author vistart <[email protected]>
22		*/
23		trait MessageTrait
24		{
25		use MutualTrait;
26
27		public $attachmentAttribute = 'attachment';
28		public $receivedAtAttribute = 'received_at';
29		public $readAtAttribute = 'read_at';
30		public static $eventMessageReceived = 'messageReceived';
31		public static $eventMessageRead = 'messageRead';
32		public $permitChangeContent = false;
33		public $permitChangeReceivedAt = false;
34		public $permitChangeReadAt = false;
35
36	4	public function hasBeenReceived()
37		{
38	4	return is_string($this->receivedAtAttribute) ? !$this->isInitDatetime($this->getReceivedAt()) : false;
		0 ignored issues – show Bug introduced 2016-02-10 13:41 UTC by Report Bug Copy Issue Report It seems like `isInitDatetime()` must be provided by classes using this trait. How about adding it as abstract method to this trait? This check looks for methods that are used by a trait but not required by it. To illustrate, let’s look at the following code example trait Idable { public function equalIds(Idable $other) { return $this->getId() === $other->getId(); } } The trait `Idable` provides a method `equalsId` that in turn relies on the method `getId()`. If this method does not exist on a class mixing in this trait, the method will fail. Adding the `getId()` as an abstract method to the trait will make sure it is available. Loading history...
39		}
40
41	4	public function hasBeenRead()
42		{
43	4	return is_string($this->readAtAttribute) ? !$this->isInitDatetime($this->getReadAt()) : false;
		0 ignored issues – show Bug introduced 2016-02-12 02:46 UTC by Report Bug Copy Issue Report It seems like `isInitDatetime()` must be provided by classes using this trait. How about adding it as abstract method to this trait? This check looks for methods that are used by a trait but not required by it. To illustrate, let’s look at the following code example trait Idable { public function equalIds(Idable $other) { return $this->getId() === $other->getId(); } } The trait `Idable` provides a method `equalsId` that in turn relies on the method `getId()`. If this method does not exist on a class mixing in this trait, the method will fail. Adding the `getId()` as an abstract method to the trait will make sure it is available. Loading history...
44		}
45
46	2	public function touchReceived()
47		{
48	2	return $this->setReceivedAt(static::currentDatetime());
49		}
50
51	2	public function touchRead()
52		{
53	2	return $this->setReadAt(static::currentDatetime());
54		}
55
56	4	public function getReceivedAt()
57		{
58	4	if (is_string($this->receivedAtAttribute)) {
59	4	$raAttribute = $this->receivedAtAttribute;
60	4	return $this->$raAttribute;
61		}
62		return null;
63		}
64
65	8	public function setReceivedAt($receivedAt)
66		{
67	8	if (is_string($this->receivedAtAttribute)) {
68	8	$raAttribute = $this->receivedAtAttribute;
69	8	return $this->$raAttribute = $receivedAt;
70		}
71		return null;
72		}
73
74	4	public function getReadAt()
75		{
76	4	if (is_string($this->readAtAttribute)) {
77	4	$raAttribute = $this->readAtAttribute;
78	4	return $this->$raAttribute;
79		}
80		return null;
81		}
82
83	8	public function setReadAt($readAt)
84		{
85	8	if (is_string($this->readAtAttribute)) {
86	8	$raAttribute = $this->readAtAttribute;
87	8	return $this->$raAttribute = $readAt;
88		}
89		return null;
90		}
91
92		/**
93		* @param \yii\base\ModelEvent $event
94		*/
95	8	public function onInitReceivedAtAttribute($event)
96		{
97	8	$sender = $event->sender;
98		/* @var $sender static */
99	8	$sender->setReceivedAt(static::getInitDatetime($event));
100	8	}
101
102		/**
103		* @param \yii\base\ModelEvent $event
104		*/
105	8	public function onInitReadAtAttribute($event)
106		{
107	8	$sender = $event->sender;
108		/* @var $sender static */
109	8	$sender->setReadAt(static::getInitDatetime($event));
110	8	}
111
112		/**
113		* We consider you have received the message if you read it.
114		* @param \yii\base\ModelEvent $event
115		*/
116	4	public function onReadAtChanged($event)
117		{
118	4	$sender = $event->sender;
119	4	$raAttribute = $sender->readAtAttribute;
120	4	if (!is_string($raAttribute)) {
121		return;
122		}
123	4	$reaAttribute = $sender->receivedAtAttribute;
124	4	if (is_string($reaAttribute) && !$sender->isInitDatetime($sender->$raAttribute) && $sender->isInitDatetime($sender->$reaAttribute)) {
125	2	$sender->$reaAttribute = $sender->currentDatetime();
126	2	}
127	4	if ($sender->permitChangeReadAt) {
128		return;
129		}
130	4	$oldRa = $sender->getOldAttribute($raAttribute);
131	4	if ($oldRa != null && !$sender->isInitDatetime($oldRa) && $sender->$raAttribute != $oldRa) {
132		$sender->$raAttribute = $oldRa;
133		return;
134		}
135	4	}
136
137		/**
138		* You are not allowed to change receive time if you have received it.
139		* @param \yii\base\ModelEvent $event
140		*/
141	4	public function onReceivedAtChanged($event)
142		{
143	4	$sender = $event->sender;
144	4	$raAttribute = $sender->receivedAtAttribute;
145	4	if (!is_string($raAttribute)) {
146		return;
147		}
148	4	if ($sender->permitChangeReceivedAt) {
149		return;
150		}
151	4	$oldRa = $sender->getOldAttribute($raAttribute);
152	4	if ($oldRa != null && !$sender->isInitDatetime($oldRa) && $sender->$raAttribute != $oldRa) {
153		$sender->$raAttribute = $oldRa;
154		return;
155		}
156	4	}
157
158		/**
159		* You are not allowed to change the content if it is not new message.
160		* @param \yii\base\ModelEvent $event
161		*/
162	4	public function onContentChanged($event)
163		{
164	4	$sender = $event->sender;
165	4	if ($sender->permitChangeContent) {
166		return;
167		}
168	4	$cAttribute = $sender->contentAttribute;
169	4	$oldContent = $sender->getOldAttribute($cAttribute);
170	4	if ($oldContent != $sender->$cAttribute) {
171	2	$sender->$cAttribute = $oldContent;
172	2	}
173	4	}
174
175		/**
176		* Trigger message received or read events.
177		* @param \yii\db\AfterSaveEvent $event
178		*/
179	4	public function onMessageUpdated($event)
180		{
181	4	$sender = $event->sender;
182	4	$reaAttribute = $sender->receivedAtAttribute;
183	4	if (isset($event->changedAttributes[$reaAttribute]) && $event->changedAttributes[$reaAttribute] != $sender->$reaAttribute) {
184	4	$sender->trigger(static::$eventMessageReceived);
185	4	}
186	4	$raAttribute = $sender->readAtAttribute;
187	4	if (isset($event->changedAttributes[$raAttribute]) && $event->changedAttributes[$raAttribute] != $sender->$raAttribute) {
188	2	$sender->trigger(static::$eventMessageRead);
189	2	}
190	4	}
191
192	8	public function initMessageEvents()
193		{
194	8	$this->on(static::EVENT_BEFORE_INSERT, [$this, 'onInitReceivedAtAttribute']);
		0 ignored issues – show Bug introduced 2016-02-11 02:52 UTC by Report Bug Copy Issue Report It seems like `on()` must be provided by classes using this trait. How about adding it as abstract method to this trait? This check looks for methods that are used by a trait but not required by it. To illustrate, let’s look at the following code example trait Idable { public function equalIds(Idable $other) { return $this->getId() === $other->getId(); } } The trait `Idable` provides a method `equalsId` that in turn relies on the method `getId()`. If this method does not exist on a class mixing in this trait, the method will fail. Adding the `getId()` as an abstract method to the trait will make sure it is available. Loading history...
195	8	$this->on(static::EVENT_BEFORE_INSERT, [$this, 'onInitReadAtAttribute']);
		0 ignored issues – show Bug introduced 2016-02-11 02:52 UTC by Report Bug Copy Issue Report It seems like `on()` must be provided by classes using this trait. How about adding it as abstract method to this trait? This check looks for methods that are used by a trait but not required by it. To illustrate, let’s look at the following code example trait Idable { public function equalIds(Idable $other) { return $this->getId() === $other->getId(); } } The trait `Idable` provides a method `equalsId` that in turn relies on the method `getId()`. If this method does not exist on a class mixing in this trait, the method will fail. Adding the `getId()` as an abstract method to the trait will make sure it is available. Loading history...
196	8	$this->on(static::EVENT_BEFORE_UPDATE, [$this, 'onReceivedAtChanged']);
		0 ignored issues – show Bug introduced 2016-02-12 02:46 UTC by Report Bug Copy Issue Report It seems like `on()` must be provided by classes using this trait. How about adding it as abstract method to this trait? This check looks for methods that are used by a trait but not required by it. To illustrate, let’s look at the following code example trait Idable { public function equalIds(Idable $other) { return $this->getId() === $other->getId(); } } The trait `Idable` provides a method `equalsId` that in turn relies on the method `getId()`. If this method does not exist on a class mixing in this trait, the method will fail. Adding the `getId()` as an abstract method to the trait will make sure it is available. Loading history...
197	8	$this->on(static::EVENT_BEFORE_UPDATE, [$this, 'onReadAtChanged']);
		0 ignored issues – show Bug introduced 2016-02-12 02:46 UTC by Report Bug Copy Issue Report It seems like `on()` must be provided by classes using this trait. How about adding it as abstract method to this trait? This check looks for methods that are used by a trait but not required by it. To illustrate, let’s look at the following code example trait Idable { public function equalIds(Idable $other) { return $this->getId() === $other->getId(); } } The trait `Idable` provides a method `equalsId` that in turn relies on the method `getId()`. If this method does not exist on a class mixing in this trait, the method will fail. Adding the `getId()` as an abstract method to the trait will make sure it is available. Loading history...
198	8	$this->on(static::EVENT_BEFORE_UPDATE, [$this, 'onContentChanged']);
		0 ignored issues – show Bug introduced 2016-02-12 02:46 UTC by Report Bug Copy Issue Report It seems like `on()` must be provided by classes using this trait. How about adding it as abstract method to this trait? This check looks for methods that are used by a trait but not required by it. To illustrate, let’s look at the following code example trait Idable { public function equalIds(Idable $other) { return $this->getId() === $other->getId(); } } The trait `Idable` provides a method `equalsId` that in turn relies on the method `getId()`. If this method does not exist on a class mixing in this trait, the method will fail. Adding the `getId()` as an abstract method to the trait will make sure it is available. Loading history...
199	8	$this->on(static::EVENT_AFTER_UPDATE, [$this, 'onMessageUpdated']);
		0 ignored issues – show Bug introduced 2016-02-15 04:42 UTC by Report Bug Copy Issue Report It seems like `on()` must be provided by classes using this trait. How about adding it as abstract method to this trait? This check looks for methods that are used by a trait but not required by it. To illustrate, let’s look at the following code example trait Idable { public function equalIds(Idable $other) { return $this->getId() === $other->getId(); } } The trait `Idable` provides a method `equalsId` that in turn relies on the method `getId()`. If this method does not exist on a class mixing in this trait, the method will fail. Adding the `getId()` as an abstract method to the trait will make sure it is available. Loading history...
200	8	}
201
202	8	public function getMessageRules()
203		{
204	8	$rules = [];
205	8	$rules = array_merge($rules, $this->getMutualRules());
206	8	if (is_string($this->attachmentAttribute)) {
207	8	$rules[] = [$this->attachmentAttribute, 'safe'];
208	8	}
209	8	if (is_string($this->receivedAtAttribute)) {
210	8	$rules[] = [$this->receivedAtAttribute, 'safe'];
211	8	}
212	8	if (is_string($this->readAtAttribute)) {
213	8	$rules[] = [$this->readAtAttribute, 'safe'];
214	8	}
215	8	return $rules;
216		}
217
218	8	public function rules()
219		{
220	8	return array_merge(parent::rules(), $this->getMessageRules());
221		}
222
223	8	public function enabledFields()
224		{
225	8	$fields = parent::enabledFields();
226	8	if (is_string($this->otherGuidAttribute)) {
227	8	$fields[] = $this->otherGuidAttribute;
228	8	}
229	8	if (is_string($this->attachmentAttribute)) {
230	8	$fields[] = $this->attachmentAttribute;
231	8	}
232	8	if (is_string($this->receivedAtAttribute)) {
233	8	$fields[] = $this->receivedAtAttribute;
234	8	}
235	8	if (is_string($this->readAtAttribute)) {
236	8	$fields[] = $this->readAtAttribute;
237	8	}
238	8	return $fields;
239		}
240		}
241

vistart / yii2-models

Push — master ( 53d264...0a50d5 )

MessageTrait::setReadAt() A

Complexity

Size

Duplication

Code Coverage

Importance

Duplication Side-by-Side

Filter issues like