Import CSV

Gdy masz setki lub tysiące produktów do przypisania filmów, robienie tego przez zakładkę Media admina jest powolne. Mediaverse dostarcza import CSV wewnątrz swojego modułu admina, który bierze plik o dwóch kolumnach (product number + URL filmu), pobiera miniaturę i tworzy za ciebie wpis product-media.

Gdzie to znaleźć

Settings → Plugins → Mediaverse → Import

Strona Import udostępnia upload pliku, siatkę podglądu, paski postępu oraz akcje import / cancel / reset.

Format CSV

CSV potrzebuje dwóch kolumn:

Kolumna	Opis
`productNumber`	Product number (SKU) Shopware, do którego ma być załączone wideo.
`videoUrl`	URL filmu — obsługuje te same źródła co embed video (YouTube, Vimeo, Facebook, TikTok, Dailymotion, G-Core, bezpośredni URL).

Wiersz nagłówka nie jest wymagany; import czyta pierwszą kolumnę jako product number i drugą jako URL.

Przykład:

SW10001,https://www.youtube.com/watch?v=123456
SW10002,https://www.youtube.com/watch?v=654321

Jeśli URL zawiera parametry zapytania start= lub end=, importer wyodrębnia je jako start / end time wideo (tam gdzie wspiera to źródło).

Uruchamianie importu

Otwórz Settings → Plugins → Mediaverse → Import.
Kliknij Upload i wybierz plik CSV.
Strona parsuje plik z paskiem postępu (Processing…) i pokazuje siatkę podglądu z pierwszymi 25 wierszami: product number, znormalizowany URL filmu, rozpoznane źródło i odznaka walidacji.
Przejrzyj podgląd. Wiersze z błędami (nieprawidłowy URL, nieznane źródło) są oznaczone.
Kliknij Import. Strona przetwarza wiersze pojedynczo:
- Wyszuka produkt po productNumber.
- Rozpozna źródło wideo z URL.
- Pobierze miniaturę (dla YouTube, Vimeo, TikTok, Dailymotion).
- Utworzy nowy wiersz product_media z ustawionym customFields.p2labProductVideo.
Status per wiersz pokazywany jest na żywo (Importing… z paskiem postępu, następnie odznaka success / error per wiersz).

Obsługa duplikatów

Importer odrzuca duplikaty: jeśli produkt już ma wpis medium z tym samym customFields.p2labProductVideo.url, wiersz zawiedzie z błędem “Video already exists”. Import nie aktualizuje ani nie nadpisuje istniejących wpisów.

Jeśli musisz zmienić wideo na produkcie, edytuj je przez zakładkę Media produktu.

Obsługiwane przypadki błędów

Invalid video URL — wzorzec URL nie pasował do żadnego obsługiwanego źródła.
Product not found — nie istnieje produkt o tym numerze.
Video already exists — ten sam URL jest już na tym produkcie.
Thumbnail download failed / canceled — miniatura źródła nie mogła zostać pobrana.
Invalid file type — wgrany plik nie jest CSV.

Cancel / Reset

Cancel zatrzymuje trwający import na granicy następnego wiersza. Wiersze już przetworzone pozostają na produktach.
Reset czyści podgląd i pozwala wgrać nowy plik.

Czego NIE robi

Nie ustawia per-video opcji odtwarzania (autoplay, muted, theme itp.). Wszystkie zaimportowane wpisy dziedziczą globalne wartości domyślne — dostosuj je per produkt później lub zmień odpowiednie globalne wartości domyślne Mediaverse.
Nie uploaduje lokalnych plików HTML5. Flow importu jest tylko dla URL-i osadzeń.
Nie tworzy tłumaczeń. Filmy wielojęzyczne wciąż trzeba ustawiać per produkt przez zakładkę Other languages.