{"id":30308,"date":"2017-02-11T15:59:59","date_gmt":"2017-02-11T05:59:59","guid":{"rendered":"https:\/\/agenticus.com\/mautic-how-to-switch-to-the-https-protocol-ssl-certificate\/"},"modified":"2024-11-13T15:45:53","modified_gmt":"2024-11-13T05:45:53","slug":"mautic-how-to-switch-to-the-https-protocol-ssl-certificate","status":"publish","type":"post","link":"https:\/\/agenticus.com\/mautic-how-to-switch-to-the-https-protocol-ssl-certificate\/","title":{"rendered":"Mautic | How to Switch to the https:\/\/ Protocol (SSL Certificate)"},"content":{"rendered":"

Yesterday, I switched my primary website over to the https:\/\/ (secure)<\/em> protocol. This article is not about how to purchase and install an SSL certificate \u2013 it\u2019s about what to do with your installation of Mautic when it ceases to work (and it will cease to work properly)<\/em> after you\u2019ve installed that certificate.<\/p>\n

WARNING:<\/strong> You\u2019re going to need a few geek skills to pull this off. If you don\u2019t have a reasonable understanding of how to edit templates and are not confident inside your cPanel \u2013 do not, repeat DO NOT fuck with this \u2013 get a geek to assist you. Your hosting provider is not going to be enough to help you to pull this off.<\/p>\n

This post is aimed at intermediate to advanced Mautic marketing automation<\/a> users.<\/p>\n

The Symptoms\u2026<\/h2>\n

First up, we edited the htaccess file and did the normal redirections that you\u2019d do for a website that has a newly installed SSL certificate, setting up the site to always resolve to the https:\/\/ protocol. After we\u2019d done that, we noticed that all of the embedded Mautic forms what we had on our (Joomla!)<\/em> website had completely disappeared from the pages where they were installed. Clearly, something was wrong.<\/p>\n

You\u2019ll also notice that the word SECURE and the padlock which sits beside it on https:\/\/ enabled websites may not appear on some pages. Instead, you\u2019ll see a circular icon. If you click this it will alert you that problems exist with the page and it may not be secure. Usually, that will relate to something that has inadvertently been hardcoded on the page, such as an image file. In the case of Mautic, look first at your embedded forms as the source of the problem. I\u2019ll cover how to diagnose and fix this later.<\/p>\n

Edit Mautic Configuration<\/h2>\n

First up, you\u2019ll need to clear your Mautic cache. Mautic does a terrible job of this and you\u2019ll find it easier to simply delete the cache folder, which you\u2019ll find located in the app folder of your installation of Mautic. Don\u2019t worry about deleting the folder. Mautic will generate a new one.<\/p>\n

Next, login into your instance of Mautic. Click on the gear icon (top right of admin panel)<\/em> and navigate to Configuration. In the system settings, you\u2019ll see your website URL. It will be the old http:\/\/ URL \u2013 not the new https:\/\/ URL that you have with you newly installed SSL certificate. Edit the website URL to include the https:\/\/ protocol and click save.<\/p>\n

When you click save Mautic will resolve to the User\/Authentication Settings tab and will display and error warning in red. You need to add the same Email, First name and Last name as you already have entered in your user settings. Click save.<\/p>\n

Edit Website Plugins<\/h2>\n

Chances are you are using a plugin to monitor website visitation if you are using a popular CMS like WordPress or Joomla!. You will need to edit the plugin so that it recognises the new https:\/\/ protocol. Navigate to the plugin within your CMS and edit the URL, as required. Click save.<\/p>\n

Edit Custom Themes<\/h2>\n

This next step only applies if you have custom themes installed. Even then it may not apply if relative URL\u2019s have been consistently used in creating those themes. Especially if your custom themes are older, there is a big chance that they may contain hardcoded URL\u2019s. Older versions of Mautic (back in the 1\u2019s)<\/em> sometimes rejected relative URL\u2019s when creating templates. A quick look at the public pages of your template should tell you if anything requires attention.<\/p>\n

Go to your cPanel (or use ftp)<\/em> and navigate to your installation of Mautic, then navigate to the theme that you wish to edit. You\u2019ll then need to go through html \/ html.twig files and edit any hardcoded URL\u2019s to reflect the new https:\/\/ protocol. Notably, pages and forms appear to be affected. I went through everything \u2013 and even cleaned up some messy code!<\/p>\n

After I\u2019d done all of that, everything seemed to work fine \u2013 except for one thing\u2026<\/p>\n

Edit Forms<\/h2>\n

Earlier I mentioned the problem of pages still being insecure. It only affected pages with embedded Mautic forms on them. The solution is simple. Mautic forms all provide a for a return URL (the URL visitors are directed to upon submission of a form)<\/em>. Navigate to each form and edit the Redirect\/URL Message field to include the https:\/\/ protocol. That immediately cleared up my issue, with some pages displaying as insecure.<\/p>\n

Warning<\/h2>\n

This was my first run through on this. I fully expect to uncover more issues in the next day or two. I\u2019ll update this post as I identify and resolve those problems.<\/p>\n

This article was originally published on tonygavin.com<\/em><\/p>\n","protected":false},"excerpt":{"rendered":"

Yesterday, I switched my primary website over to the https:\/\/ (secure) protocol. This article is not about how to purchase and install an SSL certificate \u2013 it\u2019s about what to…<\/p>\n","protected":false},"author":1,"featured_media":30272,"comment_status":"open","ping_status":"open","sticky":false,"template":"elementor_theme","format":"standard","meta":{"footnotes":""},"categories":[269,290,291],"tags":[],"class_list":["post-30308","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-crm","category-marketing-automation","category-mautic"],"_links":{"self":[{"href":"https:\/\/agenticus.com\/wp-json\/wp\/v2\/posts\/30308","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/agenticus.com\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/agenticus.com\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/agenticus.com\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/agenticus.com\/wp-json\/wp\/v2\/comments?post=30308"}],"version-history":[{"count":3,"href":"https:\/\/agenticus.com\/wp-json\/wp\/v2\/posts\/30308\/revisions"}],"predecessor-version":[{"id":30544,"href":"https:\/\/agenticus.com\/wp-json\/wp\/v2\/posts\/30308\/revisions\/30544"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/agenticus.com\/wp-json\/wp\/v2\/media\/30272"}],"wp:attachment":[{"href":"https:\/\/agenticus.com\/wp-json\/wp\/v2\/media?parent=30308"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/agenticus.com\/wp-json\/wp\/v2\/categories?post=30308"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/agenticus.com\/wp-json\/wp\/v2\/tags?post=30308"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}