{"id":3636,"date":"2021-08-16T10:48:05","date_gmt":"2021-08-16T08:48:05","guid":{"rendered":"https:\/\/www.knowboard.de\/?p=3636"},"modified":"2021-08-16T11:01:00","modified_gmt":"2021-08-16T09:01:00","slug":"mailster-integration-for-formidable-forms","status":"publish","type":"post","link":"https:\/\/www.knowboard.de\/mailster-integration-for-formidable-forms\/","title":{"rendered":"Mailster Integration for Formidable Forms"},"content":{"rendered":"\n<p>On my main site <a href=\"https:\/\/www.enym.com\" target=\"_blank\" data-type=\"URL\" data-id=\"https:\/\/www.enym.com\" rel=\"noreferrer noopener\">enym.com<\/a> I use <a href=\"https:\/\/formidableforms.com\/\" target=\"_blank\" rel=\"noreferrer noopener\" data-type=\"URL\" data-id=\"https:\/\/formidableforms.com\/\">Formidable forms<\/a> because it has great anti-spam measures and also uses the general &#8222;block words&#8220; settings from WordPress. Formidable forms integrate well with a lot of external services like Mailchimp etc. Nonetheless, there is no official support for the newsletter plugin &#8222;<a href=\"https:\/\/codecanyon.net\/item\/mailster-email-newsletter-plugin-for-wordpress\/3078294\" target=\"_blank\" rel=\"noreferrer noopener\">Mailster<\/a>&#8220; which I tend to use. <\/p>\n\n\n\n<p>But there is an API and I dug deep on the web and finally found a solution which I want to share with you to make it widespread available. The original undocumented script was found in the <a href=\"https:\/\/codecanyon.net\/item\/mailster-email-newsletter-plugin-for-wordpress\/3078294\/comments\" target=\"_blank\" rel=\"noreferrer noopener\">codecanyon comment area<\/a> of <a href=\"https:\/\/codecanyon.net\/item\/mailster-email-newsletter-plugin-for-wordpress\/3078294\" target=\"_blank\" data-type=\"URL\" data-id=\"https:\/\/codecanyon.net\/item\/mailster-email-newsletter-plugin-for-wordpress\/3078294\" rel=\"noreferrer noopener\">Mailster<\/a> &#8211; there was a link to a <a href=\"https:\/\/pastebin.com\/t4eRLyt5\" target=\"_blank\" data-type=\"URL\" data-id=\"https:\/\/pastebin.com\/t4eRLyt5\" rel=\"noreferrer noopener\">Pastebin<\/a>. So all credit goes to the unknown user who kindely pasted the solution <a href=\"https:\/\/pastebin.com\/t4eRLyt5\" target=\"_blank\" data-type=\"URL\" data-id=\"https:\/\/pastebin.com\/t4eRLyt5\" rel=\"noreferrer noopener\">there<\/a>.<\/p>\n\n\n\n<ul class=\"wp-block-list\"><li>See it in action here on enym.com and don&#8217;t forget to subscribe: <a href=\"https:\/\/www.enym.com\">DEMO<\/a> \ud83d\ude42 <\/li><\/ul>\n\n\n\n<figure class=\"wp-block-image size-large\"><img decoding=\"async\" src=\"https:\/\/www.knowboard.de\/wp-content\/uploads\/2021\/08\/Bildschirmfoto-2021-08-16-um-11.00.08-1024x819.png\" alt=\"\" class=\"wp-image-3648\"\/><figcaption>The final formidable form which integrates a nice and clean newsletter-subscription option in the bottom left corner.<\/figcaption><\/figure>\n\n\n\n<h2 class=\"wp-block-heading\">Why do I use Mailster?<\/h2>\n\n\n\n<p>Mailster is a fully functioned newsletter plugin which you can buy for a one-time-payment on themeforest\/ codecanyon. It perfectly integrates with WordPress and can easily use external mail providers like <a href=\"https:\/\/www.mailgun.com\/\" target=\"_blank\" data-type=\"URL\" data-id=\"https:\/\/www.mailgun.com\/\" rel=\"noreferrer noopener\">Mailgun<\/a>, which is my favorite BTW.<\/p>\n\n\n\n<p>Having the mailing service within WordPress is nice because you have one less login to remember and have direct access to the content created in your site to be added to the mailing. Great. Also, you have a one common place for your subscribers and users. Especially for community sites, this is easier to handle than to have multiple subscriber lists across different services.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">How to add a &#8222;Newsletter signup&#8220; option to formidable forms?<\/h2>\n\n\n\n<p>First open the form where you want to add the &#8222;Subscribe me&#8220; option. Use the switch field or a radio button to integrate the according question. Make sure it is disabled by default to not violate any laws. Note the ID in the top right corner.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">1. Note the Form-ID<\/h3>\n\n\n\n<figure class=\"wp-block-image size-large\"><img decoding=\"async\" src=\"https:\/\/www.knowboard.de\/wp-content\/uploads\/2021\/08\/image-1-1024x492.png\" alt=\"\" class=\"wp-image-3639\"\/><figcaption>You see the form ID in the URL when editing the form<\/figcaption><\/figure>\n\n\n\n<h3 class=\"wp-block-heading\">2. and 3. Note the data field IDs and the ID for the newsletter optin-field<\/h3>\n\n\n\n<figure class=\"wp-block-image size-large\"><img decoding=\"async\" src=\"https:\/\/www.knowboard.de\/wp-content\/uploads\/2021\/08\/image-1024x291.png\" alt=\"\" class=\"wp-image-3638\"\/><figcaption>Add an option to subscribe to the newsletter in your formidable form, so it can be connected with your Mailster subscriber list. You find the IDs of the fields in the top right corner.<\/figcaption><\/figure>\n\n\n\n<h3 class=\"wp-block-heading\">4. Note the ID of the target mailing-list from Mailster<\/h3>\n\n\n\n<figure class=\"wp-block-image size-large\"><img decoding=\"async\" src=\"https:\/\/www.knowboard.de\/wp-content\/uploads\/2021\/08\/image-2-1024x472.png\" alt=\"\" class=\"wp-image-3640\"\/><figcaption><meta charset=\"utf-8\">You see the list ID in the URL when editing the mailing-list<\/figcaption><\/figure>\n\n\n\n<h2 class=\"wp-block-heading\">Snippet for functions.php<\/h2>\n\n\n\n<p>Paste the following script in your functions.php file in your child themes directory and adapt the following values in the mentioned places.<\/p>\n\n\n\n<ol class=\"wp-block-list\"><li>Change the ID of the form: <br><strong>$form_id == 1<\/strong><\/li><li>Change the IDs of the data fields. You can find the IDs easily in the backend: <br><strong>$_POST[&#8218;item_meta&#8216;][7]<\/strong> (see the image above for an example).<\/li><li>Change the ID of the Optin-field: <br><strong>if ($_POST[&#8218;item_meta&#8216;][72] == true) {<\/strong><\/li><li>Change the ID of the list you want your guests to subscribe to: <br><strong>$list_ids = 1;<\/strong><\/li><\/ol>\n\n\n\n<pre class=\"EnlighterJSRAW\" data-enlighter-language=\"generic\" data-enlighter-theme=\"\" data-enlighter-highlight=\"\" data-enlighter-linenumbers=\"\" data-enlighter-lineoffset=\"\" data-enlighter-title=\"\" data-enlighter-group=\"\">\/\/FORMIDABLE MAILSTER INTEGRATION\n\nadd_action('frm_after_create_entry', 'mailster_formidable_subscribe', 30, 2);\nadd_action('frm_after_update_entry', 'mailster_formidable_subscribe', 30, 2);\n\nfunction mailster_formidable_subscribe($entry_id, $form_id){\n\tif ( $form_id == 1 ) { \/\/change to the ID of your form\n\n\t\t\/\/ define to overwrite existing users\n\t\t$overwrite = true;\n\n\t\t\/\/ add with double opt in\n\t\t$double_opt_in = true;\n\n\t\t\/\/ prepare the userdata from a $_POST request. only the email is required\n\t\t$userdata = array(\n\t\t\t'email' => $_POST['item_meta'][7], \/\/change 535, 534, 533 to the ID of your email, first name and last name field\n\t\t\t'firstname' => $_POST['item_meta'][6],\n\t\t\t\/\/'lastname' => $_POST['item_meta'][534],\n\t\t\t'status' => $double_opt_in ? 0 : 1,\n\t\t);\n\n\t\t\/\/only subscribe the user if opt-in is true\n\t\tif ($_POST['item_meta'][72] == true) {\n\n\t\t\t$subscriber_id = mailster( 'subscribers' )->add( $userdata, $overwrite );\n\n\t\t\tif ( ! is_wp_error( $subscriber_id ) ) {\n\n\t\t\t\t\/\/ your list ids\n\t\t\t\t$list_ids = 1;\n\t\t\t\tmailster( 'subscribers' )->assign_lists( $subscriber_id, $list_ids );\n\n\t\t\t} else {\n\t\t\t\t\/\/ actions if adding fails. $subscriber_id is a WP_Error object\n\t\t\t}\n\n\t\t}\n\t}\n}\n\n\n<\/pre>\n","protected":false},"excerpt":{"rendered":"<p>On my main site enym.com I use Formidable forms because it has great anti-spam measures and also uses the general &#8222;block words&#8220; settings from WordPress. Formidable forms integrate well with a lot of external services like Mailchimp etc. Nonetheless, there is no official support for the newsletter plugin &#8222;Mailster&#8220; which I tend to use. But&hellip;<\/p>\n","protected":false},"author":1,"featured_media":3641,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_seopress_robots_primary_cat":"","_seopress_titles_title":"","_seopress_titles_desc":"","_seopress_robots_index":"","footnotes":""},"categories":[1],"tags":[],"class_list":["post-3636","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-allgemein","entry","has-media"],"_links":{"self":[{"href":"https:\/\/www.knowboard.de\/wp-json\/wp\/v2\/posts\/3636"}],"collection":[{"href":"https:\/\/www.knowboard.de\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.knowboard.de\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.knowboard.de\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/www.knowboard.de\/wp-json\/wp\/v2\/comments?post=3636"}],"version-history":[{"count":5,"href":"https:\/\/www.knowboard.de\/wp-json\/wp\/v2\/posts\/3636\/revisions"}],"predecessor-version":[{"id":3649,"href":"https:\/\/www.knowboard.de\/wp-json\/wp\/v2\/posts\/3636\/revisions\/3649"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/www.knowboard.de\/wp-json\/wp\/v2\/media\/3641"}],"wp:attachment":[{"href":"https:\/\/www.knowboard.de\/wp-json\/wp\/v2\/media?parent=3636"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.knowboard.de\/wp-json\/wp\/v2\/categories?post=3636"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.knowboard.de\/wp-json\/wp\/v2\/tags?post=3636"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}