QMChatViewController

An elegant ready-to-go chat view controller for iOS chat applications that use Quickblox communication backend.

#Features

Ready-to-go chat view controller with a set of cells.
Automatic cell size calculation.
UI customisation for chat cells.
Flexibility in improving and extending functionality.
Easy to connect with Quickblox.
Optimised and performant.
Supports portrait and landscape orientations.
Auto Layout inside.

Screenshots

Requirements

iOS 7.0+
ARC
Xcode 6+
Quickblox SDK 2.0+
TTTAttributedLabel

Installation

CocoaPods

pod 'QMChatViewController', '~> 0.1'

Manually

Drag QMChatViewController folder to your project folder and link to the appropriate target.
Install dependencies.

Dependencies

TTTAttributedLabel. If you are using pods, add this to your Podfile:

pod 'TTTAttributedLabel', :git => 'https://github.com/TTTAttributedLabel/TTTAttributedLabel.git'
Quickblox iOS SDK v2.0+. If you are using pods, add this to your Podfile:

pod 'QuickBlox'

Getting started

Example is included in repository. Try it out to see how chat view controller works.

Steps to add QMChatViewController to Your app:

Create a subclass of QMChatViewController. You could create it both from code and Interface Builder.
Open your subclass of QMChatViewController and do the following in viewDidLoad method:
- Configure chat sender ID and display name:
```
	self.senderID = 2000;
	self.senderDisplayName = @"user1";
```
- Set array of chat messages and reload collection view:
```
	self.items = <array of messages>;
	[self.collectionView reloadData];
```
Handle message sending.

- (void)didPressSendButton:(UIButton *)button
         withMessageText:(NSString *)text
                senderId:(NSUInteger)senderId
       senderDisplayName:(NSString *)senderDisplayName
                    date:(NSDate *)date {
  	// Add sending message - for example:
  	QBChatMessage *message = [QBChatMessage message];
  	message.text = text;
  	message.senderID = senderId;
  
  QBChatAttachment *attacment = [[QBChatAttachment alloc] init];
  	message.attachments = @[attacment];
  
  	[self.items addObject:message];
  
  	[self finishSendingMessageAnimated:YES];
  
   	// Save message to your cache/memory storage.                     
   	// Send message using Quickblox SDK
}

Return cell view classes specific to chat message:

- (Class)viewClassForItem:(QBChatMessage *)item {
   // Cell class for message
      if (item.senderID != self.senderID) {
          
          return [QMChatIncomingCell class];
      }
      else {
          
          return [QMChatOutgoingCell class];
      }
  
  	return nil;
}

Calculate size of cell and minimum width:

  - (CGSize)collectionView:(QMChatCollectionView *)collectionView dynamicSizeAtIndexPath:(NSIndexPath 	*)indexPath maxWidth:(CGFloat)maxWidth {
  
  	QBChatMessage *item = self.items[indexPath.item];
  
  	NSAttributedString *attributedString = [self attributedStringForItem:item];
  
  	CGSize size = [TTTAttributedLabel sizeThatFitsAttributedString:attributedString
          	                                       withConstraints:CGSizeMake(maxWidth, MAXFLOAT)
      	        	                        limitedToNumberOfLines:0];
  	return size;
  }

  - (CGFloat)collectionView:(QMChatCollectionView *)collectionView minWidthAtIndexPath:(NSIndexPath *)indexPath {
  	QBChatMessage *item = self.items[indexPath.item];
  
  	NSAttributedString *attributedString =
  	[item senderID] == self.senderID ?  [self bottomLabelAttributedStringForItem:item] : [self topLabelAttributedStringForItem:item];
  
  	CGSize size = [TTTAttributedLabel sizeThatFitsAttributedString:attributedString
                                                     withConstraints:CGSizeMake(1000, 10000)
                                              limitedToNumberOfLines:1];
  
  		return size.width;
}

Top, bottom and text labels.

  - (NSAttributedString *)attributedStringForItem:(QBChatMessage *)messageItem {
  	UIColor *textColor = [messageItem senderID] == self.senderID ? [UIColor whiteColor] : [UIColor colorWithWhite:0.290 alpha:1.000];
  	UIFont *font = [UIFont fontWithName:@"Helvetica" size:15];
  	NSDictionary *attributes = @{ NSForegroundColorAttributeName:textColor, NSFontAttributeName:font};

  	NSMutableAttributedString *attrStr = [[NSMutableAttributedString alloc] initWithString:messageItem.text attributes:attributes];
  
  	return attrStr;
  }

  - (NSAttributedString *)topLabelAttributedStringForItem:(QBChatMessage *)messageItem {
  	UIFont *font = [UIFont fontWithName:@"Helvetica" size:14];
  
  	if ([messageItem senderID] == self.senderID) {
      		return nil;
  		}
  		NSDictionary *attributes = @{ NSForegroundColorAttributeName:[UIColor colorWithRed:0.184 green:0.467 blue:0.733 alpha:1.000], NSFontAttributeName:font};
  
  	NSMutableAttributedString *attrStr = [[NSMutableAttributedString alloc] 	initWithString:messageItem.senderNick attributes:attributes];
  
      	return attrStr;
  }

  - (NSAttributedString *)bottomLabelAttributedStringForItem:(QBChatMessage *)messageItem {
  		UIColor *textColor = [messageItem senderID] == self.senderID ? [UIColor colorWithWhite:1.000 alpha:0.510] : [UIColor colorWithWhite:0.000 alpha:0.490];
  		UIFont *font = [UIFont fontWithName:@"Helvetica" size:12];
  
  		NSDictionary *attributes = @{ NSForegroundColorAttributeName:textColor, NSFontAttributeName:font};
  		NSMutableAttributedString *attrStr = [[NSMutableAttributedString alloc] initWithString:[messageItem.dateSent description]
                                         					    attributes:attributes];
  
  		return attrStr;
  }

Modifying collection chat cell attributes without changing constraints:

struct QMChatLayoutModel {
    
    CGSize avatarSize;
    CGSize containerSize;
    UIEdgeInsets containerInsets;
    CGFloat topLabelHeight;
    CGFloat bottomLabelHeight;
    CGSize staticContainerSize;
};

typedef struct QMChatLayoutModel QMChatCellLayoutModel;

size of the avatar image view
message view container size
top label height
bottom label height
static size of container view

You can modify this attributes in this method:

- (QMChatCellLayoutModel)collectionView:(QMChatCollectionView *)collectionView layoutModelAtIndexPath:(NSIndexPath *)indexPath {
	QMChatCellLayoutModel layoutModel = [super collectionView:collectionView layoutModelAtIndexPath:indexPath];
	// update attributes here

	return layoutModel;
}

So if you want to hide top label or bottom label you just need to set their height to 0.

Attachemnts

QMChatViewController supports image attachment cell messages. QMChatAttachmentIncomingCell is used for incoming attachments, QMChatAttachmentOutgoingCell is used for outgoing attachments. Both of them have progress label to display loading progress. XIB's are also included.

Questions & Help

You could create an issue on GitHub if you are experiencing any problems. We will be happy to help you.
Or you can ask a 'quickblox' tagged question on StackOverflow http://stackoverflow.com/questions/ask

Documentation

Inline code documentation available.

License

See LICENSE

#Coming soon CocoaPods distribution.

buithuyen/QMChatViewController-ios