Poniższa instrukcja opisuje wymagania techniczne, proces instalacji integracji oraz sposób przygotowania wtyczki do publikacji i aktualizacji w systemie WP Desk. Najważniejsze elementy to: poprawne nagłówki wtyczki, plik changelog.txt, katalog wpdesk-integration.
Spis treści
1. Wymagania
Przed rozpoczęciem integracji upewnij się, że środowisko lokalne spełnia poniższe wymagania:
- PHP w wersji 7.4 lub nowszej, zainstalowany lokalnie.
- Composer zainstalowany lokalnie i dostępny globalnie w terminalu.
- System operacyjny z rodziny Unix, na przykład Linux lub macOS.
2. Wymogi dotyczące wtyczki
Nagłówki WordPress i WooCommerce
Aby integracja licencji oraz system aktualizacji działały poprawnie, główny plik wtyczki musi zawierać standardowe nagłówki WordPress i WooCommerce.
Requires at least— minimalna obsługiwana wersja WordPress.Tested up to— maksymalna przetestowana wersja WordPress.Requires PHP— minimalna wymagana wersja PHP.WC requires at least— minimalna obsługiwana wersja WooCommerce.WC tested up to— maksymalna przetestowana wersja WooCommerce.
Plugin Name.Przykład nagłówka wtyczki:
/**
Plugin Name: Moja Wtyczka
Requires at least: 6.7
Tested up to: 7.0
Requires PHP: 7.4
WC requires at least: 9.9
**/
Przykład changelog.txt wtyczki:
# [1.2.0] - 2026-06-21
## Added
- Dodano wsparcie dla WooCommerce 10.1
3. Instalacja pakietu integracyjnego
Krok 1: Uruchomienie instalatora
Przejdź w terminalu do głównego katalogu swojej wtyczki (np. wp-content/plugins/moja-wtyczka/) i wykonaj poniższe polecenie:
composer create-project wpdesk/wpdesk-sdk wpdesk-integration
wpdesk-integration. Skrypt instalacyjny wymaga tej nazwy do poprawnego działania.Instalator przeanalizuje wtyczkę i przygotuje paczkę integracyjną. Jeśli wtyczka posiada wiele plików z nagłówkiem Plugin Name w katalogu głównym, instalator poprosi o wskazanie, który z nich jest plikiem głównym.
Po zakończeniu konfiguracji i budowania, skrypt automatycznie usunie pliki instalatora, pozostawiając w katalogu wpdesk-integration wyłącznie gotową, zoptymalizowaną paczkę produkcyjną.
wpdesk-integration są unikatowe i nie mogą być kopiowane pomiędzy projektami. W przeciwnym razie wtyczka będzie wskazywała na niepoprawny produkt w systemie licencji.Krok 2: Dołączenie integracji w kodzie wtyczki
W głównym pliku swojej wtyczki (tym z nagłówkami WordPressa) dodaj następującą linię kodu:
require_once __DIR__ . '/wpdesk-integration/wpdesk-integration.php';
Katalog wpdesk-integration powinien zostać dodany do Twojego repozytorium i spakowany razem z wtyczką do dystrybucji.