Community link-sharing and discussion app, originally built for USV.com.
Public dev list at https://groups.google.com/forum/#!forum/conversation-app
Built with:
Prior to installation, you'll need to do a few things:
- Twitter: Log into http://dev.twitter.com and set up a new application. Note the "consumer key" and "consumer secret", which we'll need later on.
- Disqus: Go to http://disqus.com/api/applications/ and set up a new application. Note the public and secret keys, which we'll use in config. You may also need to go to http://disqus.com/admin/create/ to create a new disqus "forum", which will house the comments for your site.
- Sign up for an account at http://sendgrid.com for email delivery
General app settings are controlled via the settings.py file. You will need to provide dev/local values for the following settings:
- 'twitter_consumer_key' : '',
- 'twitter_consumer_secret' : '',
- 'disqus_public_key': '',
- 'disqus_secret_key': '',
- 'disqus_short_code': '',
- 'sendgrid_user': '',
- 'sendgrid_secret': '',
- 'hackpad_oauth_client_id':'',
- 'hackpad_oauth_secret':'',
- 'hackpad_domain':'',
- 'google_api_key': '',
- 'bitly_access_token': '',
(the hackpad, google and bitly keys are optional)
- start a local instance of mongo
./mongod
-
OR, configure your app to use a cloud-based mongo instance, by setting "MONGODB_URL" and "DB_NAME" in settings.py
-
Start the web server:
python tornado_server.py
- Site should be viewable at http://localhost:8001
We've written up a heroku-specific deployment recipe here: https://github.com/unionsquareventures/theconversation/blob/master/documentation/heroku.md
Basic business logic, organization details, and other documentation can be found in the documentation folder.