================================
HaveASec Wrapper Integration
================================


This is a fairly simple wrapper to use for the HaveASec survey for
iPhone applications designed to make adding feedback as painless as possible.

HaveASec: http://www.haveasec.com/


Overview
========

This wrapper enables an iPhone Application to:

1.  Open up a survey navigation controller embedded in current application. This survey only needs to make one server request to retrieve the survey (all the questions are loaded up front), then POST request to submit it. This design results in a fluid user experience.

2.  Let users take the HaveASec survey created by you.

3.  Using a delegate method, remove the survey so that users may return to enjoying the application.


Using the HaveASec Wrapper
===========================
See the wrapper in action by freely downloading: iDiscover (http://itunes.apple.com/WebObjects/MZStore.woa/wa/viewArtist?id=294770384)

1.  Add the HaveASecDist Folder to your project.

2.  Add the appropriate HaveASecLibs to your project (2.0 or 3.0)

3.  Initialize and open the Survey View Controller when appropriate (for example when a button is clicked -- also add #import "HaveASecViewController;"):
Ex:
HaveASecViewController *feedbackController = [[HaveASecViewController alloc] initWithShortCode:@"<your short code>" delegate:self uniqueIdentifier:nil];
[self presentModalViewController:feedbackController animated:YES];
[feedbackController release];

Note:<your short code> is the 6+ character at the end of the survey distribution url
Note:You may want to add a uniqueIdentifer (NSString) to correlate your users' responses.  If you select nil, the hardware id will be used.

4.  (Required) Delegate must respond to selector surveyDidEnd:.  
This is called is the user ends the survey.

Ex:
-(void)surveyDidEnd:(BOOL)completed{
	[self dismissModalViewControllerAnimated:YES];
}

5. (Optional) Delegate can respond to selector surveyTableStyle, surveyBackgroundColor, surveySeparatorColor, surveyTintColor, and surveyBarStyle

Ex:

-(UIColor *)surveySeparatorColor{
	return [UIColor redColor];
}
-(UITableViewStyle)surveyTableStyle{
	return UITableViewStyleGrouped;
}

- (UIColor *)surveyBackgroundColor{
	return [UIColor blackColor];
}

- (UIColor *)surveyTintColor{
	return [UIColor blackColor];
}


- (UIBarStyle)surveyBarStyle{
	return UIBarStyleBlackOpaque;
}


Contact Us
==========
Please feel free to contact us at support@haveasec.com with any bugs or suggested improvements.