🔗 Gotowa integracja z Boostore na GitHub — skrypt API-commerce
API-commerce — to gotowy skrypt PHP z otwartym kodem źródłowym, który umożliwia zarządzanie treścią Twojej strony na Boostore.pro przez wygodne REST API. Uruchom go w 5 minut na lokalnym komputerze przez OpenServer lub Apache i zautomatyzuj pracę z produktami, artykułami, blokami wizualnymi i stronami witryny.
📄 Spis treści
- Czym jest API-commerce i do czego służy
- Instalacja, uruchomienie i konfiguracja skryptu
- Którymi sekcjami można zarządzać przez API
- Elastyczność parametrów — przykłady zapytań i filtry importu
- Pełny dostęp do treści HTML
- Wielojęzyczność — zarządzanie treścią we wszystkich językach
- Często zadawane pytania
🚀 1. Czym jest API-commerce i do czego służy
API-commerce — to skrypt PHP z otwartym kodem źródłowym, opublikowany na GitHub w repozytorium BooStore-pro/API-commerce. Pełni rolę pośrednika między Twoim lokalnym środowiskiem a stroną na Boostore.pro, udostępniając wygodne REST API do zarządzania treścią.
Skrypt umożliwia wykonywanie praktycznie wszystkich operacji dostępnych w panelu administracyjnym Boostore.pro, ale przez zapytania HTTP — otwiera to szerokie możliwości automatyzacji, integracji z CRM, systemami magazynowymi, generatorami treści (ChatGPT, sieci neuronowe) i dowolnymi zewnętrznymi usługami.
⚙ Co potrafi skrypt?
📦 Produkty
Tworzenie, edytowanie, usuwanie produktów. Zarządzanie cenami, stanami magazynowymi, atrybutami, zdjęciami, kategoriami. Masowy import i aktualizacja.
📝 Artykuły
Publikacja artykułów na bloga. Zarządzanie meta-tagami (title, description, keywords), kategoriami bloga, wersjami językowymi. Pełna kontrola treści HTML.
🗄 Bloki wizualne
Tworzenie i edytowanie bloków do budowy stron: nagłówki, stopki, sekcje z produktami, banery, galerie — wszystko, z czego składają się strony na Boostore.pro.
📄 Strony witryny
Zarządzanie stronami: główna, katalog, kontakt, o nas, landing page. Pełna kontrola HTML, bloków, parametrów SEO.
⚙ 2. Instalacja i uruchomienie skryptu przez OpenServer / Apache + PHP
Skrypt jest napisany w czystym PHP 7.4+ i nie wymaga skomplikowanej konfiguracji. Wszystko, czego potrzebujesz — serwer WWW Apache z obsługą PHP i curl. Rozważymy instalację na przykładzie OpenServer — najpopularniejszego narzędzia wśród web-developerów.
👉 Instalacja krok po kroku na OpenServer
Pobierz repozytorium z GitHub
Przejdź na github.com/BooStore-pro/API-commerce i pobierz archiwum ZIP lub sklonuj repozytorium przez Git:
Umieść skrypt w folderze domeny OpenServer
Rozpakuj archiwum do folderu OpenServer/domains/api-commerce.local/ lub do dowolnego innego folderu Twojej lokalnej domeny.
Skonfiguruj przez interfejs WWW
Po pierwszym uruchomieniu otwórz skrypt w przeglądarce — trafisz na stronę konfiguracji z wygodnym GUI. Poniżej — szczegółowy opis wszystkich parametrów.
mod_rewrite i rozszerzenie curl.
📦 3. Które sekcje są dostępne do zarządzania przez API na GitHub
API-commerce udostępnia endpointy dla wszystkich kluczowych sekcji Boostore.pro. Każdy endpoint obsługuje standardowe operacje CRUD (Create, Read, Update, Delete) przez metody HTTP: GET, POST, PUT, DELETE.
🗃 Pełna lista dostępnych sekcji
| Sekcja | Metody API | Opis |
|---|---|---|
| Artykuły / Blog | GET, POST, PUT, DELETE | Pełne zarządzanie artykułami: nagłówki, treść HTML, meta-tagi, kategorie bloga, wersje językowe, status publikacji |
| Strony | GET, POST, PUT, DELETE | Zarządzanie stronami witryny: główna, katalog, kontakt, landing page. Pełny dostęp HTML, parametry SEO, przypisanie bloków |
| Bloki wizualne (Bloki/Menu) | GET, POST, PUT, DELETE | Tworzenie i edytowanie bloków do budowy stron: bloki HTML, bloki produktów, menu, banery, galerie, karuzele — dowolne elementy edytora wizualnego Boostore.pro |
| Kategorie sklepu | GET, POST, PUT, DELETE | Tworzenie i edytowanie kategorii produktów, podkategorii, zagnieżdżanie, sortowanie |
| Producenci | GET, POST, PUT, DELETE | Zarządzanie producentami marek: tworzenie, edytowanie, przypisywanie do produktów |
| Kolekcje | GET, POST, PUT, DELETE | Zarządzanie kolekcjami produktów: tworzenie, edytowanie, sortowanie, zapełnianie |
| Produkty | GET, POST, PUT, DELETE | Zarządzanie katalogiem produktów: tworzenie, edytowanie, usuwanie, zarządzanie cenami, stanami magazynowymi, charakterystykami, zdjęciami |
📈 4. Elastyczność parametrów konfiguracji
Jedną z głównych zalet API-commerce jest elastyczny system ustawień. Skrypt umożliwia precyzyjne zarządzanie procesami importu i eksportu artykułów przez interfejs WWW konfiguracji. Wszystkie parametry są dostępne od razu po instalacji — bez edytowania plików PHP.
📋 Ustawienia ogólne
Podstawowe parametry określające połączenie ze stroną i filtrowanie treści:
| Parametr | Opis | Domyślna wartość |
|---|---|---|
| 🔑 Klucz dostępu (Consumer Secret) | Klucz API do autoryzacji na stronie Boostore.pro. Tworzony w panelu administracyjnym: «Ustawienia → API» | — wymagane do wypełnienia |
| 🌐 Adres strony | URL Twojej strony na Boostore.pro, np. https://mojastrona.boostore.pro | — wymagane do wypełnienia |
| 📂 Dozwolone kategorie | ID kategorii bloga, z którymi pracuje skrypt. Puste — wszystkie kategorie | wszystkie kategorie |
| 🌐 Język artykułu wzorcowego | Artykuły tego języka są traktowane jako wzorzec. Podczas pobierania artykułów w innych językach pola są porównywane i synchronizowane ze wzorcem | Polski (pl) |
📥 Filtry przy imporcie (pobieranie artykułów ze strony)
Parametry wpływające na pobieranie artykułów ze strony do lokalnych plików HTML. Pozwalają pobierać tylko potrzebne artykuły z wybranego okresu:
| Filtr / Parametr | Opis | Domyślna wartość |
|---|---|---|
| 📥 Artykułów na zapytanie (per_page) | Liczba artykułów pobieranych w 1 zapytaniu do API. Maksymalnie 2000 | 200 |
| 📅 Data od | Pobieraj tylko artykuły z datą publikacji nie wcześniejszą niż podana (format: dd.mm.rrrr) | — nie podano |
| 📅 Data do | Pobieraj tylko artykuły z datą publikacji nie późniejszą niż podana (format: dd.mm.rrrr) | — nie podano |
| 🌐 Język | Filtr po języku artykułu. Można wybrać konkretny język lub «wszystkie» | wszystkie |
| 🆔 ID > | Pobieraj tylko artykuły z ID większym niż podana wartość | 1000 |
| 🆔 ID < | Pobieraj tylko artykuły z ID mniejszym niż podana wartość | 5000 |
| 🔍 Wyszukiwanie po nazwie (slug) | Wyszukiwanie artykułów po fragmencie slug/name. Np.: shoes — znajdzie wszystkie artykuły zawierające słowo shoes w URL | — nie podano |
| 📂 Kategorie do filtrowania | Lista ID kategorii, z których pobierać artykuły. Jeśli nie wybrano żadnej — przetwarzane są wszystkie kategorie. Można podać kilka | wszystkie kategorie |
📁 Dodatkowe opcje struktury przy imporcie
- Rozdzielać planned do blog/planned/ — artykuły z zaplanowaną datą publikacji są zapisywane do osobnego folderu
blog/planned/ - Rozdzielać według folderów kategorii — każda kategoria bloga tworzy własny podfolder, struktura plików odwzorowuje strukturę kategorii
- Tylko z nazwą (pomijać bez name) — jeśli artykuł nie ma slug/name, jest pomijany przy imporcie
🔄 Korekta według wzorca
Po zapisaniu artykułów skrypt może automatycznie synchronizować określone pola z artykułem wzorcowym (po slug):
- multilangid — identyfikator grupy wielojęzycznej
- planned — data publikacji
- status — status publikacji (0/1)
- datestamp — data utworzenia/modyfikacji
📤 Filtry przy eksporcie (wysyłanie artykułów na stronę)
Parametry zarządzające publikacją lokalnych plików HTML na stronie Boostore.pro:
| Parametr | Opis | Domyślna wartość |
|---|---|---|
| 🔄 Tryb eksportu | Określa zachowanie przy wysyłce: «Dodawanie + aktualizacja» — tworzy nowe i aktualizuje istniejące artykuły; «Tylko dodawanie nowych» — pomija już istniejące; «Tylko aktualizacja istniejących» — nie tworzy nowych | Dodawanie + aktualizacja |
| 📦 Limit wysyłki | Ile artykułów można wysłać podczas jednego uruchomienia. Maksymalnie 5000 | 200 |
| 📅 Tryb daty publikacji | Jak określać datę: z meta-danych każdego artykułu lub wymuszenie dla wszystkich | Z meta-danych (data z każdego artykułu) |
| 📅 Nadpisać planned | Jeśli ustawić datę — zostanie zastosowana do WSZYSTKICH artykułów przy eksporcie. Puste — pobierać z meta-danych | — nie podano (z meta-danych) |
| 🔒 Status dostępu (status) | Tryb określania statusu publikacji: z meta-danych każdego artykułu lub wymuszenie 0/1 dla wszystkich | Z meta-danych (status z każdego artykułu) |
| 🔄 Korekta według wzorca | Które pola automatycznie poprawiać według artykułu wzorcowego przy wysyłce: multilangid, planned, status, datestamp | multilangid, planned, status, datestamp |
📅 Parametry zarządzania datami
API-commerce daje pełną kontrolę nad datami publikacji zarówno przy imporcie, jak i przy eksporcie:
| Tryb | Parametr | Jak działa |
|---|---|---|
| 📥 Import (filtr) | «Data od» / «Data do» | Pobiera tylko artykuły w zakresie dat. Wygodne dla importu przyrostowego — np. pobrać wszystko z ostatniego tygodnia |
| 📥 Import (struktura) | «Rozdzielać planned» | Artykuły z przyszłą datą publikacji są zapisywane w blog/planned/, a nie w głównym folderze. Szkice nie mieszają się z opublikowaną treścią |
| 📤 Eksport (tryb) | «Tryb daty publikacji» | «Z meta-danych» — każdy artykuł publikowany jest z własną datą. Jeśli wybrać «Wymuszenie» — wszystkie artykuły otrzymają jedną podaną datę |
| 📤 Eksport (nadpisanie) | «Nadpisać planned» | Pozwala masowo ustawić datę publikacji dla wszystkich wysyłanych artykułów. Np. aby zaplanować publikację na jutro |
| 🔄 Synchronizacja | «Korekta według wzorca: planned, datestamp» | Podczas synchronizacji artykułów wielojęzycznych daty wersji wzorcowej (zwykle polskiej) są kopiowane do pozostałych języków. Wszystkie wersje artykułu publikowane są jednocześnie |
sitecreate_pl, opublikowane w lipcu 2026 roku, z ID od 15000 do 16000. Ustawiasz filtry: język = pl, kategoria = 1418, data od = 01.07.2026, data do = 31.07.2026, ID > 15000, ID < 16000. Skrypt pobierze tylko potrzebne artykuły — żadnych śmieci.
📝 5. Pełny dostęp do treści HTML
Jedną z mocnych stron API-commerce jest możliwość przekazywania dowolnej treści HTML w praktycznie każdym polu: opis produktu, treść artykułu, zawartość bloku wizualnego, treść strony. Żadnych ograniczeń na tagi i atrybuty.
📄 Gdzie można używać HTML
📦 Produkty
Pełny opis produktu z tabelami parametrów, listą wyposażenia, recenzjami wideo, zagnieżdżonymi zdjęciami — dowolny HTML w polu description.
📝 Artykuły
Pełnowartościowe artykuły na bloga: nagłówki H1-H6, zdjęcia, tabele, listy, cytaty, bloki kodu, znaczniki Schema.org — wszystko, co obsługuje HTML.
🗄 Bloki
Bloki wizualne do budowy stron: banery, galerie, karuzele, formularze, wideo, animacje — dowolne konstrukcje HTML/CSS obsługiwane przez przeglądarkę.
📄 Strony
Pełna kontrola nad zawartością stron: główna, o nas, kontakt, landing page promocji — HTML, CSS (przez style inline lub podłączenie zewnętrznych plików), JavaScript.
📝 Przykład: treść HTML artykułu ze zdjęciem i listą
Na stronie ten HTML będzie poprawnie wyświetlony z nagłówkami, zdjęciem, listą i linkiem — jako pełnowartościowy artykuł na blogu.
🔄 6. Wielojęzyczność — zarządzanie treścią we wszystkich językach
Boostore.pro obsługuje wielojęzyczne strony «od razu po wyjęciu z pudełka». API-commerce w pełni współpracuje z tą funkcjonalnością — możesz tworzyć i edytować treść w dowolnym obsługiwanym języku strony przez jedno API.
🔄 Jak działa wielojęzyczność w API-commerce
Każdy obiekt (produkt, artykuł, blok, strona) może mieć kilka wersji językowych. Podczas tworzenia lub aktualizacji przez API podajesz parametr language — skrypt automatycznie tworzy lub aktualizuje odpowiednią wersję językową.
✅ Obsługiwane języki
API-commerce obsługuje wszystkie języki dostępne w Twojej instalacji Boostore.pro: polski (pl), ukraiński (ua), rosyjski (ru), angielski (en) i inne. Parametr language przyjmuje dwuliterowy kod języka ISO 639-1.
multilangid łączy różne wersje językowe jednego obiektu. Pozwala to przez API-commerce zarządzać całą wielojęzyczną stroną — tworzyć, aktualizować i synchronizować treść we wszystkich językach w ramach jednego skryptu lub crona.
❓ Często zadawane pytania dotyczące API-commerce
Odpowiedzi na najczęściej zadawane pytania dotyczące instalacji, konfiguracji i używania skryptu API-commerce do integracji z Boostore.pro.
Czy trudno zainstalować API-commerce bez doświadczenia w programowaniu?
Instalacja nie wymaga umiejętności programowania. Wystarczy pobrać archiwum z GitHub, rozpakować do folderu OpenServer i podać klucze API przez interfejs webowy skryptu. Cały proces zajmuje 5-10 minut. Do wykonywania zapytań API można użyć dowolnego klienta HTTP: Postman, Insomnia, curl lub gotowych skryptów z dokumentacji.
Czy można uruchomić skrypt nie na lokalnym PC, a na hostingu?
Tak. Skrypt działa na dowolnym hostingu z Apache + PHP 7.4+ i curl. Możesz umieścić go na osobnej subdomenie lub w osobnym folderze Twojej głównej domeny. Jednak dla zapewnienia bezpieczeństwa zaleca się umieszczanie skryptu na lokalnym komputerze lub w izolowanym środowisku, a nie w publicznym dostępie.
Jakie dane są potrzebne do połączenia z Boostore.pro?
Do połączenia będą potrzebne: URL Twojej strony na Boostore.pro i klucz API (tworzony w panelu administracyjnym w sekcji «Ustawienia → API»). Klucze mogą być różnych typów — tylko do odczytu lub z pełnym dostępem do wszystkich operacji jednym kluczem.
Czy są ograniczenia na liczbę zapytań do API?
Skrypt nie ma wbudowanych ograniczeń na liczbę zapytań. Ograniczenia mogą być ustawione na poziomie hostingu lub planu taryfowego Boostore.pro. Do masowych operacji (import tysięcy produktów) zaleca się stosowanie pauz między zapytaniami — skrypt obsługuje do tego asynchroniczne kolejki.
Czy można używać API-commerce do automatycznego importu produktów z CRM lub 1C?
Tak, to jeden z głównych scenariuszy użycia. Możesz skonfigurować eksport z CRM/1C w formacie JSON lub CSV, a skrypt API-commerce będzie przetwarzać te dane i tworzyć/aktualizować produkty na stronie. Skrypt obsługuje masowe tworzenie, aktualizację po SKU, zarządzanie stanami magazynowymi i cenami. Integracja konfigurowana jest przez zapytania HTTP z Twojego CRM.
Jak zapewniane jest bezpieczeństwo podczas pracy przez API?
API-commerce używa kluczy API do uwierzytelniania wszystkich zapytań. Zaleca się umieszczanie skryptu na lokalnym komputerze lub w zamkniętej podsieci, a nie w publicznym dostępie. Wszystkie zapytania do Boostore.pro wykonywane są przez HTTPS. Dla dodatkowego bezpieczeństwa można skonfigurować filtrowanie IP i ograniczyć dostęp do skryptu przez plik .htaccess.
Czy skrypt jest darmowy? Czy są ukryte opłaty?
API-commerce — w pełni darmowy skrypt z otwartym kodem źródłowym (licencja MIT). Możesz pobrać, zainstalować i używać go bez żadnych ograniczeń i ukrytych opłat. Kod źródłowy jest dostępny na GitHub do analizy, modyfikacji i dostosowania do własnych potrzeb.
Które wersje PHP są obsługiwane?
Skrypt działa na PHP 7.4, 8.0, 8.1, 8.2 i 8.3. Zaleca się używanie PHP 8.1+ dla maksymalnej wydajności. Wymagane jest rozszerzenie curl i json — są one włączone w standardowym pakiecie PHP.
Gdzie zadawać pytania i zgłaszać błędy?
Wszystkie pytania, sugestie i zgłoszenia błędów przyjmowane są przez GitHub Issues repozytorium. Możesz tam również zostawić swoją opinię lub zaproponować ulepszenie. Deweloper aktywnie wspiera projekt i odpowiada na pytania społeczności.