🤖 Instalowanie Botoscope w Twoim sklepie WooCommerce

Instalacja Botoscope w Twoim sklepie WooCommerce

Po utworzeniu bota, wykonaj te kroki, aby połączyć swoją stronę WooCommerce z Botoscope:

🛠 Krok 1: Edytuj plik wp-config.php

Na swoim serwerze otwórz plik wp-config.php swojej instalacji WordPress i dodaj następujące linie przed linią:

/* To wszystko, przestań edytować! Szczęśliwego publikowania. */

Użyj następującego kodu (pokazane wartości przykładowe):

define('BOTOSCOPE_BOT_TOKEN', '123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11');
define('BOTOSCOPE_BOT_NAME', 'myshop_bot');
define('BOTOSCOPE_PROXY_SERVER', 'https://c12-t2hx7w.s2.botoscope.com');
define('BOTOSCOPE_CLIENT_API_KEY', 'bs-4a83c23c-7410ebfa-ac4z2ba3-b42c4a3f');
define('BOTOSCOPE_CLIENT_PASS', '6Jw6rzVxfdjwBEMtxtl');
define('BOTOSCOPE_ADMIN_CHAT_ID', 1234567890);

🔤 Konfiguracja zestawu znaków bazy danych (Krytyczne dla wsparcia Emoji)

⚠️ Problem

Wiele instalacji WordPress nadal używa starego zestawu znaków utf8, który NIE obsługuje emoji. To spowoduje:

• ❌ Usuwanie emoji z nazw/opisów produktów
• ❌ Błędy bazy danych przy zapisywaniu treści z emoji
• ❌ Niepowodzenie tworzenia zamówień w Telegramie
• ❌ Niepowodzenia synchronizacji produktów między WooCommerce a Telegramem

✅ Rozwiązanie

Otwórz plik wp-config.php i znajdź te linie (zwykle w pobliżu ustawień bazy danych):

❌ BŁĘDNE (stary format - NIE obsługuje emoji):
define('DB_CHARSET', 'utf8');
define('DB_COLLATE', '');

Zmień je na:

✅ POPRAWNE (obsługuje emoji):
define('DB_CHARSET', 'utf8mb4');
define('DB_COLLATE', 'utf8mb4_unicode_ci');

📦 Krok 2: Zainstaluj wtyczkę Botoscope

1. Zaloguj się do panelu administracyjnego WordPress.
2. Przejdź do Wtyczki → Dodaj nową.
3. Prześlij plik ZIP wtyczki Botoscope.
4. Kliknij Zainstaluj teraz, a następnie Aktywuj.

⚙️ Krok 3: Uruchom początkową konfigurację

1. W panelu administracyjnym WordPress przejdź do Botoscope → System Controls.
2. Kliknij przycisk “Reset full bot data cache”.
3. Poczekaj około minuty — strona zostanie zsynchronizowana z Twoim sklepem Telegram

✅ Gotowe!

Twój sklep jest teraz połączony z Telegramem

Możesz teraz:

• Zarządzać swoimi produktami
• Konfigurować systemy płatności
• Kontrolować kategorie i ceny
• I wiele więcej — w zależności od potrzeb Twojego biznesu

🔧 Dodatkowe funkcje i rekomendacje

🧩 Filtrowanie produktów

Jeśli chcesz dodać zaawansowane filtrowanie produktów, zainstaluj wtyczkę
HUSKY – WooCommerce Products Filter Professional:
🔗 https://products-filter.com/downloads

💱 Przełączanie walut

Jeśli chcesz, aby Twoi klienci mogli przełączać się między walutami, zainstaluj wtyczkę
FOX – WooCommerce Currency Switcher Professional:
🔗 https://currency-switcher.com/downloads

📄 Pobieranie faktur PDF dla klientów

Jeśli chcesz, aby klienci mogli pobierać faktury PDF ze strony zamówienia lub e-maila, zainstaluj wtyczkę:
🔗 WooCommerce PDF Invoices & Packing Slips

Po instalacji przejdź do wp-admin/admin.php?page=wpo_wcpdf_options_page → zakładka Zaawansowane i zastosuj następujące ustawienia:

1. Typ dostępu do linku dokumentu → Pełny
2. Ładne linki do dokumentów → Tak
3. W zakładce Narzędzia → Generuj losowy tymczasowy katalog

Po zainstalowaniu jednej lub wszystkich zalecanych wtyczek, przejdź do ustawień Botoscope, otwórz zakładkę System Controls i kliknij przycisk “Reset full bot data cache”.

🔤 Konfiguracja kodowania bazy danych (Dla wsparcia Emoji)

🎯 Wybierz swoją metodę:

Oferujemy trzy proste sposoby na naprawienie kodowania. Wybierz ten, który najlepiej Ci odpowiada:

• Metoda 1: Wtyczka na jedno kliknięcie (Najłatwiejsza!) 🎉
• Metoda 2: Kod PHP (Dla deweloperów) 💻
• Metoda 3: Bezpośredni SQL (Największa kontrola) 🔧

✨ Metoda 1: Wtyczka na jedno kliknięcie (Zalecana dla początkujących)

To jest najłatwiejsza metoda – po prostu zainstaluj wtyczkę i kliknij jeden przycisk!

1. W panelu administracyjnym WordPress przejdź do Wtyczki → Dodaj nową
2. Wyszukaj “WP phpMyAdmin Extension”
3. Zainstaluj i aktywuj wtyczkę: WP phpMyAdmin Extension
4. Przejdź do Narzędzia → phpMyAdmin w panelu administracyjnym WordPress
5. Kliknij na zakładkę SQL
6. Skopiuj i wklej polecenia SQL z Metody 3 poniżej
7. Kliknij Go

💻 Metoda 2: Jednorazowy kod PHP

Jeśli czujesz się komfortowo z edytowaniem plików PHP, ta metoda automatycznie wykonuje konwersję po załadowaniu strony.

Opcja A: Przez funkcje WordPress (Tymczasowe)

1. Przejdź do Wygląd → Edytor plików motywu
2. Otwórz functions.php (prawy pasek boczny)
3. Dodaj ten kod na samym końcu pliku:

// TYMCZASOWE: Konwertuj bazę danych na UTF8MB4
// USUŃ TEN KOD PO JEDNORAZOWYM URUCHOMIENIU!
add_action('admin_init', function() {
    if (!get_option('botoscope_db_converted_utf8mb4')) {
        global $wpdb;
        
        $prefix = $wpdb->prefix;
        
        // Tabele WooCommerce
        $tables = [
            'woocommerce_order_items',
            'woocommerce_order_itemmeta',
            'woocommerce_payment_tokens',
            'woocommerce_payment_tokenmeta',
            'woocommerce_sessions',
            'woocommerce_shipping_zones',
            'woocommerce_shipping_zone_locations',
            'woocommerce_shipping_zone_methods',
            'woocommerce_tax_rates',
            'woocommerce_tax_rate_locations',
        ];
        
        // Tabele Botoscope
        $botoscope_tables = [
            'botoscope_advertising',
            'botoscope_booking_reservations',
            'botoscope_booking_slots',
            'botoscope_booking_slots_targeted',
            'botoscope_broadcast',
            'botoscope_controls',
            'botoscope_elogios',
            'botoscope_extensions',
            'botoscope_interface_translations',
            'botoscope_marketing_campaigns',
            'botoscope_marketing_campaigns_products',
            'botoscope_marketing_campaigns_products_excluded',
            'botoscope_marketing_campaigns_terms',
            'botoscope_marketing_strategies',
            'botoscope_marketing_strategies_formulas',
        ];
        
        $all_tables = array_merge($tables, $botoscope_tables);
        
        foreach ($all_tables as $table) {
            $full_table = $prefix . $table;
            $wpdb->query("ALTER TABLE {$full_table} CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci");
        }
        
        update_option('botoscope_db_converted_utf8mb4', time());
        
        echo ''; } });

4. Kliknij Aktualizuj plik
5. Przejdź do dowolnej strony w panelu administracyjnym WordPress (np. Pulpit)
6. Zobaczysz komunikat o sukcesie, gdy konwersja zostanie zakończona
7. WAŻNE: Wróć do functions.php i USUŃ kod, który właśnie dodałeś

Opcja B: Przez samodzielny plik PHP

1. Utwórz nowy plik o nazwie convert-db.php w katalogu głównym WordPress
2. Wklej ten kod do pliku:

<?php
// Załaduj WordPress
require_once('wp-load.php');

if (!current_user_can('manage_options')) {
    die('Access denied');
}

global $wpdb;
$prefix = $wpdb->prefix;

echo '<h1>Konwertowanie bazy danych na UTF8MB4...</h1>';

// Tabele WooCommerce
$tables = [
    'woocommerce_order_items',
    'woocommerce_order_itemmeta',
    'woocommerce_payment_tokens',
    'woocommerce_payment_tokenmeta',
    'woocommerce_sessions',
    'woocommerce_shipping_zones',
    'woocommerce_shipping_zone_locations',
    'woocommerce_shipping_zone_methods',
    'woocommerce_tax_rates',
    'woocommerce_tax_rate_locations',
];

// Tabele Botoscope
$botoscope_tables = [
    'botoscope_advertising',
    'botoscope_booking_reservations',
    'botoscope_booking_slots',
    'botoscope_booking_slots_targeted',
    'botoscope_broadcast',
    'botoscope_controls',
    'botoscope_elogios',
    'botoscope_extensions',
    'botoscope_interface_translations',
    'botoscope_marketing_campaigns',
    'botoscope_marketing_campaigns_products',
    'botoscope_marketing_campaigns_products_excluded',
    'botoscope_marketing_campaigns_terms',
    'botoscope_marketing_strategies',
    'botoscope_marketing_strategies_formulas',
];

$all_tables = array_merge($tables, $botoscope_tables);

foreach ($all_tables as $table) {
    $full_table = $prefix . $table;
    
    echo "Konwertowanie {$full_table}... ";
    
    $result = $wpdb->query("ALTER TABLE {$full_table} CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci");
    
    if ($result !== false) {
        echo '<span style="color: green;">✅ Sukces</span><br>';
    } else {
        echo '<span style="color: red;">❌ Niepowodzenie: ' . $wpdb->last_error . '</span><br>';
    }
}

echo '<h2 style="color: green;">✅ Konwersja zakończona!</h2>';
echo '<p><strong>WAŻNE:</strong> Usuń ten plik (convert-db.php) z serwera teraz!</p>';
?>

3. Prześlij plik do katalogu głównego WordPress (gdzie znajduje się wp-config.php)
4. Otwórz przeglądarkę i przejdź do: https://yoursite.com/convert-db.php
5. Poczekaj na zakończenie konwersji
6. WAŻNE: Usuń plik convert-db.php z serwera!

🔧 Metoda 3: Bezpośredni SQL w phpMyAdmin

To jest najbardziej bezpośrednia metoda, jeśli czujesz się komfortowo z używaniem phpMyAdmin.

📋 Instrukcje krok po kroku:

1. Zaloguj się do panelu sterowania hostingu (cPanel, Plesk, itp.)
2. Otwórz phpMyAdmin
3. Wybierz swoją bazę danych WordPress z lewego paska bocznego
4. Kliknij na zakładkę SQL u góry
5. Skopiuj i wklej poniższe polecenia SQL
6. Kliknij Go aby wykonać

-- Konwertuj tabele WooCommerce
ALTER TABLE wp_woocommerce_order_items CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
ALTER TABLE wp_woocommerce_order_itemmeta CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
ALTER TABLE wp_woocommerce_payment_tokens CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
ALTER TABLE wp_woocommerce_payment_tokenmeta CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
ALTER TABLE wp_woocommerce_sessions CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
ALTER TABLE wp_woocommerce_shipping_zones CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
ALTER TABLE wp_woocommerce_shipping_zone_locations CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
ALTER TABLE wp_woocommerce_shipping_zone_methods CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
ALTER TABLE wp_woocommerce_tax_rates CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
ALTER TABLE wp_woocommerce_tax_rate_locations CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;

-- Konwertuj tabele Botoscope
ALTER TABLE wp_botoscope_advertising CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
ALTER TABLE wp_botoscope_booking_reservations CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
ALTER TABLE wp_botoscope_booking_slots CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
ALTER TABLE wp_botoscope_booking_slots_targeted CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
ALTER TABLE wp_botoscope_broadcast CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
ALTER TABLE wp_botoscope_controls CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
ALTER TABLE wp_botoscope_elogios CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
ALTER TABLE wp_botoscope_extensions CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
ALTER TABLE wp_botoscope_interface_translations CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
ALTER TABLE wp_botoscope_marketing_campaigns CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
ALTER TABLE wp_botoscope_marketing_campaigns_products CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
ALTER TABLE wp_botoscope_marketing_campaigns_products_excluded CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
ALTER TABLE wp_botoscope_marketing_campaigns_terms CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
ALTER TABLE wp_botoscope_marketing_strategies CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
ALTER TABLE wp_botoscope_marketing_strategies_formulas CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;

-- Konwertuj podstawowe tabele WordPress (opcjonalne, ale zalecane)
ALTER TABLE wp_posts CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
ALTER TABLE wp_postmeta CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
ALTER TABLE wp_comments CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
ALTER TABLE wp_commentmeta CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
ALTER TABLE wp_terms CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
ALTER TABLE wp_term_taxonomy CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
ALTER TABLE wp_term_relationships CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
ALTER TABLE wp_termmeta CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
ALTER TABLE wp_users CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
ALTER TABLE wp_usermeta CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
ALTER TABLE wp_options CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
ALTER TABLE wp_links CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;

✅ Po konwersji (Wszystkie metody):

1. Przejdź do Botoscope → System Controls w panelu administracyjnym WordPress
2. Kliknij “Reset full bot data cache”
3. Przetestuj tworzenie zamówienia z emoji w nazwie produktu – powinno teraz działać! ✨