A collaboration to build an open-source solution for creating patient-powered research networks.
Make sure you have reviewed and installed any prerequisites.
gem install bundler
This README assumes the following installation directory: /var/www/opn
cd /var/www
git clone https://github.com/openpprn/opn.git
cd opn
bundle install
Install default configuration files for database connection, email server connection, server url, and application name.
ruby lib/initial_setup.rb
bundle exec rake db:migrate RAILS_ENV=production
bundle exec rake assets:precompile RAILS_ENV=production
To set up your secret keys, run
figaro install
Add the following lines to the /config/application.yml file it generates and modify them accordingly. Add the appropriate keys you've gotten from the third party developers. For any service you aren't using, you can leave the lines out:
pprn: "ccfa"
pprn_title: "CCFA Partners"
pprn_condition: "Crohn's & Ulcerative Colitis"
pprn_conditions: "Crohn's, Ulcerative Colitis"
pprn_support_email: "support@ccfapartners.org"
oodt_enabled: "true"
validic_enabled: "true"
uservoice_api_key:
google_analytics_web_property_id:
validic_access_token:
validic_organization_id:
oodt_username:
oodt_password:
Open PPRN.rb to
- Configure the basic information about your PPRN
- Enable or Disable Validic and OODT
Run Rails Server (or use Apache or nginx)
rails s
Open a browser and go to: http://localhost:3000
All done!
If you are deploying to heroku, to get your application.yml loaded into heroku environment configuration (required to function), do
figaro heroku:set -e production
If you are just doing test installs or demonstrations of the website, you may want to start with some seed data. Some combination and/or all of these below should get you started:
rake db:seed
rake surveys
rake legacy_seed
The main navigation of the application is structured like so (in controller#action/view_name format):
- Home#Index
- Research#Index
- HealthData#Index
- Members#Index
If you want to edit any of the major views, you'll find them in the app/views/home, app/views/research, app/views/health_data, & app/views/members directories in .html.haml formats (eg. app/views/home/index.html.haml is the logged-in home page)
Each of those directories contains related partials that are used to help support the views, named with a leading underscore, eg. _tutorial.html.haml, which is the tutorial accessible by tab on most of the major views.
The logged out homepage is Static#Splash (can be found in app/views/static/splash.html.haml). Other static (about/tos/pp) and content pages (lots of text about the network) can be found in this same directory.