Този сайт използва бисквитки. Чрез посещението си Вие приемате използването на бисквитки. Настройки.

След като сте създали и настроили Вашия онлайн магазин, можете да изтеглите нашия уиджет от раздел Свали уиджет. Там ще откриете ZIP архив, който трябва да разархивирате при файловете на Вашия уеб сайт.

Забележка: Нашият уиджет изисква PHP версия 5.6 или по-нова.

Инсталиране на уиджета на Вашия сайт

След като свалите widget.zip от секцията Изтегли уиджет, трябва да качите архива при Вашите уеб файлове и да разархивирате съдържанието му в подпапка на главната директория на Вашия сайт. След това може да посетите уеб адреса на уиджета. Ако главната директория на сайта Ви е /home/username/www/www и сте инсталирали уиджета в /home/username/www/www/hosting, уеб адресът на уиджета би бил http://your_website.com/hosting.

Страницата на уиджета включва примерни Hosting order и Domain search страници. Секцията Embed code е мястото, от което може да копирате код за вграждане и да го поставите в нова или вече съществуваща страница. Поставеният код ще вгради уиджета във Вашата страница. Секцията Embed code е видима само в случай, че онлайн магазинът е в тестов режим, което се определя от тази настройка в /app/config.php файла:

'test_mode' => true,
Конфигуриране на страница "Условия за ползване"

Може да създадете своя собствена страница "Условия за ползване", например terms.html, и да добавите линк към нея на своята страница за поръчка. Когато вече сте изготвили страницата, отворете файла с персоналния си превод (/app/language/en.php, /app/language/fr.php и пр.). Открийте променливата terms_agree и заменете диеза (#), ползван като href атрибут, с линк към Вашата страница "Условия за ползване":

'terms_agree' => 'I have read and will abide by the <a href="http://your_website.com/terms.html" target="_blank">Hosting Terms of Use</a>',

Запазете промените, за да приложите новите настройки.

Използване на персонализирана тема

Отворете директорията, в която сте инсталирали уиджета, след което влезте в директорията /public/theme. Създайте директория с името на новата тема, например /public/theme/aqua. В директорията /aqua създайте нова директория с име css. Отидете в /public/theme/dark/css и копирайте widget.css в /public/theme/aqua/css. Отворете /public/theme/aqua/css/widget.css и въведете желаните промени в CSS файла, за да промените изгледа на Вашите уиджет страници. За да ползва някоя уиджет страница новата тема, редактирайте кода за вграждане и напишете името на новата тема (например "aqua") като data-theme атрибут:

<div id="hosting-widget" class="hosting-widget" data-theme="aqua" data-widget="order"></div>
<script src="/hosting/js/embed.js" type="text/javascript"></script>

Можете да използвате различна тема за всяка отделна уиджет страница.

Използване на персонализиран превод

От инсталационната директория на уиджета отворете директорията /app/language. Копирайте файла en.php в /app/custom/language. Редактирайте текста в /app/custom/language/en.php, за да персонализирате текстовете на уиджет страниците си.

Ако искате да добавите нов език, преименувайте en.php, така че името на файла да съответства на желания език. Например можете да именувате файла fr.php за френски превод. Редактирайте fr.php, така че стандартните текстове на английски да са заменени с превода им на френски. Когато сте готови, се върнете в инсталационната директория на уиджета и отворете директорията /app. Отворете файла config.php и намерете променливата с име locale. Заменете текущия превод (en по подразбиране) с новия:

'locale' => 'fr',

Запазете промените, за да активирате новия превод.

Рзширяване на функционалността на уиджета чрез PHP куки за събития

В уиджета има файл на име app/custom/hooks.php. Той съдържа празни имплементации на поддържаните куки за събития. Ако искате да се изпълнява Ваш PHP код, когато някое от тези събития се случи, трябва да редактирате този файл.

Куките могат да бъдат включени с опцията enable_custom_hooks в конфигурационния файл на уиджета Ви. Трябва да добавите следния ред към конфигурационния масив, за да ги включите:

'enable_custom_hooks' => true,

След това Вашите куки за събития в hooks.php файла ще се изпълняват всеки път, когато се случи някое от събитията, за които са закачени.

Например ако искате да получавате имейл всеки път, когато е направена поръчка или е получено плащане, можете да сложите следния PHP код във файла hooks.php:

<?php
return [
	'order_created' => function($order, $input = []) {
		mail('your.email.address@example.com', 'Направена поръчка', "Направена е поръчка.\n" . var_export($order, true));
	},
	'payment_received' => function($payment, $input = [] ) {
		mail('your.email.address@example.com', 'Получено плащане', "Получено е плащане.\n" . var_export($payment, true));
	}
];

Този код ще Ви изпрати имейл с данните, които са попълнени в поръчката. Трябва да замените your.email.address@example.com в примера с действителен имейл адрес.

Рзширяване на функционалността на уиджета чрез добавяне на JavaScript функции за обратно извикване

Ако искате да се изпълнява Ваш JavaScript код, когато се зареди някоя от страниците на уиджета, можете да добавите JavaScript функция за обратно извикване към нея. Тази функция може да се добави в data-callback атрибута на HTML елемента, в който се зарежда конкретната страница.

Ето примерна имплементация на функция за обратно извикване, която се изпълнява при зареждане на страницата за поръчка в уиджета:

<!DOCTYPE html>
<html>
    <head>
        <meta charset="utf-8">
        <title>Тест на уиджета</title>
        <script>
        function custom_widget_callback() {
            console.log('Функцията за обратно извикване е изпълнена със следните аргументи:')
            console.log(arguments)
        }
        </script>
        <script src="/hosting/js/embed.js" type="text/javascript"></script>
    </head>
    <body>
        <div id="hosting-widget" class="hosting-widget" data-theme="light" data-widget="order" data-callback="custom_widget_callback"></div>
    </body>
</html>

Атрибутът data-callback="custom_widget_callback" на div елемента, в който се зарежда страницата за поръчка, казва на уиджета да изпълни JavaScript функцията custom_widget_callback() при зареждането на страницата.

Този пример ще направи запис в лога на браузъра, че функцията е била изпълнена.

API лог и лог за дебъгване

С цел дебъгване или записване на API заявки можете да включите записването в лог файлове чрез редактиране на файла /app/config.php. Всичко, което трябва да направите, е да премахнете коментара на съответния ред от кода:

'log' => BASE_DIR . '/storage/logs/api.log',
'debug' => BASE_DIR . '/storage/logs/api_debug.log',

Файловете api.log и api_debug.log ще бъдат автоматично създадени.

Използване на нашето хостинг решение и уиджет/WordPress разширение

Можете да използвате Вашия онлайн магазин на няколко места без никакви проблеми. С нашето хостинг решение можете да имате един уебсайт свързан с Вашия онлайн магазин. С нашия уиджет и WordPress разширение можете да свържете неограничен брой сайтове. По този начин можете да продавате продуктите от Вашия онлайн магазин на няколко различни уебсайта (всеки с със собствен дизайн, езици и валути), но всички поръчки ще са свързани с един онлайн магазин.