Handbook v1.0

Handbook dla Twórców
AddonsHub · Przewodnik kompletny

Wszystko co musisz wiedzieć, żeby opublikować moduł PrestaShop, zarządzać profilem i korzystać z API — w jednym miejscu.

Quickstart Wymagania Moderacja API SEO Tips FAQ
W tym dokumencie

Quickstart — opublikuj pierwszy moduł w 5 minut

1
Zarejestruj konto

Podaj e-mail i nazwę. Po rejestracji na Twój adres trafi kod weryfikacyjny (2FA).

Zarejestruj →
2
Aktywuj rolę Vendor

W Panelu → Typ konta wybierz „Twórca modułów". Profil Vendor zostanie automatycznie utworzony.

Panel →
3
Uzupełnij formularz

Kliknij „Dodaj moduł" w Panelu. Wypełnij nazwę, opis, kompatybilność PS, cenę i link do zakupu.

Dodaj moduł →
4
Wyślij do moderacji

Kliknij „Wyślij do moderacji". Audyt zajmuje do 48h w dni robocze. Wynik dostaniesz mailem.

Status: pending → published

Wymagania dla modułu

Wymagania obowiązkowe ✅

  • Nazwa modułu po angielsku lub polsku, unikalna w katalogu.
  • Tagline (krótki opis) — do 200 znaków, opisujący korzyść, nie funkcję.
  • Długi opis — minimum 150 słów, bez spamu słów kluczowych.
  • Co najmniej jedna kompatybilna wersja PrestaShop (1.7.x / 8.x / 9.x).
  • Link do zakupu prowadzący bezpośrednio do strony produktu (nie strony głównej).
  • Cena w EUR netto (0 = moduł bezpłatny).
  • Pierwszy wpis changelog z listą funkcjonalności wersji 1.0.0.

Zalecane (wyższy ranking) ⭐

  • Min. 1 zrzut ekranu (zalecane: panel admina + efekt frontendowy).
  • 3–6 funkcji modułu opisanych w sekcji "Funkcje".
  • Link do wersji demo.
  • Regularne aktualizacje changelogu.

Bezwzględnie zabronione ❌

  • Złośliwy kod, backdoor, skrypt zbierający dane klientów bez ich zgody.
  • Naruszenie praw autorskich (fork bez licencji, kradzież kodu).
  • Fałszywe recenzje lub manipulacja statystykami.
  • Linki do stron phishingowych lub zawierających malware.
  • Reklamowanie konkurencyjnych platform w opisie modułu.

Proces moderacji

draft pending published lub rejected edytujesz → ponownie pending
draft

Moduł zapisany, ale niewidoczny publicznie. Możesz go edytować bez ograniczeń.

pending

Oczekuje na przegląd. Czas: do 48h w dni robocze. Nie edytuj w tym czasie.

published

Widoczny w katalogu. Możesz aktualizować changelog i zdjęcia bez ponownej moderacji.

Co sprawdzamy?

  • Kompletność — czy opis, zdjęcia i dane techniczne są wystarczające.
  • Spójność — czy tagline i opis są zgodne z rzeczywistą funkcjonalnością.
  • Link zakupu — czy prowadzi do strony produktu (testuję ręcznie).
  • Spam / SEO black-hat — sztuczne nasycenie słowami kluczowymi.
  • Kompatybilność — czy zaznaczone wersje PS są wiarygodne.

Wynik moderacji (zatwierdzenie lub odrzucenie z powodem) przychodzi na Twój adres e-mail.

REST API v1

Klucz API generujesz w Panelu → API & Klucze. Przekazuj go w nagłówku X-API-Key: <twój-klucz>.

Endpointy modułów

MetodaEndpointAuthOpis
GET/api/v1/modules—Lista opublikowanych modułów (paginacja)
GET/api/v1/modules/{slug}—Szczegóły modułu
POST/api/v1/modules✓Dodaj nowy moduł
PUT/api/v1/modules/{slug}✓Zaktualizuj moduł (tylko własny)
DELETE/api/v1/modules/{slug}✓Usuń moduł (tylko własny)
GET/api/v1/modules/{slug}/changelog—Lista changelog
POST/api/v1/modules/{slug}/changelog✓Dodaj wpis changelog

Przykład: dodanie wpisu changelog

curl -X POST https://addonshub.pl/api/v1/modules/moj-modul/changelog \
  -H "X-API-Key: ahub_xxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "version": "1.2.0",
    "type": "minor",
    "release_date": "2025-05-18",
    "changes": [
      "Dodano obsługę PS 9.0",
      "Poprawiono błąd z kodami rabatowymi",
      "Optymalizacja zapytań SQL"
    ]
  }'

Pełna dokumentacja API dostępna pod addonshub.pl/api/docs.

SEO & widoczność w Google

Strona każdego modułu jest zoptymalizowana pod kątem SEO. Oto jak możesz to wykorzystać:

Nazwa modułu

Trafia do tagu <title> i nagłówka H1. Dodaj słowo kluczowe na początku, np. „SEO Audit Pro — moduł PrestaShop".

Tagline

Pierwsze 160 znaków tagline trafia jako meta description. Pisz korzyściami: „Automatyczne meta tagi, sitemap.xml, hreflang dla PS 8.x".

Slug URL

URL ma format /modules/twoj-slug/. Słowo kluczowe w slugu poprawia CTR w wynikach Google.

Changelog = świeżość

Regularne aktualizacje changelogu sygnalizują Google, że strona jest aktywna. Nowe wpisy = wyższy ranking.

Schema.org — każda strona modułu automatycznie zawiera strukturalne dane JSON-LD (SoftwareApplication), co poprawia widoczność w rich snippets Google.

Tips & best practices

📸
Zrzuty ekranu robią robotę

Pokaż realny panel admina (nie mockup w Figmie) i efekt na froncie sklepu. Minimalne wymiary: 1280×720. Pierwszy zrzut to miniatura na karcie — zadbaj o nią najbardziej.

💰
Cena jednorazowa konwertuje lepiej

Sklepy PrestaShop preferują zakup bez abonamentu. Jeśli masz wersję „lifetime", wyeksponuj to w opisie.

📋
Changelog buduje zaufanie

Kupujący sprawdzają, jak często moduł jest aktualizowany. Moduły z regularnym changelogiem (co 2–4 tygodnie) mają wyższe współczynniki kliknięć.

🔗
Demo = konwersja

Moduły z linkiem do wersji demo mają o ~40% wyższy CTR na „Kup u twórcy". Nawet testowe demo z danymi przykładowymi wystarczy.

🌍
Kompatybilność PS 9.x — duży atut

PS 9.0 jest relatywnie nowy. Moduły z checkboxem „PS 9.x" automatycznie pojawiają się w filtrze, który odwiedza rosnąca liczba sklepów migrujących.

FAQ

Nie. AddonsHub jest katalogiem — kierujemy kupującego do Twojego linku zakupu. Nie obsługujemy płatności ani nie pobieramy żadnej prowizji.

Do 48 godzin w dni robocze (pon–pt). W weekendy moderacja może być opóźniona.

Tak, bez limitu. Wszystkie moduły wiążą się z jednym profilem Vendor.

Otrzymasz e-mail z powodem odrzucenia. Popraw wskazane elementy i ponownie kliknij „Wyślij do moderacji" — moduł trafi do kolejki od nowa.

Tak — możesz zmieniać opis, zrzuty ekranu, cenę i dodawać wpisy changelog bez ponownej moderacji. Zmiana linku zakupu lub zakresu kompatybilności może wymagać krótkiej weryfikacji.

Klucz API generujesz w Panelu → API & Klucze. Przekazujesz go w nagłówku X-API-Key. Każdy klucz jest przypisany do konta i daje dostęp wyłącznie do Twoich zasobów.

Tak. W Panelu → Typ konta możesz wybrać „Twórca + Expert". Oba profile działają na jednym koncie.

Skontaktuj się mailowo na kontakt@addonshub.pl z adresu przypisanego do konta. Dane zostaną usunięte zgodnie z Polityką Prywatności w ciągu 30 dni.

Gotowy? Dodaj swój pierwszy moduł.

Moderacja trwa do 48h. Zero prowizji, zero ukrytych opłat.

Dodaj moduł teraz