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:

• CMB2
• CMB2 Attached Posts
• CMB2 Message Field
• CMB2 Password Field
• CMB2 Sort Field

Plugin Integrations

This theme hooks into the following plugins, should they be available:

• WordPress SEO
• MultilingualPress
• Multisite Global Media

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