Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/amnestywebsite/humanity-petitions-salesforce-adapter
https://github.com/amnestywebsite/humanity-petitions-salesforce-adapter
Last synced: 4 days ago
JSON representation
- Host: GitHub
- URL: https://github.com/amnestywebsite/humanity-petitions-salesforce-adapter
- Owner: amnestywebsite
- License: other
- Created: 2024-02-13T14:20:22.000Z (9 months ago)
- Default Branch: develop
- Last Pushed: 2024-02-28T14:52:54.000Z (9 months ago)
- Last Synced: 2024-04-29T23:51:52.140Z (7 months ago)
- Language: PHP
- Homepage:
- Size: 51.8 KB
- Stars: 0
- Watchers: 3
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE.md
- Code of conduct: CODE_OF_CONDUCT.md
- Security: SECURITY.md
- Governance: GOVERNANCE.md
Awesome Lists containing this project
README
# Amnesty Petitions Salesforce Adapter
This is a companion plugin for the primary [Humanity Petitions](https://github.com/amnestywebsite/humanity-petitions) plugin, which adds support for submitting donation data directly to Salesforce via their HTTP REST API, instead of storing it within the WP database.
## Minimum Requirements
This plugin requires:
- WordPress 5.8+
- PHP 8.2+ with the Intl extension
- [Humanity Theme](https://github.com/amnestywebsite/humanity-theme) v1.0.0+
- [CMB2](https://github.com/CMB2/CMB2)
- [CMB2 Message Field](https://github.com/amnestywebsite/cmb2-message-field)
- [CMB2 Password Field](https://github.com/amnestywebsite/cmb2-password-field)
- [Humanity Petitions](https://github.com/amnestywebsite/humanity-petitions) v1.0.0+
- [Salesforce Connector](https://github.com/amnestywebsite/humanity-salesforce-connector) v1.0.0+
## Installation
The quickest way to get started using the plugin is to download the zip of the [latest release](https://github.com/amnestywebsite/humanity-petitions-salesforce-adapter/releases/latest), and install it via upload directly within WP Admin -> Plugins.
## Configuration
Once activated, this plugin adds a settings page below the primary Salesforce Settings page in Network Admin. If you haven’t configured the Salesforce Connector plugin, do that first.
Once setup has been completed, you’ll start seeing data within Salesforce as soon as your users start submitting petition signatures. By default, the plugin creates a new Campaign in Salesforce for each petition. Each signatory is created or updated as a Contact, and the Contacts are added as Campaign Members on the appropriate petition.
To configure alternative objects, choose the “Customise” option in the settings.
Four sections will become visible, which control each of the different aspects of the data that can be recorded. Each section has some contextual information which should clarify the different options available. Select which Salesforce Object types each of the data types should be saved as, and the appropriate fields. The plugin will handle the rest.
## Governance
See [GOVERNANCE.md](GOVERNANCE.md) for project governance information.
## Changelog
See [CHANGELOG.md](CHANGELOG.md) or [Releases page](https://github.com/amnestywebsite/humanity-petitions-salesforce-adapter/releases) 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](CONTRIBUTING.md).
### Special Thanks
We'd like to say a special thank you to these lovely folks:
| [Cure53](https://cure53.de) | [WP Engine](https://wpengine.com) |
| --- | --- |
|  |  |
### Want to know more about the work in other Amnesty GitHub accounts?
You can find repositories from other teams such as [Amnesty Web Ops](https://github.com/amnestywebsite), [Amnesty Crisis](https://github.com/amnesty-crisis-evidence-lab), [Amnesty Tech](https://github.com/AmnestyTech), and [Amnesty Research](https://github.com/amnestyresearch/) in their GitHub accounts
