Skip to content
Keeping tabs on the UK's parliaments and assemblies
Python PHP HTML C CSS Perl Other
Latest commit e09edd6 Apr 29, 2016 @zarino zarino committed with struan Replace footer with standard mySociety footer
This loses a few features in the migration – mainly the links to regional
assemblies, international PMOs, and the twitter/facebook widgets.

Fixes #1095
Failed to load latest commit information.
bin Use bundle to install/run compass instead of gem. Mar 13, 2015
classes Limit total length of popular search terms to 2000 characters May 19, 2016
commonlib @ de3f256 Replace legacy className() constructors with future-proof __construct() Aug 24, 2015
conf Add gzip to JS/CSS files. Oct 29, 2015
db Update redirect column length to match actual length. Apr 22, 2016
flex Update build script with new URL for SDK Jan 13, 2014
foundation @ a2a3901 Switch to using Foundation v4.2.3 via a submodule Jun 30, 2014
googleappengine copy change/ change newsletter/mailing list/URL Dec 17, 2014
puphpet [Vagrant] Make sure engine/encoding match server. Dec 4, 2015
scripts Handle speeches with speakername and no person_id. May 20, 2016
search Add exemptions for special post-leaving answers. May 22, 2015
tests Fix party stance text for single member parties Feb 23, 2016
uml-tests Remove most of uml-tests directory. May 31, 2013
www Replace footer with standard mySociety footer May 24, 2016
.gitignore Automatically generate documentation using PHPDoc Oct 27, 2015
.gitmodules Switch to using Foundation v4.2.3 via a submodule Jun 30, 2014
.scrutinizer.yml Increase code coverage timeout. May 21, 2015
.travis.yml [Travis] Don't compile docs on pull requests. Mar 30, 2016
CONTRIBUTING.md Add contributing document. Jul 13, 2015
Gemfile Use bundle to install/run compass instead of gem. Mar 13, 2015
Gemfile.lock Use bundle to install/run compass instead of gem. Mar 13, 2015
INSTALL.md Split out person loading to separate script. Apr 14, 2015
LICENSE.md Fix incorrect name in LICENCE.md Mar 3, 2014
README.md Clarifications and corrections to README.md. Sep 14, 2015
Vagrantfile Improvements to the Vagrant box: Feb 13, 2015
build-docs.sh Automatically generate documentation using PHPDoc Oct 27, 2015
composer.json Update PHPUnit dependency version to 4.8, update Dependencies. Aug 24, 2015
composer.lock Fix broken composer symfony/config hash. Mar 30, 2016
composer.phar Update Composer to latest version. Aug 24, 2015
phpdoc.dist.xml Automatically generate documentation using PHPDoc Oct 27, 2015
phpunit.xml Remove the suppression of errors causing PHPUnit hard failures. Oct 4, 2014

README.md

Hello everyone,

If you're looking to set up a new Parliamentary monitoring site then you should look at our Pombola probject at http://www.mysociety.org/international/pombola/ which takes the lessons we've learned from writing and running TheyWorkForYou and uses them to create a modern, flexible and more easily adaptable platform for creating your own Parliamentary monitoring site. We strongly encourage people to use this rather than trying to adapt TheyWorkForYou to their own requirements.

If you want to dig in to the source of TheyWorkForYou then carry right on below.

We're pleased to release the TheyWorkForYou.com source code. This is the code for the website itself. It's mainly written in PHP, although there are also some Perl scripts for database loading and indexing. The backend parser code is separate and available on GitHub. You can read more about this on TheyWorkForYou's parser info page

The TheyWorkForYou.com source code in this distribution is released under a BSD style license. Roughly, this means you are free to copy, use, modify and redistribute the code or binaries made from the code. Commercial or non- commercial use is allowed. However, we disclaim warranty, and expect you not to use our name without our permission.

See the file LICENSE.md for exact legal information.

What is TheyWorkForYou.com anyway?

Everything MPs say in the UK's House of Commons is recorded in a document called Hansard. TheyWorkForYou.com helps make sense of this vital democratic resource and, crucially, allows you to add your own annotations and links to the official transcripts of Parliament.

How on earth do I use this code?

See INSTALL.md for installation questions.

If you have questions, the best place to ask is the mySociety TheyWorkForYou email list at https://groups.google.com/a/mysociety.org/forum/#!forum/theyworkforyou

Developing with Vagrant

You will need the latest versions of VirtualBox and Vagrant, then:

  • Stick an entry in your hosts file to point twfy.mysociety at 192.168.88.10 (Apache doesn't like IP addresses).
  • Run vagrant up.
  • Go make a cup of tea. It may take a while whilst Vagrant and Puppet do their thing.
  • Point your web browser at http://twfy.mysociety and marvel at modern technology.

Compiling Static Assets

If you're working on a page which uses the redesign, you will need to compile static assets after changes:

  • vagrant ssh
  • cd /data/twfy/www/docs/style
  • compass compile for a one-off compilation or compass watch to recompile on changes

Testing

TheyWorkForYou includes a test suite, using PHPunit. To run tests, ensure that the environment variables TWFY_TEST_DB_HOST, TWFY_TEST_DB_NAME, TWFY_TEST_DB_USER and TWFY_TEST_DB_PASS are set and contain relevant information for your testing database. The database will be stripped down and rebuilt during testing, so make sure it's not an important copy.

You may find that in some versions of PHPUnit errors are thrown regarding code coverage reports. If this is the case, the version installed by Composer and located at /vendor/bin/phpunit should run correctly.

Build Status

Build Status

Code Coverage

Scrutinizer Quality Score

mySociety Installability

Something went wrong with that request. Please try again.