Instrukcja

Instrukcja użytkownika

Publiczna instrukcja prowadzi autora przez instalację Nomad Editor, wgranie Nomad Plugin, połączenie z Marketplace i publikację książki. Nie zawiera prywatnej dokumentacji technicznej systemu.

Nomad Plugin Pobierz Studio

04 — Co robi Nomad Plugin

Nomad Plugin działa w WordPress Marketplace. Używa go administrator WordPressa i właściciel Marketplace.

Gdzie go znaleźć

  1. Zaloguj się do WordPressa jako administrator.
  2. W menu bocznym znajdź sekcję Nomad Plugin.
  3. W obecnej wersji technicznej wejście może być podpisane Nomad Books.
  4. Otwórz ekran Nomad Center.

Do czego służy

Nomad Plugin:

  • odbiera publikacje książek z Nomad Editor,
  • tworzy publiczne strony książek,
  • uruchamia checkout dla kupującego,
  • pyta Nomad Center, czy sprzedaż jest dozwolona,
  • odbiera statusy płatności, druku i wysyłki,
  • pokazuje administratorowi WordPressa prośby parowania Editorów,
  • pomaga wznowić sprzedaż, gdy Center wymaga akcji właściciela Marketplace.

Najważniejsze działy w menu Nomad Plugin

Menu Nomad Plugin jest podzielone na cztery działy, z których każdy odpowiada na inne pytanie:

  • Nomad Center — technikalia: jak ten Marketplace łączy się z Center i Editorem,
  • Sprzedaż książek — komercja: modele, oferty, ceny, opłacanie paczek,
  • Marketplace operacyjnie — co WordPress i Plugin już wiedzą o bieżącej sprzedaży,
  • Powiadomienia o dostępności — zapisy kupujących na niedostępne książki.

Status (dział: Nomad Center)

Pokazuje, czy WordPress zna Center URL, Site ID, token Editora, token monitoringu i certyfikat. Standardowy użytkownik nie edytuje tych wartości ręcznie.

Diagnostyka sprzedaży i połączenia (dział: Nomad Center)

Pokazuje, czy Marketplace może pytać Nomad Center o decyzję sprzedażową. Jeśli tu jest błąd certyfikatu albo podpisu, publiczny checkout może być zablokowany.

Dostęp do Nomad Center (dział: Nomad Center)

Tu są linki do:

  • panelu operatora Center,
  • panelu twórcy,
  • panelu partnera druku.

Dla zwykłego autora najważniejszy jest panel twórcy. Konto twórcy powstaje po aktywnym certyfikacie Marketplace.

Prośby parowania Editorów (dział: Nomad Center)

Tu administrator WordPressa zatwierdza połączenie Editora z Marketplace.

Przy requestach są trzy decyzje:

  • Zatwierdź — zezwól temu Editorowi publikować do tego Marketplace,
  • Odrzuć — odrzuć tę próbę,
  • Ban — zablokuj ten fingerprint Editora dla tego Marketplace.

Sterowanie sprzedażą książek (dział: Sprzedaż książek)

Tu można dla opublikowanej książki:

  • zobaczyć status Center,
  • zapisać model sprzedaży,
  • wybrać anonimową ofertę Nomad,
  • zaakceptować model i koszty,
  • opłacić paczkę książek,
  • pobrać paczkę produkcyjną, jeśli jest dostępna.

Center nadal jest źródłem prawdy. Jeśli zmiana jest niebezpieczna albo niezgodna z ofertą, Center może utrzymać poprzedni bezpieczny stan.

Zmiana modelu współpracy (np. przełączenie książki z paczki na POD) jest jawny strategy_override. Jeśli książka ma opłaconą, fizycznie wydrukowaną paczkę, Center przy przełączeniu na POD:

  • wysyła pozostałe wydrukowane egzemplarze na adres rozliczeniowy autora (tylko wysyłka — książki już istnieją, bo opłacenie paczki tworzy zlecenie druku całej serii),
  • konsumuje stan (batch_stock_sold), więc książka może żyć czysto jako POD,
  • zapisuje audyt zmiany.

Jeśli po przełączeniu na POD Center zwraca dokładnie jedną ofertę POD, Plugin automatycznie ją wybiera i akceptuje model + koszty, więc sprzedaż rusza bez drugiego ręcznego kroku.

Stan sprzedaży (dział: Marketplace operacyjnie)

Pokazuje skrót:

  • status certyfikatu,
  • liczbę opublikowanych książek,
  • książki z blokadą sprzedaży,
  • zamówienia opłacone,
  • status płatności,
  • status druku,
  • status dostawy.

Gdy checkout jest zablokowany dla którejkolwiek książki, sekcja pokazuje alert z powodem i akcją naprawczą.

Powiadomienia o dostępności (waitlist)

Kupujący może zapisać się powiadomieniem o dostępności na landingu książki, której sprzedaż jest dziś wstrzymana (np. wyczerpana paczka batch albo subscribe_reprint). Mechanizm działa w pełni wewnątrz Pluginu:

  • Zapis — publiczny endpoint POST /wp-json/nomad-books/v1/books/{id}/waitlist waliduje e-mail, odrzuca zapis jeśli książka jest już dostępna, i zapisuje wiersz w tabeli nb_waitlist (idempotentny per książka+e-mail; ponowny zapis po wysłanym powiadomieniu re-aktywuje wiersz do pending).
  • Forward do Center — gdy decyzja Center pozwala na zapis na dodruk (reprint_subscription_allowed), ten sam e-mail jest też przekazywany do Center (POST /books/{id}/subscribe-reprint), gdzie zasila licznik popytu na dodruk widoczny dla autora/operatora (nc_reprint_subscriptions).
  • Powiadomienie — trzy ścieżki wysyłają wiadomość e-mail (wp_mail) do każdego zapisanego kupującego dokładnie raz:
  1. godzinowy cron przegląda książki z oczekującymi zapisami i pyta Center o żywą decyzję,
  2. szybka ścieżka: gdy rendering landingu widzi książkę znów dostępną, planuje asynchroniczne wysyłanie 30 s później,
  3. ręczny przycisk „Wyślij powiadomienia teraz" w dziale Powiadomienia.

Wiersz jest oznaczany notified dopiero po potwierdzeniu wysyłki przez wp_mail, więc błąd mailera zostawia zapis do ponownej próby.

  • Nadzór operatora — dział Powiadomienia pokazuje listę adresów per książka (z lokalnej nb_waitlist), pozwala usuwać wpisy i wysłać powiadomienia ręcznie.

Uwaga: dział Powiadomienia pokazuje tylko lokalną tabelę nb_waitlist. Licznik popytu na dodruk z Center (reprint_subscriptions) jest widoczny w dziale Sprzedaż książek dla książek batch.

Czego nie robić ręcznie

  • Nie wpisuj ręcznie tokenu Editora, jeśli normalny pairing działa.
  • Nie zmieniaj Site ID.
  • Nie kasuj certyfikatu, jeśli sprzedaż ma działać.
  • Nie ustawiaj oferty drukarni po stronie WordPressa poza listą anonimowych ofert Nomad.
  • Nie udostępniaj kupującemu PDF jako produktu cyfrowego.

Oczekiwany wynik

Nomad Plugin pokazuje aktywne połączenie z Nomad Center, aktywny certyfikat, listę opublikowanych książek i czytelny status sprzedaży.