
armatura-domowa.pl
Serwis katalogowo-marketingowy armatury: WordPress z własnym motywem blokowym i wtyczką katalogową.
- PROJECT
- WEB-047
- PLATFORMA
- WORDPRESS · MOTYW BLOKOWY
- ŚRODOWISKO
- DOCKER + MAILPIT
- IMPORT
- CSV PRODUKTÓW I MEDIÓW
- WERSJA
- 1.18.0
- STATUS
- UKOŃCZONY
- DATA
- 16 sierpnia 2026
Katalogowy serwis produktowy armatury łazienkowej i kuchennej z importem CSV produktów, cen i mediów, rodzinami wariantów kolorystycznych oraz modułami AI i SEO. Środowisko lokalne stawiane jednym skryptem na Dockerze.
PROBLEM
Katalog armatury ma cechę, która wywraca typowy sklep: ten sam produkt istnieje w kilku wykończeniach — chrom, czarny mat, złoto, gun metal — i są to jednocześnie osobne indeksy magazynowe i warianty tego samego modelu. Potraktowanie ich jako niezależnych produktów rozsypuje nawigację; potraktowanie jako zwykłych wariantów gubi rozróżnienie w magazynie.
POMYSŁ
Wprowadzić pojęcie rodziny wariantów kolorystycznych jako osobny byt w modelu danych i budować całą prezentację wokół niego. Produkt ma swoje SKU, rodzina ma swoją stronę, a przełączanie wykończenia nie jest filtrem, tylko nawigacją wewnątrz rodziny.
PROJEKT
Rozwiązanie to własny motyw blokowy plus wtyczka katalogowa. Import CSV wciąga produkty, ceny i media, po czym buduje rodziny na podstawie reguł nazewnictwa. Zdjęcia pochodzą z osobnego katalogu miniatur przygotowanego wcześniej w procesie fotograficznym.
Środowisko lokalne stawia jeden skrypt: Docker z WordPressem, bazą i Mailpitem do przechwytywania poczty testowej. Dzięki temu zmiany testuje się bez dotykania produkcji, a wdrożenie idzie przygotowanym pakietem.
Import jest idempotentny — powtórne wgranie tego samego pliku CSV nie tworzy duplikatów, tylko aktualizuje istniejące pozycje. To warunek konieczny, żeby dało się aktualizować ofertę cyklicznie, a nie raz przy uruchomieniu sklepu.
REALIZACJA
Projekt ma rozbudowaną historię przekazań — kilka plików HANDOFF z kolejnych dni pracy oraz raport końcowy. Repozytorium zawiera także pakiet wdrożeniowy z opisem aktualizacji do wersji 1.18.0 oraz plik tłumaczeń katalogu.
Moduł AI odpowiada za opisy produktowe, moduł SEO za strukturę danych i metadane — obydwa działają na danych z katalogu, a nie zamiast nich.
Zdjęcia produktowe pochodzą z tego samego obiegu, co pozostałe projekty fotograficzne w warsztacie: sesja, usunięcie tła, kadr 3000 × 3000, miniatury. Serwis jest więc ostatnim ogniwem łańcucha, który zaczyna się przy softboxie — i to jest argument za trzymaniem całego procesu we własnych rękach.
Mailpit w środowisku lokalnym rozwiązuje problem, o którym pamięta się dopiero po pierwszej pomyłce: formularze i powiadomienia testowane na kopii serwisu potrafią wysłać wiadomość do prawdziwego klienta. Przechwytywanie poczty w środowisku deweloperskim zamyka tę drogę.
Wersjonowanie pakietu wdrożeniowego wraz z opisem zmian okazało się przy tym równie ważne jak sam kod: przy serwisie utrzymywanym miesiącami pytanie „co dokładnie poszło na produkcję i kiedy” pada częściej niż jakiekolwiek pytanie o implementację.
EFEKT
Serwis jest wdrożony i utrzymywany. Import da się powtórzyć po zmianie w katalogu źródłowym, a rodziny wariantów budują się automatycznie, co eliminuje najbardziej pracochłonną część aktualizacji oferty.
WNIOSKI
Model danych okazał się ważniejszy od warstwy prezentacji. Kiedy rodziny wariantów zostały opisane poprawnie, większość problemów z nawigacją, SEO i zdjęciami rozwiązała się sama — bo wynikały z tego samego braku.


