+ /**
+ * Typically just used to fill out Twitter-compatible API status data.
+ *
+ * FIXME: Make all the calls before this end up with a Notice instead of ArrayWrapper please...
+ */
+ public function onNoticeSimpleStatusArray($notice, array &$status, Profile $scoped=null, array $args=array())
+ {
+ if ($scoped instanceof Profile) {
+ $status['favorited'] = Fave::existsForProfile($notice, $scoped);
+ } else {
+ $status['favorited'] = false;
+ }
+ return true;
+ }
+
+ /**
+ * Typically just used to fill out StatusNet specific data in API calls in the referenced $info array.
+ */
+ public function onStatusNetApiNoticeInfo(Notice $notice, array &$info, Profile $scoped=null, array $args=array())
+ {
+ if ($scoped instanceof Profile) {
+ $info['favorite'] = Fave::existsForProfile($notice, $scoped) ? 'true' : 'false';
+ }
+ return true;
+ }
+
+ public function onNoticeDeleteRelated(Notice $notice)
+ {
+ $fave = new Fave();
+ $fave->notice_id = $notice->id;
+
+ if ($fave->find()) {
+ while ($fave->fetch()) {
+ Memcached_DataObject::blow('fave:ids_by_user_own:%d', $fave->user_id);
+ Memcached_DataObject::blow('fave:ids_by_user_own:%d;last', $fave->user_id);
+ Memcached_DataObject::blow('fave:ids_by_user:%d', $fave->user_id);
+ Memcached_DataObject::blow('fave:ids_by_user:%d;last', $fave->user_id);
+ $fave->delete();
+ }
+ }
+
+ $fave->free();
+ }
+
+ public function onStartNoticeListPrefill(array &$notices, array $notice_ids, Profile $scoped=null)
+ {
+ // prefill array of objects, before pluginfication it was Notice::fillFaves($notices)
+ Fave::fillFaves($notice_ids);
+
+ // DB caching
+ if ($scoped instanceof Profile) {
+ Fave::pivotGet('notice_id', $notice_ids, array('user_id' => $scoped->id));
+ }
+ }
+
+ /**
+ * show the "favorite" form in the notice options element
+ * FIXME: Don't let a NoticeListItemAdapter slip in here (or extend that from NoticeListItem)
+ *
+ * @return void
+ */
+ public function onStartShowNoticeOptionItems($nli)
+ {
+ if (Event::handle('StartShowFaveForm', array($nli))) {
+ $scoped = Profile::current();
+ if ($scoped instanceof Profile) {
+ if (Fave::existsForProfile($nli->notice, $scoped)) {
+ $disfavor = new DisfavorForm($nli->out, $nli->notice);
+ $disfavor->show();
+ } else {
+ $favor = new FavorForm($nli->out, $nli->notice);
+ $favor->show();
+ }
+ }
+ Event::handle('EndShowFaveForm', array($nli));
+ }
+ }
+
+ public function onAppendUserActivityStreamObjects(UserActivityStream $uas, array &$objs)
+ {
+ $faves = array();
+ $fave = new Fave();
+ $fave->user_id = $uas->user->id;
+
+ if (!empty($uas->after)) {
+ $fave->whereAdd("modified > '" . common_sql_date($uas->after) . "'");
+ }
+
+ if ($fave->find()) {
+ while ($fave->fetch()) {
+ $faves[] = clone($fave);
+ }
+ }
+
+ return $faves;
+ }
+
+ public function onStartShowThreadedNoticeTailItems(NoticeListItem $nli, Notice $notice, &$threadActive)
+ {
+ if ($nli instanceof ThreadedNoticeListSubItem) {
+ // The sub-items are replies to a conversation, thus we use different HTML elements etc.
+ $item = new ThreadedNoticeListInlineFavesItem($notice, $nli->out);
+ } else {
+ $item = new ThreadedNoticeListFavesItem($notice, $nli->out);
+ }
+ $threadActive = $item->show() || $threadActive;
+ return true;
+ }
+
+ /**
+ * EndInterpretCommand for FavoritePlugin will handle the 'fav' command
+ * using the class FavCommand.
+ *
+ * @param string $cmd Command being run
+ * @param string $arg Rest of the message (including address)
+ * @param User $user User sending the message
+ * @param Command &$result The resulting command object to be run.
+ *
+ * @return boolean hook value
+ */
+ public function onStartInterpretCommand($cmd, $arg, $user, &$result)
+ {
+ if ($result === false && $cmd == 'fav') {
+ if (empty($arg)) {
+ $result = null;
+ } else {
+ list($other, $extra) = $this->split_arg($arg);
+ if (!empty($extra)) {
+ $result = null;
+ } else {
+ $result = new FavCommand($user, $other);
+ }
+ }
+ return false;
+ }
+ return true;
+ }
+
+ public function onHelpCommandMessages(HelpCommand $help, array &$commands)
+ {
+ // TRANS: Help message for IM/SMS command "fav <nickname>".
+ $commands['fav <nickname>'] = _m('COMMANDHELP', "add user's last notice as a 'fave'");
+ // TRANS: Help message for IM/SMS command "fav #<notice_id>".
+ $commands['fav #<notice_id>'] = _m('COMMANDHELP', "add notice with the given id as a 'fave'");
+ }
+
+ /**
+ * Are we allowed to perform a certain command over the API?
+ */
+ public function onCommandSupportedAPI(Command $cmd, array &$supported)
+ {
+ $supported = $supported || $cmd instanceof FavCommand;
+ }
+