Easy Instagram Photos - Dokumentacja modułu Magento 2
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
- Dodaj repozytorium do pliku composer.json:
"repositories": [
...
{
"type": "vcs",
"url": "git@git.auroracreation.com:aurora-modules/easy-instagram-photos.git"
}
...
],
- Następnie dodaj zależność w pliku composer.json:
"require": {
...
"aurora/easy-instagram-photos": "*"
...
},
- W folderze głównym Magento wykonaj następujące polecenia:
composer update aurora/easy-instagram-photos
php bin/magento module:enable Aurora_EasyInstagramPhotos
php bin/magento setup:upgrade
Instalacja manualna
- Rozpakuj archiwum
- Przenieś pliki modułu na serwer do lokalizacji:
{Magento root}
└── app/
└── code
- W folderze głównym Magento wykonaj następujące polecenia:
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.