wpdesk / wpdesk-sdk
Requires
- php: >=7.4
- psr/log: ^1.1
- wpdesk/wp-wpdesk-license: ^4.1.0
Requires (Dev)
- humbug/php-scoper: 0.18.9
- sniccowp/php-scoper-wordpress-excludes: ^6.9
README
Ta paczka umożliwia szybką integrację wtyczki WordPress z systemem licencji i aktualizacji WP Desk. Wersja produkcyjna kodu (wraz z bibliotekami zależnymi) jest automatycznie izolowana (scoped) przy użyciu narzędzia PHP-Scoper. Chroni to przed konfliktami z innymi wtyczkami korzystającymi z tych samych bibliotek.
Wymagania
- Lokalnie zainstalowany PHP >= 7.4.
- Lokalnie zainstalowany Composer (dostępny globalnie w terminalu).
- System operacyjny z rodziny Unix (Linux / macOS).
Wymogi dotyczące wtyczki (Nagłówki i Changelog)
Aby integracja oraz system aktualizacji działały poprawnie, główny plik Twojej wtyczki powinien zawierać standardowe nagłówki WordPress i WooCommerce:
Requires at least(minimalna wersja WordPress)Tested up to(maksymalna przetestowana wersja WordPress)Requires PHP(minimalna wersja PHP)WC requires at least(minimalna wersja WooCommerce)WC tested up to(maksymalna przetestowana wersja WooCommerce)
Dodatkowo, w głównym katalogu wtyczki musi znajdować się plik changelog.txt przygotowany zgodnie z formatem Keep a Changelog.
Instrukcja instalacji
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
Important
Docelowy katalog musi nazywać się dokładnie 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ą.
Krok 2: Dołączenie integracji w kodzie wtyczki
W głównym pliku swojej wtyczki 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.