{"id":14469,"date":"2022-02-09T12:18:50","date_gmt":"2022-02-09T10:18:50","guid":{"rendered":"https:\/\/www.wp-crm.com\/?post_type=docs&#038;p=14469"},"modified":"2023-06-20T16:08:30","modified_gmt":"2023-06-20T13:08:30","slug":"developer-filters-in-gravity-forms-connect","status":"publish","type":"docs","link":"https:\/\/www.wp-crm.com\/docs\/developer-filters-in-gravity-forms-connect\/","title":{"rendered":"[Developer] Filters in Gravity Forms Connect"},"content":{"rendered":"\n<p>There are six filters in Gravity Forms Connect. Each does the same thing, but for the six different record types (contacts, organizations, projects, tasks, campaigns, opportunities) that are available in WP-CRM System.<\/p>\n\n\n\n<p>These filters allow the user to determine if when updating a record if the categories should be appended to existing categories (default), or replace existing categories.<\/p>\n\n\n\n<ul>\n<li><mark style=\"background-color:rgba(0, 0, 0, 0);color:#253c55\" class=\"has-inline-color\"><strong>wp_crm_system_gravity_forms_append_organization_categories<\/strong><\/mark><\/li>\n\n\n\n<li><mark style=\"background-color:rgba(0, 0, 0, 0);color:#253c55\" class=\"has-inline-color\"><strong>wp_crm_system_gravity_forms_append_contact_categories<\/strong><\/mark><\/li>\n\n\n\n<li><mark style=\"background-color:rgba(0, 0, 0, 0);color:#253c55\" class=\"has-inline-color\"><strong>wp_crm_system_gravity_forms_append_opportunity_categories<\/strong><\/mark><\/li>\n\n\n\n<li><mark style=\"background-color:rgba(0, 0, 0, 0);color:#253c55\" class=\"has-inline-color\"><strong>wp_crm_system_gravity_forms_append_project_categories<\/strong><\/mark><\/li>\n\n\n\n<li><mark style=\"background-color:rgba(0, 0, 0, 0);color:#253c55\" class=\"has-inline-color\"><strong>wp_crm_system_gravity_forms_append_task_categories<\/strong><\/mark><\/li>\n\n\n\n<li><mark style=\"background-color:rgba(0, 0, 0, 0);color:#253c55\" class=\"has-inline-color\"><strong>wp_crm_system_gravity_forms_append_campaign_categories<\/strong><\/mark><\/li>\n<\/ul>\n\n\n\n<p>Each filter should return true (default) or false.<\/p>\n\n\n\n<ul>\n<li><mark style=\"background-color:rgba(0, 0, 0, 0);color:#253c55\" class=\"has-inline-color\"><strong>true\u00a0(default):<\/strong><\/mark> Any time a record is updated, any new categories will be appended to any existing categories for the record. For example, if before a record is updated it is assigned to\u00a0<mark style=\"background-color:rgba(0, 0, 0, 0);color:#253c55\" class=\"has-inline-color\"><strong>Category A<\/strong><\/mark>\u00a0and\u00a0<mark style=\"background-color:rgba(0, 0, 0, 0);color:#253c55\" class=\"has-inline-color\"><strong>Category B<\/strong><\/mark>, then the record is updated to include\u00a0<mark style=\"background-color:rgba(0, 0, 0, 0);color:#253c55\" class=\"has-inline-color\"><strong>Category C<\/strong><\/mark>, the record will result in being assigned to\u00a0<mark style=\"background-color:rgba(0, 0, 0, 0);color:#253c55\" class=\"has-inline-color\"><strong>Category A<\/strong><\/mark>,\u00a0<mark style=\"background-color:rgba(0, 0, 0, 0);color:#253c55\" class=\"has-inline-color\"><strong>Category B<\/strong><\/mark>, and\u00a0<mark style=\"background-color:rgba(0, 0, 0, 0);color:#253c55\" class=\"has-inline-color\"><strong>Category C<\/strong><\/mark>.<\/li>\n\n\n\n<li><mark style=\"background-color:rgba(0, 0, 0, 0);color:#253c55\" class=\"has-inline-color\"><strong>false:<\/strong><\/mark> Any time a record is updated, the existing categories will be\u00a0<em>replaced<\/em>\u00a0with the new categories. For example, if before a record is updated it is assigned to\u00a0<mark style=\"background-color:rgba(0, 0, 0, 0);color:#253c55\" class=\"has-inline-color\"><strong>Category A<\/strong><\/mark>\u00a0and\u00a0<mark style=\"background-color:rgba(0, 0, 0, 0);color:#253c55\" class=\"has-inline-color\"><strong>Category B<\/strong><\/mark>, then the record is updated to include\u00a0<mark style=\"background-color:rgba(0, 0, 0, 0);color:#253c55\" class=\"has-inline-color\"><strong>Category C<\/strong><\/mark>, the record will result in being assigned to just\u00a0<mark style=\"background-color:rgba(0, 0, 0, 0);color:#253c55\" class=\"has-inline-color\"><strong>Category C<\/strong><\/mark>.<\/li>\n<\/ul>\n\n\n\n<p>You might find the following use cases helpful in determining which is appropriate for your usage.<\/p>\n\n\n\n<p>If you are categorizing a contact based on their interests from the lead generation form they fill out, you may not want to lose the prior interests. Originally they fill out a form, which categorizes them as interested in &#8220;Graphic Design&#8221;. The form will then add them to the &#8220;Graphic Design&#8221; category. Subsequently, they fill out another form that categorizes them as interested in &#8220;Content Writing Services&#8221;. The form will then add them to the &#8220;Content Writing Services&#8221; category, and keep them in the original &#8220;Graphic Design&#8221; category. In this case you would leave the filter to return true, which is the default value, so nothing needs to be done with the filter.<\/p>\n\n\n\n<p>If you have projects that are only assigned to one category at a time and they could possibly change scope in the future, it might make sense for any updates to the project through a form to replace the existing category. Originally a form is submitted that created a project in the &#8220;Logo Design&#8221; category. Subsequently, the form is submitted again and the scope changed to &#8220;Brand Consulting&#8221;, and the project should no longer be in the &#8220;Logo Design&#8221; category. In this case you would want the project filter to return false, which can be done like this:<\/p>\n\n\n\n<pre class=\"wp-block-preformatted\">add_filter( 'wp_crm_system_gravity_forms_append_project_categories', '__return_false' );<\/pre>\n\n\n\n<p>Note that each filter listed above can be used in the same way by changing the first parameter in the\u00a0<mark style=\"background-color:rgba(0, 0, 0, 0);color:#253c55\" class=\"has-inline-color\"><strong>add_filter()\u00a0<\/strong><\/mark>function.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>There are six filters in Gravity Forms Connect. Each does the same thing, but for the six different record types (contacts, organizations, projects, tasks, campaigns, opportunities) that are available in WP-CRM System. These filters allow the user to determine if when updating a record if the categories should be appended to existing categories (default), or&hellip;<\/p>\n","protected":false},"author":465,"featured_media":0,"comment_status":"closed","ping_status":"closed","template":"","meta":{"om_disable_all_campaigns":false},"doc_category":[85],"doc_tag":[],"yoast_head":"<!-- This site is optimized with the Yoast SEO plugin v22.2 - https:\/\/yoast.com\/wordpress\/plugins\/seo\/ -->\n<title>[Developer] Filters in Gravity Forms Connect - WP-CRM System<\/title>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/www.wp-crm.com\/docs\/developer-filters-in-gravity-forms-connect\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"[Developer] Filters in Gravity Forms Connect - WP-CRM System\" \/>\n<meta property=\"og:description\" content=\"There are six filters in Gravity Forms Connect. Each does the same thing, but for the six different record types (contacts, organizations, projects, tasks, campaigns, opportunities) that are available in WP-CRM System. These filters allow the user to determine if when updating a record if the categories should be appended to existing categories (default), or&hellip;\" \/>\n<meta property=\"og:url\" content=\"https:\/\/www.wp-crm.com\/docs\/developer-filters-in-gravity-forms-connect\/\" \/>\n<meta property=\"og:site_name\" content=\"WP-CRM System\" \/>\n<meta property=\"article:publisher\" content=\"https:\/\/www.facebook.com\/wpcrm\/\" \/>\n<meta property=\"article:modified_time\" content=\"2023-06-20T13:08:30+00:00\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:site\" content=\"@wpcrmsystem\" \/>\n<meta name=\"twitter:label1\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data1\" content=\"2 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\/\/schema.org\",\"@graph\":[{\"@type\":\"WebPage\",\"@id\":\"https:\/\/www.wp-crm.com\/docs\/developer-filters-in-gravity-forms-connect\/\",\"url\":\"https:\/\/www.wp-crm.com\/docs\/developer-filters-in-gravity-forms-connect\/\",\"name\":\"[Developer] Filters in Gravity Forms Connect - WP-CRM System\",\"isPartOf\":{\"@id\":\"https:\/\/www.wp-crm.com\/#website\"},\"datePublished\":\"2022-02-09T10:18:50+00:00\",\"dateModified\":\"2023-06-20T13:08:30+00:00\",\"breadcrumb\":{\"@id\":\"https:\/\/www.wp-crm.com\/docs\/developer-filters-in-gravity-forms-connect\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\/\/www.wp-crm.com\/docs\/developer-filters-in-gravity-forms-connect\/\"]}]},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\/\/www.wp-crm.com\/docs\/developer-filters-in-gravity-forms-connect\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\/\/www.wp-crm.com\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"WP-CRM System Documentation\",\"item\":\"https:\/\/www.wp-crm.com\/docs\/\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"[Developer] Filters in Gravity Forms Connect\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\/\/www.wp-crm.com\/#website\",\"url\":\"https:\/\/www.wp-crm.com\/\",\"name\":\"WP-CRM System\",\"description\":\"Customer Relationship Management Built For WordPress\",\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\/\/www.wp-crm.com\/?s={search_term_string}\"},\"query-input\":\"required name=search_term_string\"}],\"inLanguage\":\"en-US\"}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"[Developer] Filters in Gravity Forms Connect - WP-CRM System","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/www.wp-crm.com\/docs\/developer-filters-in-gravity-forms-connect\/","og_locale":"en_US","og_type":"article","og_title":"[Developer] Filters in Gravity Forms Connect - WP-CRM System","og_description":"There are six filters in Gravity Forms Connect. Each does the same thing, but for the six different record types (contacts, organizations, projects, tasks, campaigns, opportunities) that are available in WP-CRM System. These filters allow the user to determine if when updating a record if the categories should be appended to existing categories (default), or&hellip;","og_url":"https:\/\/www.wp-crm.com\/docs\/developer-filters-in-gravity-forms-connect\/","og_site_name":"WP-CRM System","article_publisher":"https:\/\/www.facebook.com\/wpcrm\/","article_modified_time":"2023-06-20T13:08:30+00:00","twitter_card":"summary_large_image","twitter_site":"@wpcrmsystem","twitter_misc":{"Est. reading time":"2 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/www.wp-crm.com\/docs\/developer-filters-in-gravity-forms-connect\/","url":"https:\/\/www.wp-crm.com\/docs\/developer-filters-in-gravity-forms-connect\/","name":"[Developer] Filters in Gravity Forms Connect - WP-CRM System","isPartOf":{"@id":"https:\/\/www.wp-crm.com\/#website"},"datePublished":"2022-02-09T10:18:50+00:00","dateModified":"2023-06-20T13:08:30+00:00","breadcrumb":{"@id":"https:\/\/www.wp-crm.com\/docs\/developer-filters-in-gravity-forms-connect\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/www.wp-crm.com\/docs\/developer-filters-in-gravity-forms-connect\/"]}]},{"@type":"BreadcrumbList","@id":"https:\/\/www.wp-crm.com\/docs\/developer-filters-in-gravity-forms-connect\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/www.wp-crm.com\/"},{"@type":"ListItem","position":2,"name":"WP-CRM System Documentation","item":"https:\/\/www.wp-crm.com\/docs\/"},{"@type":"ListItem","position":3,"name":"[Developer] Filters in Gravity Forms Connect"}]},{"@type":"WebSite","@id":"https:\/\/www.wp-crm.com\/#website","url":"https:\/\/www.wp-crm.com\/","name":"WP-CRM System","description":"Customer Relationship Management Built For WordPress","potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/www.wp-crm.com\/?s={search_term_string}"},"query-input":"required name=search_term_string"}],"inLanguage":"en-US"}]}},"_links":{"self":[{"href":"https:\/\/www.wp-crm.com\/wp-json\/wp\/v2\/docs\/14469"}],"collection":[{"href":"https:\/\/www.wp-crm.com\/wp-json\/wp\/v2\/docs"}],"about":[{"href":"https:\/\/www.wp-crm.com\/wp-json\/wp\/v2\/types\/docs"}],"author":[{"embeddable":true,"href":"https:\/\/www.wp-crm.com\/wp-json\/wp\/v2\/users\/465"}],"replies":[{"embeddable":true,"href":"https:\/\/www.wp-crm.com\/wp-json\/wp\/v2\/comments?post=14469"}],"version-history":[{"count":5,"href":"https:\/\/www.wp-crm.com\/wp-json\/wp\/v2\/docs\/14469\/revisions"}],"predecessor-version":[{"id":17040,"href":"https:\/\/www.wp-crm.com\/wp-json\/wp\/v2\/docs\/14469\/revisions\/17040"}],"wp:attachment":[{"href":"https:\/\/www.wp-crm.com\/wp-json\/wp\/v2\/media?parent=14469"}],"wp:term":[{"taxonomy":"doc_category","embeddable":true,"href":"https:\/\/www.wp-crm.com\/wp-json\/wp\/v2\/doc_category?post=14469"},{"taxonomy":"doc_tag","embeddable":true,"href":"https:\/\/www.wp-crm.com\/wp-json\/wp\/v2\/doc_tag?post=14469"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}