codeforamerica / civic-issue-finder

UNMAINTAINED. An embeddable widget to find issues on the Code for America API
http://www.codeforamerica.org/geeks/civicissues
33 stars 15 forks source link

civictechbatsignal

Civic Issue Finder

The easiest way to get started with civic hacking. This is a small, embeddable, and customizable web app that makes it easy to find open GitHub Issues from across the civic technology movement. It fetches data from the Code for America API.

How to get your Issues included

  1. Get your group included on the CfAPI. Don't worry if your group isn't a Brigade. We're glad to have you!
  2. Ensure your project is included in your group's projects on the CfAPI. Ask your Captain or Delivery Lead how they included projects or check the projects_list_url column for your group on the Group Information sheet.
  3. Create GitHub Issues for your projects. Make sure they are easy to understand. Create and use appropriate GitHub labels. We recommend using "help wanted" whenever it is as we display these issues on the most sites.
  4. The CfAPI updates once an hour. Check back to see if your Issues appear. Send a message to @ondrae if you need help.

How to Use

This widget can be accessed directly, or it can be embedded into any webpage with the code generated by our embed tool.

Summary Video

![Kind of long and boring] (https://img.youtube.com/vi/CYrpA76xzfA/0.jpg)

Blog Post

https://www.codeforamerica.org/blog/2014/10/30/the-civic-tech-issue-finder/

The Embed Code

<iframe src="https://www.codeforamerica.org/geeks/civicissues/widget" width="100%" height="600" frameBorder="0"> </iframe>

The url in the src attribute of the iframe can be given the following query params to customize your widget

Note: On Code for America sites, please include the tracking=false parameter, so that we don't double up on our Google Analytics page views.

Installation

The CFAPI is built on Flask and Python with a little bit of Javascript. The app.py file describes the routes. The templates have the html. main.js helps out the embed form.

Contacts

Copyright

Copyright (c) 2014-2015 Code for America.