|Vivian Brown 0552141317 Merge pull request #433 from EFForg/rm18595-rate_limit_subscriptions||2 months ago|
|.ebextensions||3 years ago|
|app||3 months ago|
|bin||3 years ago|
|config||2 months ago|
|db||7 months ago|
|docker||9 months ago|
|features||5 months ago|
|lib||6 months ago|
|public||5 months ago|
|script||10 months ago|
|spec||5 months ago|
|vendor||9 months ago|
|.csslintrc||2 years ago|
|.dockerignore||2 years ago|
|.env.example||9 months ago|
|.eslintignore||2 years ago|
|.eslintrc||2 years ago|
|.gitignore||10 months ago|
|.rubocop.yml||10 months ago|
|.ruby-gemset||3 years ago|
|.ruby-version||2 years ago|
|.sass-lint.yml||10 months ago|
|.travis.yml||9 months ago|
|Dockerfile||6 months ago|
|Gemfile||8 months ago|
|Gemfile.lock||2 months ago|
|LICENSE||3 years ago|
|README.md||9 months ago|
|Rakefile||9 months ago|
|config.ru||10 months ago|
|docker-compose.yml.example||10 months ago|
|package.json||10 months ago|
|varnish.vcl||5 months ago|
|yarn.lock||10 months ago|
The Action Center Platform is an online organizing tool maintained by EFF. Administrators can create targeted campaigns where users sign petitions, contact legislators, and engage on social media.
Follow these instructions to run the Action Center using Docker (recommended). To run the Action Center without Docker, see setup without Docker.
git clone https://github.com/EFForg/action-center-platform.git
.env. Fill in the variables in
.envaccording to the instructions in that file. See notable dependencies for hints.
sudo docker-compose build
sudo docker-compose up
sudo docker-compose exec app bash.
rake db:migrateto migrate the database.
rake congress:updateto populate CongressMember table.
To add a new icon to the fontset, read the Update your existing fontello font section of the fontello_rails_converter readme.
Action Center administrators can create four types of actions:
To get started using the Action Center, create a user and grant them admin privileges. Administrators can create, track, and manage campaigns.
To create an admin user:
registerlink in the top nav.
rake users:add_admin[firstname.lastname@example.org]New users will need to complete an e-mail confirmation in order to log in. Administrators can access admin features by clicking
adminin the nav.
To remove an admin user:
To list all admin users:
Action Center uses DelayedJob to perform certain tasks outside of a web request context. See that repository for information regarding how to run a delayed job worker. If you are deploying with Docker, our docker-compose.yml.example shows how to create a service which processes the job queue indefinitely.
You may also want to automate certain other tasks (such as
rake signatures:deduplicate and
rake congress:update) to run occasionally. For those deploying with Docker, docker-compose.yml.example illustrates how to create a service which runs these commands periodically using cron.
Embedding actions is simple. Just include the following HTML on the page you want the action to be embedded:
The link href should point to the action page you wish to embed. You may add
?nosignup=1 to the URL to get newsletter signup fields omitted from the action.
If you want to get fancy, you can modify the embed code to include some of the following parameters, all of which are optional:
To run the full test suite, simply run
rake with no arguments.
We use WebMock to stub backend requests to third party services and Puffing Billy to stub frontend (Ajax) requests. Puffing Billy will cache unrecognized requests and play them back during future test runs. To prevent Puffing Billy from making any new requests, set
rake will also run our linting:
Sass-lint checks for consistent style across the stylesheets. Our .sass-lint file is derived from SEC.
For notes related to deploying Action Center in production, see the project wiki.
This project was created by Lilia Kai, Thomas Davis, and Sina Khanifar. Large portions of the codebase are directly attributable to them, while under the employ or contractorship of the Electronic Frontier Foundation in 2014. Thank you Lilia, Thomas, and Sina! The Action Center is currently maintained by the EFF Engineering and Design team.
LICENSE file for licensing information. This is applicable to the entire project, sans any 3rd party libraries that may be included.