eKomi Official Oxid eSales Plugin

Description OXID eSales

eKomi Plugin for Oxid eShop allows you to integrate your Oxid eShop easily with the eKomi system. This allows you to collect verified reviews, display eKomi seal on your website and get your seller ratings on Google. This helps you increase your website's click-through rates, conversion rates and also, if you are running Google AdWord Campaigns, this helps in improving your Quality Score and hence your costs per click.

1. Key Features

   • Get Google Seller Ratings.

   • Increase click-through rate by over 17%

   • Increase Conversion Rate Key Features.

   • Collect order and product base Reviews.

   • Publish reviews on search engines: Google, Bing, Yahoo!

   • Manage Reviews: our team of Customer Feedback Managers reviews each and every review for any terms which are not allowed and also put all negative reviews in moderation.
     
     

2. Compatibility
   

   Oxid CE 4.7.x and above.
   
   

3. Download Plugin

   1. Download the zip file
      
      
      

4. Plugin Installation

   4.1. If you don't have an account with eKomi please register with us from https://store.ekomiapps.de/en/register
   4.2. Installation guides

   1. Plugin Installation

      1. Download the plugin.

      2. Unzip the file in a temporary directory.

      3. Upload it to “{root}/source/modules/” directory using FTP/SFTP.
         
         If your shop version is above 6.2, then please run these commands:
         

         cd <shop_directory>
         
         vendor/bin/oe-console oe:module:install-configuration source/modules/ekomi/ekomiintegration
         sudo composer config repositories.ekomi path source/modules/ekomi/ekomiintegration
         
         sudo composer update

         
         

      4. Remove the contents of “{root}/source/tmp” folder.
      5. Log in to the shop admin panel.
         
         
         
         
      6. Go to Extensions -> Modules ​and click “eKomi Integration”.
         
         
         
         
      7. Click on Overview ​and Activate the Plugin.
         
         
         
         

      8. Go to the "Settings" ​tab and click on Configuration.
         
         
         

         • Insert your Shop Id and Shop Secret
         • Select Mode. (for SMS, mobile number format should be according to E164)
         • Choose Status on which you want to send information to eKomi
         • Select the Export Method.
           - Order Status Change | Hook (Will export data when order status is modified to one of the configured order statuses)
           - Every hour | Cron  (Will export orders with configured status every hour)
         • Select Turnaround Time (Order Completion time in days). The turnaround time is a plugin configuration parameter that tells the plugin to check orders that go back that far into the past that match the chosen order state. E.g. you want to send to ekomi all orders that got the status “Order Completion” within the last 10 days, then you set the turnaround time to 10 days.
         • Select Product Identifier (How do you identify the product?)
         • Enter Exclude Products (Comma-separated Products IDs, which should not be sent to eKomi)
         • Enable / Disable Product Reviews ( if enabled, product attributes will also be sent to eKomi i.e.  product id, name, image, and URL )
         • Enable / Disable Show PRC Widget (Enable this if you want to show PRC widget)
         • Insert token in PRC Widget Token field. (Extract Token from the widget code provided by eKomi and insert here
         • Accept Terms and Conditions, if not accepted the plugin will not send data to eKomi.
         • Click on Save button to Save configurations.
           
           Note 1: Please make sure that the “Shop Id” and “Shop Secret” are correct.
           Note 2: Please contact support@ekomi.de if you want an opt-in function.
           

           Note 3: If you choose the Every hour (Cron) for the “export method”, please add below URL in crontab or cPanel Cron task manager and set it's execution time to every hour. Otherwise, this method will not work.
           

           <shop-url>/index.php?cl=ekomiintegrationcron&fnc=exportOrders

      9. Display PRC widget
         
         Insert this short-code on the product details page, where you want to display the widget:
         
         

         [{if class_exists('ekomiSmartWidget')}]
             [{oxid_include_widget cl="ekomiSmartWidget" oxid=$oDetailsProduct->oxarticles__oxid->value}]
         [{/if}]

         
         

         Will display as:
         
         
         

         Example: Installation on Default Theme(flow):
         

         1. open tabs.tpl in edit mode.
            <root>/Application/views/flow/tpl/page/details/inc/tabs.tpl

         2. Insert this code snippet.
            
            

            [{block name="details_tabs_ekomiprc"}]
                    [{capture append="tabs"}]<a href="#ekomiprc" data-toggle="tab">ekomi Reviews</a>[{/capture}]
                    [{capture append="tabsContent"}]
                        <div id="ekomiprc" class="tab-pane[{if $blFirstTab}] active[{/if}]">
                            [{if class_exists('ekomiSmartWidget')}]
                            [{oxid_include_widget cl="ekomiSmartWidget" oxid=$oDetailsProduct->oxarticles__oxid->value}]
                            [{/if}]
                        </div>
                        [{assign var="blFirstTab" value=false}]
                    [{/capture}]
            [{/block}]

            
            Will display as:
            
            
            

         
         

   4.3. Plugin installation Videos

   1. Installation Video
      
      

5. Troubleshooting

   eKomi headquarters in Berlin is the best place to start if you need help with this plugin. There are technical support team will get you up and running in time. Please contact at support@ekomi.de
   
   

6. Plugin Information

   • Maintenance status: Minimally maintained

   • Development status: Stable

   • Downloads: 21

   • Last modified: 23 June 2020
     
     

7. Recommended releases
   

   Version	Download	Date	Changelogs
   4.0.2	zip (29.4 kB)	16 February 2021	Added terms and conditions checkbox
   4.0.1	zip (27.2 kB)	23 June 2020	Fixed issue with the module activation.
   4.0.0	zip (27.2 kB)	05 June 2020	Fixed compatibility issues. Added composer.json
   3.1.2	zip (27.0 kB)	20 December 2019	Removed Smart Check feature
   3.1.1	zip (27.2 kB)	18 September 2019	Fixed Canonical URL issue.
   3.1.0	zip (27.1 kB)	16 September 2019	Remove the auto-enable customer segment functionality.
   3.0.0	zip (27.4 kB)	05 September 2019	Smart check feature Option to select the product identifier Option to exclude products Sending product image and URL Integration of smart widget PRC
   2.1.1	zip (18.6 kB)	29 May 2019	Load order status dynamically.
   2.1.0	zip (19.7 kB)	13 September 2018	Added Cron in export methods.