Opineo - Zaufane opinie.

Kod: Odnośnik widoczny tylko dla zalogowanych użytkowników - Zarejestruj się

Automat do zgłaszania adresów email można napisać samemu wykorzystując skrypt pod adresem:
         http://www.opineo.pl/gate.php
      

Wywołanie będzie miało takie same skutki, jak ręczne wpisanie adresu Klienta przy użyciu formularza dostępnego na tej stronie. Skrypt przyjmuje następujące parametry:
type - zawsze wartość customer (wymagany)
email - zgłaszany adres Klienta (wymagany)
login - login do panelu sklepu na stronie Opineo (wymagany)
pass - hasło do panelu sklepu na stronie Opineo (wymagany)
firm - nazwa producenta zakupionego produktu (jeśli dostępna)
product - nazwa zakupionego produktu

Podanie argumentów firm oraz product spowoduje automatyczne wypełnienie pól Temat recenzji, Producent oraz model formularza oceny sklepu i produktu podaną zawartością.

Dodatkowo możliwe jest podanie parametru opcjonalnego queue określającego liczbę dni po ilu należy wysłać zaproszenie. Dopuszczalne wartości to: 1, 5, 10 lub 20 (np. queue=5). W przypadku braku parametru przyjmuje się 5 dni.

Przykładowe wywołanie:
http://www.opineo.pl/gate.php?type=customer&email=example@example.com
   &login=sklep&pass=sklep&queue=1&firm=Nikon&product=D90
      

Jeśli autoryzacja przebiegnie poprawnie oraz dostęp do usługi nie jest zablokowany wywołanie zwróci komunikat w formacie JSON, w postaci:
         {
            "code":      <kod błędu>,
            "message":   <komunikat o błędzie>
         }
      

W celu poprawnego odczytania zwracanego wyniku należy skorzystać z funkcji json_decode() w PHP, lub jej analogu w wykorzystywanym języku programowania/skryptowym.

Powodzenie sygnalizowane jest kodem 0. Pozostałe możliwe rezultaty to:
1 - adres już oczekuje w kolejce na wysyłkę maila
2 - adres email nie jest poprawny
3 - zaproszenie zostało już wysłane na ten adres

Podanie nieprawidłowych danych do logowania skutkuje odpowiedzią HTTP 404 Not Found serwera. Analogicznie, próba wysłania emaila przez sklep, któemu funkcja wysyłania zaproszeń nie została udostępniona zwróci odpowiedź 403 Forbidden.

Możliwe jest także skorzystanie z przygotowanego przez nasz zespół skryptu PHP, który dokona zgłoszenia automatycznie. Skorzystanie ze skryptu wymaga włączenia do kodu aplikacji sklepu pobranego pliku, oraz wywołaniu funkcji opineo_zapisz_zaproszenie() zgodnie z instrukcją zamieszczoną w pliku źródłowym. Do prawidłowego działania wymagana jest wersja PHP co najmniej 5.2.0


Kod: Odnośnik widoczny tylko dla zalogowanych użytkowników - Zarejestruj się

<script type="text/javascript" src="http://www.opineo.pl/gate.php?type=customer&email={email_klienta}
   &login=xxx&pass=xxx&queue=5&order_no={numer_zamowienia}"></script>

Kod: Odnośnik widoczny tylko dla zalogowanych użytkowników - Zarejestruj się

<script type="text/javascript" src="./skrypt.php?email={email_klienta}&order_no={numer_zamowienia}"></script>

Kod: Odnośnik widoczny tylko dla zalogowanych użytkowników - Zarejestruj się

http://www.opineo.pl/gate.php?type=customer&email={email_klienta}
   &login=xxx&pass=xxx&queue=5&order_no={numer_zamowienia}

Kod: Odnośnik widoczny tylko dla zalogowanych użytkowników - Zarejestruj się

<script type="text/javascript"><!--
ceneo_client_email ='{email_klienta}';
ceneo_order_id = '{numer_zamowienia}';
//-->
</script>
<script type="text/javascript" src="https://ssl.ceneo.pl/transactions/track/v2/script.js?accountGuid=tu_wpisac_swoj_numer_ceneo"></script>

Zalecaną formą zgłaszania adresów e-mail do Wiarygodnych Opinii jest instalacja niżej wygenerowanego skryptu na stronie sklepu. Poprzednie rozwiązanie nadal będzie funkcjonować, nie będzie jednak dalej rozwijane i wskazana jest jak najszybsza migracja na obecne rozwiązanie.

<script type='text/javascript' src='https://www.opineo.pl/shop/wo.js?uid={u_id}'></script>

Skrypt potrzebuje następujących argumentów w żądaniu, aby prawidłowo zgłosić e-mail do wysyłki:

Podstawowe informacje:

opi_email - zgłaszany adres klienta
opi_order_no - podanie parametru opi_order_no spowoduje przypisane numeru zamówienia do wystawionej opinii. Pozwoli to uprościć ewentualną reklamację recenzji. Ponadto numer zamówienia ukazany będzie w raporcie szczegółowym dostępnym w sekcji Statystyki Wiarygodnych Opinii. (opcjonalnie)
opi_queue - określa liczbę dni po ilu należy wysłać zaproszenie. Dopuszczalne wartości to: 1, 5, 10 lub 20. W przypadku braku parametru przyjmuje się 5 dni. (opcjonalnie)
Informacje o produktach są przekazywane w tablicy, w której kazdy rekord jest tablicą o następującej strukturze:

opi_product_firm - marka zakupionego produktu
opi_product_name - model zakupionego produktu
opi_product_id - sklepowy identyfikator produktu
opi_skapiec_id - (opcjonalnie) - sklepy, które są zintegrowane ze skąpcem w celu zwiększenia trafności identyfikacji produktu mogą podawać identyfikator produktu przesyłany do serwisu skąpiec.pl. W przypadku takiej opcji identyfikator produktu należy podać standardowo w polu product_id i dodatkowo ustawić wartość zmiennej opi_skapiec_id na '1'. W przeciwnym wypadku wartość należy ustawić na '0'.
WAŻNE – Do ankiety można podpiąć maksymalnie 4 produkty!

Wszystkie parametry do skryptu zapisujemy w następujący sposób:

nazwa_parametru = 'wartosc';

Argumenty definiujemy przed wygenerowanym skryptem.
Przykładowe prawidłowe wywołanie wygląda następująco:
<script type='text/javascript'>
opi_email = 'klient@poczta.pl';
opi_order_no = '123456789';
</script>
<script type='text/javascript' src='https://www.opineo.pl/shop/wo.js?uid={u_id}'></script>


Przykład z dodanymi informacjami o produktach:

<script type='text/javascript'>
opi_email = 'klient@poczta.pl';
opi_order_no = '123456789';

opi_products = new Array();
opi_products[0] =
new Array('opi_product_firm','opi_product_model','opi_product_id','opi_skapiec_id');
opi_products[1] = new Array('Marka','Model','Identyfikator','0');

</script>
<script type='text/javascript' src='https://www.opineo.pl/shop/wo.js?uid={ui_id}'></script>

Skrypt należy umieścić na na stronie ostatniego kroku potwierdzającego złożenie zamówienia, pomiędzy tagiem <body> i </body> strony.

Ważne! - skrypt musi być wywoływany z poziomu domeny zapisanej jako strona www sklepu w panelu Opineo.

Jeśli autoryzacja przebiegnie poprawnie oraz dostęp do usługi nie jest zablokowany wywołanie zwróci komunikat w formacie JSON, w postaci:

{
"code": <kod błędu>,
"message": <komunikat o błędzie>
}

Powodzenie sygnalizowane jest kodem 0. Pozostałe możliwe rezultaty to:

1 - adres już oczekuje w kolejce na wysyłkę maila
2 - adres email nie jest poprawny
3 - zaproszenie zostało już wysłane na ten adres
Podanie nieprawidłowych danych do autoryzacji skutkuje odpowiedzią HTTP 404 Not Found serwera. Analogicznie, próba wysłania emaila przez sklep, któemu funkcja wysyłania zaproszeń nie została udostępniona zwróci odpowiedź 403 Forbidden.

Możliwe jest także skorzystanie z przygotowanego przez nasz zespół skryptu PHP, który dokona zgłoszenia automatycznie. Skorzystanie ze skryptu wymaga włączenia do kodu aplikacji sklepu pobranego pliku, oraz wywołaniu funkcji opineo_zapisz_zaproszenie() zgodnie z instrukcją zamieszczoną w pliku źródłowym. Do prawidłowego działania wymagana jest wersja PHP co najmniej 5.2.0 oraz zainstalowane rozszerzenie php_curl

Odnośnik widoczny tylko dla zalogowanych użytkowników - Zarejestruj się

W chwili obecnej nie są dostępne skrypty w innych językach. Automatycznego zgłoszenia Klienta można w takiej sytuacji dokonać wykorzystując adres bramy, podany powyżej.

Korzystając z Wiarygodnych Opinii powinieneś zamieścić w swoim regulaminie punkt:

Klient dokonujący zakupu w sklepie wyraża zgodę na przekazanie swojego adresu e-mail do Opineo Sp. z o.o. z siedzibą we Wrocławiu ul. Zelwerowicza 20; 53-676 Wrocław w celu wypełnienia ankiety wraz z opinią o dokonanej transakcji w Sklepie. Zgodnie z obowiązującymi przepisami ustawy "O ochronie danych osobowych" z dnia 29.08.1997r.

Kod: Odnośnik widoczny tylko dla zalogowanych użytkowników - Zarejestruj się

<?php
/********************************************************************************
 * Wstawiam swój kod wyciągający dane z bazy do wysłania zaproszenia do pełnej  *
 * opini wraz z produktami                                                      *
 ********************************************************************************/
$adres_bazy = localhost;
$nazwa_bazy = xxx;
$baza_user = xxx;
$baza_haslo = xxx;

$polacz = mysql_connect($adres_bazy, $baza_user, $baza_haslo) or die(mysql_error());
$db = mysql_select_db($nazwa_bazy, $polacz) or die(mysql_error());

$adres = $_GET['meil'];
$login = xxxxxx;
$haslo = xxxxxx;
$result = @mysql_query( $query );
$czas = 5 ;
$order_no = $_GET['no_id'];
$query = "SELECT kqs_producenci.nazwa, kqs_produkty.nazwa, kqs_produkty.numer FROM (kqs_zamowienia_produkty LEFT JOIN kqs_produkty ON kqs_zamowienia_produkty.produkt_id = kqs_produkty.numer) LEFT JOIN kqs_producenci ON kqs_produkty.producent_id = kqs_producenci.numer
GROUP BY kqs_producenci.nazwa, kqs_produkty.nazwa, kqs_produkty.numer, kqs_zamowienia_produkty.zamowienie_id, kqs_produkty.cena
HAVING (((kqs_zamowienia_produkty.zamowienie_id)= $order_no))
ORDER BY kqs_produkty.cena DESC LIMIT 0,4";
$result = @mysql_query( $query );

$produkty = array();
if( $result ){
      while( $row = mysql_fetch_array( $result, MYSQL_NUM ) )
     {
         $produkty[] = array(opi_product_firm => $row[0], opi_product_name=> $row[1], opi_product_id=>$row[2], opi_skapiec_id => 0)
      }
}

/*Wywołuję funkcję wysyłającą dane do serwera opineo*/

 opineo_zapisz_zaproszenie($adres, $login, $haslo, $czas = 5, $order_no = false, $produkty = false)
 



/********************************************************************************
 * Copyright (c) 2012 Opineo.pl                                                 *
  ********************************************************************************/

/*
 * [!] Wymaga modułu php_curl
 */

if(!defined('OPINEO_ZAPROSZENIA')){
   define('OPINEO_ZAPROSZENIA', 'http://www.opineo.pl/');
   
   /**
    * Wywolanie funkcji powinno nastapic w w takim miejscu w kodzie,
    * w ktorym transakcja zostala zakonczona. Funkcja polaczy sie
    * z serwerem Opineo i automatycznie dokona zgloszenia adresu email
    * Klienta.
    *
    * Po 5 dniach zostanie do klienta wyslany email z zaproszeniem do
    * wystawienia opinii i jednorazowym linkiem prowadzacym do formularza
    * oceny sklepu.
    *
    * Do celow testowania mozna posluzyc sie stala OPINEO_DEBUG. Jej ustawienie
    * powoduje zwracanie zawsze tego samego kodu bledu -- ustawionego w OPINEO_DEBUG.
    *
    * @param string $adres email klienta, do ktorego nalezy wyslac zaproszenie
    * @param string $login identyfikator uzytkownika administrujacego sklepem na Opineo
    * @param string $haslo uzytkownika Opineo administrujacego danymi sklepu
    * @param int $czas liczba dni po ilu ma zostac wyslane zaproszenie. Dopuszczalne wartosci t: 1, 5 (domyslnie), 10.
    *
    * @param array $produkty tablica zawierające dane o produktach wg. nastepującego schematu:
    * opi_product_firm - marka zakupionego produktu
    * opi_product_name - model zakupionego produktu
    * opi_product_id - sklepowy identyfikator produktu
    * opi_skapiec_id - (opcjonalnie) - sklepy, które są zintegrowane ze skąpcem w celu zwiększenia
    * trafności identyfikacji produktu mogą podawać identyfikator produktu przesyłany do serwisu skąpiec.pl.
    * W przypadku takiej opcji identyfikator produktu należy podać standardowo
    * w polu product_id i dodatkowo ustawić wartość zmiennej opi_skapiec_id na '1'.
    *
    *  Przykład:
    *  $produkty = array(
    *     array(opi_product_firm,opi_product_name,opi_product_id,opi_skapiec_id),
    *     array(opi_product_firm,opi_product_name,opi_product_id,opi_skapiec_id)
    *  );
    *
    * @param string $order_no numer zamowienia
    *
    * @return array kod bledu, jesli wystapil (0 -- powodzenie) oraz stosowny komunikat;
    *    false, gdy nie mozna nawiazac polaczenia z serwerem.
    */
   
   function opineo_zapisz_zaproszenie($adres, $login, $haslo, $czas = 5, $order_no = false, $produkty = false){

      if (defined('OPINEO_DEBUG')){
         return json_decode("{\"code\":".OPINEO_DEBUG.",\"message\":\"...\"}", true);
      }
      if ($czas != 5 && $czas != 1 && $czas != 10){
         $czas = 5;
      }
      
      $query = Array(
         'type'   =>   'php',
         'email'   =>   $adres,
         'login'   =>   $login,
         'pass'   =>   $haslo,
         'queue'   =>   $czas,
      );
      if (!empty($order_no)) $query['order_no'] = $order_no;
      
      $query = http_build_query($query);
      $url = OPINEO_ZAPROSZENIA . "/gate.php?$query";
      
      $o = curl_init();
      curl_setopt($o, CURLOPT_URL, $url);
      curl_setopt($o, CURLOPT_RETURNTRANSFER, 1);
      
      if(is_array($produkty)){
         curl_setopt($o, CURLOPT_POST, 1);
         curl_setopt($o, CURLOPT_POSTFIELDS, 'products='.json_encode($produkty));
      }
      
      $json = curl_exec($o);
      $http_status = curl_getinfo($o, CURLINFO_HTTP_CODE);      
      curl_close($o);   

      if ($http_status !== 200)
         return $json;
         
      if ($json === false)
         return false;         
         
      $res = json_decode($json, true);
      return $res;
   }
}
mysql_close($sdb);
?>