Moduł: dc_customer_menagers
Nazwa wyświetlana: Design Cart Customer Menagers
Autor: Design Cart
Wersja: 1.0.0
Platforma: PrestaShop 9
Katalog modułu: /modules/dc_customer_menagers/

Spis treści

1. Po co moduł powstał
2. Jaki problem rozwiązuje
3. Co robi moduł
4. Zakładka: Lista opiekunów
5. Zakładka: Dodaj opiekuna
6. Zakładka: Ustawienia
7. Zakładka „Opiekunowie” w produkcie
8. Wyświetlanie na froncie
9. Instalacja
10. Podsumowanie

1. Po co moduł powstał

W sklepach B2B, specjalistycznych i premium klient często potrzebuje konkretnej osoby do kontaktu – nie ogólnego formularza, tylko opiekuna produktu, działu lub asortymentu. Standardowy PrestaShop nie ma gotowego mechanizmu, który:

• przechowuje bazę opiekunów (zdjęcie, imię/nazwa, opis, e-mail, telefon),
• pozwala przypisać wybranych opiekunów do konkretnego produktu,
• wyświetla ich w spójnym bloku na karcie produktu (np. pod przyciskiem „Dodaj do koszyka”),
• daje kontrolę nad wyglądem bloku bez edycji kodu motywu.

Design Cart Customer Menagers powstał właśnie po to: żeby sklep mógł pokazać „twarz” obsługi przy produkcie, a administrator mógł zarządzać opiekunami i stylem bloku z jednego, czytelnego panelu.

2. Jaki problem rozwiązuje

• Anonimowa karta produktu – klient widzi cenę i opis, ale nie wie, do kogo napisać lub zadzwonić w sprawie konfiguracji, wyceny B2B czy dostępności.
• Rozproszone dane kontaktowe – e-maile i telefony opiekunów lądują w opisach HTML, stopce lub PDF-ach; trudno je utrzymać i aktualizować.
• Brak przypisania per produkt – jeden opiekun nie pasuje do całego katalogu; różne kategorie i linie produktów mają innych specjalistów.
• Chaos w zakładce „Moduły” – wiele rozszerzeń ląduje w jednej zakładce formularza produktu. Ten moduł tworzy własną zakładkę „Opiekunowie”, żeby nie mieszać się z innymi.
• Brak kontroli wizualnej – bez centralnych ustawień każda zmiana wyglądu wymagałaby CSS w motywie. Tu typografia, kolor, wyrównanie i kształt zdjęcia są w konfiguracji modułu.

3. Co robi moduł

Moduł składa się z trzech warstw:

1. Konfiguracja globalna – lista opiekunów, formularz dodawania/edycji, ustawienia wyglądu bloku na froncie.
2. Przypisanie do produktu – w edycji produktu zakładka „Opiekunowie”: zaznaczanie aktywnych opiekunów i sortowanie metodą przeciągnij i upuść.
3. Front – blok opiekunów pod obszarem zakupu (hook displayProductAdditionalInfo), stylowany według ustawień.

Nawigacja w panelu konfiguracji opiera się na kafelkach:

• Lista opiekunów – przegląd i masowe akcje,
• Dodaj opiekuna – formularz nowego wpisu / edycji,
• Ustawienia – wygląd i teksty bloku na froncie.

Kolorystyka panelu admina modułu: brandowy kolor #1ea28b.

4. Zakładka: Lista opiekunów

To strona startowa konfiguracji (section=home). Pokazuje wszystkich opiekunów zapisanych w bazie.

4.1. Co widać na liście

Po poprawnym zapisie opiekuna z formularza następuje automatyczne przekierowanie z powrotem na tę listę wraz z komunikatem potwierdzenia.

5. Zakładka: Dodaj opiekuna

Formularz tworzenia lub edycji opiekuna. Po wejściu w „Dodaj opiekuna” lub „Edycja” widać tylko formularz (bez listy). Powrót do listy – kafelek Lista opiekunów.

5.1. Pola formularza

Uwaga: nazwa i opis są zależne od języka; e-mail i telefon są wspólne dla wszystkich wersji językowych.

6. Zakładka: Ustawienia

Tu definiujesz wygląd bloku opiekunów na karcie produktu oraz globalne teksty nagłówka listy.

6.1. Zdjęcie opiekuna na froncie

6.2. Treści listy (wielojęzyczne)

6.3. Typografia – wspólne pola dla każdej sekcji tekstu

Dla każdego z poniższych elementów tekstowych ustawiasz te same parametry:

Elementy, dla których te ustawienia są dostępne osobno:

1. Nazwa listy opiekunów – styl nagłówka całej sekcji.
2. Opis listy opiekunów – styl tekstu wprowadzającego pod nagłówkiem.
3. Nazwa opiekuna – styl imienia / nazwy w karcie opiekuna.
4. Opis opiekuna – styl opisu roli / specjalizacji.
5. Adres email – styl linku e-mail.
6. Numer telefonu – styl linku telefonicznego.

Przycisk Zapisz ustawienia zapisuje wszystkie powyższe wartości globalnie (dla całego sklepu).

7. Zakładka „Opiekunowie” w produkcie

W formularzu produktu (Obserwacja / Edycja produktu) moduł dodaje własną zakładkę Opiekunowie (obok Opis, Szczegóły, Warianty, Wysyłka, Wycena, SEO, Opcje itd.). Nie korzysta z zbiorczej zakładki „Moduły”, żeby uniknąć pomyłek przy wielu rozszerzeniach.

7.1. Elementy zakładki

Zapis następuje przy standardowym zapisie produktu w PrestaShop.

8. Wyświetlanie na froncie

• Hook: displayProductAdditionalInfo – typowo w okolicy przycisku „Dodaj do koszyka” (zależnie od motywu).
• Wyświetlane są tylko opiekunowie zaznaczeni jako aktywni dla danego produktu, w ustalonej kolejności.
• Jeśli produkt nie ma żadnego aktywnego opiekuna – blok nie jest renderowany.
• Kolejność względem innych modułów w tym samym hooku ustawiasz w: Wygląd → Pozycje → hook displayProductAdditionalInfo.

9. Instalacja

9.1. Wymagania

• PrestaShop 9,
• uprawnienia do instalacji modułów w panelu BO,
• katalog /img/ zapisywalny przez serwer WWW (dla uploadu zdjęć opiekunów do /img/dc_filemenager/).

9.2. Kroki instalacji

1. Skopiuj katalog modułu do /modules/dc_customer_menagers/.
2. W panelu administracyjnym przejdź do Moduły → Menedżer modułów.
3. Wyszukaj Design Cart Customer Menagers i kliknij Instaluj.
4. Moduł utworzy tabele w bazie:
   • ps_dc_cm_manager – dane opiekuna (zdjęcie, e-mail, telefon),
   • ps_dc_cm_manager_lang – nazwa i opis w językach,
   • ps_dc_cm_product_manager – przypisanie do produktu (kolejność, aktywność).
5. Zostaną zarejestrowane hooki BO/FO oraz zapisana domyślna konfiguracja wyglądu.
6. Wejdź w Konfiguruj przy module – dodaj opiekunów, ustaw style, a następnie w produktach zaznacz, kto ma się wyświetlać.

9.3. Uprawnienia katalogu zdjęć (Ubuntu / Apache)

Jeśli upload zdjęć nie działa (błąd zapisu pliku), ustaw prawa dla katalogu docelowego:

sudo mkdir -p /var/www/html/selmago/img/dc_filemenager
sudo chown -R www-data:www-data /var/www/html/selmago/img/dc_filemenager
sudo find /var/www/html/selmago/img/dc_filemenager -type d -exec chmod 775 {} \;
sudo find /var/www/html/selmago/img/dc_filemenager -type f -exec chmod 664 {} \;

Ścieżkę dostosuj do lokalizacji swojego sklepu.

9.4. Odinstalowanie

Przy odinstalowaniu moduł usuwa swoje tabele oraz wpisy konfiguracyjne. Dane opiekunów i przypisania do produktów zostaną trwale usunięte. Pliki zdjęć w /img/dc_filemenager/ mogą pozostać na dysku – w razie potrzeby usuń je ręcznie.

10. Podsumowanie

Design Cart Customer Menagers to moduł PrestaShop 9 do prezentacji opiekunów produktów na karcie produktu. Pozwala zbudować bazę opiekunów (zdjęcie, nazwa, opis, e-mail, telefon), przypisać ich per produkt z kolejnością i widocznością, a wygląd bloku na froncie kontrolować z panelu – bez edycji motywu.

Najważniejsze korzyści:

• czytelny kontakt „twarzą w twarz” przy produkcie,
• osobna zakładka „Opiekunowie” w produkcie (bez mieszania z innymi modułami),
• pełna kontrola typografii i kształtu zdjęcia,
• obsługa wielu języków dla nazw i opisów,
• bezpieczny upload zdjęć tylko dla administratora BO.

Typowy workflow wdrożenia:

1. Zainstaluj moduł.
2. W Ustawieniach ustaw teksty listy i wygląd.
3. W Dodaj opiekuna utwórz opiekunów.
4. W produktach w zakładce Opiekunowie zaznacz i posortuj osoby do wyświetlenia.
5. Sprawdź front karty produktu i ewentualnie kolejność w Wygląd → Pozycje dla hooka displayProductAdditionalInfo.