MojeID pro Magento

Tento dokument představuje uživatelskou dokumentaci modulu MojeID. Naleznete zde popis funkcí, návod na instalaci a použití modulu.

Licence modulu

Modul je poskytován s licencí  OSL v 3.0.

Stažení modulu

  • Vyberte si verzi modulu, která je kompatibilní s verzí Magenta, kterou používáte:
Magento verze Verze modulu Datum vydání modulu
1.4.x CE* 3.1.1.0 13. 2. 2011

* Community edition

Dokumentace modulu

Podpora modulu je realizována prostřednictvím fóra na Magento.CZ:

1. Funkce modulu

Modul přidává do Magento přihlašovací metodu  MojeID pro zákazníky ve front-endu. Implementován protokol OpenID 2.0.

Vyzkoušet můžete v demo e-shopu zde:

2. Stažení a instalace modulu

1. krok - instalace balíčku

  • Stažení, instalace a aktualizace modulu je popsána zde.

2. krok - formulář pro přihlášení

Po instalaci modulu je třeba přidat přihlašovací formulář MojeID na frontend. V základní instalaci Magento se to provede takto:

Přidat řádek:

<block type="mojeid/form_login" name="mojeid_form_login" template="mojeid/login.phtml"/>

do souboru app/design/frontend/base/default/layout/customer.xml na řádek cca 96, hned pod řádek, který obsahuje:

<block type="customer/form_login" name="customer_form_login" template="customer/form/login.phtml"/>

Formulář pro přihlášení přes MojeID se pak zobrazí pod standardním formulářem pro přihlášení do Magenta.

Pokud používáte vlastní design, pak nezapomeňte řádek vložit do správného customer.xml.

3. krok - nastavení XRDS dokumentu

Soubor xrds.xml nahrajte do adresáře na serveru, kde máte Magento nainstalované. Například do /home/www/domain.tld/xrds.xml. Tento dokument pak musí být dostupný přes prohlížeč, například na URL:

Dále je třeba tento soubor upravit tak, aby parametr <URI> obsahoval URL cestu k MojeID modulu ve vašem e-shopu, například:

<URI>http://www.domain.tld/mojeid/index/finish/</URI>

Do souboru app/design/frontend/base/default/template/page/html/head.phtml pak přidejte řádek, který obsahuje cestu k xrds.xml souboru ve vašem e-shopu:

<meta http-equiv="x-xrds-location" content="http://www.domain.tld/xrds.xml"/>

Vložte jej hned za řádek:

<meta name="robots" content="<?php echo htmlspecialchars($this->getRobots()) ?>"/>

Pokud používáte vlastní design, pak nezapomeňte řádek vložit do správného head.phtml.

3. Nastavení a použití modulu

Nastavení v back-endu

Modul se nastavuje v backendu v záložce System -> Configuration -> Customers -> MojeID.

Obrázek 1: Nastavení MojeID v backendu

Atributy Email, Jméno a Přijmení jsou povinné a uživatel s jejich poskytnutím musí na straně MojeID souhlasit, jinak se autentizace neprovede. Na straně MojeID označeny *.

Atributy Fakturační a Dodocí adresa jsou pak volitelné a pro každou lze nastavit jeden ze tří statusů:

  • Vyžadováno - uživatel musí s předáním atributu na straně MojeID souhlasit, jinak se autentizace neprovede; na straně MojeID označeny *
  • Zakázáno - atribut se na straně MojeID vůbec nezobrazí
  • Volitelné - uživatel může s předáním atributu na starně MojeID souhlasit

V defaultním nastavení je Platební adresa vyžadována a dodací adresa zakázána.

V backendu ve správě zákazníků v záložce Customers -> Manage Customers pak přibyl jeden sloupeček MojeID, který může mít hodnutu Yes/No? podle toho, zda se uživatel přihlásil přes MojeID. Při každém dalším přihlášení přes MojeID je tento sloupeček aktualizován.

SSL certifikát

Pokud se po návratu z MojeID do e-shopu setkáte s následující hláškou o nezašifrovaném spojení, pak toto není chyba modulu, ale je to záležitost nastavení vašeho serveru, respektive domény, kde e-shop provozujete. Pro její odstranění je třeba nainstalovat SSL cerifikát a nastavit HTTPS protokol (nastavit secure base url v backendu).

Obrázek 2: Nezašifrované spojení

4. Release notes

Verze 3.1.1.0 - 13. 2. 2011

  • první stabilní verze

Attachments