=== CongressLookup === Contributors: ConstructiveGrowth, Quick2ouch, gsnarawat, trishahdee Donate link: https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=3ZSYXP8PLH6AJ Tags: congress, lookup, senator, representative, US congress, find senator, find representative Requires at least: 3.0 Tested up to: 3.9.1 Stable tag: 2.0 License: GPLv2 or later License URI: http://www.gnu.org/licenses/gpl-2.0.html Give your visitors the ability to lookup US Congress members for specific zip codes and addresses. == Description ==

CongressLookup is a free WordPress plugin giving your site visitor an easy way to find United States congressional representatives. CongressLookup makes it easier to launch a grassroots campaign for your favorite cause and will keep your visitors on your site instead of sending them to elsewhere to find their legislators.

Where The Data Comes From
CongressLookup uses data provided by Google Maps GeoCoding API and Sunlight Foundation APIs. For more information and how to obtain your API key see the FAQs.

Google Maps GeoCoding API
By using this plugin you are bound by the Google Maps terms of use. Google GeoCoding API limits use to 2,500 requests per IP address per day. We have added a cache feature (default setting is 30 minutes) you can set to reduce the number of requests made to the API. If you anticipate 2,500 is not enough for your site, please contact us about a custom solution.

Sunlight Foundation APIs
CongressLookup uses free databases provided by the Sunlight Foundation through the use of an API key registered to the site it will be used on. To obtain one for your site, create a free account and it will be emailed to you.

The following information can be displayed for each legislator. You can turn any of these on/off in the Admin settings: Birthdate, Congresspedia URL, District, Email, Fax, Gender, Picture, Phone, State, Title, Webform, and Website.

Using CongressLookup Plugin
The minimum information needed to get results is a 5-digit zip code. However, some zip codes cover more than one congressional district so the more of the address is entered the more accurate the results will be.

CongressLookup is implemented on your WordPress site with use of a shortcode. See the Quick Start Guide and FAQs for more information.

Customizing The Look of the Plugin
There are three theme options available: No Theme, Modern and Custom Theme.

Support
Please use the CongressLookup plugin support tab on the WordPress.org website. Keeping support questions and answers public helps everyone. But feel free to contact us here for any other help you may need.

Official Website
http://congresslookup.com

== Installation == 1. Unzip `CongressLookup.zip` and Upload folder to the `/wp-content/plugins/` directory 1. Activate the plugin through the 'Plugins' menu in WordPress 1. Or in your Plugin page "Add Plugin" search: enter "CongressLookup" then install and activate. 1. To obtain a free Sunlight Labs API key for your site, create a free account and it will be emailed to you. 1. IMPORTANT: Click the activation link in the Sunlight Labs email. 1. Enter API key and configure in: WP Admin > Settings > CongressLookup 1. Use the following shortcode in a page or post: `[CongressLookup]` 1. Use the following code in your template, placed outside the loop:
`` == Frequently Asked Questions == = Why does it take so long for CongressLookup to install on my site? = As per the terms of use for legislator photos from Sunlight Labs, you can not directly link (hotlink) to their site. Therefore, you must host the images locally on your server. We include the copy of the photos zip file with the plugin and, because of it’s size, may cause the plugin to install slower then you are used to.

= Where does the legislator information comes from = CongressLookup uses data provided by both Google GeoCoding API and Sunlight Foundation APIs.

= What are Google Maps API Terms of Use? = By using this plugin you are bound by both the Google Maps terms of use and the Google GeoCoding API terms of use. The information presented here and on our website is for informational purposes only and is not intended to be legal advise.

= Why use Google Maps GeoCoding API? = Google GeoCoding API is used to obtain the longitude and latitude of a particular address. This is the most accurate way to determine within which legislative districts an address is located.

= How accurate is Google GeoCoding data? = GeoCoding is not 100% accurate. Sometimes an entered address will not return the correct location. For this reason, we have included a Google Map the visitor can use to verify the location is correct.

= What if the map location is different from the address entered? = The plugin’s Google map has a movable pointer you can click and drag to more accurately target the desired location. The address in the input window (and the corresponding legislators) will automatically recalculate each time the red marker is repositioned.

= How do I tell Google their information is wrong? = You can tell Google of any inaccuracies by clicking the link in the lower right corner of the map: “Report a map error”.

= Are there limits on how many addresses can be looked up with CongressLookup plugin? = We, the developers, created CongressLookup plugin to be free and do not limit how much you can use it, however, both Google GeoCoding and Sunlight Labs have restrictions and/or limits imposed when using their APIs. Please consult their websites for more information on the legal use of their APIs.

= What are the Google GeoCoding API limitations? = Google GeoCoding API limits its use to 2,500 requests per IP address per day.

= How does the CongressLookup Admin cache setting help with the Google GeoCoding limit? = We have added a cache feature you can set to reduce the number of requests made to the API. The default setting will clear the cache every 30 minutes. If you anticipate 2,500 requests per day will not be enough for your site, even with the caching, please contact us about a custom solution.

= What is the Sunlight Lab API used for? = CongressLookup uses free databases provided by the Sunlight Foundation whose mission is to make government more transparent and accessible. Part of what they do is maintain free databases of information about the US government. We make use of their legislator information and legislator photos databases in CongressLookup plugin. From Sunlight Labs website:
Sunlight Labs takes data inside and about government and transforms it into services developers can use. We do it for free because we think that if people can see what’s going on, it makes the country better. It might not sound like the most glamorous life ever, but it’s pretty great for us, as long as you make use of it.
= Why do I need my own Sunlight Labs API key? = You must use your own API key because it is required by their terms of service:

Usage of Sunlight Services depends upon an API key which should only be used by the individual/organization which requested it. Sharing or distribution of API keys is not permitted.
= How do I get a Sunlight Lab API key? = To obtain a free API key for your site, create a free account and it will be emailed to you.

= How do I use the Sunlight Lab API key? = Simply enter and save it on the CongressLookup Admin Settings page. = Where is the CongressLookup settings page located? = WP Admin > Settings > CongressLookup = Why must I host the legislator photos on my site? = As per the terms of use for legislator photos from Sunlight Labs, you can not directly link (hotlink) to their site. Therefore, you must host the images locally on your server. We include the copy of the photos zip file with the plugin and, because of it’s size, may cause the plugin to install slower then you are used to.

= Why are the pictures not showing or are the wrong pictures? = Members of Congress change after elections and sometimes leave or are replaced midterm. When this happens, your locally hosted zip file of their pictures needs to be updated to stay accurate. There is a button in the plugin Admin settings to download the most recent copy of the picture zip file. Note: when the Sunlight Labs picture folder changes, you will receive a notice in your WP Admin to update the pictures.

= What legislator information can be displayed? = The following information can be displayed for each legislator. You can turn any of these on/off in the Admin settings:

= How much information must be entered in the address field to get results? = Minimum information needed is a 5-digit zip code. However, some zip codes cover more than one congressional district so the more of the address is entered, the more accurate the results will be.

= Can I change the look of the plugin? = There are three themes to choose from:

= How do I use CongressLookup on my site? = Use the following shortcode in a page or post:

[CongressLookup]

Use the following code in your template, outside of the loop:

<?php echo do_shortcode("[CongressLookup]"); ?> = How do I contact support? = Please use the CongressLookup plugin Support Tab above. Keeping support questions and answers public helps everyone. But feel free to contact us here for any other help you may need.

Official Website
http://congresslookup.com

== Screenshots == 1. CongressLookup frontend with Modern theme screenshot-1.jpg 1. WP Admin > Settings > CongressLookup screenshot-2.jpg == Changelog == = 2.0 = * Update 15 May 2014 Replaced the use of deprecated Sunlight Labs Congress API with more comprehensive Sunlight Congress API. Added more congressperson stats, now available from new API, with checkboxes in admin. Added ability for admin to choose to display only Senators, only Representatives, or both (default) from a dropdown menu in admin. Minor CSS changes = 1.0 = * Original version, 23 August 2012 == Upgrade Notice == = 2.0 = Upgrade is necessary before the 2014 Congress inauguration (January 2015), which is when the deprecated Sunlight Foundation Congress API will stop working.