<commit_before>LSNewsletterInvite
==================

LSNewsletterInvite is a simple newsletter invite popup that works with MailChimp to help you get more newsletter signups. 

You can drop LSNewsletterInvite into any iPhone or iPad app (iOS 5.0 or later) and it will give your users a simple and enticing path to sign up for your newsletter. This code is released under MIT/X11, so feel free to modify and share your changes.

What makes LSNewsletterInvite better?
=====================================

There are 3 main reasons we put together LSNewsletterInvite. Almost all of them have to do with the way developers were unintentionally making it harder to gain newsletter signups.

1. Presenting a newsletter signup **form at launch** is the single most effective way to get signups. Presenting an alert view that follows up with a newsletter form is terribly inefficient and results in far more users dismissing the chance to sign up than users subscribing. Imagine if 50-75% of your users were signing up for your newsletter rather than the 10% you're seeing now. That's what will happen with a form at launch.

2. Providing an **attractive form** makes the user feel more invited, and more likely to give you their data. LSNewsletterInvite is intended to be used to create a unique and attractive invite experience. So often, developers drop their users into a basic white and gray table view to sign up for the newsletter. Users respond so much more willingly to enticing marketing copy and images. LSNewsletterInvite allows you to add Title, Background, Invite, and Copy Images. We'll continue to share examples of how this library is used to make a more beautiful experience.

3. The **dismiss button** is un-obvious. Signing up for the newsletter shouldn't be forced. You want your users to want to get emails. However, by creating an un-obvious method of dismissal, more users are going to take the few seconds to give you their email address and name.

Let's be honest. LSNewsletterInvite is a simple wrapper around ChimpKit, it's a pretty way to present it, and takes almost as much work as using the tools ChimpKit gives you. Let's be even more honest. You're not doing the things you need to get consistent newsletter signups. Here's hoping that this tool at least gives you a nudge in the right direction.

>When you talk to your users (especially via email) they’ll become more active.
>Email your users. Frequently.
[@jkhowland](https://twitter.com/jkhowland/status/313721204282376192)

Getting Started
===============

1. Add the LSNewsletterInvite code (directory) to your project
2. Add ChimpKit and SVProgressHUD libraries to your project
3. Link your apps binary with the QuartzCore framework (this is for SVProgressHUD
4. Add a dictionary with the key "MailChimp" to your app info.plist file with the following settings:
     "MailChimpAPIKey" : "YOUR_API_KEY"
     "MailChimpListID" : "YOUR_LIST_ID"
5. Call `[LSNewsletterInvite appLaunched:YES viewConroller:__YOUR_VIEW_CONTROLLER__ andSettings:nil]` in your app delegates `didFinishLaunchingWithOptions:` method. The viewController is provided for the Invite to be presented.

The tool is made for easy customization. You can add custom images, as well as custom text to each of the fields.

You also have the option to manually initialize and present LSNewsletterInvite. An example of this is in the demo projected included with the library.

Better Settings
===============

As of version 0.6 the settings of the view controller can be updated by creating an instance of LSNewsletterInviteSettings and updating the properties of that object, then assigning it in the 'appLaunched' method or as the 'settings' property of an LSNewsletterInvite object you initialized yourself.

License
=======
Copyright 2013 [LearnStack]
This library is distributed under the terms of MIT/X11

[LearnStack]: http://learnstack.com<commit_msg>Added example images to Readme.md<commit_after>LSNewsletterInvite
==================

LSNewsletterInvite is a simple newsletter invite popup that works with MailChimp to help you get more newsletter signups. 

You can drop LSNewsletterInvite into any iPhone or iPad app (iOS 5.0 or later) and it will give your users a simple and enticing path to sign up for your newsletter. This code is released under MIT/X11, so feel free to modify and share your changes.

What makes LSNewsletterInvite better?
=====================================

There are 3 main reasons we put together LSNewsletterInvite. Almost all of them have to do with the way developers were unintentionally making it harder to gain newsletter signups.

1. Presenting a newsletter signup **form at launch** is the single most effective way to get signups. Presenting an alert view that follows up with a newsletter form is terribly inefficient and results in far more users dismissing the chance to sign up than users subscribing. Imagine if 50-75% of your users were signing up for your newsletter rather than the 10% you're seeing now. That's what will happen with a form at launch.

2. Providing an **attractive form** makes the user feel more invited, and more likely to give you their data. LSNewsletterInvite is intended to be used to create a unique and attractive invite experience. So often, developers drop their users into a basic white and gray table view to sign up for the newsletter. Users respond so much more willingly to enticing marketing copy and images. LSNewsletterInvite allows you to add Title, Background, Invite, and Copy Images. We'll continue to share examples of how this library is used to make a more beautiful experience.

3. The **dismiss button** is un-obvious. Signing up for the newsletter shouldn't be forced. You want your users to want to get emails. However, by creating an un-obvious method of dismissal, more users are going to take the few seconds to give you their email address and name.

Let's be honest. LSNewsletterInvite is a simple wrapper around ChimpKit, it's a pretty way to present it, and takes almost as much work as using the tools ChimpKit gives you. Let's be even more honest. You're not doing the things you need to get consistent newsletter signups. Here's hoping that this tool at least gives you a nudge in the right direction.

>When you talk to your users (especially via email) they’ll become more active.
>Email your users. Frequently.
[@jkhowland](https://twitter.com/jkhowland/status/313721204282376192)

Getting Started
===============

1. Add the LSNewsletterInvite code (directory) to your project
2. Add ChimpKit and SVProgressHUD libraries to your project
3. Link your apps binary with the QuartzCore framework (this is for SVProgressHUD
4. Add a dictionary with the key "MailChimp" to your app info.plist file with the following settings:
     "MailChimpAPIKey" : "YOUR_API_KEY"
     "MailChimpListID" : "YOUR_LIST_ID"
5. Call `[LSNewsletterInvite appLaunched:YES viewConroller:__YOUR_VIEW_CONTROLLER__ andSettings:nil]` in your app delegates `didFinishLaunchingWithOptions:` method. The viewController is provided for the Invite to be presented.

The tool is made for easy customization. You can add custom images, as well as custom text to each of the fields.

You also have the option to manually initialize and present LSNewsletterInvite. An example of this is in the demo projected included with the library.

Better Settings
===============

As of version 0.6 the settings of the view controller can be updated by creating an instance of LSNewsletterInviteSettings and updating the properties of that object, then assigning it in the 'appLaunched' method or as the 'settings' property of an LSNewsletterInvite object you initialized yourself.

Example Implementations
=======================

<img style="float:left;" hspace="30" width="200" src="https://raw.github.com/LearnStack/LSNewsletterInvite/master/LSNewsletterInviteDemo/LSNewsletterInviteDemo/Sample%20Images/Example-Default.png" alt="Default Image"> <img style="float:left;" hspace="30" width="200" src="https://raw.github.com/LearnStack/LSNewsletterInvite/master/LSNewsletterInviteDemo/LSNewsletterInviteDemo/Sample%20Images/Example-Rise.png" alt="Sunrise Image">  <img style="float:left;" hspace="30" width="200" src="https://raw.github.com/LearnStack/LSNewsletterInvite/master/LSNewsletterInviteDemo/LSNewsletterInviteDemo/Sample%20Images/Example-Kids-Game.png" alt="Kids Game Image">

License
=======
Copyright 2013 [LearnStack]
This library is distributed under the terms of MIT/X11

[LearnStack]: http://learnstack.com
{'fraction_non_alphanumeric': 0.07085968610915905, 'fraction_numerical': 0.013000702740688685, 'mean_word_length': 5.038896746817539, 'pattern_counts': {'":': 0, '<': 6, '<?xml version=': 0, '>': 10, 'https://': 5, 'lorem ipsum': 0, 'www.': 0, 'xml': 0}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 0, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '5636986', 'n_tokens_mistral': 2315, 'n_tokens_neox': 2115, 'n_words': 1181}