Articles in this section

Using We Vote on your Website in an HTML Frame

Avatar
We Vote Help Center
  • Updated
Follow

This article describes how you can place any page on www.WeVote.US on your organizational website.

We Vote Pages We Recommend

  1. Interactive Ballot. Show a voter what is on their ballot. This is the base URL to use: https://WeVote.US/ballot
  2. Interactive Ballot, Customized for your Organization. Show a voter what is on their ballot, with your own logo and several other settings. After you sign into We Vote (preferably with your organization's Twitter sign in / login), go to "Your Settings" and choose a custom domain, plus several other customization options.
  3. Voter Guide. Let voters know what you think they should support or oppose. In order to share your opinions, you can use "WeVote.US" plus your Twitter handle. So if you are the ACLU, the base URL to use to share your voter guide is: https://WeVote.US/ACLU

Supported URL Variables

By adding any of these URL variables after the base URL, you can modify the behavior of We Vote.

  • id=
    This id can be any string or number that you use to identify a person within your organizational database. This is the id we call "external_voter_id" when you are requesting analytics using the API organizationAnalyticsByVoter.
  • voter_address=
    We Vote automatically geolocates each voter (City, State + ZIP) based on the IP address of the device the voter is using, but if you have a full address, you can pass it into We Vote. By passing an address in the URL, you are telling We Vote to show the ballot for that address for the next election (or the ballot for the most recent election if the data for the next election isn't ready yet). We recommend URL-encoding the address, like this: voter_address=New%20York%2C%20NY

Sample HTML Code with Frame

Here is a sample web page that shows how to add a frame to one of your HTML pages. Replace the "https://wevote.us..." URL right after this code "<iframe src=" with the URL and variables that best fit your needs.

<!DOCTYPE html>
<html lang="en">
<head>
<meta name="viewport" content="width=device-width, initial-scale=1, maximum-scale=1, user-scalable=no">
<title> We Vote Frame Example </title>
<meta charset="utf-8">
</head>

<body>
<iframe src="https://wevote.us/ballot?partner=cpdaction&campaign=free-tools&we_vote_branding_off=1&hide_intro_modal=0&voter_address=New%20York%2C%20NY&af=cpdaction" frameborder="0"  style="overflow:hidden;overflow-x:hidden;overflow-y:hidden;height:500%;width:100%;position:absolute;top:0px;left:0px;right:0px;bottom:0px" height="500%" width="100%"></iframe>,<script type="text/javascript" src="//cdnjs.cloudflare.com/ajax/libs/iframe-resizer/3.5.3/iframeResizer.min.js"></script>,<script type="text/javascript">iFrameResize({ log:true, checkOrigin:false});</script>
</body>

</html>

Notes

On the first visit to We Vote with the above URL variables, we use the information to configure the display of We Vote, and then we remove these variables from the URL. 

Comments

0 comments

Article is closed for comments.