{"id":128615,"date":"2020-09-15T14:04:00","date_gmt":"2020-09-15T14:04:00","guid":{"rendered":"https:\/\/wordpress.org\/plugins\/gragrid-gravity-forms-sendgrid\/"},"modified":"2022-06-11T03:26:01","modified_gmt":"2022-06-11T03:26:01","slug":"gragrid","status":"publish","type":"plugin","link":"https:\/\/szl.wordpress.org\/plugins\/gragrid\/","author":14722045,"comment_status":"closed","ping_status":"closed","template":"","meta":{"_crdt_document":"","version":"2.2.2","stable_tag":"2.2.2","tested":"6.0.11","requires":"5.2","requires_php":"7.3","requires_plugins":"","header_name":"Gragrid: Gravity Forms + SendGrid","header_author":"Vladimir Contreras","header_description":"Integrates Gravity Forms with SendGrid, allowing form submissions to be automatically sent to your SendGrid contact lists.","assets_banners_color":"272727","last_updated":"2022-06-11 03:26:01","external_support_url":"","external_repository_url":"","donate_link":"https:\/\/github.com\/vlasscontreras\/gragrid","header_plugin_uri":"https:\/\/github.com\/vlasscontreras\/gragrid","header_author_uri":"https:\/\/github.com\/vlasscontreras","rating":5,"author_block_rating":0,"active_installs":100,"downloads":3994,"num_ratings":1,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":{"1.0.0":{"tag":"1.0.0","author":"vlass","date":"2020-09-15 14:03:43"},"1.1.0":{"tag":"1.1.0","author":"vlass","date":"2020-10-24 22:00:39"},"2.0.0":{"tag":"2.0.0","author":"vlass","date":"2021-03-04 01:40:06"},"2.1.0":{"tag":"2.1.0","author":"vlass","date":"2021-03-13 22:53:16"},"2.2.0":{"tag":"2.2.0","author":"vlass","date":"2021-05-21 22:09:47"},"2.2.1":{"tag":"2.2.1","author":"vlass","date":"2021-08-03 01:14:31"},"2.2.2":{"tag":"2.2.2","author":"vlass","date":"2022-06-11 03:26:01"}},"upgrade_notice":[],"ratings":{"1":0,"2":0,"3":0,"4":0,"5":1},"assets_icons":{"icon.svg":{"filename":"icon.svg","revision":2483129,"resolution":false,"location":"assets","locale":false}},"assets_banners":{"banner-1544x500.png":{"filename":"banner-1544x500.png","revision":2483129,"resolution":"1544x500","location":"assets","locale":""},"banner-772x250.png":{"filename":"banner-772x250.png","revision":2483129,"resolution":"772x250","location":"assets","locale":""}},"assets_blueprints":{},"all_blocks":[],"tagged_versions":["1.0.0","1.1.0","2.0.0","2.1.0","2.2.0","2.2.1","2.2.2"],"block_files":[],"assets_screenshots":{"screenshot-1.png":{"filename":"screenshot-1.png","revision":2495065,"resolution":"1","location":"assets","locale":""},"screenshot-2.png":{"filename":"screenshot-2.png","revision":2495065,"resolution":"2","location":"assets","locale":""},"screenshot-3.png":{"filename":"screenshot-3.png","revision":2495065,"resolution":"3","location":"assets","locale":""}},"screenshots":{"1":"Plugin settings page","2":"Multiple feeds, send submissions to multiple lists","3":"Feed settings page"},"jetpack_post_was_ever_published":false},"plugin_section":[],"plugin_tags":[2483,601,1655,12451,1016],"plugin_category":[41,42],"plugin_contributors":[190856],"plugin_business_model":[],"class_list":["post-128615","plugin","type-plugin","status-publish","hentry","plugin_tags-emails","plugin_tags-forms","plugin_tags-gravity-forms","plugin_tags-sendgrid","plugin_tags-subscribers","plugin_category-communication","plugin_category-contact-forms","plugin_contributors-vlass","plugin_committers-vlass"],"banners":{"banner":"https:\/\/ps.w.org\/gragrid\/assets\/banner-772x250.png?rev=2483129","banner_2x":"https:\/\/ps.w.org\/gragrid\/assets\/banner-1544x500.png?rev=2483129","banner_rtl":false,"banner_2x_rtl":false},"icons":{"svg":"https:\/\/ps.w.org\/gragrid\/assets\/icon.svg?rev=2483129","icon":"https:\/\/ps.w.org\/gragrid\/assets\/icon.svg?rev=2483129","icon_2x":false,"generated":false},"screenshots":[{"src":"https:\/\/ps.w.org\/gragrid\/assets\/screenshot-1.png?rev=2495065","caption":"Plugin settings page"},{"src":"https:\/\/ps.w.org\/gragrid\/assets\/screenshot-2.png?rev=2495065","caption":"Multiple feeds, send submissions to multiple lists"},{"src":"https:\/\/ps.w.org\/gragrid\/assets\/screenshot-3.png?rev=2495065","caption":"Feed settings page"}],"raw_content":"<!--section=description-->\n<p>Integrate your Gravity Forms with SendGrid to send submissions with email fields to your contact lists.<\/p>\n\n<h3>Advanced<\/h3>\n\n<p>You can customize the contact data sent to SendGrid in the entry submission context with this hook:<\/p>\n\n<pre><code>apply_filters( 'gragrid_contact_params', array $contact_params, array $entry, array $form )\n<\/code><\/pre>\n\n<ul>\n<li><code>$contact_params<\/code> (array): Contact parameters, includes first name, email, custom fields, etc.<\/li>\n<li><code>$entry<\/code> (array): The form entry that was just created.<\/li>\n<li><code>$form<\/code> (array): The current form, the origin of the submission.<\/li>\n<\/ul>\n\n<p>You can also customize the SendGrid API requests using the following hook:<\/p>\n\n<pre><code>apply_filters( 'gragrid_request_args', array $args, string $path )\n<\/code><\/pre>\n\n<ul>\n<li><code>$args<\/code> (array): Request arguments, includes headers, method, body, etc.<\/li>\n<li><code>$path<\/code> (string): The specific API endpoint being called.<\/li>\n<\/ul>\n\n<!--section=installation-->\n<ol>\n<li>Upload the extracted contents of <code>gravity-forms-sengrid.zip<\/code> to the <code>\/wp-content\/plugins\/<\/code> directory<\/li>\n<li>Activate the plugin through the 'Plugins' menu in WordPress<\/li>\n<li>Go to Forms &gt; Settings &gt; SendGrid and add your API key<\/li>\n<\/ol>\n\n<!--section=faq-->\n<dl>\n<dt id='why%20can%27t%20i%20create%20a%20feed%3F'><h3>Why can't I create a feed?<\/h3><\/dt>\n<dd><p>Make sure you have set a valid API key in the global SendGrid settings by going to Forms &gt; Settings &gt; SendGrid. There should be a green checkmark next to the API key field if the API key is valid.<\/p><\/dd>\n<dt id='what%20permissions%20do%20i%20need%20to%20select%20when%20creating%20an%20api%20key%3F'><h3>What permissions do I need to select when creating an API key?<\/h3><\/dt>\n<dd><p>This plugin only requires full access to <strong>Marketing &gt; Marketing<\/strong>.<\/p><\/dd>\n<dt id='why%20the%20field%20dropdowns%20in%20the%20mapping%20settings%20are%20empty%3F'><h3>Why the field dropdowns in the mapping settings are empty?<\/h3><\/dt>\n<dd><ul>\n<li>To map the <strong>Email<\/strong> you need to have a field of type <a href=\"https:\/\/docs.gravityforms.com\/email\/\">Email<\/a> or <a href=\"https:\/\/docs.gravityforms.com\/hidden\/\">Hidden<\/a>.<\/li>\n<li>To map the <strong>First Name<\/strong> and <strong>Last Name<\/strong> you need to have a field of type <a href=\"https:\/\/docs.gravityforms.com\/name\/\">Name<\/a>, <a href=\"https:\/\/docs.gravityforms.com\/text-field\/\">Text<\/a>, or <a href=\"https:\/\/docs.gravityforms.com\/hidden\/\">Hidden<\/a><\/li>\n<li>To map the <strong>Address<\/strong> you need to have a field of type <a href=\"https:\/\/docs.gravityforms.com\/address-field\/\">Address<\/a>, <a href=\"https:\/\/docs.gravityforms.com\/text-field\/\">Text<\/a>, or <a href=\"https:\/\/docs.gravityforms.com\/hidden\/\">Hidden<\/a><\/li>\n<\/ul><\/dd>\n<dt id='the%20field%20dropdown%20options%20in%20the%20mapping%20settings%20are%20blank%20but%20selectable%2C%20what%27s%20going%20on%3F'><h3>The field dropdown options in the mapping settings are blank but selectable, what's going on?<\/h3><\/dt>\n<dd><p>The field dropdowns show the <a href=\"https:\/\/docs.gravityforms.com\/common-field-settings\/#field-label\">Field Label<\/a> or <a href=\"https:\/\/docs.gravityforms.com\/common-field-settings\/#admin-field-label\">Admin Field Label<\/a>, so make sure you have either of those set up in your fields. Or both, it's also a good practice for accessibility!<\/p><\/dd>\n<dt id='why%20i%20don%27t%20see%20any%20custom%20fields%20in%20the%20form%20settings%3F'><h3>Why I don't see any custom fields in the form settings?<\/h3><\/dt>\n<dd><p>The custom field mapping won't appear unless you have at least 1 custom field in your SendGrid account, so make sure you have at least one.<\/p><\/dd>\n<dt id='can%20this%20plugin%20be%20installed%20at%20the%20same%20time%20as%20the%20official%20sendgrid%20gravity%20forms%20add-on%3F'><h3>Can this plugin be installed at the same time as the official SendGrid Gravity Forms add-on?<\/h3><\/dt>\n<dd><p>Yes. The official add-on and this plugin have different purposes and do not have conflicts in between.<\/p><\/dd>\n<dt id='can%20this%20plugin%20be%20installed%20at%20the%20same%20time%20as%20the%20official%20sendgrid%20wordpress%20plugin%3F'><h3>Can this plugin be installed at the same time as the official SendGrid WordPress plugin?<\/h3><\/dt>\n<dd><p>Yes. Just like Gravity Forms' SendGrid add-on, this plugin serves a different purpose and does not conflict with it.<\/p><\/dd>\n\n<\/dl>\n\n<!--section=changelog-->\n<h4>2.2.2<\/h4>\n\n<ul>\n<li>Fixes the truncated contact lists on the feed settings page<\/li>\n<li>Tested on WordPress 6.0<\/li>\n<\/ul>\n\n<h4>2.2.1<\/h4>\n\n<ul>\n<li>Handles fatal error on the feed listing when the API key is invalid<\/li>\n<li>Escape HTML in translation strings<\/li>\n<li>Tested on WordPress 5.8<\/li>\n<\/ul>\n\n<h4>2.2.0<\/h4>\n\n<ul>\n<li>Fixes fatal error due to unitialized API class on Gravity Forms 2.5+ [<a href=\"https:\/\/github.com\/vlasscontreras\/gragrid\/issues\/15\">#15<\/a>]<\/li>\n<li>Adds error feedback when contact lists cannot be retrieved on the feed settings<\/li>\n<\/ul>\n\n<h4>2.1.0<\/h4>\n\n<ul>\n<li>Adds support to map more reserved\/default SendGrid fields<\/li>\n<li>Adds support to map custom fields \ud83e\udd73<\/li>\n<li>Introduces a new filter hook <code>gragrid_contact_params<\/code> to filter contact data at entry context<\/li>\n<\/ul>\n\n<h4>2.0.0<\/h4>\n\n<ul>\n<li>Uses Twilio SendGrid's new Marketing Campaigns API (see <a href=\"https:\/\/github.com\/vlasscontreras\/gragrid\/issues\/9\">#9<\/a>)<\/li>\n<li>Adds address fields to map them to SendGrid Contacts<\/li>\n<li>New logo \ud83d\udc85\ud83c\udffb<\/li>\n<\/ul>\n\n<h4>1.1.0<\/h4>\n\n<ul>\n<li>Adds support for conditional feeds<\/li>\n<li>Adds notes to form entries when the feeds are processed<\/li>\n<\/ul>\n\n<h4>1.0.0<\/h4>\n\n<ul>\n<li>Initial release<\/li>\n<\/ul>","raw_excerpt":"Integrates Gravity Forms with SendGrid, allowing form submissions to be automatically sent to your SendGrid contact lists.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/szl.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/128615","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/szl.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/szl.wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/szl.wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=128615"}],"author":[{"embeddable":true,"href":"https:\/\/szl.wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/vlass"}],"wp:attachment":[{"href":"https:\/\/szl.wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=128615"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/szl.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=128615"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/szl.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=128615"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/szl.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=128615"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/szl.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=128615"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/szl.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=128615"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}