Korzystanie z wtyczek Gigya w Drupal - Gigya Documentation - Podręcznik programisty

1. Udostępnij wtyczkę
2. Wtyczka Reakcje
3. Reakcje Kod Przykładowy
4. Definiowanie akcji
5. Śledź wtyczkę paska
6. Dodawanie wtyczki jako bloku
7. Dodawanie wtyczki jako pola zawartości
8. Dodawanie wtyczki w panelu
9. Dodawanie wielu wtyczek do panelu

Ten dokument pokaże Ci, jak skonfigurować wtyczki Gigya i wstawić je do swojej witryny.

Wtyczki można skonfigurować za pomocą panelu konfiguracji administracyjnej pod wpisem Gigya ( Konfiguracja> Usługi internetowe> Ustawienia Gigya ).

Wybierz kartę wtyczki, którą chcesz skonfigurować.

Udostępnij wtyczkę

The Gigya Dzielić wtyczka pozwala użytkownikom dzielić się historiami z sieciami społecznościowymi.

Możesz łatwo zintegrować Gigya Share Bar w swojej witrynie Drupal, definiując dla niego kontener na stronie Gigya> Share Settings . Czytaj więcej w Dodawanie wtyczek Gigya Sekcja.

Możesz wybrać dostawców akcji, które chcesz mieć, wpisując je w polu Dostawcy akcji , oddzielone przecinkiem.

Wartość domyślna Opis ID kontenera gigya-share Identyfikator elementu HTML DOM, który będzie zawierał pasek udostępniania. Udostępnianie przycisków, Facebook, Google Plus, twitter, e-mail Wpisz rozdzielaną przecinkami listę przycisków udostępniania, które chcesz wyświetlić. Pełna lista dostępnych dostawców znajduje się w socialize.showShareBarUI Strona API. Układ paska współrzędnych Poziomo Poziomo lub Pionowo. Pokaż liczniki Prawo Określ, czy i gdzie (w prawo lub w górę), aby wyświetlić liczbę kliknięć przycisku akcji dla tego produktu. Zakres publikacji
do kanału aktywności Oba

Przestarzałe

Domyślny tytuł udziału [węzeł: tytuł] Domyślny tytuł do wyświetlenia dla wpisu elementu udostępniania. Domyślny opis udziału [węzeł: podsumowanie] Domyślny opis wpisu elementu udostępniania. Domyślny linkback URL [node: url: absolute] Domyślny linkback, do którego użytkownicy będą kierowani po kliknięciu postu udostępniania. Obraz używa znacznika obrazu, jeśli istnieje. Instrukcje dotyczące miejsca, w którym należy pobrać obraz dla pozycji postu.
Dostępne są następujące opcje:

• Pierwsze zdjęcie na postie.
• Określ adres URL obrazu.
• Użyj znacznika obrazu, jeśli istnieje, pierwszego zdjęcia na postu - jeśli został określony adres URL obrazu, użyj go. W przeciwnym razie użyj pierwszego obrazu, który pojawia się w poście.

Udostępnij za pomocą krótkich adresów URL nie Zaznacz to pole, aby użyć krótkiego adresu URL. Lista żetonów Szybko wstaw żetony do jednego z pól ustawień, klikając pole, a następnie klikając żądany token. Ustawienia zaawansowane (brak wartości domyślnej) To pole umożliwia określenie opcji konfiguracji poza tymi dostępnymi w powyższych polach. Aby uzyskać szczegółowe informacje, patrz Sekcja Ustawienia zaawansowane . Lista dostępnych opcji konfiguracji znajduje się w tabeli parametrów w socialize.showShareBarUI Strona API.

The Gigya Komentarze wtyczka umożliwia użytkownikom witryny publikowanie komentarzy i prowadzenie dyskusji na temat opublikowanych treści w witrynie.

The Gigya Ocena i recenzje wtyczka zapewnia klientom łatwy sposób na przekazywanie opinii na temat produktów i treści w witrynie.

Wtyczka Oceny i recenzje jest rozszerzeniem wtyczki komentarzy i można ją ustawić w konsoli administracyjnej Gigya, gdy tworzenie nowej kategorii komentarzy .

Wtyczka wymaga również skonfigurowania w konsoli administracyjnej Gigya, postępując zgodnie z instrukcjami opisane na stronie wtyczki Komentarze .

Zarówno komentarze Gigya, jak i oceny i recenzje wspierają SEO, co oznacza, że ​​treść komentarzy / opinii jest dostępna do przeszukiwania przez główne wyszukiwarki.

Komentarze:

Oceny i recenzje:

Aby użyć tej wtyczki, zdefiniuj identyfikator kategorii w Konsoli administracyjnej Gigya i wprowadź ją poniżej, a następnie ustaw opcję Włącz komentarze Gigya na Tak . Pozostałe ustawienia są opcjonalne.

PoleDomyślnieOpis

Włącz Gigya Komentarze Nie Wybierz Tak, aby włączyć wtyczkę Komentarze lub Nie, aby ją wyłączyć. Komentarze Gigya ID kategorii Wprowadź nazwę kategorii komentarzy, którą ustawiłeś w konsoli Gigya. Aby zdefiniować kategorię komentarzy, przejdź do Konsoli zarządzania Gigya, Ustawienia> Komentarze> Ustawienia komentarzy . Aby dowiedzieć się więcej, zapoznaj się z Ustaw kategorię nowego komentarza na stronie Gigyi. Komentarze identyfikatora kontenera Identyfikator kontenera, w którym będą wyświetlane komentarze. Zakres publikacji
do kanału aktywności Oba

Przestarzałe

Nie ładuj komentarzy Drupala tak Jeśli zaznaczone komentarze Drupala nie zostaną załadowane, załadowane zostaną tylko komentarze Gigya. Uwaga: może to zaszkodzić SEO witryny, ponieważ komentarze nie będą indeksowane przez wyszukiwarki Zaawansowane ustawienia (brak wartości domyślnej) To pole umożliwia określenie opcji konfiguracji poza tymi dostępnymi w powyższych polach. Aby uzyskać szczegółowe informacje, patrz Sekcja Ustawienia zaawansowane . Lista dostępnych opcji konfiguracji znajduje się w tabeli parametrów w comments.showCommentsUI Strona API.

Wtyczka Reakcje

The Gigya Wtyczka Reakcje umożliwia użytkownikom dzielenie się zdefiniowanymi reakcjami na produkty witryn w sieciach społecznościowych użytkowników. Ta wtyczka wyświetla na stronie zestaw przycisków, takich jak:

Przyciski reakcji są zdefiniowane przez rozdzieloną przecinkami listę obiektów JSON. Każdy obiekt definiuje pojedynczy przycisk reakcji, który ma być wyświetlany na pasku reakcji. odnoszą się do Obiekt reakcji dla specyfikacji struktury obiektu. Możesz także użyć Gigyi Kreator reakcji . Upewnij się, że jesteś zalogowany na stronie Gigyi, możesz uzyskać dostęp do kreatora, klikając kartę Wtyczki , a następnie Reakcje na pasku bocznym.

Pole

Wartość domyślna Opis ID kontenera gigya-reaction Identyfikator kontenera, w którym będą wyświetlane komentarze. Identyfikator pręta ID pręta reakcji na pasku reakcji. Tytuł reakcji [węzeł: tytuł] Domyślny tytuł do wyświetlenia dla wpisu elementu udostępniania. Domyślny linkback URL [węzeł: tytuł] Domyślny linkback, do którego użytkownicy będą kierowani po kliknięciu postu udostępniania. Układ Poziomo Poziomo lub Pionowo. Kierunek rozmieszczenia przycisków. Użyj wielu reakcji Tak Wybierz Tak, aby zezwolić pojedynczemu użytkownikowi na aktywację wielu reakcji, jeśli ustawiono na Nie tylko dozwolony jest jeden pasek reakcji na użytkownika. Zlicz typ numeru lub procent. Liczba przycisków reakcji jest wyświetlana jako liczba dosłowna lub jako procent wszystkich naciśniętych przycisków. Zakres publikacji do kanału aktywności Oba

Przestarzałe

Obraz używa znacznika obrazu, jeśli istnieje. Instrukcje dotyczące miejsca, w którym należy pobrać obraz dla pozycji postu.
Dostępne są następujące opcje:

• Pierwsze zdjęcie na postie.
• Określ adres URL obrazu.
• Użyj znacznika obrazu, jeśli istnieje, pierwszego zdjęcia na postu - jeśli został określony adres URL obrazu, użyj go. W przeciwnym razie użyj pierwszego obrazu, który pojawia się w poście.

Ustawienia zaawansowane (brak wartości domyślnej) To pole umożliwia określenie opcji konfiguracji poza tymi dostępnymi w powyższych polach. Aby uzyskać szczegółowe informacje, patrz Sekcja Ustawienia zaawansowane . Lista dostępnych opcji konfiguracji znajduje się w tabeli parametrów w socialize.showReactionsBarUI Strona API. Lista żetonów Szybko wstaw żetony do jednego z pól ustawień, klikając pole, a następnie klikając żądany token.

Reakcje Kod Przykładowy

Poniższy przykładowy kod wyświetla te przyciski reakcji:

{tekst: „Niesamowite”, ID: „niesamowite”, iconImgUp: „http: //cdn.gigya.com/gs/i/reactions/icons/Amazing_Icon_Up.png”, iconImgOver: „http: //cdn.gigya. com / gs / i / reaction / icons / Amazing_Icon_Down.png ', podpowiedź: „Ten element jest niesamowity”, feedMessage: „To jest niesamowite!”, headerText: „Twoja reakcja na ten post jest„ Niesamowita ” {tekst: 'Geeky', ID: 'geeky', iconImgUp: 'http: //cdn.gigya.com/gs/i/reactions/icons/Geeky_Icon_Up.png', iconImgOver: 'http: //cdn.gigya. com / gs / i / reaction / icons / Geeky_Icon_Down.png ', podpowiedź: „Ten element jest naukowy”, feedMessage: „To jest naukowy!”, headerText: „Twoja reakcja na ten post jest„ naukowa ”\ t

Gigya Lojalność - grywalizacja i zachowanie użytkownika to społeczna platforma lojalności i nagród, którą możesz umieścić na swojej stronie, zwiększyć zaangażowanie witryny i sprawić, że doświadczenie użytkowników będzie przyjemniejsze. Aby skorzystać z tej wtyczki, zaznacz pole wyboru Włącz Gigami Gamification . Pozostałe ustawienia Gamification są opcjonalne. Wtyczka Gamification wymaga również skonfigurowania w konsoli administracyjnej Gigya, wykonując kroki opisane na stronie wtyczki Gamification .

PoleDomyślnieOpis

Włącz Gigya Gamification Tak Zaznacz to pole, aby włączyć wtyczkę Gamification lub Nie, aby ją wyłączyć. Włącz powiadomienia o grywalizacji Tak Zaznacz to pole, aby włączyć wyskakujące okienka powiadamiające użytkownika o osiągnięciach Gamification: Zobacz Powiadomienia po więcej szczegółów. Okres czasu w tabeli liderów Wszystkie Wyświetla dla najlepszych użytkowników wyzwanie w ustalonym okresie: patrz Tabela liderów po więcej szczegółów. Liczba użytkowników tablicy wyników 12 Wybierz liczbę z przedziału od 1 do 23, aby ustawić liczbę użytkowników wyświetlaną w tabeli liderów. Ustawienia zaawansowane (brak wartości domyślnych) Ta sekcja umożliwia określenie opcji konfiguracji poza tymi dostępnymi w powyższych polach. Aby uzyskać szczegółowe informacje, patrz Sekcja Ustawienia zaawansowane . Każde pole ustawia zaawansowane ustawienia odpowiedniej wtyczki.
Lista dostępnych opcji konfiguracji znajduje się w tabeli parametrów na stronie API odpowiedniej metody:

Sekcja Bloki grywalizacji na karcie Ustawienia grywalizacji to szybki sposób na skonfigurowanie i wdrożenie niektórych wtyczek mechaniki gry Gigya, takich jak Status użytkownika i Tablica wyników.

Wtyczki te wyświetlają widma GM i aktualizują je na żywo, gdy użytkownik wykonuje działania wpływające na stan wtyczki. Aby dowiedzieć się więcej, przejdź do Sekcja wtyczek Mechanika gry . Podczas dodawania wielu wystąpień wtyczki, musisz zdefiniować blok zawierający każdą instancję wtyczki i zostanie umieszczony na twojej stronie internetowej. Na przykład, możesz chcieć umieścić jedną wtyczkę Statusu Użytkownika w nagłówku swojej witryny i jedną w stopce. Aby to osiągnąć, musisz utworzyć dwa bloki, z których każdy zawiera instancję wtyczki Status użytkownika, i umieścić jeden w nagłówku, a drugi w stopce.

Aby utworzyć blok, wykonaj następujące kroki:

• Na karcie Gamification przejdź do pola Utwórz nowy blok .
• Wpisz nazwę nowego pudełka. Zaleca się użycie nazwy odpowiedniej dla celu tego pola, więc dla pierwszego pola zawierającego dwa dodatki Status użytkownika odpowiednia będzie nazwa taka jak User_Status_1 .
• Zaznacz pole obok wtyczki, którą chcesz utworzyć (w naszym przykładzie: Status użytkownika).
• Kliknij Utwórz blok .
• Kliknij Zapisz konfigurację, aby zapisać wprowadzone zmiany (na dole strony).

Aby umieścić wtyczkę na swojej stronie, przejdź do Konfiguracja> Struktura> Bloki . Znajdź nowo utworzony blok, aw kolumnie Region wybierz sekcję witryny, w której chcesz umieścić wtyczkę. Aby usunąć blok, po prostu zaznacz pole obok niego w sekcji Usuń bloki i kliknij Usuń .

Definiowanie akcji

Wyzwania związane z grywalizacją są napędzane przez działania . Używanie GM do definiowania wyzwania użytkownicy mogą następnie wykonywać działania, aby zdobywać punkty za zaangażowanie.
Moduł Gigya umożliwia synchronizację działań w witrynie Drupal ze wstępnie zdefiniowanymi działaniami zdefiniowanymi w wyzwania sekcji konsoli. Aby zintegrować działania z witryną, musisz pobrać, zainstalować i włączyć moduł reguł .

• Po skonfigurowaniu modułu reguł przejdź do Konfiguracja> Przepływ pracy> Reguły .
• Nazwij akcję, wypełniając wymagane pole tekstowe Nazwa i wybierz zdarzenie, na które chcesz zareagować z listy rozwijanej Reakcja po zdarzeniu .
• Jeśli chcesz ograniczyć akcję do określonych stron, wybierz typ strony z listy rozwijanej Ogranicz według typu . W przeciwnym razie akcja zostanie wywołana za każdym razem, gdy wystąpi zdarzenie reakcji. Na przykład, jeśli wybierzesz zawartość Przeglądane zdarzenie, a nie ograniczysz według typu, zdarzenie zostanie wyzwolone przy każdym załadowaniu strony. Jeśli jednak wybierzesz ograniczenie według typu do samych stron typu Artykuł , zdarzenie jest uruchamiane tylko w przypadku załadowania strony artykułu.
• Kliknij Zapisz, aby kontynuować.
• W sekcji Akcje kliknij Dodaj akcję .
• W akcji Wybierz, aby dodać listę rozwijaną, wybierz akcję mechaniki gry Gigya .
• Następująca lista rozwijana będzie zawierała akcje zdefiniowane w konsoli Gigya. Wybierz akcję, którą chcesz powiązać z utworzonym wydarzeniem.
• Kliknij Zapisz, aby ukończyć proces, i powtarzaj, aż wszystkie akcje, które chcesz uruchomić na swojej stronie, są powiązane z regułą w Drupalu.

Śledź wtyczkę paska

W tej sekcji wyjaśniono, jak dodać wtyczki społecznościowe Gigya do swojej witryny. Zauważ, że niektóre wtyczki wymagają skonfigurowania w konsoli administracyjnej Gigya: zobacz sekcję ustawień wtyczki, aby uzyskać szczegółowe informacje.

Po skonfigurowaniu wtyczki możesz wstawić ją na swoją stronę (strony) na kilka sposobów (kliknij linki, aby uzyskać więcej informacji):

1. Dodawanie wtyczki jako bloku
2. Dodawanie wtyczki jako pola zawartości
3. Dodawanie wtyczki do panelu

Aby wybrać najlepszą metodę, poszukaj notatki u góry strony konfiguracji wtyczki, na przykład:

Dodawanie wtyczki jako bloku

Aby dodać wtyczkę Gigya jako blok na swojej stronie:

Dodawanie wtyczki jako pola zawartości

Aby dodać wtyczkę Gigya jako pole w swoim typie treści:

Następnie będziesz musiał dostroić wtyczkę, aby dopasować ustawienia wyświetlania wtyczki w konsoli administracyjnej

to jest to! Nowa wtyczka społecznościowa Gigya pojawi się w Twojej witrynie na zdefiniowanej przez Ciebie pozycji.

Dodawanie wtyczki w panelu

Wtyczki Gigya można również dodawać do paneli, jeśli masz moduł paneli zainstalowany i włączony.

1. Moduł Gigya ma również integrację z panelami , którą należy również włączyć w sekcji Gigya na stronie Moduły .
   
2. Dodając nowy panel, dodaj kontekst do panelu, ponieważ niektóre wtyczki Gigya wymagają kontekstu i nie będą dostępne do osadzenia na panelu w inny sposób. Dodaj kontekst, zaznaczając pole wyboru Konteksty w sekcji Funkcje opcjonalne na pierwszej stronie przepływu panelu Dodaj .
   
3. Następnie zostaniesz poproszony o wybranie kontekstu dla panelu z rozwijanego menu dostępnych kontekstów.
   
4. Wybierz kontekst, który chcesz i kliknij Dodaj kontekst . Na podstawie wybranego kontekstu konieczne będzie wprowadzenie identyfikatora dla instancji tego kontekstu. Na przykład, jeśli wybrałeś kontekst węzła , będziesz musiał wprowadzić identyfikator istniejącej jednostki węzła w swojej witrynie.
   
5. To tyle, ile wymaga Gigya. Po zakończeniu tworzenia panelu i dodaniu wtyczki Gigya do panelu po prostu kliknij Dodaj zawartość z menu ustawień:
   
6. W wyskakującym oknie wybierz Gigya z menu po lewej stronie:
   
7. Wybierz wtyczkę, którą chcesz dodać z listy dostępnych wtyczek (jeśli brakuje niektórych wtyczek, upewnij się, że masz zdefiniowany kontekst do panelu) i kliknij Zakończ .
   

Dodawanie wielu wtyczek do panelu

Podczas dodawania więcej niż jednej wtyczki tego samego typu do panelu (tj. Dwóch następujących po sobie pasków), musisz zdefiniować różne identyfikatory kontenerów wtyczek, ponieważ domyślny identyfikator nie może być przypisany do więcej niż jednego kontenera.
Odbywa się to poprzez zaznaczenie pola wyboru Zastąp domyślne ustawienia na wdowie, która następuje po wybraniu wtyczki.

Po zaznaczeniu pola dostępne będą dalsze opcje konfiguracji. Zmień nazwę identyfikatora kontenera (np. Gigya-follow-bar2), aby umożliwić wyświetlenie na stronie dwóch instancji wtyczki.

Zapisać

Zapisać

Zapisać