Bagisto Bagisto

Koszyk

Nie masz jeszcze nic w koszyku.

Twój koszyk jest pusty

Rozpocznij zakupy

Dokumentacja SDK

Zbuduj cokolwiek
na platformie SaaShop

Pełna dokumentacja techniczna dla deweloperów tworzących motywy, wtyczki i integracje dla sklepów Bagisto na platformie SaaShop.

Zacznij od Quickstart →

Bagisto 2.x · Laravel 11 · PHP 8.2+ · REST API · Webhooks

Laravel
znany stack techniczny
REST
pełne API sklepu
Satis
Composer dla pakietów
24h
wsparcie techniczne

Dokumentacja

Wszystko czego potrzebujesz jako deweloper

Wybierz sekcję i zacznij budować

🎨

Tworzenie motywów

Struktura motywu, widoki Blade, Tailwind CSS, integracja z Visual Edytorem, tłumaczenia i publikacja w Marketplace.

Czytaj dokumentację →
🔌

Tworzenie wtyczek

Architektura paczek Bagisto, Service Providerzy, eventy, obserwatorzy, migracje bazy danych i publikacja przez Satis.

Czytaj dokumentację →
⚡

REST API

Pełna dokumentacja endpointów API sklepu. Produkty, zamówienia, klienci, koszyk, płatności i zarządzanie magazynem.

Czytaj dokumentację →
🔔

Webhooks

Reaguj na zdarzenia w sklepie w czasie rzeczywistym. Nowe zamówienia, zmiany statusów, rejestracje klientów i płatności.

Czytaj dokumentację →
🖼️

Visual Editor SDK

Twórz konfigurowalne sekcje i bloki dla edytora wizualnego Bagisto Plus. Drag & drop, podgląd live, globalne ustawienia.

Czytaj dokumentację →
📦

Composer & Satis

Dystrybucja prywatnych paczek przez Composer Satis. Wersjonowanie, aktualizacje, kontrola dostępu i integracja z panelem dewelopera.

Czytaj dokumentację →

Quickstart

Pierwsze kroki z SDK SaaShop

1

Zainstaluj Bagisto lokalnie

Sklonuj repozytorium Bagisto i skonfiguruj środowisko deweloperskie przez Laravel Sail lub Herd.

composer create-project bagisto/bagisto
cd bagisto && php artisan serve
2

Dodaj repozytorium SaaShop Satis

Dodaj prywatne repozytorium Composer SaaShop aby mieć dostęp do SDK i przykładowych paczek.

composer config repositories.saashop
  composer https://satis.saashop.pl
composer require saashop/sdk-core
3

Wygeneruj szkielet paczki

Użyj generatora SaaShop CLI aby stworzyć gotową strukturę motywu lub wtyczki w kilka sekund.

php artisan saashop:make-package
  --type=theme MojFirma/MojMotyw
php artisan saashop:make-package
  --type=plugin MojFirma/MojPlugin
4

Opublikuj w Marketplace

Po zakończeniu pracy wyślij paczkę do weryfikacji przez panel dewelopera SaaShop. Certyfikacja trwa 48h.

php artisan saashop:publish
  --validate
php artisan saashop:submit MojFirma/MojMotyw

Przykład kodu

Czysty Laravel.
Znajomy stack.

SaaShop SDK jest w 100% oparte na Bagisto i Laravel. Jeśli znasz te frameworki, jesteś już w domu. Żadnych własnych abstrakcji, żadnego vendor lock-in – czysty, testowalny kod PHP.

Eventy, Service Providerzy, Eloquent, Blade – wszystko działa dokładnie tak jak w standardowym projekcie Laravel. Twój kod jest przenośny i łatwy w utrzymaniu.

  • ✓ PHP 8.2+ z pełnym typowaniem
  • ✓ Laravel 11 – eventy, queues, cache, broadcasting
  • ✓ Eloquent ORM – relacje, zakresy, obserwatorzy
  • ✓ Testy PHPUnit i Pest – pełne środowisko testowe
Zobacz pełne API Reference →
PHP · Service Provider
namespace MojFirma\MojPlugin\Providers;

use Illuminate\Support\ServiceProvider;
use SaaShop\SDK\Contracts\Plugin;

class MojPluginServiceProvider extends ServiceProvider
    implements Plugin {

  public function register(): void {
    // Rejestracja serwisów
    $this->app->singleton(
      'moj-plugin', MojPlugin::class
    );
  }

  public function boot(): void {
    // Eventy Bagisto
    Event::listen(
      'checkout.order.save.after',
      [OrderListener::class, 'handle']
    );
    $this->loadMigrationsFrom(
      __DIR__.'/../Database/Migrations'
    );
  }
}
PHP · Webhook Handler
// Rejestracja webhooka w config/saashop.php
'webhooks' => [
  'order.placed' =>
    OrderPlacedHandler::class,
  'order.shipped' =>
    OrderShippedHandler::class,
  'customer.registered' =>
    CustomerRegisteredHandler::class,
],

REST API

Najczęściej używane endpointy

Pełna lista dostępna w dokumentacji API Reference

GET /api/v1/products Lista produktów z filtrowaniem, sortowaniem i paginacją
POST /api/v1/checkout/order Złożenie zamówienia – kompletny flow checkout
GET /api/v1/orders/{id} Szczegóły zamówienia – produkty, adres, status, płatność
PUT /api/v1/orders/{id}/status Zmiana statusu zamówienia – wyzwala eventy i powiadomienia
GET /api/v1/customers/{id} Dane klienta – historia zamówień, adresy, grupy
POST /api/v1/inventory/update Aktualizacja stanów magazynowych – pojedynczo lub bulk
DEL /api/v1/cart/{id}/item Usunięcie produktu z koszyka – synchronizacja sesji

Dlaczego SaaShop SDK

Buduj szybciej, zarabiaj więcej

📚

Pełna dokumentacja

Każdy endpoint, każde zdarzenie, każda klasa opisana z przykładami kodu. Zero zgadywania jak coś działa.

🧩

Gotowe komponenty

Biblioteka gotowych komponentów UI, helpersów PHP i przykładowych paczek do pobrania i rozbudowy.

🔒

Bezpieczeństwo

Wbudowana obsługa CSRF, autoryzacja przez Sanctum, rate limiting i walidacja danych zgodna z OWASP.

🧪

Środowisko testowe

Sandbox z danymi testowymi, mock API i narzędzia do automatycznego testowania wtyczek przed publikacją.

💬

Społeczność deweloperów

Kanał Slack dla deweloperów SaaShop, forum techniczne i regularne AMA z zespołem platformy.

🔄

Changelog i migracje

Przejrzysty changelog przy każdej wersji SDK z instrukcjami migracji. Kompatybilność wsteczna przez minimum 2 wersje.

Zacznij budować dziś

Dokumentacja jest bezpłatna i dostępna bez rejestracji. Zarejestruj konto dewelopera gdy będziesz gotowy do publikacji.

Quickstart – zacznij w 5 minut → Zarejestruj konto dewelopera

Bezpłatna dokumentacja · Sandbox testowy · Wsparcie przez Slack