MinnPost / object-sync-for-salesforce

WordPress plugin that maps and syncs data between Salesforce objects and WordPress objects.
https://wordpress.org/plugins/object-sync-for-salesforce/
GNU General Public License v2.0
93 stars 48 forks source link
crm-wordpress-plugin object-sync-for-salesforce salesforce salesforce-wordpress-plugin wordpress wordpress-plugin

Object Sync for Salesforce

PHPCS Inspections Code Climate Scrutinizer Code Quality

Object Sync for Salesforce is a WordPress plugin that maps and syncs data between Salesforce objects and WordPress content types. It originated as a WordPress fork of the Drupal Salesforce Suite (version 7.x-3.x-dev), though it has evolved since then.

Getting started

For any supported WordPress content types (e.g. post, page, user, or any supported custom content type in your installation), you can assign Salesforce objects that will be created / updated / deleted when the data in WordPress is saved, and the WordPress objects can be created / updated / deleted when the data in Salesforce is saved.

For each such combination of object and content type, choose which fields should be mapped to one another, creating a fieldmap. The plugin acts on matching data after it is installed.

This plugin also includes developer hooks that allow for additional plugins to modify what data the plugin is working with, or what happens upon specific events.

To get started, install Object Sync for Salesforce from the WordPress plugin repository and follow the setup instructions.

Requirements

  1. The minimum system requirements for the Action Scheduler library. Currently this library requires a PHP installation of at least version 7.0 and a WordPress installation of at least version 6.3.
  2. SSL support.
  3. A Salesforce account. Developers can register for a free Developer Edition account at https://developer.salesforce.com/signup
  4. A remote application/connected Salesforce app for authorization.

We maintain extensive documentation of the plugin beyond its installation process as well, including its developer hooks. This documentation also exists in the plugin's docs folder when it is downloaded.

Troubleshooting

If you are having trouble setting up or configuring the plugin, we've provided answers to some common problems in our troubleshooting document. Expanding this document is also a great way to contribute to this plugin.

Getting support using this plugin

We make an effort to answer support requests in the WordPress plugin forum. If you have these requests, please put them in that forum only. Do not send them by email or by social media.

While MinnPost's nonprofit newsroom does welcome donations to support our work, this plugin does not have a paid version.

Use this repository for bugs, feature requests, and other additions and especially do that if you can help solve these things.

Extending this plugin

WordPress developers can use hooks in this plugin to extend its functionality. These are listed, with links to each hook's documentation, in the developer hooks documentation, and are frequently mentioned throughout the plugin's documentation.

We host a document intended to list plugins that use these hooks or otherwise extend this plugin, and we welcome additions.

Contribute to plugin development

If you'd like to suggest a feature, or if you think you've encountered a bug, you can create an issue on our GitHub repository. We actively add our own issues to the list, and comment on their progress.

We welcome contributions of code, documentation, or translations to this project from other developers. See our contributing guidelines.

Finding other sync options

This plugin can be relatively complicated, and sometimes other plugins can effectively integrate Salesforce and WordPress, especially if there are more limited, specific requirements. If one of these can meet those requirements, use it. We're happy to link to additional choices here, as well.

Changelog

See our full changelog for information about all previous releases.

All versions of this plugin are listed in the releases.

Donating

If you'd like to support this project financially, MinnPost is a 501(c)(3) nonprofit news organization located in Minnesota. You can make a tax-deductible donation, and we'll attach it to our open source development work, at https://www.minnpost.com/support/?campaign=7010G0000012fXGQAY.