Source/ESAccountEvents.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 "AIContactController.h"
  18 #import "ESAccountEvents.h"
  19 #import "ESContactAlertsController.h"
  20 #import <AIUtilities/ESImageAdditions.h>
  21 #import <Adium/AIAccount.h>
  22
  23 #define ACCOUNT_CONNECTION_STATUS_GROUPING  2.0
  24
  25 /*!
  26  * @class ESAccountEvents
  27  * @brief Component to handle account-related Contact Alerts events
  28  */
  29 @implementation ESAccountEvents
  30
  31 /*!
  32  * @brief Install
  33  */
  34 - (void)installPlugin
  35 {
  36         accountConnectionStatusGroupingOnlineTimer = nil;
  37         accountConnectionStatusGroupingOfflineTimer = nil;
  38
  39         //Register the events we generate
  40         [[adium contactAlertsController] registerEventID:ACCOUNT_CONNECTED withHandler:self inGroup:AIAccountsEventHandlerGroup globalOnly:YES];
  41         [[adium contactAlertsController] registerEventID:ACCOUNT_DISCONNECTED withHandler:self inGroup:AIAccountsEventHandlerGroup globalOnly:YES];
  42         [[adium contactAlertsController] registerEventID:ACCOUNT_RECEIVED_EMAIL withHandler:self inGroup:AIOtherEventHandlerGroup globalOnly:YES];
  43
  44         //Observe status changes
  45     [[adium contactController] registerListObjectObserver:self];
  46 }
  47
  48 - (void)uninstallPlugin
  49 {
  50         [[adium contactController] unregisterListObjectObserver:self];
  51 }
  52
  53 /*!
  54  * @brief Short description for an event
  55  *
  56  * We're global-only, so no short descriptions are needed.
  57  */
  58 - (NSString *)shortDescriptionForEventID:(NSString *)eventID { return @""; }
  59
  60 /*!
  61  * @brief Global short description for an event
  62  */
  63 - (NSString *)globalShortDescriptionForEventID:(NSString *)eventID
  64 {
  65         NSString        *description;
  66
  67         if([eventID isEqualToString:ACCOUNT_CONNECTED]){
  68                 description = AILocalizedString(@"You connect",nil);
  69         }else if([eventID isEqualToString:ACCOUNT_DISCONNECTED]){
  70                 description = AILocalizedString(@"You disconnect",nil);
  71         }else if ([eventID isEqualToString:ACCOUNT_RECEIVED_EMAIL]){
  72                 description = AILocalizedString(@"New email notification",nil);
  73         }else{
  74                 description = @"";
  75         }
  76
  77         return(description);
  78 }
  79
  80 /*!
  81  * @brief English, non-translated global short description for an event
  82  *
  83  * This exists because old X(tras) relied upon matching the description of event IDs, and I don't feel like making
  84  * a converter for old packs.  If anyone wants to fix this situation, please feel free :)
  85  *
  86  * @result English global short description which should only be used internally
  87  */
  88 - (NSString *)englishGlobalShortDescriptionForEventID:(NSString *)eventID
  89 {
  90         NSString        *description;
  91
  92         if([eventID isEqualToString:ACCOUNT_CONNECTED]){
  93                 description = @"Connected";
  94         }else if([eventID isEqualToString:ACCOUNT_DISCONNECTED]){
  95                 description = @"Disconnected";
  96         }else if ([eventID isEqualToString:ACCOUNT_RECEIVED_EMAIL]){
  97                 description = @"New Mail Received";
  98         }else{
  99                 description = @"";
 100         }
 101
 102         return(description);
 103 }
 104
 105 /*!
 106  * @brief Long description for an event
 107  */
 108 - (NSString *)longDescriptionForEventID:(NSString *)eventID forListObject:(AIListObject *)listObject
 109 {
 110         NSString        *description;
 111
 112         if([eventID isEqualToString:ACCOUNT_CONNECTED]){
 113                 description = AILocalizedString(@"When you connect",nil);
 114         }else if([eventID isEqualToString:ACCOUNT_DISCONNECTED]){
 115                 description = AILocalizedString(@"When you disconnect",nil);
 116         }else if([eventID isEqualToString:ACCOUNT_RECEIVED_EMAIL]){
 117                 description = AILocalizedString(@"When you receive a new email notification",nil);
 118         }else{
 119                 description = @"";
 120         }
 121
 122         return(description);
 123 }
 124
 125 /*!
 126  * @brief Natural language description for an event
 127  *
 128  * @param eventID The event identifier
 129  * @param listObject The listObject triggering the event
 130  * @param userInfo Event-specific userInfo
 131  * @param includeSubject If YES, return a full sentence.  If not, return a fragment.
 132  * @result The natural language description.
 133  */
 134 - (NSString *)naturalLanguageDescriptionForEventID:(NSString *)eventID
 135                                                                                 listObject:(AIListObject *)listObject
 136                                                                                   userInfo:(id)userInfo
 137                                                                         includeSubject:(BOOL)includeSubject
 138 {
 139         NSString        *description = nil;
 140
 141         if(includeSubject){
 142                 NSString        *format = nil;
 143                 if([eventID isEqualToString:ACCOUNT_CONNECTED]){
 144                         format = AILocalizedString(@"%@ connected",nil);
 145                 }else if([eventID isEqualToString:ACCOUNT_DISCONNECTED]){
 146                         format = AILocalizedString(@"%@ disconnected",nil);
 147                 }else if([eventID isEqualToString:ACCOUNT_RECEIVED_EMAIL]){
 148                         format = AILocalizedString(@"%@ received new email",nil);
 149                 }
 150
 151                 if(format){
 152                         description = [NSString stringWithFormat:format,[listObject formattedUID]];
 153                 }
 154         }else{
 155                 if([eventID isEqualToString:ACCOUNT_CONNECTED]){
 156                         description = AILocalizedString(@"connected",nil);
 157                 }else if([eventID isEqualToString:ACCOUNT_DISCONNECTED]){
 158                         description = AILocalizedString(@"disconnected",nil);
 159                 }else if([eventID isEqualToString:ACCOUNT_RECEIVED_EMAIL]){
 160                         description = AILocalizedString(@"received new email",nil);
 161                 }
 162         }
 163
 164         return(description);
 165 }
 166
 167 - (NSImage *)imageForEventID:(NSString *)eventID
 168 {
 169         static NSImage  *eventImage = nil;
 170         if(!eventImage) eventImage = [[NSImage imageNamed:@"pref-accounts" forClass:[self class]] retain];
 171         return eventImage;
 172 }
 173
 174 #pragma mark Aggregation and event generation
 175 /*!
 176  * @brief Update list object
 177  *
 178  * We aggregate account connection events to avoid a quick sign on/sign off from triggering the event
 179  */
 180 - (NSSet *)updateListObject:(AIListObject *)inObject keys:(NSSet *)inModifiedKeys silent:(BOOL)silent
 181 {
 182         if([inObject isKindOfClass:[AIAccount class]]){ //We only care about accounts
 183                 if([inModifiedKeys containsObject:@"Online"]){
 184
 185                         if ([[inObject numberStatusObjectForKey:@"Online"] boolValue]){
 186                                 if (accountConnectionStatusGroupingOnlineTimer){
 187                                         [accountConnectionStatusGroupingOnlineTimer invalidate]; [accountConnectionStatusGroupingOnlineTimer release];
 188                                 }
 189
 190                                 accountConnectionStatusGroupingOnlineTimer = [[NSTimer scheduledTimerWithTimeInterval:ACCOUNT_CONNECTION_STATUS_GROUPING
 191                                                                                                                                                                                            target:self
 192                                                                                                                                                                                          selector:@selector(accountConnection:)
 193                                                                                                                                                                                          userInfo:inObject
 194                                                                                                                                                                                           repeats:NO] retain];
 195                         }else{
 196                                 if (accountConnectionStatusGroupingOfflineTimer){
 197                                         [accountConnectionStatusGroupingOfflineTimer invalidate]; [accountConnectionStatusGroupingOfflineTimer release];
 198                                 }
 199
 200                                 accountConnectionStatusGroupingOfflineTimer = [[NSTimer scheduledTimerWithTimeInterval:ACCOUNT_CONNECTION_STATUS_GROUPING
 201                                                                                                                                                                                                 target:self
 202                                                                                                                                                                                           selector:@selector(accountDisconnection:)
 203                                                                                                                                                                                           userInfo:inObject
 204                                                                                                                                                                                            repeats:NO] retain];
 205                         }
 206                 }
 207         }
 208
 209         return(nil);
 210 }
 211
 212 /*!
 213  * @brief Called an account connects and remains online for ACCOUNT_CONNECTION_STATUS_GROUPING
 214  */
 215 - (void)accountConnection:(NSTimer *)timer
 216 {
 217         [[adium contactAlertsController] generateEvent:ACCOUNT_CONNECTED
 218                                                                          forListObject:[timer userInfo]
 219                                                                                   userInfo:nil
 220                                           previouslyPerformedActionIDs:nil];
 221         [accountConnectionStatusGroupingOnlineTimer release]; accountConnectionStatusGroupingOnlineTimer = nil;
 222 }
 223
 224 /*!
 225  * @brief Called an account disconnects and remains offline for ACCOUNT_CONNECTION_STATUS_GROUPING
 226  */
 227 - (void)accountDisconnection:(NSTimer *)timer
 228 {
 229         [[adium contactAlertsController] generateEvent:ACCOUNT_DISCONNECTED
 230                                                                          forListObject:[timer userInfo]
 231                                                                                   userInfo:nil
 232                                           previouslyPerformedActionIDs:nil];
 233         [accountConnectionStatusGroupingOfflineTimer release]; accountConnectionStatusGroupingOfflineTimer = nil;
 234 }
 235
 236 @end