Humanity Theme
This is the home of Amnesty International's WordPress theme, which is currently in production use on over 30 sites.
If you'd like to use it yourself, see the usage section.
If you'd like to contribute to the theme, see the contributing.
Minimum Requirements
This theme requires:
- WordPress 5.8+
- PHP 8.2+ with the Intl extension
Required Plugins
We currently rely upon CMB2 and CMB2 extensions for settings management, but our eventual goal is to remove these dependencies.
Our full list of dependencies is below:
Plugin Integrations
This theme hooks into the following plugins, should they be available:
Companion Plugins
Plugins which can be used to extend the theme with additional functionality, originally designed specifically for Amnesty International.
Donations
The Donations plugin works in conjunction with WooCommerce to provide the capability to accept one-off and recurring donations.
Petitions
The Petitions plugin provides the capability to create, curate, and manage petitions.
Image Credit
The Image Credit plugin adds support to the theme for automatic output of media copyright information (from the image description field) on the site frontend. The plugin uses a lookup table, which can be pre-populated using WP CLI, to make the image lookup from its URI blisteringly fast, instead of the much slower meta lookup.
Media Copyright
The Media Copyright plugin will ensure that images that do not have copyright attribution are not allowed to display on the site.
Usage
The quickest way to get started using the theme is to download the zip of the latest release, and install it via upload directly within WP Admin -> Themes.
We recommend your site be configured as a multisite, both for future-proofing, and for more granular user permissions control. Many of the theme's customisation options make more sense at the network-level, too.
Governance
See GOVERNANCE.md for project governance information.
Changelog
See CHANGELOG.md or Releases page for full changelogs.
Contributing
For information on how to contribute to the project, or to get set up locally for development, please see the documentation in CONTRIBUTING.md.
Special Thanks
We'd like to say a special thank you to these lovely folks:
| Cure53 | WP Engine |
|---|---|
 |
 |
Want to know more about the work in other Amnesty GitHub accounts?
You can find repositories from other teams such as Amnesty Web Ops, Amnesty Crisis, Amnesty Tech, and Amnesty Research in their GitHub accounts
