Aby wyświetlić ankietę na stronie, należy odwołać się do skryptu CashBill wyświetlającego wyniki ankiety, podając prefix ankiety.
Istnieją dwa sposoby uzyskania wyników ankiety:
- serializowana tablica wyników,
- gotowy HTML z wynikami.
W przypadku, gdy chcemy we własnym zakresie przetworzyć tablicę wyników w swoim skrypcie, należy odwolać się do pliku:
http://sms.cashbill.pl/ankieta_show.php?id=prefix&dest=7xxxx&serialize=y
Przykład:
<?
$id_service = urlencode('prefix');
$zm = file('http://sms.cashbill.pl/ankieta_show.php?id='.$id_service.'&dest=7xxxx&serialize=y');
$wyniki = unserialize(implode($zm));
?>
Otrzymamy serializowaną tablicę w postaci:
array(
[końcówka SMS'a (a, b, c...)] => array ('Odpowiedź w ankiecie' , 'ilość glosów na odpowiedź' ),
);
W przypadku, gdy chcemy od razu uzyskać gotowego HTML'a z wynikami ankiety, można zastosować odwołanie do skryptu wyświetlającego wyniki w znaczniku <iframe>
na swojej stronie.
Przykładowe odwołanie:
<iframe src="http://sms.cashbill.pl/ankieta_show.php?id=prefix&dest=7xxxx" height="400px" width="400px"></iframe>
Jest to najprostsze wyświetlenie ankiety, modyfikując odpowiednie parametry przesyłane metodą GET, możemy dostosować ankietę do własnej strony.
Parametry do modyfikacji sposobu wyświetlania ankiety to:
-
sg - sposób wyświetlania głosów w ankiecie. Dostępne wartości to:
-
sg - sposób wyświetlania głosów w ankiecie. Dostępne wartości to:
- - domyślnie wyświetlana jest liczba głosów
- - p - ilość odpowiedzi wyświetlana w postaci procentowej
- - pg - wyświatlany jest procentowy podział na głosy i w nawiasie liczba głosów
- - gp - wyświetlana jest liczba głosów i w nawiasie procentowy podział na głosy
-
sd - Czy pod paskiem ilości głosów na być wyświetlana dla każdej odpowiedzi treść SMS'a. Dostępne wartości to:
- - domyślnie nie jest wyświetlana
- - y - pod każda odpowiedzią w ankiecie wyświetlana jest treść SMS'a, którą należy wysłać, aby zagłosować w ankiecie.
-
s - za pomocą tego parametru wskazujemy adres pliku ze stylami (w postaci http://domena/plik.css).
-
r - jeżeli ten parametr jest ustawiony i jest liczbą, ankieta w <iframe> jest odświeżana co r sekund.
Nazwy klas styli w pliku wyświetlającym wyniki ankiety (mozliwość modyfikacji przez zewnętrzny plik css):
<body>
<div class="pytanie">Pytanie</div>
<div class="odpowiedz" style="float: left;">a ) Odpowiedz 1</div>
<div class="glosow" style="text-align: right">1 głosów (3 %)</div>
<div class="pasek" style="width: 3%; clear: both;"> </div>
<div class="showdetail">SMS o treści: <span class="trescsmsup">am qweqwe a</span></div>
<div class="help">Aby wziąć udział w ankiecie, wyślij SMS o treści:
<span class="trescsms">am qweqwe a, b, c...</span><br>
pod numer <span class="numersms">7xxx.</span><br>
<span class="kosztsms">Koszt SMS'a to: x PLN z VAT</span>
</div>
<div class="cashbill">Ankietę obsługuje system <a href="http://cashbill.pl/" target="_blank">CashBill</a></div>
</body>