<!-- TITLE: Slider - Dokumentacja modułu Magento 2--> <!-- SUBTITLE: Autor: Aurora Creation --> # Slider - Dokumentacja modułu Magento 2 ## Opis modułu Moduł umożliwia dodanie widżetu ze slajderem fotografii na wybranej stronie w sklepie. ## Zgodność modułu Ten moduł jest zgodny z następującymi wersjami Magento Community: **2.2**, **2.3** i **2.4**. ## Sposób działania Aby móc dodać widżet Slidera musisz stworzyć przynajmniej 1 baner i 1 slajd. ### Dodawanie slajdu: Kieruj się do Panelu Admina. Tam przejdź do **Content > Aurora Banner > Slides**. Wybierz opję **Create New Slide**. Pojawi się widok konfiguracji slajdu.  **Name**- nazwa slajdu. **Assign to Banner(s)**- przypisanie do baneru. **Enable Slide** - włącz slajd. **Store View** - wybór Store View. Slajd może być wyświetlany dla wybranej grupy klinetów i w wybranym przedziale czasu.  **Customer Groups** - wybór grupy klienta. **Display From** - data początkowa wyświetlania **Display To** - data końcowa wyświetlania **Wybór obrazka do slajdu:**  **Image Type** - wybór między dodaniem obrazka z pliku bądź z linku. **Large Image File**- dodanie obrazka o szerokości maksymalnej 1023 px. Można również załadować obrazki innej maksymalnej szerokości. **Image Title** - tytuł slajdu. **Image Alt** - alternatywny opis obrazka.  **URL** - umożliwia wstawienie linku, do którego ma przekierowywać kliknięcie przycisku nad slajdem. **Open URL in New Window**- czy strona ma otworzyć się w nowym oknie. **Add 'No follow' to URL** - dodaje atrybut nofollow do adresu URL.  **Enable title and button**- włącz opcję przycisku i tytułu dla slajdu. **Title**- tytuł wyświetlany nad slajdem. **Color**- kolor przycisku. **Description** - opis wyświetlany nad slajdem. **Button text** - tekst wyświetlany w przycisku. **Position X** - pozycja przycisku względem osi X. **Positon Y**- pozycja przycisku względem osi Y.  Po konfiguracji slajdu należy wybrać opcję **Save** Zapisany slajd pokaże się pod ścieżką **Content > Aurora Banner > Slides**. ### Dodawanie baneru: Kieruj się do Panelu Admina. Tam przejdź do **Content > Aurora Banner > Banners**. Wybierz opję **Create New Banner**.  Pod podaną ściężka otrzymasz konfiguracje do baneru, składającą się z pól: **Name** – nazwa baneru. **Enable Banner** – włącz baner. oraz pól umożliwiających zmianę zachowania Slidera:  **Animation Effect**– pozwala na wybór animacji podczas przejścia Slidera. **Pause Time Between Transitions, ms**– umożliwia ustawienie czasu pauzy między widokiem kolejnych slajdów, wyrażony w milisekundach. **Slide Transition Speed, ms**– ustawienie szybkości przejścia między kolejnymi sladami, wyrażona w milisekundach. **Stop Animation While Mouse is on the Banner**– zatrzymanie przejścia między slajdami, kiedy kursor myszy znajduje się na banerze. **Display Arrows** – pokazuje strzałki nawigacyjne. **Display Navigation Bullets**– pokazuje paginację u dołu Slidera.  Jeżeli jest dodany slajd, można przypisać go do baneru zaznaczając checkbox.  Po konfiguracji slajdu należy wybrać opcję **Save** Zapisany sliajd pokaże się pod ścieżką **Content > Aurora Banner > Banners**. ### Dodawanie widżetu Slidera: Kieruj się do Panelu Admina. Tam przejdź do **Content > Elements > Widgets**. Wybierz opję **Add Widget**.  W opcji **Type** musisz wybrać **Rich Banner Slider**. W opcji **Design Theme** motyw swojego sklepu. Następnie należy kliknąć przycisk **Continue**  Pojawi nam się widok gdzie wpisujemy tytuł widżetu, przypisujemy widżet do Store Views.  W rubryce Layout Updates po kliknięciu w przycisk **Add Layout Update** wybieramy gdzie (na jakich stronach i w jakim kontenerze) ma wyświetlać się widżet ze Sliderem. W zakładce **Widget Options**: **Choose banner type** - wybieramy typ banneru. **Banner 1** - przyciskiem **Select Banner...** wybieramy baner z przypisanym slajdem.  Po konfiguracji widżetu należy kliknąć przycisk **Save**, odświeżyć cache, Slider pojawi się w wybranym miejscu. ## Instalacja modułu ### Instalacja przez Composer 1. Dodaj repozytorium do pliku composer.json: ```text "repositories": [ ... { "type": "vcs", "url": "git@git.auroracreation.com:magento2/slider.git" } ... ], ``` 2. Zmodyfikuj plik composer.json: ```text "require": { ... "aurora/slider": "*" ... }, ``` 3. W folderze głównym Magento wykonaj następujące polecenia: ```text composer update aurora/slider php bin/magento module:enable Aurora_Slider php bin/magento setup:upgrade ``` ### Instalacja manualna 1. Rozpakuj archiwum 2. Przenieś pliki modułu na serwer do lokalizacji: ```text {Magento root} └── app/ └── code ``` 3. W folderze głównym Magento wykonaj następujące polecenia: ```text php bin/magento module:enable Aurora_Slider php bin/magento setup:upgrade ``` ## Dziennik zmian ### v3.2.4 * Dodanie możliwości wyboru koloru tekstu oraz tła dla tytułu, opisu oraz przycisku slidera ### v3.2.3 * Poprawa zachowania opcji dotyczących tytułu, opisu oraz przycisku na sliderze ### v3.2.2 * Naprawa błędu uniemożliwiającego edycję slider ### v3.2.1 * Dodanie możliwości wyboru koloru tekstu oraz tła dla tytułu, opisu oraz przycisku slidera ### v3.2.0 * Aktualizacja biblioteki Swiper, poprawienie stylu oraz rozdzielczości ### v3.1.5 * Dodanie nowych testów ### v3.1.4 * Usunięcie niewykorzystywanych importów Zend ### v3.1.3 * Poprawienie schematu bazy danych ### v3.1.2 * Poprawy błędów ### v3.1.1 * Poprawa błędu z ładowaniem zdjęcia ### v3.1.0 * Aktualizacja modułu ### v3.0.8 * Poprawa działania przycisku na sliderze ### v3.0.7 * Dodanie opcji braku animacji slidera ### v3.0.6 * Poprawa działania opcji przy wielu istniejących banerach ### v3.0.5 * Dodanie możliwości ustawienia opisu slidu ### v3.0.4 * Poprawa błędów ### v3.0.3 * Poprawki w wyświetlaniu slidera ### v3.0.2 * Dodanie slidera do widgetów ### v3.0.1 * Zamiana biblioteki Slick na Swiper ### v3.0.0 * Nowa wersja działająca jako widget ### Dziękujemy za zainteresowanie naszymi modułami!