{"id":611,"date":"2023-12-11T12:44:21","date_gmt":"2023-12-11T12:44:21","guid":{"rendered":"https:\/\/help.kybernaut.cz\/help\/plugin-settings\/"},"modified":"2023-12-11T12:44:21","modified_gmt":"2023-12-11T12:44:21","slug":"plugin-settings","status":"publish","type":"ht_kb","link":"https:\/\/help.kybernaut.cz\/en\/help\/plugin-settings\/","title":{"rendered":"Plugin settings"},"content":{"rendered":"\n<p>Setting up the Messenger integration is done in <strong>WooCommerce \/ Settings<\/strong> under the <strong>Shipping \/ Messenger<\/strong> tab. You can adjust the shipping price classically via <strong>WooCommerce \/ Settings \/ Shipping<\/strong> as you are used to. If you haven&#8217;t installed the plugin yet, you want to start reading from the Installing the <a href=\"https:\/\/help.kybernaut.cz\/help\/instalace-pluginu\/\" data-type=\"ht_kb\" data-id=\"177\">plugin article<\/a>. <\/p>\n<figure class=\"wp-block-embed is-type-video is-provider-youtube wp-block-embed-youtube wp-embed-aspect-4-3 wp-has-aspect-ratio\"><div class=\"wp-block-embed__wrapper\">\n\n<div data-service=\"youtube\" data-id=\"b23D8ESL9SI\" data-title=\"Nastaven&iacute; pluginu Kybernaut Messenger\" data-autoscale style=\"position:absolute;top:0;right:0;bottom:0;left:0;\"><\/div><\/div><\/figure>\n\n<h2 class=\"wp-block-heading\">Basic settings<\/h2>\n\n<p>Below, we&#8217;ll go through the individual plugin settings in <strong>WooCommerce \/ Settings \/ Shipping \/ Messenger<\/strong> that need to be adjusted before you can start using it.  <\/p>\n\n<h3 class=\"wp-block-heading\">1. Integration<\/h3>\n\n<ol class=\"wp-block-list\">\n<li>Enter your <strong>username<\/strong> and <strong>password <\/strong>(the same as the one you use to log in to the portal in Messenger).<\/li>\n\n\n\n<li>Enter the <strong>importKey<\/strong> you should get from Messenger. If you don&#8217;t have one, contact <a href=\"https:\/\/www.messenger.cz\/kontakty\/praha.html\">their support<\/a>.<\/li>\n\n\n\n<li>For starters, I recommend <strong>Enable Debugging<\/strong>, which means saving all requests to Messenger so you know what&#8217;s going on in your store. Once you have tested it, you can disable logging. Requests that Messenger rejects outright as incorrect will be logged anyway.  <br\/><br\/>Most errors (missing data, etc.) will not be logged because Messenger does not process requests in real time. If you happen to make such a mistake, they will usually call you so you don&#8217;t have to worry.<\/li>\n<\/ol>\n\n<h3 class=\"wp-block-heading\">2. Transport settings<\/h3>\n\n<p>Set the <strong>shipping type<\/strong> &#8211; unless you have arranged a special one, leave the 106 type (economy delivery the day after pick-up).<\/p>\n\n<p>For proper cooperation with Messenger, the number of packages and their weight rounded to the nearest kilogram must be transmitted. Since it is not possible to estimate how you want to pack a package in WooCommerce in the case of multiple packages, I agreed with Messenger that the total weight of all packages will be divided by the number of packages (i.e. it does not reflect the actual packing), but should be enough to change the price.<\/p>\n\n<p>The weight of the shipment is calculated by the weight of the products<a href=\"https:\/\/help.kybernaut.cz\/help\/nastaveni-pluginu-messenger\/#pridani-hmotnosti-zbozi-ve-woocommerce\">(how to add the weight of the product?<\/a>) + the weight of the packaging material. You can specify this in the <strong>Weight of packaging material<\/strong> setting.<\/p>\n\n<p>You have the possibility to influence how many packages the goods will be divided into in two ways (the first one that is fulfilled is always used):<\/p>\n\n<ul class=\"wp-block-list\">\n<li><strong>Items per package<\/strong> &#8211; the number of items that are in one package (useful e.g. in the case of sending bottles of wine, etc.<\/li>\n\n\n\n<li><strong>Maximum package weight<\/strong> &#8211; if you have multiple small items that are better packed at once, you probably want to set a maximum package weight and a very high number of items in the package (e.g. sending cosmetics).<\/li>\n<\/ul>\n\n<p>If you need to change these values for certain cases, you can use the <a href=\"https:\/\/help.kybernaut.cz\/help\/filtry-pro-vyvojare-messenger\/\" data-type=\"ht_kb\" data-id=\"283\">available filters<\/a>, which your programmer can certainly handle.  <\/p>\n\n<h3 class=\"wp-block-heading\">3. Pick-up location<\/h3>\n\n<p>In this section, enter information about who will ship the packages for you and where they are to be picked up.<\/p>\n\n<h3 class=\"wp-block-heading\">4. Activation, adding transport and test<\/h3>\n\n<p>When you have all the basic settings ready, go all the way back to the top of the settings and enable the integration by checking <strong>Enable &#8211; Send orders to Messenger<\/strong>.<\/p>\n\n<p>Now it&#8217;s time to set up the Messenger transport method:<\/p>\n\n<ol class=\"wp-block-list\">\n<li>In the <strong>WooCommerce \/ Settings \/ Shipping<\/strong> tab, under Shipping Zones, select the Zone where you want to send items via Messenger<\/li>\n\n\n\n<li>Press the <strong>Add Shipping Method<\/strong> button and select the <strong>Messenger<\/strong> method <strong>.<\/strong><\/li>\n\n\n\n<li>Set price and custom shipping name<\/li>\n<\/ol>\n\n<p>If you are set up, you can send a test order to Messenger, which you can find in the <a rel=\"noreferrer noopener\" href=\"https:\/\/portal-test.messenger.cz\/portal\/login\" target=\"_blank\">Test Portal<\/a> under the <strong>Shipment Overview \/ All Shipments<\/strong> tab.  <\/p>\n\n<p>The order will be sent in the <strong>processing <\/strong> state, i.e. after payment has been made.<\/p>\n\n<p class=\"wp-block-ht-blocks-messages wp-block-hb-message wp-block-hb-message--withicon is-style-alert\">Unfortunately, Messenger does not guarantee the availability of the test portal &#8211; if your shipment does not appear there, please contact their support. They will advise you.<\/p>\n\n<p class=\"wp-block-ht-blocks-messages wp-block-hb-message wp-block-hb-message--withicon is-style-danger\">Attention &#8211; if you are sending an order to Messenger, please use an existing street, city and postcode when filling in the delivery address &#8211; orders with non-existing data will not get into Messenger at all.  <br><br>If you need to test in live operation, use the first and last name field and possibly a note on the order instead of a fictitious address.<\/p>\n\n<p>If everything is OK, you can turn off the test operation.<\/p>\n\n<h2 class=\"wp-block-heading\">Cash on delivery<\/h2>\n\n<p>The plugin automatically handles the delivery of COD and COD added by Woo shipping. If you need another payment method to be taken as a cash on delivery, you need to adjust it using the <a href=\"https:\/\/help.kybernaut.cz\/help\/filtry-pro-vyvojare-messenger\/#kbnt-messenger-cod-methods\">filter<\/a>, if you don&#8217;t know how to use it, <a href=\"https:\/\/help.kybernaut.cz\/potrebuji-pomoci\/\" data-type=\"page\" data-id=\"20\">email me<\/a>.<\/p>\n\n<h2 class=\"wp-block-heading\">Tracking delivery status<\/h2>\n\n<p>If you want to track the delivery status of an order in the administration, you need to send the address of your REST API to Messenger, which will process the shipment status. You can find it in <strong>WooCommerce \/ Settings \/ Shipping \/ Messenger<\/strong>:<\/p>\n\n<figure class=\"wp-block-image size-full\"><img loading=\"lazy\" decoding=\"async\" width=\"735\" height=\"187\" src=\"https:\/\/help.kybernaut.cz\/wp-content\/uploads\/2021\/11\/messenger_stav_objednavky.png\" alt=\"\" class=\"wp-image-278\" srcset=\"https:\/\/help.kybernaut.cz\/wp-content\/uploads\/2021\/11\/messenger_stav_objednavky.png 735w, https:\/\/help.kybernaut.cz\/wp-content\/uploads\/2021\/11\/messenger_stav_objednavky-300x76.png 300w, https:\/\/help.kybernaut.cz\/wp-content\/uploads\/2021\/11\/messenger_stav_objednavky-50x13.png 50w, https:\/\/help.kybernaut.cz\/wp-content\/uploads\/2021\/11\/messenger_stav_objednavky-60x15.png 60w, https:\/\/help.kybernaut.cz\/wp-content\/uploads\/2021\/11\/messenger_stav_objednavky-100x25.png 100w\" sizes=\"auto, (max-width: 735px) 100vw, 735px\" \/><\/figure>\n\n<p>Each time you change the status, a new note will be added to your order. In case of delivery, the order status will then change to <strong>Completed<\/strong>.<\/p>\n\n<h2 class=\"wp-block-heading\">Adding product weight in WooCommerce<\/h2>\n\n<p>For everything to work properly, you must have a weight added to each product offered. which you can check in <strong>WooCommerce<\/strong> Settings <strong>\/ Settings \/ Products \/ Warehouse.<\/strong> <\/p>\n\n<p>You can set it in the product detail in the <strong>Product Data \/ Shipping<\/strong> settings <strong>.<\/strong> <\/p>\n\n<figure class=\"wp-block-image size-full\"><img loading=\"lazy\" decoding=\"async\" width=\"642\" height=\"326\" src=\"https:\/\/help.kybernaut.cz\/wp-content\/uploads\/2021\/11\/messenger_hmotnost_produktu.png\" alt=\"\" class=\"wp-image-277\" srcset=\"https:\/\/help.kybernaut.cz\/wp-content\/uploads\/2021\/11\/messenger_hmotnost_produktu.png 642w, https:\/\/help.kybernaut.cz\/wp-content\/uploads\/2021\/11\/messenger_hmotnost_produktu-300x152.png 300w, https:\/\/help.kybernaut.cz\/wp-content\/uploads\/2021\/11\/messenger_hmotnost_produktu-50x25.png 50w, https:\/\/help.kybernaut.cz\/wp-content\/uploads\/2021\/11\/messenger_hmotnost_produktu-60x30.png 60w, https:\/\/help.kybernaut.cz\/wp-content\/uploads\/2021\/11\/messenger_hmotnost_produktu-100x51.png 100w\" sizes=\"auto, (max-width: 642px) 100vw, 642px\" \/><figcaption class=\"wp-element-caption\">Weight setting on product detail.<\/figcaption><\/figure>\n\n<p>Alternatively, you can use the <strong>Quick Edit<\/strong> or even the Bulk <strong>Edit<\/strong> action on the <strong>Product Overview <\/strong>if you have multiple products that weigh the same.<\/p>\n\n<figure class=\"wp-block-image size-full\"><img loading=\"lazy\" decoding=\"async\" width=\"718\" height=\"532\" src=\"https:\/\/help.kybernaut.cz\/wp-content\/uploads\/2021\/11\/messenger_hmotnost_produktu_rychla_uprava.png\" alt=\"\" class=\"wp-image-276\" srcset=\"https:\/\/help.kybernaut.cz\/wp-content\/uploads\/2021\/11\/messenger_hmotnost_produktu_rychla_uprava.png 718w, https:\/\/help.kybernaut.cz\/wp-content\/uploads\/2021\/11\/messenger_hmotnost_produktu_rychla_uprava-300x222.png 300w, https:\/\/help.kybernaut.cz\/wp-content\/uploads\/2021\/11\/messenger_hmotnost_produktu_rychla_uprava-50x37.png 50w, https:\/\/help.kybernaut.cz\/wp-content\/uploads\/2021\/11\/messenger_hmotnost_produktu_rychla_uprava-60x44.png 60w, https:\/\/help.kybernaut.cz\/wp-content\/uploads\/2021\/11\/messenger_hmotnost_produktu_rychla_uprava-100x74.png 100w\" sizes=\"auto, (max-width: 718px) 100vw, 718px\" \/><figcaption class=\"wp-element-caption\">Add or edit product weight from the <strong>Quick Edit<\/strong> menu in the product overview.<\/figcaption><\/figure>\n","protected":false},"excerpt":{"rendered":"<p>A guide to basic Messenger plugin settings.<\/p>\n","protected":false},"author":1,"template":"","format":"standard","meta":{"footnotes":""},"ht-kb-category":[53],"ht-kb-tag":[74,63],"class_list":["post-611","ht_kb","type-ht_kb","status-publish","format-standard","hentry","ht_kb_category-messenger-en","ht_kb_tag-quick-setup","ht_kb_tag-settings"],"_links":{"self":[{"href":"https:\/\/help.kybernaut.cz\/en\/wp-json\/wp\/v2\/ht-kb\/611","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/help.kybernaut.cz\/en\/wp-json\/wp\/v2\/ht-kb"}],"about":[{"href":"https:\/\/help.kybernaut.cz\/en\/wp-json\/wp\/v2\/types\/ht_kb"}],"author":[{"embeddable":true,"href":"https:\/\/help.kybernaut.cz\/en\/wp-json\/wp\/v2\/users\/1"}],"version-history":[{"count":1,"href":"https:\/\/help.kybernaut.cz\/en\/wp-json\/wp\/v2\/ht-kb\/611\/revisions"}],"predecessor-version":[{"id":612,"href":"https:\/\/help.kybernaut.cz\/en\/wp-json\/wp\/v2\/ht-kb\/611\/revisions\/612"}],"wp:attachment":[{"href":"https:\/\/help.kybernaut.cz\/en\/wp-json\/wp\/v2\/media?parent=611"}],"wp:term":[{"taxonomy":"ht_kb_category","embeddable":true,"href":"https:\/\/help.kybernaut.cz\/en\/wp-json\/wp\/v2\/ht-kb-category?post=611"},{"taxonomy":"ht_kb_tag","embeddable":true,"href":"https:\/\/help.kybernaut.cz\/en\/wp-json\/wp\/v2\/ht-kb-tag?post=611"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}