hughperkins / requestpolicy

RequestPolicy is a Firefox extension that gives you control over cross-site requests. --- It has been developed until 2012 and is being continued since July 2014.

RequestPolicy Continued

About RequestPolicy

RequestPolicy is a Firefox extension that gives you control over cross-site requests. It does this through user-defined whitelists and blacklists. Users can also subscribe to policies (whitelists and blacklists) maintained by others.

For more information about RequestPolicy and cross-site requests, have a look at our website

This project

The RequestPolicy "Continued" project is a fork of RequestPolicy, which had been developed by Justin Samuel until 2012. Currently we aim at releasing our first stable version – 1.0 – but there is still much to do. If you want to be informed about this milestone, you could subscribe to this issue. If you're interested, here you can find a list of all open issues for version 1.0.

Getting the Source Code

If you'd like to download the RequestPolicy source code from our version control system, you can do so with:

git clone https://github.com/RequestPolicyContinued/requestpolicy.git

Building the XPI Firefox addon

Before building you need to install GNU Make as well as the npm package preprocessor. On a debian-based system you could run:

sudo apt-get install make npm
sudo npm install -g preprocessor

After preparation, run make from the repository's root directory. The XPI file will be created at dist/requestpolicy.xpi and can be used for easy installation of RP into your web browser (e.g. Firefox).

License

GPL v3

---

Contributing

Here are a few ways you can help make this project better!

Discussion

If you have any questions or general thoughts about the project, please post them in our general discussion

Testing, reporting bugs & requesting new features

Always use the latest release, or build the XPI from the most recent source revision

If you'd like a bug to be fixed or a feature added, find if it has already been reported. Open a new issue if needed, and add information about the bug/request such as:

• Steps to reproduce the bug (user actions)
• What should happen.
• What happens instead.

Response time from the maintainers should be around a few days.

Please bear in mind that each user might have a different browser setup. Sometimes it's necessary to further investigate the problem:

Some bugs are caused by other Firefox addons interfering with RequestPolicy. To make sure a bug is caused by RequestPolicy itself:

• Disable all other addons from Firefox's addon manager
• Try to reproduce the bug

If the bug does not happen with only RPC enabled, the bug is related to another addon:

• Re-enable one addon, test again.
• Repeat until the problem occurs again
• Report us the incompatible addon (with a link to the addon download page)

To test if the bug is related to your specific configuration, you can create a new, blank Firefox profile and try to reproduce the bug.

Code contributions

You can look through the existing bugs/requests here.

You can find bugs that should be easy to fix here.

More information on RequestPolicy development can be found here

Translations

You can help us translate our project by editing the locale files and sending us a Pull Request.

Documentation and website

You can help build and design the website and documentation here

Bug triage

You can help us find more info about unconfirmed bugs by finding if the bug is reproducible. In what environment? What are the steps to reproduce?

You can ask the maintainers to close already fixed bugs by testing old tickets to see if they are happening, or remove duplicate bug reports.

Donations

You can add bounties at bountysource for bugs you would like to be fixed.

Community and support

• You can help us answer questions our users have on the issue tracker
• You can write posts about the project, take screenshots and make videos, share RequestPolicy Continued on the Internet, show how it's used in daily life, and talk about it to your friends.