Instrukcja instalacji modułu płatności Transferuj.pl
Transkrypt
Instrukcja instalacji modułu płatności Transferuj.pl
INSTRUKCJA INSTALACJI MODUŁU PŁATNOŚCI TRANSFERUJ.PL w QuickCart Wersja: 3.0 Październik 2011 Transferuj.pl jest własnością Krajowego Integratora Płatności SA • ul. Św. Marcin 73/6 • 61-808 Poznań • [email protected] NIP 777-306-15-79 • KRS 0000412357 • REGON 300878437 Instrukcja instalacji modułu płatności Transferuj.pl • w QuickCart • Wersja 3.0 1. WYMAGANIA Aby korzystać z modułu płatności Transferuj.pl dla skryptu QuickCart niezbędne jest, by środowisko posiadało następujące elementy: 1. System QuickCart 3.6 lub 4.1(http://opensolution.org/) 2. Pliki instalacyjne modułu płatności Transferuj.pl dostępne są tutaj: http://transferuj.pl/integracja-w-sklepach.html Uwaga: należy pobrać moduł odpowieni dla swojej wersji QuickCart! Moduł był testowany na wersji polskiej Quick.Cart 3.6 oraz 4.1. Sprawdź czy masz ustawiony język polski w: Konfiguracja / Opcje / Domyślny Język 2. INSTALACJA MODUŁU 1. Rozpakuj zawartość archiwum quickcart.zip na dysk. Po rozpakowaniu powinien powstać folder „tr_quickcart”, w którym znajduje się plik trvalidation.php. 2. Wyślij katalog plik trvalidation.php do głównego katalogu Quick.Cart na Twoim serwerze. 2 • Strona Transferuj.pl • KIP SA Instrukcja instalacji modułu płatności Transferuj.pl • w QuickCart • Wersja 3.0 3. Zaloguj się do panelu administracyjnego Quick.Cart, przejdź do zakładki Strony / Nowa Strona. Następnie utwórz dwie strony. Pierwsza ma zwierać podziękowania za złożenie zamówienia, druga - komunikat o błędzie po wykonaniu transakcji z wynikiem błędnym. Adresy url tych stron będą potrzebne w modyfikacji pliku konfiguracyjnego Quick.Cart. 4. Z katalogu głównego Quick.Cart pobierz pliki: - general.php z podkatalogu config - orders_print.tpl z podkatalogu templates 5. W pliku general.php znajdź parametr - $config['embed_php'] następnie przypisz mu wartość true: /* * If You want embed PHP code in template files * set this variable true but it is not recommended and * script will be slower */ $config['embed_php'] = true; 6. W pliku general.php znajdź linijki: 3 • Strona Transferuj.pl • KIP SA Instrukcja instalacji modułu płatności Transferuj.pl • w QuickCart • Wersja 3.0 //error_reporting( E_ALL ^ E_DEPRECATED ); unset( $config, $aMenuTypes, $aPhotoTypes, $lang, $aUser ); następnie zaraz po nich wklej następujący kod (dostępny również w pliku kod_general_php.txt w archiwum zip z modułem) : /* * Transferuj.pl */ $config['ids']="0000"; //id sprzedawcy $config['kodp']="twojkod"; //kod potwierdzajacy $config['tekstp']="Powrót do sklepu"; //tekst przycisku powrotu $config['tekstp'] = iconv('windows-1250', 'UTF-8', $config['tekstp']); $config['error_url']="http://domena.pl/blad"; //adres powrotny po wykonaniu transakcji z wynikiem blednym $config['back_url']="http://domena.pl/dziekujemy"; // adres strony z podziekowaniami. $config['notify_url']="http://domena.pl/trvalidation.php"; //uzupelnij swoja domene w celu lokalizacji pliku trvalidation.php Pamiętaj, aby uzupełnić Twoje ID sprzedawcy w polu $config['ids'] Twoj kod potwierdzajacy, adresy stron zwrotnych podanych pkt w 3. oraz inne parametry jak wskazano w komentarzach. Zapisz plik general.php i nadpisz go na serwerze 7. Zaloguj się do panelu administracyjnego Quick.Cart, przejdź do zakładki Zamówienia / Nowa Płatność, w polu Nazwa wpisz - 4 • Strona Transferuj.pl • KIP SA Instrukcja instalacji modułu płatności Transferuj.pl • w QuickCart • Wersja 3.0 Transferuj.pl oraz w polu Cena - 0 . Ustaw ceny po prawej, jakie mają być doliczone za wysyłkę podczas płatności przez Transferuj.pl i wybór danej metody dostawy towaru. Jest to konieczne, bez tego nie będzie można wybrać danej metody płatności - w tym wypadku Transferuj.pl. Po wpisaniu cen, kliknij "zapisz". 8. Teraz otwórz plik orders_print.tpl pobrany w pkt 4. i za linią 4 <h3>$lang[Order_sent]</h3> wklej poniższy kod (dostępny również w pliku kod_orders_print_tpl.txt w archiwum .zip z modułem): <form action="https://secure.transferuj.pl" method="post" id="transferujForm" name="transferujForm"> <?php if (strtolower($aOrder[sPaymentName])=='transferuj.pl'){ echo '<input type="submit" value="Zaplać z Transferuj.pl" />'; } echo('<input type="hidden" name="id" value="'.$config[ids].'"/>'); ?> <input type="hidden" name="kwota" value="$aData[sSummary]" /> <?php $tekst = 'Zamówienie nr: '.$aOrder[iOrder]; $tekst = iconv('windows-1250', 'UTF-8', $tekst); echo('<input type="hidden" name="opis" value="'.$tekst.'" />'); ?> <input type="hidden" name="email" value="$aOrder[sEmail]" /> <input type="hidden" name="nazwisko" value="$aOrder[sLastName]" /> <input type="hidden" name="imie" value="$aOrder[sFirstName]" /> <input type="hidden" name="adres" value="$aOrder[sStreet]" /> <input type="hidden" name="miasto" value="$aOrder[sCity]" /> <input type="hidden" name="kraj" value="Polska" /> <input type="hidden" name="kod" value="$aOrder[sZipCode]" /> <?php $crc=base64_encode($aOrder[iOrder]); echo '<input type="hidden" name="crc" value="'.$crc.'" />'; ?> 5 • Strona Transferuj.pl • KIP SA Instrukcja instalacji modułu płatności Transferuj.pl • w QuickCart • Wersja 3.0 <input type="hidden" <input type="hidden" <input type="hidden" <input type="hidden" <input type="hidden" </form> name="telefon" value="$aOrder[sPhone]" /> name="pow_tekst" value="$config[tekstp]" /> name="pow_url" value="$config[back_url]" /> name="wyn_url" value="$config[notify_url]" /> name="pow_url_blad" value="$config[error_url]"> Zapisz plik i wyślij go na serwer nadpisując stary. 9. Od teraz Twoi klienci będą mogli dokonywać szybkich płatności online przez system Transferuj.pl. 3. KONTAKT W razie potrzeby odpowiedzi na pytania lub szczegółowe wyjaśnienie kwestii technicznych prosimy o kontakt poprzez formularz znajdujący się w Panelu sprzedawcy lub na adres e-mail: [email protected] 4. HISTORIA ZMIAN Wersja 1.0 (Luty 2010): Pierwsze wydanie modułu. Wersja 2.0 (Wrzesień 2010) Moduł dostosowany do wersji polskiej QuickCart 3.6. Wersja 3.0 (Październik 2011) Moduł dostosowany do wersji polskiej QuickCart 4.1. 6 • Strona Transferuj.pl • KIP SA