Contents

1. GotToVote! Registration Centres

The first of the GotToVote! components to be built. This allows easy display and finding of registration centers.

Demo: http://rci.gottovote.cc/

1.1. Requirements

GotToVote! Registration Centres uses:

1. Github Pages - Serve the HTML
2. Fusion Tables - Store the database of registration centres

As such, you would need Github and Google accounts respectively. Both are free.

To test the webserver on your own machine, you will need to install Jekyll.

1.2. Installation

Start by creating a fork of GotToVote! RCI repository.

Once done you can clone your version onto your local machine.

git clone https://github.com/[username]/GotToVote-RCI.git

To see it in action almost immediately run:

cd GotToVote-RCI
jekyll serve

That’s it. If you visit http://localhost:4000/ you’ll see a vanilla version of GotToVote! Ghana.

1.3. Data Loading

1.3.1. Structure the Data

Make sure that the data is the following column order and format:

• Id
  • Type: number
  • Description: Unique identifier of each row of data.
• Region_Code:
  • Type: number
  • Description: Unique identifier per region. This is the top most administrative boundary level.
• Region_Name:
  • Type: text
  • Description: Matched to the region code.
• District_Code:
  • Typer: number
  • Description: Unique identifier per district. Administrative boundary level after the region. Region is bigger and could have many districts.
• District_Name:
  • Type:text
  • Description: Relating to district code.
• Electoral_Code:
  • Type: number
  • Description: Unique identifier per electoral administrative boundary level after district. Electoral area is smaller than a district. Many electoral areas make a district.
• Electoral_Name:
  • Type: number
  • Description: Electoral area name relating to the electoral code.
• Reg_Centre_Code:
  • Type: number
  • Description: Unique identifier for each registration centre.
• Reg_Centre_Name:
  • Type: text
  • Description: Registration centre name
• Other_Polling_Stations (Optional):
  • Type: text
  • Description: Most registration centres happen to be polling stations but not all polling station are registration centres. This column can be added to create more polling stations.

Sample of the above data structure can be found here.

You can use whatever tools you wish to use for the structuring of data, and we recommend using either Google Sheets or Open Refine, or a combination of both. MS Excel is fine too.

Once done, export the data in CSV or TSV format.

1.3.2. Import into Fusion Tables

The data for GotToVote! Registration Centres lives on Fusion Tables. If you’re not familiar with Google Fusion Tables, try the Tutorials.

Create a new fusion table and Import the CSV (or TSV) from your computer.

1.3.3. Access Data via Fusion Tables API

The Fusion Tables REST API provides an easy way to query our table without having to load the entire dataset.

For GotToVote! Registration Centres, we need two things:

1. Google API Key [Steps]
2. Table ID [Reference]

Follow the getting started guide here for more information.

So that the data is accessible, make sure the table access permissions is not Private.

Once done, edit the _config.yml file as follows:

# GotToVote Config

country: "YOUR_COUNTRY_NAME"
election_year: "ELECTION_YEAR"

registration_end_date: "REGISTRATION_END_DATE"

api_key: "YOUR_GOOGLE_API_KEY"
table_id: "YOUR_FUSION_TABLE_ID"

google_analytics: 'YOUR_GOOGLE_ANALYTICS_TRACKER'

...

1.4. Deployment

Now you’re ready to rumble. If you would like to see the platform in action on your local machine, simply open the folder in terminal or command prompt and run jekyll serve. You should then be able to see your version of GotToVote! Registration Centres on http://localhost:4000/.

To deploy using Github Pages, just commit and push your latest changes and the platform should be available at http://[YOUR_USERNAME].github.io/GotToVote-RCI/

To use a custom URL e.g mycountry2015.org follow the steps here.

We are also very much willing to make mycountry.gottovote.cc available to you so please reach out to hello[at]gottovote[dot]cc.

Contact

Any questions on setting up GotToVote? Get in touch at support[at]gottovote[dot]cc