armatura-domowa.pl
CODE

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.

ARMATURA.WWWSERWIS KATALOGOWY · WORDPRESS + IMPORT
PRODUKCJA
WEJŚCIEPRZETWARZANIEDECYZJANARZĘDZIEMAGAZYNKONTROLAWYJŚCIE01CSV PRODUKTÓW02NORMALIZACJA03RODZINYWARIANTÓWkolory, serie04IMPORT MEDIÓW05BAZA WP06MOTYW BLOKOWY07WTYCZKAKATALOGU08MODUŁ AIopisy09SEO10STRONA
IMPORT CSV → RODZINY WARIANTÓW → MEDIA → SEO · DOCKER LOKALNIE, DEPLOY PAKIETEM
01

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.

02

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.

03

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.

04

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ę.

05

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.

07

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.