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ń kontakt@transferuj.pl NIP 777-306-15-79 KRS 0000412357 REGON 300878437
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
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
//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 w pkt 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
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
<input type="hidden" name="telefon" value="$aorder[sphone]" /> <input type="hidden" name="pow_tekst" value="$config[tekstp]" /> <input type="hidden" name="pow_url" value="$config[back_url]" /> <input type="hidden" name="wyn_url" value="$config[notify_url]" /> <input type="hidden" name="pow_url_blad" value="$config[error_url]"> </form> 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: pt@transferuj.pl 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