README

Moduł dostarcza poleceń konsoli do synchronizacji mediów z AWS S3 i zarządzania galeriami.

Dostępne Polecenia

Kompleksowe narzędzie do konwersji obrazów na format WebP, tworzenia miniaturek i czyszczenia.

Kolejność operacji:
1. Czyszczenie wstępne: Skanuje cały bucket w poszukiwaniu i usuwa niepoprawnie nazwane pliki, np. obraz.jpg.webp lub obraz.webp.webp.
2. Konwersja obrazów: Wyszukuje obrazy (JPG, PNG, JPEG) w pub/media/ (z wyłączeniem catalog/ i tmp/) i konwertuje je do formatu WebP.
3. Tworzenie miniaturek: Dla każdego nowo utworzonego pliku .webp generuje jego miniaturkę (domyślnie 240x240px) i zapisuje ją w odpowiednim katalogu .thumbs, np. pub/media/.thumbswysiwyg/obraz.webp.
4. Czyszczenie końcowe: Usuwa całą zawartość folderu pub/media/tmp/ w S3, a następnie tworzy go na nowo jako pusty katalog.

Podstawowe użycie:

bin/magento gardenlawn:gallery:convert-to-webp

Opcje:
- --force lub -f: Wymusza regenerację istniejących już plików .webp i ich miniaturek. Skrypt najpierw usunie stare pliki, a następnie utworzy je na nowo.
```
bin/magento gardenlawn:gallery:convert-to-webp --force
```
- -v: Tryb szczegółowy (verbose). Wyświetla szczegółowe logi z każdego etapu (pobieranie, konwersja, wysyłanie, czyszczenie).
```
bin/magento gardenlawn:gallery:convert-to-webp -v
```
Zaleca się uruchamianie komendy w tle lub w sesji screen dla dużych bibliotek mediów.

Synchronizuje tabelę media_gallery_asset z zawartością bucketa S3.

Podstawowe użycie (tylko dodawanie nowych plików):
```
bin/magento gardenlawn:mediagallery:sync-s3
```
Opcje:
- --dry-run: Wyświetla, jakie zmiany zostałyby wprowadzone, bez modyfikacji bazy danych.
- --with-delete: (Ostrożnie!) Włącza usuwanie z bazy danych wpisów o plikach, które nie istnieją już w S3.
- --force-update: (Może być wolne!) Włącza aktualizację istniejących plików, jeśli brakuje im hash, width, height lub hash się zmienił.
Przykład pełnej synchronizacji (dodawanie, aktualizacja, usuwanie):
```
bin/magento gardenlawn:mediagallery:sync-s3 --with-delete --force-update --dry-run
```

Tworzy galerie na podstawie folderów, linkuje do nich zasoby i opcjonalnie czyści nieużywane galerie. Uruchamiaj po sync-s3.

Podstawowe użycie (tworzenie galerii i linkowanie):
```
bin/magento gardenlawn:mediagallery:populate-all
```
Opcje:
- --dry-run: Wyświetla, jakie zmiany zostałyby wprowadzone, bez modyfikacji bazy danych.
- --with-prune: (Ostrożnie!) Włącza usuwanie galerii, które nie odpowiadają już żadnym istniejącym plikom.
Przykład użycia z czyszczeniem galerii:
```
bin/magento gardenlawn:mediagallery:populate-all --with-prune --dry-run
```