App The Vote Files

AppTheVote README


NOTES
I was inspired by the "Rock The Vote" campaign to develop code to encourage US Citizens to 
participate in the 2012 Federal elections.  My goals were to develop the tiniest, 
most benign code, that could be re-used by other app developers with the barest 
minimum of effort.


This code 
1.  Determines if the device is being used in the United States, without using GPS or any other external information.
2.  Whenever the app enters the foreground, if the 2012 US Federal elections are about to take place
    it displays a reminder to the user to vote on November 6th, unless the user has already been reminded.

USAGE
To add "App The Vote" functionality, simply add the three files into your XCode iOS project.   That's it.  
No changes are required to your project.  The sole exceptions (possibly) are 
Open/GL based apps and apps that do not use the standard UIView hierarchy for their GUI. 


SAMPLE PROJECT
The sample project can be used to see how to use the code (just include it) and what the reminder
popup looks like.  To force the pop-up to display, edit AppTheVote.h to set the debug flag to YES


LICENSE
This software is open source, and may be used/modified/changed in any project.  A note to the developer 
(terrygconsulting@gmail.com) would be nice, but is not required.


BUGS
None known.  Code passes all static analyzer test without any issues.


SUGGESTED FEATURES
It would be nice if multiple apps using this code could communicate between them, to prevent users
from receiving multiple reminders from different apps.  However, I was unable to determine a 
mechanism to do this, under iOS, that can be done with drop-in code at runtime.


DISCLAIMER
The code has been tested on as many devices as I can get my hands on -- iPhones and iPads in landscape and portrait orientations.  
Since there are so many variables in software production, test with your own projects to ensure the code
works as described. 


CREDIT
Developed by Terry Grossman (terrygconsulting@gmail.com)