Facebook prihlásenie a registrácia

Ako prepojenie funguje

Doplnok umožňuje prihlásenie, poprípade registráciu, zákazníka do eshopu pomocou Facebooku.

Pokiaľ zákazník klikne na tlačidlo Prihlásiť sa cez Facebook, systém ho automaticky presmeruje na stranu Facebooku. V potvrdzovacom okne odsúhlasí zdieľanie informácií a potom ho Facebook presmeruje späť do eshopu. Pokiaľ proces zistí, že takýto email v eshope zatiaľ neexistuje, urobí sa automatická registrácia.

Pozor! Táto funkcia je prístupná iba od verzie šablón 5.2 a vyššie.

1. Pre fungovanie Facebook vyžaduje

Odporúčame tieto kroky vykonať skôr, než začnete prepájať Facebook prihlásenie - uľahčí to celý proces vytvárania a neskoršieho overovania.

• Pre vašu spoločnosť musí existovať Firemný účet v Facebook Business.
• Vaša spoločnosť musí byť Facebookom Overená v Facebook Business (Viac v Facebook pomocníkovi).
• Vytvorenie účtu a aplikácie v Facebook Developer
  • Pokiaľ aplikáciu bude vytvárať a testovať vlastník Firemného účtu v Facebook Business - Pokračujte rovno na krok 2 a ďalej podľa návodu.
  • Ak aplikáciu bude vytvárať iná osoba:
    1. Vlastník Firemného účtu sa musí prihlásiť do Facebook Developer (pod emailom, ktorý je v Facebook Business),
    2. Dokončite iba kroky 2 a 3 podľa návodu.
    3. Prejdite do rozhrania Facebook Business av sekcii Nastavenia/Užívatelia - Ľudia pridajte užívateľa, ktorý bude aplikáciu pre vás vytvárať a testovať.
    4. Tento užívateľ následne cez svoj Facebook Developer vyberie vytvorenú aplikáciu, prekontroluje krok 3 vo vytvorenej aplikácii a pokračuje ďalej podľa návodu.

2. Aktivácia doplnku

Prepojenie funguje na základe aktivácie doplnku v Upgates.

1. Prihláste sa do svojej administrácie Upgates,
2. Prejdite do sekcie Doplnky,
3. Vyhľadajte doplnok Prihlásenie do e-shopu,
4. Kliknite na Aktivovať,
5. V pravom hornom rohu kliknite na +Nové a vyberte Facebook.

3. Vytvorenie aplikácie

Pre správne fungovanie aplikácie odporúčame pre každú vašu jazykovú mutáciu vytvoriť separátnu Facebook aplikáciu. Má to totiž potom nadväznosť na správne odkazy na obchodné podmienky, atď.

Pozor! Facebook vyžaduje aby aplikácia bola vytvorená pod Firemným overeným účtom.

1. Otvorte Facebook Developer prostredie,
2. Kliknite na tlačidlo Create App,
   Facebook otvorí krokovaný proces vytvárania aplikácie
   • App detail
     • App name - Názov vašej facebook aplikácie. Vyplňte najlepšie vašu doménu alebo názov projektu - zobrazí sa v pop-up okne pre prihlásenie na strane Facebooku.
       (V prezenčnom príklade bol názov aplikácie Upgates)
     • App contact email - Skontrolujte, alebo upravte kontaktný email
     • Kliknite na Next

• • Use cases
    • V sekcii Featured vyberte Authenticate and request data from users with Facebook Login
    • Kliknite na Next
  • Business
    • Zvoľte firemný business účet, pre ktorý login vytvárate.
    • Kliknite na Next
  • Requirements
    • Tu môžete prekontrolovať že vaša spoločnosť má správne overenie
    • Kliknite na Next
  • Overview
    • Finálna stránka celkovej kontroly
    • Kliknite na Go to dashboard
      Facebook pravdepodobne pre overenie bude chcieť vaše heslo pre váš Facebook účet a potom vás presmeruje do aplikácie.

Ďalej pokračujte nastavením vytvorenej aplikácie.

4. Nastavenie aplikácie

1. Vo vytvorenej aplikácii v Facebook Developer zvoľte sekciu Prípady použitia "Use cases",
2. Kliknite v aplikácii Authenticate and request data from users with Facebook Login na Customize,
3. V ľavom menu sa uistite, že ste v sekcii Permissions and Features,
   • V zozname ponúkaných Permissions and features nájdite položku "email" a na pravej strane kliknite na +Add.
     Upgates nečíta a neukladá žiadne dodatočné dáta, ktoré nepotrebuje. Pokiaľ teda povolíte ďalšie sekcie ako vek, alebo lokáciu, atď. Upgates tieto dáta nebude prevolávať, kontrolovať, ani ukladať alebo overovať. Upgates pracuje iba s poľami: Meno, Priezvisko, Email a prezývka a iba v prípade, keď sa zakladá nový účet užívateľa.
4. V ľavom menu Facebook Developera prejdite do sekcie Settings,
   • Do sekcie Valid OAuth Redirect URls vložte URL adresu z Administrácie Upgates.
     1. Pokiaľ ešte nemáte aktivovaný doplnok Prihlásenie do eshopu, postupujte podľa návodu vyššie.
     2. Ak ešte nemáte pridaného Facebook poskytovateľa, pridajte ho cez tlačidlo +Nový v pravom hornom rohu.
     3. Kliknite na Názov poskytovateľa Facebook a otvorte jeho detail.
     4. V poli Vaša "valid OAuth redirect URls" skopírujte URL adresu a vložte do aplikácie Facebooku.
        Príklad tvaru URL: https://www.vasadomena.sk/oauth/login/facebook
     5. Dole na stránke kliknite na Save changes.
   • Pokiaľ máte viac jazykových mutácií na rôznych doménach neodporúčame vkladať všetky jazykové mutácie do jednej Facebook aplikácie ale rozdeliť ich do samostatných aplikácií tak, aby sa zachovali správne odkazy na Privacy policy, Terms of Service atď.
5. V ľavom menu Facebook Developera prejdite do sekcie App settings a zvoľte podsekciu Základné,
6. V hornej časti vyplňte
   • Privacy policy URL - Vložte URL adresu, na ktorej máte informácie pre zákazníkov ohľadom GPDR
   • Terms of Service URL - Vložte URL adresu, na ktorej máte obchodné podmienky
   • User data deletion - Zvoľte "Data deletion instructions URL" a vložte URL adresu, na ktorej máte informácie pre zákazníkov ohľadom GDPR
   • App icon - Nahrajte logo / Fav ikonu vášho eshopu v podporovanom formáte a veľkosti. Ikona, ktorú nahráte sa následne zobrazí v prihlasovacom okne na strane Facebooku.
     
   • Category - Zvoľte kategóriu, ktorou sa váš eshop zaoberá
7. Akonáhle budete mať hornú časť vyplnenú na konci stránky kliknite na Save changes.
8. Prejdite späť na hornú časť stránky a skopírujte App ID a App secret do detailu Facebook prepojenia v administrácii Upgates.
9. Vykonané zmeny Uložte.
10. Pokračujte krokom Testovanie aplikácie.

5. Testovanie aplikácie

Teraz máte vytvorenú aplikáciu v neoverenom stave. To znamená, že aplikácia funguje iba pod užívateľskými účtami, ktoré sú pridané v Facebook Developera / App roles - Roles.
Pod týmito účtami je teda možné aplikáciu na eshope otestovať.

5.1 Testovanie aplikácie pred spustením

1. V administrácii Upgates vyhľadajte sekciu Doplnky,
2. Vyberte doplnok pre Prihlásenie cez 3. strany,
3. Zvoľte prepojenie Facebook,
4. V poli Aktívne zakliknite checkbox a Uložte,
   Akonáhle nastavíte prepojenie ako Aktívne na eshope sa zobrazí tlačidlo pre prihlásenie / registrácia cez Facebook. To však znamená, že tlačidlo vidia aj bežní zákazníci. Týmto zákazníkom proces nebude fungovať, pretože nie sú pridaní do Developer prostredie Facebooku ako používatelia. Akonáhle testovanie skončíte, odporúčame pole Aktívne zase späť dkliknúť.
5. Prihlásenie a registráciu môžete teraz otestovať.
6. Akonáhle s testovaním skončíte, odporúčame pole Aktívne zatiaľ vypnúť.
7. Ďalej pokračujte na zverejnenie aplikácie.

5.2 Zverejnenie aplikácie pre bežných zákazníkov

1. V ľavom menu prejdite do sekcie Review,
2. Zvoľte App review (Kontrola aplikácie),
3. Kliknite na tlačidlo Next,
4. Facebook prekontroluje vytvorenú aplikáciu, a ukáže zoznam posledných bodov
   • Verification - Malo by byť označené ako kompletné
   • App settings - Malo by byť označené ako kompletný
   • Allowed Usage - Schvaľovací proces toho, ako budete nakladať s jednotlivými informáciami (Email a Verejný profil užívateľa)
     • Postupne kliknite na obe tlačidlá Get stardet a potvrďte ich odsúhlasenie.
     • Akonáhle budete mať odsúhlasené, kliknite dole na stránke na tlačidlo Next.
   • Data handling - Vyplňte informácie o tom, či máte nejakého spracovateľa / poskytovateľa služieb, ktorý bude mať prístup k dátam užívateľov a ďalšie náležitosti.
     • Akonáhle budete mať vyplnené, kliknite dole na stránke na tlačidlo Next.
   • Reviewer instructions - Pokyny pre Facebook kontrolórov, ktorí budú prihlásení u vás kontrolovať.
     • Napríklad uveďte niečo ako:
       Keď ste prišli na e-shop, e-shop je v CZ language. Na vrchole hlavy, kliknite na užívateľský profil icon and select "Prihlásiť". In modal is a button "Prihlásiť sa cez Facebook" po kliknutí na používateľa sa redirected do environmentu Facebook, agree to do informacie prevedené z ich facebook profilu a returned do e-shop ako logged-in user.
     • Ostatné voliteľné polia môžete ponechať prázdne
     • Akonáhle budete mať vyplnené, kliknite dole na stránke na tlačidlo Next.

• • Formulár vás následne vráti späť na zoznam a mali by ste vidieť všetko označené ako hotové.
  • Dole na stránke kliknite na tlačidlo Submit for review.
    • Začiarknite súhlas a kliknite na tlačidlo Submit.
  • Formulár sa odošle na schválenie av sekcii Status uvidíte Review in progress. Vyčkajte na dokončenie kontroly zo strany Facebooku.
    
    (na screene je výsledok kontroly Facebooku - schválená aplikácia)

2. V administrácii Facebook Developera,
3. Prekontrolujte, alebo vyberte správnu aplikáciu, ktorú budete chcieť zvereňovať,
4. V detaile aplikácie Prejdite do sekcie Zverejniť,
5. Skontrolujte, že v sekcii Business verification je vaša spoločnosť overená,
6. Pokiaľ bude všetko v poriadku, dole na stránke kliknite na tlačidlo Publish,

Chyby v aplikácii

• Facebook pre založenie účtu nevyžaduje Email. Účet je možné založiť bez emailu iba na telefónne číslo. Takého používateľa v Upgates však nebude možné vytvoriť.
• Chyby v prostredí Facebooku:
  
  • Aplikácia nie je aktívna - "Aplikácia momentálne nie je dostupná. Jej autor o tom vie..."
    • Táto chybová hláška znamená, že nebol dokončený bod Testovanie aplikácie
  • Funkcia nie je dostupná - "Facebook prihlásenia je momentálne nedostupné pre túto aplikáciu, pretože v nej aktualizujeme dodatočné podrobnosti"
    • Táto chybová hláška znamená, že Facebook zatiaľ nedokončil kontrolu vašej aplikácie. (viz zverejnenie aplikácie)
• Chyby na eshope:
  • Overenie používateľa zlyhalo. Služba 3. strany je nedostupná, alebo vrátila nesprávne dáta. Skúste to prosím neskôr.
    • Všeobecné chybové hlásenie, ktoré zastrešuje množstvo variácií chýb, ktoré môžu vzniknúť v Facebooku. Možné príčiny:
      Užívateľ zrušil v Facebooku zdieľanie dát, Detský profil, Facebook vrátil nevalidné dáta atď.
  • Prihlásenie nebolo možné dokončiť, pretože používal s takýmto emailom neexistuje.
    • V nastavení Upgates pravdepodobne máte nastavené, že registrovať do e-shopu sa môžu iba firmy. Tým pádom môžu nastávať tieto prípady:
      • Zákazník má v eshope už registrovaný účet, ale prihlásenie prebieha z aplikácie 3. strany, ktorá je registrovaná pod iným emailom.
      • Zákazník nemá v eshope registrovaný účet, a tým pádom nie je možné prihlásenie vykonať.

Tlačidlá na e-shope

Tlačidlá na eshope sa zobrazujú vďaka Prekladom.

• Facebook_login_button - Prihlásiť sa cez Facebook
• Facebook_registration_button - Registrovať sa cez Facebook

Zakázanie registrácií

Registrácia cez služby 3. strán sú istým spôsobom nekompletné registrácie. Bežný zákazník vyplňujúci registračný formulár na eshope vypĺňa rôzne povinné polia (napr. Meno, Adresu, Telefón, Zem, atď...). Tieto informácie služby 3. strán o zákazníkovi nemajú, prípadne ich umožnia zákazníkovi nezdieľať, a preto aby aj napriek absencii týchto polí z 3. strán registrácie v poriadku prebehla je nutné takémuto procesu dovoliť obísť pravidlá povinných polí.

Na čo sa to používa

Zakázanie registrácií využijete napríklad v prípadoch, keď v systéme máte nastavené, že umožňujete registráciu iba firemným zákazníkom. Aby sme zaistili fungovanie aj pre takéto prípady, umožňuje doplnok v detaile každého prepojenia zakázať registráciu užívateľom cez služby 3. strán.

Čo všetko sa zakáže

Na eshope zmiznú tlačidlá pre registráciu cez služby 3. strán (Facebook, Google, atď.) a cez prihlasovacie tlačidlá bude umožnená iba registrácia.