{"id":16700,"date":"2022-02-28T15:19:12","date_gmt":"2022-02-28T15:19:12","guid":{"rendered":"https:\/\/www.mautic.org\/feature-highlight-mautic-marketplace\/"},"modified":"2024-12-18T11:56:43","modified_gmt":"2024-12-18T11:56:43","slug":"feature-highlight-mautic-marketplace","status":"publish","type":"post","link":"https:\/\/mautic.org\/blog\/feature-highlight-mautic-marketplace","title":{"rendered":"Feature Highlight: The Mautic Marketplace"},"content":{"rendered":"<p>In Mautic 4.2 the Mautic Marketplace now enables you to install and manage plugins within Mautic, both in the user interface and at the command line. Read on to learn more about how it works, some caveats you need to know before using it, and how to get your plugins listed in the Marketplace.<\/p>\n<h2>Who can use the Mautic Marketplace?<\/h2>\n<p>The Mautic Marketplace is enabled by default in browse mode but the install, update and removal of plugins is only available if you manage your Mautic instance using Composer. This is due to the underlying architecture of Mautic and the plugin updating process being incompatible with the current, outdated update methods.<\/p>\n<p>From Mautic 4.2 there is a new setting which you can enable to tell Mautic that you are managing it through Composer, which will disable the built-in web-based updating system and enable you to manage plugins within the Marketplace.<\/p>\n<p>We have provided step-by-step instructions on how to switch to using Composer if you\u2019re not currently managing Mautic this way, in case you would like to switch to using this method &#8211; read more in the documentation <a href=\"https:\/\/mau.tc\/switch-to-composer\" target=\"_blank\" rel=\"noopener\">here<\/a>. From Mautic 5, the current updating methods will be removed and Composer will be the default way of managing installation and upgrades of Mautic &#8211; read more in <a href=\"https:\/\/www.mautic.org\/blog\/community\/important-changes-mautic-install-and-upgrade-process\">this blog post<\/a>.<\/p>\n<h2>How to use the Mautic Marketplace<\/h2>\n<p>From Mautic 4.2 there is a setting in the Global Configuration which allows you to selectively tell Mautic that you\u2019re using Composer to manage your installation, which will allow you to install and remove plugins through the Mautic Marketplace.\u00a0\u00a0\u00a0 It will also block updates in the user interface.<\/p>\n<p><img fetchpriority=\"high\" decoding=\"async\" class=\" size-full wp-image-14901\" src=\"https:\/\/www.mautic.org\/wp-content\/uploads\/2022\/02\/switch-enable-composer.png\" alt=\"A screenshot of the setting to enable Composer support\" title=\"\" width=\"1600\" height=\"410\" srcset=\"https:\/\/mautic.org\/wp-content\/uploads\/2022\/02\/switch-enable-composer.png 1600w, https:\/\/mautic.org\/wp-content\/uploads\/2022\/02\/switch-enable-composer-300x77.png 300w, https:\/\/mautic.org\/wp-content\/uploads\/2022\/02\/switch-enable-composer-1024x262.png 1024w, https:\/\/mautic.org\/wp-content\/uploads\/2022\/02\/switch-enable-composer-768x197.png 768w, https:\/\/mautic.org\/wp-content\/uploads\/2022\/02\/switch-enable-composer-1536x394.png 1536w\" sizes=\"(max-width: 1600px) 100vw, 1600px\" \/><\/p>\n<p>Please read the guidelines <a href=\"https:\/\/docs.mautic.org\/en\/marketplace\">here<\/a>.<\/p>\n<h3>Using the Mautic Marketplace in the User Interface<\/h3>\n<p>When the setting above has been enabled, you will be able to manage plugins with the Mautic Marketplace, and a notice will be displayed with a link to the documentation.<\/p>\n<p><img decoding=\"async\" class=\" size-full wp-image-14902\" src=\"https:\/\/www.mautic.org\/wp-content\/uploads\/2022\/02\/composer-read-only.png\" alt=\"Screenshot showing composer enabled with a blue notice saying it is in a basic format.\" title=\"\" width=\"1600\" height=\"621\" srcset=\"https:\/\/mautic.org\/wp-content\/uploads\/2022\/02\/composer-read-only.png 1600w, https:\/\/mautic.org\/wp-content\/uploads\/2022\/02\/composer-read-only-300x116.png 300w, https:\/\/mautic.org\/wp-content\/uploads\/2022\/02\/composer-read-only-1024x397.png 1024w, https:\/\/mautic.org\/wp-content\/uploads\/2022\/02\/composer-read-only-768x298.png 768w, https:\/\/mautic.org\/wp-content\/uploads\/2022\/02\/composer-read-only-1536x596.png 1536w\" sizes=\"(max-width: 1600px) 100vw, 1600px\" \/><\/p>\n<p>Once you have enabled the setting you will be able to search the marketplace using the filter, and install plugins by selecting the option from the dropdown item pictured above.<\/p>\n<p>If you haven\u2019t correctly set the Composer setting, you will see a warning that the Mautic Marketplace is available in read-only mode as below, with a link which explains how to transition to a Composer-managed installation.<\/p>\n<p><img decoding=\"async\" class=\" size-full wp-image-14903\" src=\"https:\/\/www.mautic.org\/wp-content\/uploads\/2022\/02\/need-to-enable-composer.png\" alt=\"A screenshot of the Mautic Marketplace alerting the user that they need to enable Composer support.\" title=\"\" width=\"1600\" height=\"630\" srcset=\"https:\/\/mautic.org\/wp-content\/uploads\/2022\/02\/need-to-enable-composer.png 1600w, https:\/\/mautic.org\/wp-content\/uploads\/2022\/02\/need-to-enable-composer-300x118.png 300w, https:\/\/mautic.org\/wp-content\/uploads\/2022\/02\/need-to-enable-composer-1024x403.png 1024w, https:\/\/mautic.org\/wp-content\/uploads\/2022\/02\/need-to-enable-composer-768x302.png 768w, https:\/\/mautic.org\/wp-content\/uploads\/2022\/02\/need-to-enable-composer-1536x605.png 1536w\" sizes=\"(max-width: 1600px) 100vw, 1600px\" \/><\/p>\n<h2>How to get my plugin listed on the Mautic Marketplace<\/h2>\n<p>We are in the process of moving our developer documentation to a new platform, please find the instructions on how to prepare your plugin for inclusion in the marketplace and how to submit your plugin for review <a href=\"https:\/\/mautic-developer.readthedocs.io\/en\/latest\/marketplace\/listing.html\" target=\"_blank\" rel=\"noopener\">here<\/a>.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>In Mautic 4.2 the Mautic Marketplace now enables you to install and manage plugins within Mautic, both in the user interface and at the command line. Read on to learn more about how it works, some caveats you need to know before using it, and how to get your plugins listed in the Marketplace.<\/p>\n","protected":false},"author":2,"featured_media":17301,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"publish_to_discourse":"","publish_post_category":"","wpdc_auto_publish_overridden":"","wpdc_topic_tags":"","wpdc_pin_topic":"","wpdc_pin_until":"","discourse_post_id":"","discourse_permalink":"","wpdc_publishing_response":"","wpdc_publishing_error":"","footnotes":""},"categories":[1498],"tags":[910,1343,1342],"class_list":["post-16700","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-product-news","tag-features","tag-marketplace","tag-mauticmarketplace"],"acf":[],"_links":{"self":[{"href":"https:\/\/mautic.org\/wp-json\/wp\/v2\/posts\/16700","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/mautic.org\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/mautic.org\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/mautic.org\/wp-json\/wp\/v2\/users\/2"}],"replies":[{"embeddable":true,"href":"https:\/\/mautic.org\/wp-json\/wp\/v2\/comments?post=16700"}],"version-history":[{"count":1,"href":"https:\/\/mautic.org\/wp-json\/wp\/v2\/posts\/16700\/revisions"}],"predecessor-version":[{"id":17164,"href":"https:\/\/mautic.org\/wp-json\/wp\/v2\/posts\/16700\/revisions\/17164"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/mautic.org\/wp-json\/wp\/v2\/media\/17301"}],"wp:attachment":[{"href":"https:\/\/mautic.org\/wp-json\/wp\/v2\/media?parent=16700"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/mautic.org\/wp-json\/wp\/v2\/categories?post=16700"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/mautic.org\/wp-json\/wp\/v2\/tags?post=16700"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}