{"id":13238,"date":"2023-11-08T12:14:27","date_gmt":"2023-11-08T18:14:27","guid":{"rendered":"https:\/\/www.mrc-productivity.com\/docs\/?post_type=ht_kb&#038;p=13238"},"modified":"2024-09-11T13:49:09","modified_gmt":"2024-09-11T18:49:09","slug":"when-to-use-which-version-of-m-painter","status":"publish","type":"ht_kb","link":"https:\/\/www.mrc-productivity.com\/docs\/knowledge-base\/when-to-use-which-version-of-m-painter","title":{"rendered":"m-Painter &#8211; Latest vs Legacy"},"content":{"rendered":"\n<h2 class=\"wp-block-heading\">Overview<\/h2>\n\n\n\n<p>This document will address various FAQs on which version of m-Painter is the best choice for your existing and new applications.<\/p>\n\n\n\n<p>This documentation will reference m-Painter as either &#8220;latest&#8221; or &#8220;legacy&#8221;. The most current m-Painter is called the latest m-Power, whereas its predecessor is the legacy m-Painter. <\/p>\n\n\n\n<p class=\"wp-block-ht-blocks-messages wp-block-hb-message wp-block-hb-message--withicon is-style-info\">The latest m-Painter editor is only available for customers running a m-Power January 2024 <a href=\"\/mrcjava\/servlet\/CUSTPORTAL.I00009s\">update<\/a> or later. <\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Which version of m-Painter is my application using?<\/h2>\n\n\n\n<p>Any existing application&#8217;s m-Painter Version can be identified via the Edit Properties section of the application. <\/p>\n\n\n\n<p>Within the Program Options tab, the property <em>m-Painter Version\/Mode<\/em> will be present, as displayed in Figure 1.<\/p>\n\n\n\n<figure class=\"wp-block-image size-large\"><a href=\"\/docs\/vue-images\/mpainterversion1.png\"><img decoding=\"async\" src=\"\/docs\/vue-images\/mpainterversion1.png\" alt=\"\"\/><\/a><figcaption class=\"wp-element-caption\">Figure 1: The Edit Properties section will identify which version of m-Painter is being used.<\/figcaption><\/figure>\n\n\n\n<p>The options in Figure 1 are explained below:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>Latest<\/strong> &#8211; The application is using the latest m-Painter. <\/li>\n\n\n\n<li><strong>Legacy<\/strong> &#8211;  The application is using the legacy m-Painter. <\/li>\n\n\n\n<li><strong>Text mode<\/strong> &#8211; Neither m-Painter GUI is used and the presentation is purely edited in HTML source mode.<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-ht-blocks-messages wp-block-hb-message wp-block-hb-message--withicon\">Any <strong>new <\/strong>applications will be defaulted to Latest or Legacy, depending on the <em>m-Painter Version<\/em> property set within the <a rel=\"noreferrer noopener\" href=\"\/docs\/knowledge-base\/interface-and-build-settings#application-options\" target=\"_blank\">Interface and Build Settings<\/a> of the data dictionary. This is discussed further down in this document.<\/p>\n\n\n\n<p>Visually, these two versions can be also be readily differentiated: <\/p>\n\n\n\n<div class=\"wp-block-group\"><div class=\"wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained\">\n<h3 class=\"wp-block-heading\">Latest m-Painter <\/h3>\n\n\n\n<p>This editor always opens in the current tab within the browser session, and is easily identifiable by the blue save button and green run button located at the left hand side of the screen.<\/p>\n\n\n\n<figure class=\"wp-block-image size-large is-resized\"><a href=\"\/docs\/vue-images\/mpainterversion3.png\"><img decoding=\"async\" src=\"\/docs\/vue-images\/mpainterversion3.png\" alt=\"image\"\/><\/a><figcaption class=\"wp-element-caption\">Figure 2: Latest m-Painter<\/figcaption><\/figure>\n<\/div><\/div>\n\n\n\n<div class=\"wp-block-group\"><div class=\"wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained\">\n<h3 class=\"wp-block-heading\">Legacy m-Painter<\/h3>\n\n\n\n<p>This editor always opens in a new tab (labeled &#8220;m-Painter&#8230;.&#8221;) within the current browser session and has all presentation options in a light grey toolbar:<\/p>\n\n\n\n<figure class=\"wp-block-image size-large\"><a href=\"\/docs\/vue-images\/mpainterversion2.png\"><img decoding=\"async\" src=\"\/docs\/vue-images\/mpainterversion2.png\" alt=\"\"\/><\/a><figcaption class=\"wp-element-caption\">Figure 3: Legacy m-Painter<\/figcaption><\/figure>\n\n\n\n<p>All m-Power applications created prior to the installation of the January 2024 m-Power update are using the legacy m-Painter. <\/p>\n\n\n\n<h3 class=\"wp-block-heading\" id=\"defaulting-the-version-of-m-painter-used-for-new-applications\">Using the new version of m-Painter for old applications<\/h3>\n\n\n\n<p>Existing dictionaries, created before the January 2024 update, will need a new property added that tells your applications if they should use the Latest or Legacy m-Painter.<\/p>\n\n\n\n<p>To add it, please open the Interface and Build Settings properties from the developer interface and use the Property Options -&gt; Text Mode feature to add this property manually via the text editor:<\/p>\n\n\n\n<p><strong><code>&lt;mpainter_version&nbsp;pdesc=\"mpainter_version\"&nbsp;value=\"2\"\/&gt;<\/code><\/strong><\/p>\n\n\n\n<p>Add this BEFORE the final&nbsp;<code>&lt;\/Application Options&gt;<\/code>&nbsp;tag and then save the file. You will then be able to edit this property\u2019s value via the interface:<\/p>\n\n\n\n<figure class=\"wp-block-image\"><img decoding=\"async\" src=\"https:\/\/www.mrc-productivity.com\/docs\/vue-images\/mpainterversion4.png\" alt=\"\"\/><\/figure>\n<\/div><\/div>\n\n\n\n<p class=\"wp-block-ht-blocks-messages wp-block-hb-message wp-block-hb-message--withicon is-style-info\">This dictionary property is necessary, but understand it will only affect whether <strong>new<\/strong> applications are set to use the Latest or Legacy m-Painter, by default.<\/p>\n\n\n\n<div class=\"wp-block-group\"><div class=\"wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained\">\n<h2 class=\"wp-block-heading\">What are the requirements for using the latest m-Painter?<\/h2>\n\n\n\n<p>In order to use the Latest m-Painter, <strong>all <\/strong>of the following conditions must be met regarding the application:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>The m-Power software version is on the <a href=\"\/docs\/knowledge-base\/m-power-updates\" data-type=\"ht_kb\" target=\"_blank\" rel=\"noreferrer noopener\">January 2024 update or later.<\/a><\/li>\n\n\n\n<li>The application is a newly created OR is an existing app recompiled with an HTML overwrite.<\/li>\n\n\n\n<li>The application&#8217;s template style is Bootstrap theme (set at the dictionary level). <\/li>\n\n\n\n<li>The <em>m-Painter Version<\/em>\/<em>Mode <\/em>property in the application&#8217;s properties must be set to Latest (as discussed at the beginning of this document).<\/li>\n<\/ul>\n<\/div><\/div>\n\n\n\n<h2 class=\"wp-block-heading\">Which version should I use?<\/h2>\n\n\n\n<p>If all of the above requirements above are met,  the latest m-Painter editor mrc recommends developers use. However for older customers who have existing Legacy applications and prefer this editor, individual applications may still use the legacy editor.  <\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Other FAQs<\/h2>\n\n\n\n<div class=\"wp-block-ht-blocks-accordion wp-block-hb-accordion\"><div class=\"wp-block-hb-accordion__section\" data-ht-blocks-accordion-block-state=\"closed\"><div class=\"wp-block-hb-accordion__title\"><span>Q: Can Sky theme or Retro theme applications utilize latest m-Painter?<\/span><\/div><div class=\"wp-block-hb-accordion__content\"><div class=\"wp-block-hb-accordion__contentwrap\">A: No. The latest m-Painter is <strong>only <\/strong>available for Bootstrap theme applications. <\/div><\/div><\/div><div class=\"wp-block-hb-accordion__section\" data-ht-blocks-accordion-block-state=\"closed\"><div class=\"wp-block-hb-accordion__title\"><span>Q: In one dictionary can some applications use legacy m-Painter, and others latest m-Painter?<\/span><\/div><div class=\"wp-block-hb-accordion__content\"><div class=\"wp-block-hb-accordion__contentwrap\">A: Yes! Each individual application&#8217;s properties allow developers to specify which version of m-Painter will be used.<\/div><\/div><\/div><div class=\"wp-block-hb-accordion__section\" data-ht-blocks-accordion-block-state=\"closed\"><div class=\"wp-block-hb-accordion__title\"><span>Q: I have a existing Bootstrap application that uses legacy m-Painter. Now I want to use latest m-Painter What do I need to do?<\/span><\/div><div class=\"wp-block-hb-accordion__content\"><div class=\"wp-block-hb-accordion__contentwrap\">A: In Edit Properties of the application, set the <em>m-Painter Version\/Mode<\/em> property to Latest. Then recompile the application with an HTML overwrite.<\/div><\/div><\/div><div class=\"wp-block-hb-accordion__section\" data-ht-blocks-accordion-block-state=\"closed\"><div class=\"wp-block-hb-accordion__title\"><span>Q: Can I use both m-Painter versions in one app? <\/span><\/div><div class=\"wp-block-hb-accordion__content\"><div class=\"wp-block-hb-accordion__contentwrap\">A: No, a single application can only to be set to use legacy m-Painter or latest m-Painter. <\/div><\/div><\/div><div class=\"wp-block-hb-accordion__section\" data-ht-blocks-accordion-block-state=\"closed\"><div class=\"wp-block-hb-accordion__title\"><span>Q: Are there any runtime differences between using legacy m-Painter and latest m-Painter?<\/span><\/div><div class=\"wp-block-hb-accordion__content\"><div class=\"wp-block-hb-accordion__contentwrap\">A: No. The functionality of the application&#8217;s selected template remains the same, regardless of which m-Painter is used. <\/div><\/div><\/div><div class=\"wp-block-hb-accordion__section\" data-ht-blocks-accordion-block-state=\"closed\"><div class=\"wp-block-hb-accordion__title\"><span>Q: What if I use latest m-Painter in my app but then later decide I want to switch back to legacy m-Painter? <\/span><\/div><div class=\"wp-block-hb-accordion__content\"><div class=\"wp-block-hb-accordion__contentwrap\">A: You may switch between the versions anytime you&#8217;d like. Please just make sure anytime you switch however you recompile the application with an HTML overwrite. <\/div><\/div><\/div><\/div>\n","protected":false},"excerpt":{"rendered":"<p>Overview This document will address various FAQs on which version of m-Painter is the best choice for your existing and new applications. This documentation will reference m-Painter as either &#8220;latest&#8221; or &#8220;legacy&#8221;. The most current m-Painter is called the latest m-Power, whereas its predecessor is the legacy m-Painter. Which version&#8230;<\/p>\n","protected":false},"author":2,"comment_status":"closed","ping_status":"closed","template":"","format":"standard","meta":{"footnotes":""},"ht-kb-category":[255],"ht-kb-tag":[],"class_list":["post-13238","ht_kb","type-ht_kb","status-publish","format-standard","hentry","ht_kb_category-mpainter"],"_links":{"self":[{"href":"https:\/\/www.mrc-productivity.com\/docs\/wp-json\/wp\/v2\/ht-kb\/13238","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.mrc-productivity.com\/docs\/wp-json\/wp\/v2\/ht-kb"}],"about":[{"href":"https:\/\/www.mrc-productivity.com\/docs\/wp-json\/wp\/v2\/types\/ht_kb"}],"author":[{"embeddable":true,"href":"https:\/\/www.mrc-productivity.com\/docs\/wp-json\/wp\/v2\/users\/2"}],"replies":[{"embeddable":true,"href":"https:\/\/www.mrc-productivity.com\/docs\/wp-json\/wp\/v2\/comments?post=13238"}],"version-history":[{"count":41,"href":"https:\/\/www.mrc-productivity.com\/docs\/wp-json\/wp\/v2\/ht-kb\/13238\/revisions"}],"predecessor-version":[{"id":14300,"href":"https:\/\/www.mrc-productivity.com\/docs\/wp-json\/wp\/v2\/ht-kb\/13238\/revisions\/14300"}],"wp:attachment":[{"href":"https:\/\/www.mrc-productivity.com\/docs\/wp-json\/wp\/v2\/media?parent=13238"}],"wp:term":[{"taxonomy":"ht_kb_category","embeddable":true,"href":"https:\/\/www.mrc-productivity.com\/docs\/wp-json\/wp\/v2\/ht-kb-category?post=13238"},{"taxonomy":"ht_kb_tag","embeddable":true,"href":"https:\/\/www.mrc-productivity.com\/docs\/wp-json\/wp\/v2\/ht-kb-tag?post=13238"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}