Instrukcja do wtyczki "Galeria+"
Spis treści:
- Jak zintegrować wtyczkę?
- Jak dodać film?
- Po zainstalowaniu wtyczki filmy nie są wyświetlane
- Jak umieścić wtyczkę na osobnej stronie i zrobić galerię zdjęć lub wideo?
- W jaki sposób filmy mogą być wyświetlane oddzielnie od galerii zdjęć na stronie produktu?
- Jak zastąpić ikonę pełnego ekranu?
- Używanie wtyczki w innych aplikacjach
- Korzystanie z wtyczki w aplikacji "Zdjęcia"
- Jak skonfigurować mobilną wersję wtyczki?
- Lista wszystkich opcji wtyczki "Gallery+"
- Jak ukryć przyciski nawigacyjne w wersji mobilnej?
- Przykład dostępu do funkcji, poprzez JavaScript.
Jak zintegrować wtyczkę?
Otwórz aplikację "Sklep" -> "Wtyczki" -> "Galeria+".Opcja nr.1: Automatyczne wyjście za pomocą haka:
Włącz wtyczkę ustawiając pole wyboru "Włącz".
Po włączeniu wtyczka automatycznie wyświetla galerię na stronie produktu za pomocą haka "frontend_product".
Jeśli w bieżącym motywie projektu istnieje już Galeria zdjęć, zaleca się usunięcie jej z szablonu.
Opcja nr.2: Wyjście poprzez wstawienie kodu w szablonie:
Włącz wtyczkę ustawiając pole wyboru "Włącz".
Wyłącz opcję "Użyj haka (frontend_product)".
Jeśli w bieżącym motywie projektu istnieje już Galeria zdjęć, zaleca się usunięcie jej z szablonu.
Jak dodać film?
Otwórz film z YouTube, który chcesz umieścić w Galerii+.Kliknij prawym przyciskiem myszy w oknie wideo i wybierz "Kopiuj adres URL filmu".
Otwórz aplikację "Sklep" -> "Towary" -> wybierz żądany produkt -> "Edytuj" -> "Zdjęcia i filmy " -> "Menadżer wideo" -> naciśnij przycisk "Dodaj", wklej adres URL w polu "Wideo URL", naciśnij "Zapisz".
Po zainstalowaniu wtyczki filmy nie są wyświetlane
Domyślnie wtyczka nie wyświetla filmów, które są już wprowadzone w aplikacji "Sklep". Linki do filmów, we wtyczce, dodawane są poprzez sekcję Towary" -> wybierz żądany produkt -> "Edytuj" -> "Zdjęcia i filmy " -> "Menadżer wideo" -> naciśnij przycisk "Dodaj", wklej adres URL w polu "Wideo URL", naciśnij "Zapisz".Jak umieścić wtyczkę na osobnej stronie i zrobić galerię zdjęć lub wideo?
Otwórz ustawienia wtyczki i odznacz "Tylko na stronie produktu".Utwórz nowy produkt bez określania kategorii.
Otwórz "Menedżer wideo" i dodaj wymagane adresy URL.
Jeśli potrzebujesz galerii zdjęć, prześlij wymagane obrazy.
Dowiedz się ID produktu:
Użyj kodu:
{if $wa->shop}{shopGalleryplusPlugin::display(ID)}{/if}
na żądanej stronie (z obsługą Smarty) lub w szablonie motywu projektu.
Na przykład, jeśli ID produktu: 43, kod będzie:
{if $wa->shop}{shopGalleryplusPlugin::display(43)}{/if}
W jaki sposób filmy mogą być wyświetlane oddzielnie od galerii zdjęć na stronie produktu?
W domyślnie film jest wyświetlany w galerii wraz ze zdjęciem.Możesz wyłączyć wyświetlanie wideo w galerii i wyświetlać je osobno w szablonie za pomocą kodu.
Otwórz ustawienia wtyczki w zakładce "Ustawienia ogólne", dla opcji "Tryb wyświetlania" ustaw wartość "Tylko obrazy".
W plik product.html dodaj kod:
{shopGalleryplusPlugin::getVideosById($product.galleryplus_videos,800,600)} - ze wskazaniem rozmiaru wideo.
{shopGalleryplusPlugin::getVideosById($product.galleryplus_videos,640,360,false)} - bez dodawania przerwy w linii dla każdego filmu.
Jak zastąpić ikonę pełnego ekranu?
Możesz zmienić przypisanie reguł CSS w bieżącym motywie projektu.Przykład CSS:
.galleryplus-maximize .galleryplusicon-zoom-in::before {
content: " ";
background-image: url(http://icons.iconarchive.com/icons/gakuseisean/ivista-2/32/Misc-Zoom-In-icon.png);
width: 20px;
height: 20px;
background-position: center;
background-size: cover;
background-repeat: no-repeat;
vertical-align: middle;
}
Używanie wtyczki w innych aplikacjach
Otwórz wybraną aplikację w backend'zie -> Projekt -> Szablony -> plik head.html, na końcu pliku dodaj linię:{if $wa->shop}{shopGalleryplusPlugin::getScripts()}{/if}
Utwórz produkt bez kategorii i dowiedz się ID produktu:
Użyj kodu:
{if $wa->shop}{shopGalleryplusPlugin::display(ID)}{/if}
na żądanej stronie (z obsługą Smarty) lub w szablonie motywu projektu.
Na przykład, jeśli ID produktu: 43, kod będzie:
{if $wa->shop}{shopGalleryplusPlugin::display(43)}{/if}
Korzystanie z wtyczki w aplikacji "Zdjęcia"
Otwórz aplikację Zdjęcia -> Projekt -> Szablony -> plik head.html, na końcu pliku dodaj linię:{if $wa->shop}{shopGalleryplusPlugin::getScripts()}{/if}
Następnie otwórz plik main.html (index.html albo content.html) i dodaj kod z pliku template.txt. Zobacz także pliki uzupełniające dla wyjścia z albumu.
Jak skonfigurować mobilną wersję wtyczki?
Korzystając z tego kodu w szablonie motywu projektowego, możesz zmienić ustawienia wtyczki dla wersji mobilnej na dowolną.{if waRequest::isMobile()}
{* Mobile version *}
{shopGalleryplusPlugin::display($product.id, ['modalImgFit'=>'cover', 'thumbnailsSize'=>'48x48', 'thumbsAlign'=>'bottom'])}
{else}
{* PC version *}
{shopGalleryplusPlugin::display($product.id)}
{/if}
Lista dostępnych parametrów znajduje się poniżej.
Lista wszystkich opcji wtyczki "Gallery+"
Parametr | Typ | Wartość domyślna | Opis | Dostępne wartości |
Aktywacja | ||||
enabled | bool | 0 | Włączyć | |
autoInit | integer | 1 | Automatyczna inicjalizacja | |
hookFrontendProduct | bool | 1 | Użyj haka (frontend_product) | |
onlyProductPage | integer | 1 | Tylko na stronie produktu | |
Ogólne | ||||
displayMode | string | both | Tryb wyświetlania | images, videos, both, |
width | string | auto | Szerokość | |
ratio | string | 4/3 | Współczynnik proporcji | |
mainImageSize | string | 750x0 | Rozmiar obrazu głównego | |
thumbnailsSize | string | 48x48 | Rozmiar miniatur | |
largeImageSize | string | 970x0 | Rozmiar powiększonego obrazu | |
slideShow | bool | 0 | Pokaz slajdów | |
slideShowBtn | bool | 1 | Przycisk pokazu slajdów | |
slideShowTimeout | int | 6000 | Czas przejścia dla slajdów | |
clickOnImage | string | none | Kliknięcie na obrazek | none, next, open, |
showNextOnClick | bool | 1 | Pokaż następny slajd | |
imgFit | string | contain | Jak umieszczać obrazy | cover, contain, auto, 100%, 100% 100% |
infiniteLoop | bool | 1 | Nieskończona pętla | |
showNavButtons | bool | 0 | Włączenie przycisków nawigacyjnych | |
useBadge | bool | 1 | Używanie naklejek | |
buttonsColor | string | white | Kolor przycisków | white, black, red, pink, purple, deep-purple, indigo, blue, light-blue, cyan, aqua, teal, green, light-green, lime, sand, khaki, yellow, amber, orange, deep-orange, blue-gray, brown, gray |
spinnerId | string | 4 | Spinner | 1, 2, 3, 4, 5, 6 |
Miniatury | ||||
showThumbnails | bool | 1 | Wyświetlanie miniatur | |
thumbsAlign | string | bottom | Wyrównanie miniatur | top, left, right, bottom |
thumbEventType | string | click | Przełączanie slajdów | none, click, hover, both |
thumbFit | string | cover | Jak umieścić miniatury | cover, contain, auto, 100%, 100% 100% |
thumbVideoFit | string | 180% | Jak dopasować miniatury wideo | cover, contain, auto, 100%, 100% 100% |
placeVideoThumbnails | string | left | Rozmieszczenie miniatur wideo | left, right, |
thumbsVerticalWidth | float | 55 | Szerokość kontenera dla pionowych miniatur | |
Tryb pełnoekranowy | ||||
mode | string | modal | Tryb wyskakującego okienka | modal, fullwindow, none |
modalShowNavButtons | bool | 1 | Włączanie przycisków nawigacyjnych | |
modalShowNextOnClick | bool | 1 | Otwieranie następnego slajdu po kliknięciu obrazu | |
modalShowZoomButtons | bool | 1 | Pokaż przyciski powiększenia | |
modalShowTitle | bool | 1 | Pokaż tytuł | |
modalTitleTextAlign | string | left | Wyrównanie nagłówka | left, center, right, justify |
modalShowDescription | bool | 1 | Wyświetlanie opisów obrazów | |
modalDescriptionDisplay | string | bottomleft | Położenie tekstu opisu | topmiddle, topleft, topright, bottomleft, bottomright, bottommiddle |
modalDescriptionAtimationClass | string | left | Animacja tekstu opisu | none, left, right, opacity |
modalImgFit | string | contain | Jak umieścić obrazy w wyskakującym oknie | cover, contain, auto, 100%, 100% 100% |
modalBackgroundColor | string | white | Kolor tła wyskakującego okna | white, black, red, pink, purple, deep-purple, indigo, blue, light-blue, cyan, aqua, teal, green, light-green, lime, sand, khaki, yellow, amber, orange, deep-orange, blue-gray, brown, light-gray, gray, dark-gray, pale-red, pale-yellow, pale-green, pale-blue |
Miniatury w wyskakującym oknie | ||||
modalShowThumbnails | bool | 1 | Wyświetlanie miniatur | |
modalThumbsAlign | string | bottom | Wyrównanie miniatur | top, bottom |
Powiększenie obrazu | ||||
elevateUseZoom | bool | 1 | Użyj zoomu | |
elevateZoomType | string | lens | Typ powiększenia soczewki | window, lens, inner |
elevateLensShape | string | round | Kształt soczewki | round, square |
elevateZoomWindowPosition | integer | 1 | Pozycja okna soczewki | 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16 |
elevateScrollZoom | bool | 1 | Skalowanie za pomocą przewijania | |
elevateLensSize | int | 250 | Rozmiar soczewki | |
elevateLensBorderColor | string | #fff | Kolor obramowania | |
elevateLensBorderSize | int | 1 | Grubość obramowania | |
Odtwarzacz wideo | ||||
ytplayer_modestbranding | integer | 0 | Ukryj logo YouTube | |
ytplayer_color | string | red | Kolor paska postępu odtwarzacza wideo | red, white |
ytplayer_theme | string | dark | Motyw projektowy odtwarzacza wideo | light, dark |
ytplayer_iv_load_policy | integer | 1 | Notatki wideo | 1, 3 |
ytplayer_showinfo | integer | 0 | Wyświetlanie informacji o wideo | |
ytplayer_rel | integer | 0 | Pokaż podobne filmy | |
ytplayer_fs | integer | 1 | Pokaż przycisk trybu pełnoekranowego | |
ytpquality | string | hqdefault | Jakość (rozdzielczość) podglądu obrazu dla wideo | hqdefault, sddefault, maxresdefault |
ytpquality2x | string | maxresdefault | Jakość (rozdzielczość) podglądu obrazu dla wideo (2X) | hqdefault, sddefault, maxresdefault |
Integracja | ||||
embedCode | Przykłady kodów osadzania | Według identyfikatora produktu: {if $wa->shop}{shopGalleryplusPlugin::display($product.id)}{/if} Według kilku identyfikatorów produktów: {if $wa->shop}{shopGalleryplusPlugin::multiDisplay([1,2,3], [slideShow=>true])}{/if} Według listy produktów: {if $wa->shop}{shopGalleryplusPlugin::displaySet('promo', [slideShow=>true])}{/if} Z zestawu danych: {if $wa->shop}{shopGalleryplusPlugin::customDisplay([['thumb'=>'/thumb.jpg', 'img'=>'/img.jpg', 'big'=>'/big.jpg', 'title'=>'Product name', 'desc'=>'Description']], '[{"0":"https://youtube.com/embed/s5nWTeLxhHA","title":"Test","desc":"Description"},["https://youtube.com/embed/5gvJGrvRS2k"]]', [slideShow=>true])}{/if} |
||
videosEmbedCode | Tylko filmy z YouTube, bez galerii | {shopGalleryplusPlugin::getVideosById($product.galleryplus_videos)} | ||
Resetuj | ||||
resetSettings | bool | 0 | Resetowanie ustawień | |
convertVideos | bool | 0 | Konwertowanie wideo na nowy format |
Jak ukryć przyciski nawigacyjne w wersji mobilnej?
Dodaj kod na końcu pliku head.html bieżącego motywu projektowego:{if $wa->isMobile()}
<!-- {literal} --><style>
.galleryplus-next, .galleryplus-prev {display: none !important;}
</style><!-- {/literal} -->
{/if}
Przykład dostępu do funkcji, poprzez JavaScript.
Wyłącz opcję "Automatyczna inicjalizacja" w ustawieniach wtyczki i dodaj kod do szablonu:{literal}
<script type="text/javascript">
(function($){$(function(){
$('.galleryplus').each(
function(){
var gp = $(this).GalleryPlus();
gp.fn.playSlideShow(); //uzyskanie dostępu do potrzebnych funkcji
});
});
})(jQuery);
</script>
{/literal}
Błąd w tekście? Zaznacz ją myszką i kliknij Ctrl + F1 lub kliknij na ten blok!