WooCommerce

Онлайн магазини, базирани на WordPress с WooCommerce плъгин, могат лесно да се интегрират Mokka като платежен метод, със специално разработения модул, който поддържаме. По-долу в тази статия е описано как можете да инсталирате и конфигурирате плъгина на Mokka за интеграция с WordPress уебсайтове в електронния си магазин, работещ с WooCommerce.

В тази статия е описано как можете да инсталирате и конфигурирате плъгина на Mokka за интеграция на електронни магазини, работещи под WooCommerce (WordPress).

Съдържание: 

• Инсталация
  • Инсталация на Mokka плъгин за WordPress през административния панел
  • Инсталация на WordPress Mokka плъгина в CPanel
• Конфигуриране на Mokka за WooCommerce
  • таб "API settings"
  • Таб "Store settings"
  • "Statuses" tab
  • Таб "Checkout"
  • Таб "Widget & Popup"
  • Таб "Additional"

 

 

Инсталация на плъгин "Mokka for WooCommerce"

Модулът на Mokka се инсталира ръчно като плъгин за WordPress.
Преди да пристъпите към интеграцията на услугата Mokka във вашия онлайн магазин, е необходимо първо да изтеглите плъгина на Mokka за WooCommerce и да го добавите на сървъра на онлайн магазина.

Можете да направите това по три начина, описани по-долу.

 

Инсталация на Mokka плъгин за WordPress през административния панел

За да инсталирате плъгина на Mokka през административния панел на WordPress, трябва да следвате долните стъпки:

1) Влезте в административния панел на уебсайта си с потребител, който има роля ”Администратор”.
2) От лявото меню, навигирайте до Разширения ("Plugins") и от допълнителното меню изберете “Добавяне на още” ("Add new").

3) В горния ляв ъгъл на страницата, кликнете на бутона “Качване на разширение” ("Upload Plugin").

 

4) Кликнете на бутона “Choose file” и изберете сваления файл в "zip" формат и клинете на бутона “Инсталиране” ("Install Now")

5) След като плъгинът се качи кликнете на бутона на “Инсталиране” ("Install Now")

6) След успешната инсталация, натиснете бутона “Активиране” ("Activate plugin")

7) Плъгинът ще се появи в меню "Woocommerce"-> "Мокка payment".

След като плъгинът е активиран, можете да преминете към конфигурация.

 

Инсталация на WordPress Mokka плъгина в CPanel

За инсталация през CPanel-а, трябва да разполагате с потребителско име и парола за CPanel на уебсайта, след което да влезете в него и да отидете във “File Manager”.

1) Отваряте папка “public_html”, след това - папка “wp_content”, която се намира в нея, и накрая - папка “plugins”

2) В папка “plugins” кликвате на “Upload” в горната част на страницата

3) Отваря се нов прозорец. Изберете .ZIP файла на плъгина, който се намира на компютъра и го качете.

4) Върнете се в папка “plugins”, където ще видите файла в ZIP формат. Кликнете с десен бутон на файла и изберете “Extract”.

5) Потвърдете разархивирането на файловете в папка “plugins”.
6) След като разархивирането приключи, изтрийте ZIP файла с плъгина и можете да излезете от CPanel акаунта.
7) Отворете административния панел на онлайн магазина и отидете в меню “Разширения” (“Plugins”), подменю “Инсталирани” (Installed). Там ще видите плъгина "Mokka for WooCommerce".  Кликнете на линка “Активиране” под името “Mokka for Woocommerce”

7) Подменю "Mokka payment" ще се появи в меню "Woocommerce"-> подменю "Мокка payment".

След като плъгинът е активиран, можете да преминете към конфигурация.

 

Конфигуриране на Mokka за WooCommerce

Платежният метод Mokka ще бъде наличен при приключване на поръчката в онлайн магазина ви, след като направите няколко нястройки в модула, намиращ се като подменю в WooCommerce. 

 

Tab "API settings"

1) От административния панел на онлайн магазина, навигирайте то меню “WooComerce" и изберете подменю "Mokka payment".

2) Отваря се страница с няколко таба. По подразбиране е отворен табът "API settings”.
В него трябва да въведете следните данни, които сте получили като част от материалите за интеграция на Mokka:

• Status - показва статуса на модула Mokka: enabled (активен) или disabled (неактивен).
  • Disabled - ако от падащото меню изберете статусът да е неактивен, Mokka няма да се показва като платежен метод във вашия електронен магазин
  • Enabled - ако изберете “активен” от падащото меню, Mokka ще се визуализира в списъка с начините за плащане в количката на онлайн магазина.
• Test mode - отметката не трябва да бъде поставена
  • отметка на тази настройка се поставя, за тестове и корекции на интеграцията в тестова среда. Тестовата среда има ограничена функционалност за потребителите и данните, получени от нея, не влизат в базата данни на Mokka.
• Store ID - Идентификационен номер на магазина в системата на Mokka.
  Можете да го откриете като част от инструкциите за интеграция, които са ви предоставени от Mokka.
• Secret key - парола за свързване към системата на Mokka.
  Можете да я откриете като част от инструкциите за интеграция, които са ви предоставени от Mokka.
• Base URL address - основният URL адрес за свързване с продукционна среда на Mokka. Линкът ще ви бъде предоставен от служител на Mokka
• Store ID (Test mode) and Secret key (Test mode) - полетата не са задължителни за попълване.
  При извършване на тестове на тестова среда, служител на Mokka, ще ви предостави необходимите данни
• Base URL address (Test mode) - URL адрес за тестови цели, не е задължително за попълване
  При извършване на тестове на тестова среда, служител на Mokka, ще ви предостави необходимите данни
• Orders page - линк за бърза навигация към страницата за покупки. Генерира се автоматично и не може да бъде променян.

3) След като извършите конфигурацията, кликнете на бутона “Save settings” и можете да преминете към следващите табове за конфигурация и настройка.

 

Таб "Store settings"

1) Отворете таб "Store settings" на страницата Mokka Payments

• Minimum Order Value - трябва да бъде същата сума, която е вписана в Приложение 2 към Договора за факторинг и сътрудничество, на ред “Минимален размер на Вземането"
• Maximum Order Value - трябва да бъде същата сума, която е вписана в Приложение 2 към Договора за факторинг и сътрудничество, на ред “Максимален размер на Вземането”
• Maximum percentage, % - процентът от сумата, която клиентът може да плати към Mokka; за България в момента тази стойност е винаги "100"
• Valid till (Hours:Minutes) - задайте същото време, както на сървъра, на който се намира уебсайтът
• Generate invoice after Mokka accepted payment - тази настройка за генериране на фактура след одобрение на плащането от клиента със сума Mokka
• Show for all deliveries - при поставяне на отметка в чекбокса, платежният метод Mokka ще се показва за всички начини на доставка, налични в онлайн магазина.
• Sort Order - позиция на Mokka в списъка с платежни методи на страницата за завършване на поръчката.
• Show for all deliveries - избор на методи за доставка, за които Mokka ще е налична като метод за плащане.
• Shipping methods – списък с начините за доставка, налични в магазина. При поставяне на отметка на един или няколко начина за доставка, Mokka ще бъде наличен метод за плащане само за тях. За тези, за които няма поставена отметка, потребителите няма да имат възможност да платят с Mokka.

 

Таб “Statuses”

В таб “Statuses” се прави връзка между статусите за поръчка, налични в Mokka и тези на онлайн магазина. По-долу са обяснени различните статуси на поръчка на Mokka, за да знаете към кои от статусите във вашия онлайн магазин да ги свържете.

• Сanceled orders - статус за анулирани поръчки. В него услугата Mokka се анулира за потребителя и от страна на Mokka.
• Finalized orders - статус, който изпраща информация към Mokka, че поръчката е завършена от страна на магазина. Обикновено това е статис, който показва, че поръчката е доставена на клиента.
• New order - статус, който изпраща информация към Mokka, че има създадена нова поръчка в онлайн магазина, за който все още няма решение от страна на Mokka за отпускане на сума Mokka или клиентът не е завършил процеса по поръчка.
• Full returned orders - статус за поръчки, които са изцяло върнати. При него, използваната сума Mokka се връща към акаунта на потребителя.
  Към момента плъгинът на Mokka не поддържа частично връщане на поръчки.
• Approved orders - статус, който показва положителен отговор за отпускане на сума Mokka към потребителя от страна на Mokka. Поръчката е завършена, но не е приклюена.
• Declined orders - статус, който показва отказ за отпускане на сума Mokka към потребителя от страна на Mokka. Поръчката не може да бъде завършена с плащане с Mokka. За да бъде завършена, трябва да бъде избран друг метод за плащане.

Свързване на статуси в таба:

Таб “Checkout”

В таб "Checkout" се конфигурира начинът, по който Mokka се визуализира в количката в онлайн магазина.

Тъй като текстовете и логото на Mokka по подразбиране за плъгина са на английски, те трябва бъдат променени със съответните на български език, както е описано по-долу.

• Widget display type - изберете "Uploaded Image"
  • Uploaded Image - от тук можете да качите логото на Mokka, което ви е изпратено като част от помощните материали за интеграция на Mokka. Трябва да кликнете на изображението, вляво от настройката и да качите файла от компютъра си.  
  • Image URL - можете да оставите полето празно. 
    Полето се попълва, когато имате URL адрес към изображението на логото на Mokka - в този случай, той се поставя тук. При избор на визуализация на логото на Mokka чрез линк към изображението, в "Widget display type" трябва да изберете "Image url". 
• Payment method title - името на платежния метод Mokka, по начина, по който ще се показва на страницата за завършване на поръчката.
  Трябва да бъде попълнено с “Mokka - купи сега, плати после”.
• Payment method title color - определя цвета на името на платежния метод на страницата за завършване на поръчката.
  Кодът на цвета е: “#FF5A1E”.
• Inactive payment method text - текстът, който се визуализира в попъп, в случай, че стойността на поръчката е по-ниска от минималната сума за поръчка с Mokka в онлайн магазина или по-висока от максималната сума за поръчка с Mokka в магазина.

Таб “Widget & Popup”

В таб “Widget & Popup” се правят настройки на начина, по който ще се показва Mokka в списъка с продукти, както и на продуктовата страница.

Полетата трябва да се попълнят по следния начин:

• Widget display - определя къде да се визуализира Mokka:
  • Product page - при поставянето на отметка на този чекбокс, уиджетът на Mokka ще се визуализира на страницата на продукта
  • Category page - при поставянето на отметка на този чекбокс, уиджетът на Mokka ще се визуализира на страницата със списъка с продукти, за всеки продукт.
• Maximum number of loan months - максималният брой месеци, за които потребителят може да връща сумата за поръчка, според Приложение 2 към Договора за факторинг и сътрудничество с Mokka.
• Minimum number of loan months - минималният брой месеци, за които потребителят може да връща сумата за поръчка, според Приложение 2 към Договора за факторинг и сътрудничество с Mokka.
  Обикновено стойността за това поле е “1”.
• Widget display type - тази настройка ви позволява да изберете начина, по който ще изглежда уиджетът на Mokka в списъка с продуктите и на продуктовата страница.
• Widget content - това поле позволява да се променя текста в уиджета на Mokka. Могат да се използват HTML тагове. Текстът в HTML формат ще ви бъде изпратен заедно с останалите материали за конфигурация на Mokka за WooCommerce
• Popup content - елементът се използва за настройка на съдържанието на попъп прозореца, който се показва при клик на иконката с въпросителен знак на уиджета на Mokka. Могат да бъдат използвани HTML тагове. Текстът в HTML формат ще ви бъде изпратен заедно с останалите материали за конфигурация на Mokka за WooCommerce

 

Таб "Additional"

Настройките в таб “Additional” не са задължителни. Те се използват за свързване към Airbrake за записване на грешки при използване на Mokka.

• Enable Airbrake error logging - активира лог на грешките чрез Airbrake. По подразбиране е деактивирано.
• Airbrake Project ID - ID на проекта в Airbrake. Задължително за попълване, ако се активира записване на грешките с Airbrake.
• Airbrake Project Key - продуктовият ключ в Airbrake. Задължително за попълване, ако се активира записване на грешките с Airbrake.
• Send client related metadata to Revo Core - ако тази опция е избрана, плъгинът изпраща мета данни за потребителя към подсистемите на Revo Core.
• Prefill fields - изпраща потребителски данни (име, контактна информация и други), като част от процеса на регистрация и завършване на поръчката за автоматично попълване на формите за регистрация.

 

Когато всички промени по всички табове са завършени, натиснете бутона "Save settings" в края на страницата, за да бъдат запазени и отразени в електронния магазин.