🚀 Generator Marcupów v1.2 by PDG

Generowanie i kompresja setek obrazów to wymagający proces dla serwera. Twój hosting musi spełniać poniższe kryteria:

A. Jak przygotować plik nadruku (Wzór)?

• Zalecany format: Zapisuj wzory jako .PNG z przezroczystym tłem. Wtyczka wspiera .JPG i .WebP, ale brak przezroczystości spowoduje nałożenie grafiki z kwadratowym, białym tłem.
• Krajanie: Upewnij się, że wzór nie ma 500 pikseli pustej, przezroczystej przestrzeni wokół siebie. Użyj opcji Auto-Trim w ustawieniach wtyczki, aby skrypt zrobił to za Ciebie!

B. Pliki tła (Zdjęcia "czystych" koszulek) BARDZO WAŻNE

Skrypt automatycznie przypisuje warianty kolorystyczne do zdjęć na podstawie ich nazwy na serwerze. Musisz je wgrać do folderu /wp-content/uploads/templates/.

Przykłady poprawnych nazw plików na serwerze:

• Biała koszulka męska (rozmiar L): koszulka_meska_bialy_l.jpg
• Czarna bluza z kapturem damska (rozmiar S): bluza_kaptur_damska_czarny_s.jpg
• Kubek 330ml biały: kubek_330ml_bialy_uniwersalny.jpg

1. W panelu WordPress wejdź w Generator Marcupów → Ustawienia.
2. W górnej sekcji wklej swój unikalny klucz licencyjny.
3. Kliknij Weryfikuj Klucz. Po udanej weryfikacji licencja zostanie przypisana do domeny, a panel zniknie, odblokowując pełny dostęp do narzędzi.

Jeśli zmieniasz adres sklepu, wejdź w Ustawienia i kliknij Odłącz licencję, aby móc użyć jej ponownie pod innym adresem.

⚡ Limity serwera (Workery AJAX)

System sam dzieli pracę na procesy, chroniąc serwer przed błędem "Timeout". Masz do dyspozycji 2 suwaki:

• Ilość procesów Liderów: Liderzy to procesy tworzące szkielet produktu w bazie banych WooCommerce i odpytujące serwery OpenAI (ChatGPT). Zalecana wartość: 1 lub 2. Większa ilość może zablokować bazę MySQL.
• Ilość procesów Followersów: Followersi to procesy czysto graficzne – "wypluwają" zdjęcia wariantów. Zalecana wartość: 4 do 8. Jeśli podczas generowania zawiesza Ci się pasek postępu, obniż tę wartość.

🤖 Integracja AI (ChatGPT)

Wklej w to pole swój tajny klucz API OpenAI (np. sk-proj-12345...). Pozwala to wtyczce na samodzielne tworzenie profesjonalnych opisów produktów.

🔍 Opcje Matrycy i SEO

• Auto-Trim (Odcinanie tła): Skrypt sam przytnie puste przezroczyste krawędzie w plikach PNG wgranych do Generatora.
• Siatka i Magnes (Snap): Włącza zieloną "strefę bezpiecznego zadruku", z której wzór nie może wyjść podczas przesuwania.
• Automatyczne Tagi Alt (SEO Master): Każdy stworzony produkt i zdjęcie otrzyma odpowiednie meta tagi, co drastycznie zwiększa ruch z wyszukiwarki Google Grafika.

1. Wybierz asortyment z listy (np. Koszulka Damska). Skrypt w tle załaduje bazowe zdjęcie czystej koszulki.
2. Wczytaj dowolny testowy wzór (z dysku lub wpisując jego nr z bazy).
3. Na ekranie pojawią się dwa obszary robocze:
   • Wzór Duży (Standard): Typowy nadruk na klatkę piersiową lub plecy.
   • Wzór Mały (Na sercu): Nadruk w stylu "kieszonka" lub logotyp.
4. Przyciski sterujące:
   • ✨ Auto-Dopasuj - Skrypt oblicza proporcje i wpycha wzór na idealny środek strefy (lub w prawy górny róg dla małego wzoru).
   • ↔️ Środek / ↕️ Środek - Centrowanie ręczne względem zielonej ramki lub całego tła.
   • 📐 Siatka - Włącza/Wyłącza blokadę ruchów. **Przy włączonej siatce** wzór jest zamknięty w zielonej strefie zadruku. **Przy wyłączonej siatce** ograniczeniem jest tylko krawędź obrazka.
5. Możesz pozycjonować nadruk strzałkami klawiatury (co 1px) lub z klawiszem Shift (co 10px).
6. Zapisz Matrycę.

A. Uzupełnianie Formularza

• Tytuł Produktu: Krótka nazwa motywu (np. Kocham Góry). Skrypt sam doda rodzaj odzieży, tworząc tytuł np. Bluza męska z kapturem Kocham Góry.
• Numer grafiki: Twój własny identyfikator (np. GORY-01).
  Ważne: Numer jest skanowany algorytmem MD5. Jeśli wgrasz plik o innym hashu, a podasz stary numer, system wyrzuci błąd. Chroni to Twoją bazę!
• Rodzaj (Asortyment): Z wciśniętym klawiszem Ctrl (lub Cmd) zaznacz listę produktów, które chcesz wygenerować naraz (np. Koszulka, Bluza i Kubek).
• Ceny domyślne: Ustal cenę dla każdego wybranego rodzaju.
• Kolory: Zaznacz dostępne kolory. Jeśli nie masz na serwerze np. zielonej koszulki, system automatycznie pominie ten kolor i nie stworzy "pustego" wariantu!
• Ustawienia AI: Wybierz Długość opisu i Styl (np. Długi i wyczerpujący w stylu Profesjonalnym). Dodaj ewentualne instrukcje do promptu.

B. Rozpoczęcie Pracy

Na dolnym pasku znajdziesz 4 główne przyciski:

• 👁️ Szybki Podgląd: Renderuje w czasie rzeczywistym siatkę podglądową ze wszystkimi wybranymi produktami, aby upewnić się, że nadruk nie nachodzi np. na sznurki od bluzy.
• 🔥 Wygeneruj DUŻE: Tworzy tylko warianty z dużym nadrukiem na środku.
• 👕 Wygeneruj MAŁE: Tworzy tylko warianty z małym logo. Produkty te automatycznie zyskują na końcu tytułu dopisek "(Małe)" oraz literę "-P" w numerze ID.
• ✨ Wygeneruj OBA WARIANTY: Pełna automatyzacja. Skrypt najpierw wygeneruje duże koszulki, a potem od nowa założy w sklepie oddzielne produkty z małym nadrukiem.

Ta zakładka pozwala Ci na zarządzanie całą kolekcją grafik wgrywanych na serwer.

• Konwersja na bieżąco: Każdy plik wgrany przez zakładkę "Nowy Wzór" lub "Generator" jest automatycznie "odchudzany" i zmieniany z powolnego PNG na nowoczesny, bezstratny format WebP.
• Analityka użycia: Przy każdym wzorze w bazie znajdziesz listę linków do konkretnych produktów WooCommerce, w których ten wzór został użyty. Idealne do śledzenia kolekcji.
• Szybkie wczytywanie: Przycisk "Wczytaj do Generatora" przy każdym wzorze natychmiast przeniesie Cię do głównego panelu, automatycznie wpisując tytuł i numer z bazy.

Czasami po 2 miesiącach od wystawienia produktu uznasz, że nadruk na "Czarnej bluzie" powinien być o 2 cm wyżej. Nie musisz kasować produktu i tracić pozycjonowania URL ani recenzji klientów!

1. Wejdź w Generator → Fixer.
2. Wpisz numer wewnętrzny grafiki.
3. Kliknij w nazwę produktu i wybierz konkretny Kolor (np. Czarny).
4. Ukaże Ci się edytor z wadliwym zdjęciem. Nanieś poprawki (przesuń wzór / zeskaluj go).
5. Kliknij 🔥 Podmień i Usuń stare zdjęcia.

Opcja dostępna w Ustawieniach. Jest to automatyczny system zwiększania wartości koszyka (Cross-selling) bez użycia skomplikowanych wtyczek.

• Logika działania: System opiera się na wspólnym identyfikatorze graficznym (numerze grafiki).
• Zasada "Co z Czym": Ustalasz w Ustawieniach, że jeśli klient kupuje "Dowolną Odzież", skrypt ma zaproponować mu do kompletu "Tylko Akcesoria (Kubki/Torby)" z rabatem np. 15%.
• Efekt: Kiedy użytkownik wejdzie w koszulkę "Best Dad", pod przyciskiem Dodaj do Koszyka pojawi się piękny, klikalny baner zachęcający do dobrania "Kubka Best Dad" (o ile taki wygenerowałeś) z naliczonym rabatem za zestaw.

❌ Wciskam podgląd/generuj i skrypt nakłada logo na tabelę rozmiarów!

Nie dostosowałeś się do schematu nazewnictwa z punktu 3. Twój obrazek z wymiarami nazywa się w sposób nierozpoznany przez skrypt (np. wymiary.png zamiast wymiar.png, lub info_koszulka.jpg). Jeśli plik techniczny nie ma w nazwie m.in. słowa tabel, rozmiar, kroj lub specyfikacj, skrypt uznaje go za "czystą" koszulkę. Zmień nazwę pliku na FTP.

❌ Generowanie zatrzymuje się na 40% - błąd 500 / 503 Timeout

Osiągnąłeś fizyczny limit obciążenia procesora (CPU) na swoim serwerze, lub limit czasu wykonywania skryptu (PHP Time Limit). Wejdź w Ustawienia wtyczki i zmniejsz "Ilość procesów Followersów" do 2 lub 3. Produkcja potrwa dłużej, ale nie zawiesi serwera.

❌ Brak opisu ze Sztucznej Inteligencji (AI) na produktach

Sprawdź swoje konto API OpenAI. Błąd występuje, gdy: 1) Wykorzystałeś budżet na koncie, 2) Nie podpiąłeś karty płatniczej w OpenAI, 3) Klucz skopiowany do ustawień ma w sobie spację na końcu lub stracił ważność.

❌ Próbuję zaktualizować grafikę (wpisuję stary nr), a skrypt wyrzuca BŁĄD MD5!

Skaner MD5 broni Twojej bazy. Jeśli wygenerowałeś produkt o numerze A-12 wrzucając obrazek wilka, a miesiąc później próbujesz wygenerować obrazek kota wpisując ten sam numer A-12, system to zablokuje, krzycząc, że plik ma inny "cyfrowy podpis". Pilnuj numeracji swoich grafik!