Source/AIAutoReplyPlugin.m

   1 /*
   2  * Adium is the legal property of its developers, whose names are listed in the copyright file included
   3  * with this source distribution.
   4  *
   5  * This program is free software; you can redistribute it and/or modify it under the terms of the GNU
   6  * General Public License as published by the Free Software Foundation; either version 2 of the License,
   7  * or (at your option) any later version.
   8  *
   9  * This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even
  10  * the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General
  11  * Public License for more details.
  12  *
  13  * You should have received a copy of the GNU General Public License along with this program; if not,
  14  * write to the Free Software Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA  02111-1307, USA.
  15  */
  16
  17 #import "AIAutoReplyPlugin.h"
  18 #import "AIContactController.h"
  19 #import "AIContentController.h"
  20 #import "AIPreferenceController.h"
  21 #import "AIStatusController.h"
  22 #import <AIUtilities/AIArrayAdditions.h>
  23 #import <Adium/AIAccount.h>
  24 #import <Adium/AIChat.h>
  25 #import <Adium/AIContentMessage.h>
  26 #import <Adium/AIContentObject.h>
  27
  28 /*!
  29  * @class AIAutoReplyPlugin
  30  * @brief Provides AutoReply functionality for the state system
  31  *
  32  * This class implements the state system behavior for auto-reply.  If auto-reply status is active on an account,
  33  * initial messages recieved on that account will be replied to automatically.  Subsequent messages will not receive
  34  * a reply unless the chat window is closed.
  35  *
  36  * This is the expected behavior on certain protocols such as AIM, and considered a convenience on other protocols.
  37  */
  38 @implementation AIAutoReplyPlugin
  39
  40 /*!
  41  * @brief Initialize the auto-reply system
  42  *
  43  * Initialize the auto-reply system to monitor account status.  When an account auto-reply flag is set we begin to
  44  * monitor chat messaging and auto-reply as necessary.
  45  */
  46 - (void)installPlugin
  47 {
  48         //Init
  49         receivedAutoReply = [[NSMutableArray alloc] init];
  50
  51         //Add observers
  52         [[adium notificationCenter] addObserver:self
  53                                                                    selector:@selector(didReceiveContent:)
  54                                                                            name:CONTENT_MESSAGE_RECEIVED object:nil];
  55         [[adium notificationCenter] addObserver:self
  56                                                                    selector:@selector(didSendContent:)
  57                                                                            name:CONTENT_MESSAGE_SENT object:nil];
  58         [[adium notificationCenter] addObserver:self
  59                                                                    selector:@selector(chatWillClose:)
  60                                                                            name:Chat_WillClose object:nil];
  61
  62         [[adium contactController] registerListObjectObserver:self];
  63 }
  64
  65 /*!
  66  * Deallocate
  67  */
  68 - (void)dealloc
  69 {
  70         [[adium contactController] unregisterListObjectObserver:self];
  71         [receivedAutoReply release];
  72
  73         [super dealloc];
  74 }
  75
  76 /*!
  77  * @brief Account status changed.
  78  *
  79  * Update our chat monitoring in response to account status changes.
  80  *
  81  * TODO: If there are no accounts with an auto-reply flag set we SHOULD stop monitoring messages for optimal performance.
  82  */
  83 - (NSSet *)updateListObject:(AIListObject *)inObject keys:(NSSet *)inModifiedKeys silent:(BOOL)silent
  84 {
  85         if([inObject isKindOfClass:[AIAccount class]] &&
  86            [inModifiedKeys containsObject:@"StatusState"]){
  87
  88                 //Reset our list of contacts who have already received an auto-reply
  89                 [receivedAutoReply release];
  90                 receivedAutoReply = [[NSMutableArray alloc] init];
  91         }
  92
  93     return(nil);
  94 }
  95
  96 /*!
  97  * @brief Respond to a received message
  98  *
  99  * Respond to a received message by sending out the current auto-reply.  We only send the auto-reply once to each
 100  * contact, and then their name is added to a list and additional received messages are ignored.
 101  */
 102 - (void)didReceiveContent:(NSNotification *)notification
 103 {
 104     AIContentObject     *contentObject = [[notification userInfo] objectForKey:@"AIContentObject"];
 105     AIChat                              *chat = [contentObject chat];
 106
 107         //We will not respond to the received message if it is an auto-reply, over a chat where we have already responded,
 108         //or over a chat with a name.
 109         //XXX - Using the presence of a name on the chat to determine if it's multi-user or not is not clean -ai
 110         if([[contentObject type] isEqualToString:CONTENT_MESSAGE_TYPE] &&
 111            ![(AIContentMessage *)contentObject isAutoreply] &&
 112            ![receivedAutoReply containsObjectIdenticalTo:chat] &&
 113            [chat name] == nil){
 114
 115                 [self sendAutoReplyFromAccount:[contentObject destination]
 116                                                          toContact:[contentObject source]
 117                                                                 onChat:chat];
 118                 [receivedAutoReply addObject:chat];
 119         }
 120 }
 121
 122 /*!
 123  * @brief Send an auto-reply
 124  *
 125  * Sends our current auto-reply to the specified contact.
 126  * @param source Account sending the object
 127  * @param destination Contact receiving the object
 128  * @param chat Chat the communication is occuring over
 129  */
 130 - (void)sendAutoReplyFromAccount:(id)source toContact:(id)destination onChat:(AIChat *)chat
 131 {
 132         AIContentMessage        *responseContent;
 133         NSAttributedString      *autoReply;
 134
 135         if(autoReply = [[[chat account] statusState] autoReply]){
 136                 responseContent = [AIContentMessage messageInChat:chat
 137                                                                                            withSource:source
 138                                                                                           destination:destination
 139                                                                                                          date:nil
 140                                                                                                   message:autoReply
 141                                                                                                 autoreply:YES];
 142
 143                 [[adium contentController] sendContentObject:responseContent];
 144         }
 145 }
 146
 147 /*!
 148  * @brief Respond to our user sending messages
 149  *
 150  * For convenience, when our user messages a contact while away we exclude that contact from receiving our auto-away
 151  * on future messages.
 152  */
 153 - (void)didSendContent:(NSNotification *)notification
 154 {
 155     AIContentObject     *contentObject = [[notification userInfo] objectForKey:@"AIContentObject"];
 156         AIChat                  *chat = [contentObject chat];
 157
 158     if([[contentObject type] isEqualToString:CONTENT_MESSAGE_TYPE]){
 159         if(![receivedAutoReply containsObjectIdenticalTo:chat]){
 160             [receivedAutoReply addObject:chat];
 161         }
 162     }
 163 }
 164
 165 /*!
 166  * @brief Respond to a chat closing
 167  *
 168  * Once a chat is closed we forget about whether it has received an auto-response.  If the chat is re-opened, it will
 169  * receive our auto-response again.  This behavior is not necessarily desired, but is a side effect of basing our
 170  * already-received list on chats and not contacts.  However, many users have come to expect this behavior and it's
 171  * presence is neither strongly negative or positive.
 172  */
 173 - (void)chatWillClose:(NSNotification *)notification
 174 {
 175     [receivedAutoReply removeObjectIdenticalTo:[notification object]];
 176 }
 177
 178 @end