# Masowa edycja produktów w PrestaShop 8 i 9: dokumentacja

> Przegląd Moduł pokazuje katalog w edytowalnej tabeli jak w arkuszu kalkulacyjnym, w panelu PrestaShop 8 lub 9. Edytujesz produkty lub kombinacje z klawiatury, stosujesz akcje zbiorcze do setek produktów, eksportujesz…

- Strona: <https://www.datafirefly.com/pl/documentation/bulk-edit-products-prestashop/>
- Język: pl
- Zaktualizowano: 2026-09-23
- Inne języki: [fr](https://www.datafirefly.com/documentation/bulk-edit-products-prestashop/index.md), [en](https://www.datafirefly.com/en/documentation/bulk-edit-products-prestashop/index.md), [es](https://www.datafirefly.com/es/documentation/bulk-edit-products-prestashop/index.md), [de](https://www.datafirefly.com/de/documentation/bulk-edit-products-prestashop/index.md), [it](https://www.datafirefly.com/it/documentation/bulk-edit-products-prestashop/index.md), [nl](https://www.datafirefly.com/nl/documentation/bulk-edit-products-prestashop/index.md), [pt](https://www.datafirefly.com/pt/documentation/bulk-edit-products-prestashop/index.md)
- Indeks: <https://www.datafirefly.com/pl/documentation/llms.txt>

## Przegląd

Moduł pokazuje katalog w edytowalnej tabeli jak w arkuszu kalkulacyjnym, w panelu PrestaShop 8 lub 9. Edytujesz produkty lub kombinacje z klawiatury, stosujesz akcje zbiorcze do setek produktów, eksportujesz i ponownie importujesz plik CSV, a każdą zapisaną zmianę można cofnąć z historii.

## Instalacja

1. W **Moduły > Menedżer modułów** kliknij **Załaduj moduł** i wybierz `dfbulkeditor-1.0.0.zip`.
2. Instalacja tworzy zakładkę **Katalog > Edycja masowa** oraz dwie tabele historii.
3. Przycisk **Konfiguruj** modułu otwiera ustawienia i bezpośredni link do edytora.

### Ustawienia

- **Wierszy na stronę (domyślnie)**: 50, 100, 250 lub 500. Każdy pracownik może to zmienić w tabeli.
- **Elementów na żądanie zbiorcze**: od 10 do 500, domyślnie 50. Akcje zbiorcze są wysyłane w kilku żądaniach tej wielkości. Zmniejsz wartość, jeśli serwer przerywa długie żądania.
- **Przechowuj historię przez (dni)**: domyślnie 180. Starsze zestawy zmian są usuwane automatycznie raz dziennie i nie można ich już cofnąć.

## Uprawnienia

Uprawnienia ustawia się w **Zaawansowane > Zespół > Uprawnienia**, dla zakładki Edycja masowa. Uprawnienie **Wyświetlanie** pozwala przeglądać tabelę i historię oraz eksportować CSV. Uprawnienie **Edycja** jest potrzebne do zapisu, uruchomienia akcji zbiorczej, importu pliku lub cofnięcia zestawu zmian. Bez niego tabela działa tylko do odczytu.

## Tabela

### Widoki Produkty i Kombinacje

Przełącznik w lewym górnym rogu zmienia widok między produktami a kombinacjami. Widok Kombinacje pokazuje każdą kombinację z produktem, atrybutami, wpływem na cenę i ceną końcową netto oraz brutto. Kombinacje jednego produktu są zgrupowane, a nazwa produktu powtarza się tylko w kolorze szarym.

### Język, wyszukiwanie i filtry

Lista języków wybiera język wyświetlanych i edytowanych pól tekstowych (nazwa, meta tytuł, meta opis, przyjazny URL, teksty dostępności). Wyszukiwanie obejmuje nazwę, kod referencyjny, EAN i ID. Przycisk **Filtry** otwiera kryteria: kategoria z podkategoriami lub bez, marka, status, zakres stanu, zakres ceny netto, brakujące dane (EAN, kod referencyjny, cena zakupu, meta tytuł, meta opis, zdjęcie) oraz produkty z kombinacjami lub bez.

### Kolumny

Przycisk **Kolumny** pokazuje lub ukrywa każdą kolumnę. Przeciągnij prawą krawędź nagłówka, aby zmienić szerokość, a kliknij dwukrotnie, aby przywrócić domyślną. Te ustawienia są zapisywane w przeglądarce, osobno dla każdego widoku. Kliknięcie sortowalnego nagłówka sortuje tabelę.

## Edycja komórek

### Klawiatura i mysz

- **Strzałki, Tab, Enter**: przechodzenie między komórkami.
- **Pisanie, F2 lub podwójne kliknięcie**: edycja aktywnej komórki. Enter zatwierdza i schodzi niżej, Tab zatwierdza i przechodzi w prawo, Esc anuluje.
- **Shift + kliknięcie lub Shift + strzałki**: zaznaczenie zakresu.
- **Ctrl + C / Ctrl + V**: kopiowanie i wklejanie, także z i do Excela lub Arkuszy Google. Pojedyncza wartość wklejona na zakres wypełnia cały zakres.
- **Ctrl + D**: wypełnienie w dół pierwszą wartością zakresu.
- **Delete**: wyczyszczenie zaznaczonych komórek tekstowych.
- **Spacja**: przełączenie pola tak/nie (status, dostępny do zamówienia itd.).
- **Ctrl + Z**: cofnięcie ostatniej niezapisanej zmiany.
- **Ctrl + S**: zapis.

Nazwa, meta tytuł i meta opis są edytowane w szerszym polu z licznikiem znaków: zalecane 60 dla meta tytułu i 160 dla meta opisu.

### Przypadki szczególne

- **Cena brutto**: wpisana wartość jest przeliczana na cenę netto według reguły podatkowej produktu.
- **Kategorie i kategoria główna**: te komórki otwierają wybór w drzewie z wyszukiwaniem. Po usunięciu kategorii głównej zastępuje ją pierwsza pozostała kategoria.
- **Stan produktu z kombinacjami**: zablokowany w widoku Produkty, edytuje się go w widoku Kombinacje.
- **EAN-13**: maksymalnie 13 cyfr, ostrzeżenie sygnalizuje błędną cyfrę kontrolną.

### Zapis

Zmienione komórki są podświetlone na żółto, a przycisk **Zapisz** pokazuje ich liczbę. Zapis odbywa się partiami. Wartość odrzucona przez PrestaShop pozostaje czerwona: najedź na komórkę, aby przeczytać powód. Jeśli zmienisz widok, stronę lub filtr przy niezapisanych zmianach, moduł zaproponuje ich zapisanie, odrzucenie lub anulowanie.

## Akcje zbiorcze

### Zakres i podgląd

Przycisk **Akcje zbiorcze** działa na zaznaczone wiersze lub wszystkie przefiltrowane wyniki, do 100 000 elementów. Aby wybrać wszystkie wyniki, zaznacz pole w nagłówku i kliknij „Zaznacz wszystkie wyniki (N)”. Przycisk **Podgląd** pokazuje stan przed i po dla pierwszych 20 elementów oraz elementy pominięte wraz z powodem. Następnie akcja wykonuje się partiami z paskiem postępu.

### Ceny

Cena do zmiany: cena brutto, cena netto lub cena zakupu dla produktów; cena końcowa brutto, cena końcowa netto, wpływ netto lub cena zakupu dla kombinacji. Operacje: zwiększ lub zmniejsz o %, zwiększ lub zmniejsz o kwotę, ustaw wartość lub cena zakupu pomnożona przez współczynnik. Zaokrąglenia: 2 miejsca po przecinku, do 0,05 lub 0,10, liczba całkowita, końcówka ,99, ,95 lub ,90. W produkcie z kombinacjami zmienia się cena bazowa, a wpływy pozostają bez zmian.

### Stan, status, marka i podatek

Stan można ustawić, zwiększyć lub zmniejszyć (produkty z kombinacjami są pomijane w widoku Produkty). Status włącza lub wyłącza. Markę można przypisać lub usunąć. Zmiana reguły podatkowej może zachować ceny brutto, przeliczając cenę netto.

### Kategorie

Dodaj do kategorii, usuń z kategorii, zastąp wszystkie kategorie (zaznaczając kategorię główną w selektorze) lub zmień kategorię główną.

### Nazwy i teksty SEO

Pola: meta tytuł, meta opis, nazwa lub przyjazny URL. Operacje: wypełnij z szablonu, dodaj na początku, dodaj na końcu, znajdź i zamień. Zmienne wstawia się jednym kliknięciem: `{name}`, `{reference}`, `{ean13}`, `{manufacturer}`, `{category}`, `{price}`, `{shop}`, `{id}`. Przykład: `{name} | {shop}` z opcją „Tylko gdy pole jest puste”. Akcja dotyczy języka wybranego w tabeli lub wszystkich języków. Przyjazne URL są czyszczone, a zbyt długie teksty przycinane.

### Zmień inne pole

Widoczność, stan produktu, dostępny do zamówienia, pokaż cenę, tylko online, oznaczenie „wyprzedaż”, minimalna ilość, alert niskiego stanu, dodatkowy koszt wysyłki, waga, szerokość, wysokość, głębokość i teksty dostępności. W widoku Kombinacje: minimalna ilość, alert niskiego stanu i wpływ na wagę.

### Rabaty

**Dodaj rabat** tworzy cenę specjalną katalogu: procent lub kwota (domyślnie brutto, w przeciwnym razie zaznacz „Kwota netto”), opcjonalne daty początku i końca, grupa klientów i minimalna ilość. Rabat o dokładnie takich samych warunkach nie jest tworzony dwa razy. **Usuń wszystkie rabaty** kasuje ceny specjalne katalogu tych elementów, nie ruszając reguł koszyka ani reguł cen katalogowych. W widoku Kombinacje rabat dotyczy każdej kombinacji. Kolumna „Rabaty” pokazuje liczbę trwających lub zaplanowanych rabatów.

## Eksport i import CSV

### Eksport

Przycisk pobierania eksportuje zaznaczone wiersze lub wszystkie przefiltrowane wyniki ze wszystkimi edytowalnymi polami widoku. Dwa formaty: średnik i przecinek dziesiętny dla Excela po polsku i w większości języków europejskich lub przecinek i kropka dziesiętna dla Excela po angielsku i Arkuszy Google. Nagłówki to kody pól (`key`, `price`, `quantity`...). Kategorie są podane jako ID rozdzielone znakiem `|`.

### Ponowny import

1. Pozostań w tym samym widoku co przy eksporcie (Produkty lub Kombinacje) i wybierz język pól tekstowych.
2. Kliknij przycisk importu i upuść plik. Separator jest wykrywany automatycznie.
3. Wybierz sposób odnajdywania elementów: klucz (kolumna `key` eksportu), ID, kod referencyjny lub EAN-13. Kod wspólny dla kilku produktów jest zgłaszany i pomijany.
4. Kliknij **Podgląd**, aby zobaczyć zmiany pierwszych 20 wierszy, a następnie **Importuj**.

Puste komórki są pomijane, a zapisywane są tylko wartości różne od obecnych. W przypadku cen zmiana ceny netto ma pierwszeństwo przed ceną brutto. Pola tak/nie przyjmują 1/0, tak/nie i odpowiedniki w językach modułu. Każdy import pojawia się w historii i można go cofnąć jak akcję zbiorczą.

## Historia i cofanie

Zakładka **Historia** wymienia każdy zapis w tabeli, akcję zbiorczą, import i cofnięcie, z datą, pracownikiem oraz liczbą produktów i wartości. **Szczegóły** pokazują każdą wartość przed i po. **Cofnij** przywraca poprzednie wartości zestawu. Domyślnie wartość zmieniona ponownie po zestawie zostaje zachowana i zgłoszona. Zaznacz „Nadpisz późniejsze zmiany” w potwierdzeniu, aby mimo to ją przywrócić. Cofnięcie również można cofnąć.

## Multisklep

Tabela pokazuje i edytuje tylko wybrany sklep. W kontekście „Wszystkie sklepy” lub grupy komunikat wskazuje, który sklep jest wyświetlany. Wybierz inny sklep w menu multisklepu, aby go edytować.

## Rozwiązywanie problemów

- **Akcja zbiorcza zatrzymuje się w połowie**: zmniejsz „Elementów na żądanie zbiorcze” w konfiguracji. Przetworzone elementy pozostają w historii i można je cofnąć.
- **Komórka pozostaje czerwona po zapisie**: PrestaShop odrzucił wartość. Najedź na komórkę, aby przeczytać powód, popraw i zapisz ponownie.
- **Importowany plik zawiera dziwne znaki**: zapisz go w Excelu jako „CSV UTF-8”.
- **Produkt po zmianie nazwy nie jest znajdowany w wyszukiwarce sklepu**: moduł reindeksuje aktywne produkty widoczne w wyszukiwarce. Sprawdź widoczność produktu.
