<!-- TITLE: Easy Instagram Photos - Dokumentacja modułu Magento 2--> <!-- SUBTITLE: Autor: Aurora Creation --> # Easy Instagram Photos - Dokumentacja modułu Magento 2 ## Opis modułu Obecnie Instagram posiada przeszło 700 milionów aktywnych użytkowników i ich liczba ciągle rośnie. Spraw, by Twój sklep nie był obojętny na światowe trendy i połącz go ze swoim kontem Instagram. Moduł Easy Instagram Photos pozwala na dodawanie galerii zdjęć generowanych na podstawie najnowszych wpisów z Twojego konta Instagram. ## Zgodność modułu Ten moduł jest zgodny z następującymi wersjami Magento Community: **2.3** i **2.4**. ## Sposób działania Po instalacji modułu przejdź w menu do **Stores > Configuration > Aurora > Easy Instagram Photos**. Konfiguracja modułu podzielona jest na 2 zakładki: W zakładce **General** należy uzupełnić poniższe pola:  **Enable** - Włącz moduł. **Instagram App ID** - Identyfikator aplikacji Instagram. **Instagram App Secret** - Sekretny klucz aplikacji. **Api Url** - URL do konta Instagram. **Long-Lived access token** - Token dostępu do API. **Image width** - Szerokość zdjęć (w pikselach). **Image height** - Wysokość zdjęć (w pikselach). **Image count** - Ilość zdjęć, które będą wyświetlane w widgecie. **Filter Image Type Only** - Włącz aby z konta Instagram pobierane były tylko zdjęcia (posty z wideo będą ignorowane). Natomiast w zakładce **Refresh** dostępne są następujące opcje:  **Automatic** - Włącz automatyczne odświeżanie tokenu dostępu. **Manually generate long-lived token** - Ręcznie odśwież token dostępu. **Instagram App Secret** - Ręcznie pobierz najnowsze zdjęcia z konta IG (moduł automatycznie pobiera dane raz dziennie). Aby uzyskać wszystkie potrzebne do konfiguracji dane, konieczne jest stworzenie nowej aplikacji **Instagram Basic Display API** w platformie dla developerów Meta. Instrukcja dostępna pod tym linkiem: https://developers.facebook.com/docs/instagram-basic-display-api. Po uzupełnieniu konfiguracji możemy korzystać z widgetu dostarczonego przez moduł, na przykład dodając tworząc go w **Content > Widgets** lub dodając go przy pomocy PageBuilder'a w treści interesującego nas bloku CMS.  Widget posiada tylko jedną niestandardową opcję do skonfigurowania - tytuł, który będzie wyświetlany w bloku widgetu.  Widget po umieszczeniu go na stronie głównej prezentuje się następująco:  ## Instalacja modułu ### Instalacja przez Composer 1. Dodaj repozytorium do pliku composer.json: ```text "repositories": [ ... { "type": "vcs", "url": "git@git.auroracreation.com:aurora-modules/easy-instagram-photos.git" } ... ], ``` 2. Następnie dodaj zależność w pliku composer.json: ```text "require": { ... "aurora/easy-instagram-photos": "*" ... }, ``` 3. W folderze głównym Magento wykonaj następujące polecenia: ```text composer update aurora/easy-instagram-photos php bin/magento module:enable Aurora_EasyInstagramPhotos 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_EasyInstagramPhotos php bin/magento setup:upgrade ``` ## Dziennik zmian ### v2.1.3 - Naprawa przycisków do odświeżania tokenów oraz zdjęć. - Dodanie grupy cron. - Poprawki standardów kodowania. ### v2.1.2 - Aktualizacja GitLab CI/CD. - Refaktoring kodu - standardy kodowania, deklaracje typów. ### v2.1.1 - Poprawa metody sprawdzającej czy post zawiera wideo. ### v2.1.0 - Dodanie opcji ignorowania postów z wideo. ### v2.0.6 - Poprawa odświeżania tokenów na multistore. ### v2.0.5 - Poprawa adresu URL do pobierania mediów. ### v2.0.4 - Naprawa usuwania starych zdjęć. ### v2.0.3 - Obsługa store views w zadaniach cron. ### v2.0.2 - Przypisywanie zdjęciom store view. ### v2.0.1 - Poprawa błędnego wyświetlania zdjęć. - Poprawka w Gitlab CI/CD. ### v2.0.0 - Refaktoring modułu. - Dodanie repozytorium oraz interfejsów. ### v1.2.8 - Zmiana nazwy eventu i observera. ### v1.2.7 - Zmiana nazewnictwa plików zdjęć. ### v1.2.6 - Poprawki nazwy modułu - acl, ścieżki konfiugracji. ### v1.2.5 - Usunięcie .gitignore. ### v1.2.4 - Poprawka w Gitlab CI/CD. ### v1.2.2 - Brak zmian. ### v1.2.1 - Poprawa adresu URL do zdjęć. ### v1.2.0 - Zapisywanie zdjęć na serwerze. - Zmiana rozmiaru obrazów. ### v1.1.4 - Dodanie atrybutu rel=”noopener” w linku do posta. ### v1.1.3 - Poprawki w szablonie widgetu. ### v1.1.2 - Zmiana wersji modułu. ### v1.1.1 - Ograniczenie liczby pobieranych zdjęć. ### v1.1.0 - Zmiana API. - Obsługa tokenów dostępu. ### v1.0.2 - Dodanie README. ### v1.0.1 - Ostylowanie widgetu. ### v1.0.0 - Inicjalizacja modułu. ### Dziękujemy za zainteresowanie naszymi modułami!