Integracijski API — dokumentacija
Stavite croportal gumb na svoj site!
Integracija glasovanja na vaš site/blog
Integracijska ikonica za glasovanje na Croportalu služi autorima na webu kako bi potaknuli svoje čitatelje da dodaju, odnosno glasaju za njihove članke, te tako prošire kvalitetne sadržaje na što širu publiku.
Integracijski kôdovi trenutno podržavaju:
- Automatsko otkrivanje da li sadržaj već postoji na Croportalu, i ovisno o tome prezentacija različitih korisničkih sučelja (sučelje za glasovanje ili sučelje za dodavanje novog linka)
- Real-time prikaz trenutnog broja glasova
- Glasovanjem za dotični sadržaj ne odlazi se sa matične stranice
Sljedeći primjeri ilustriraju različite načine integracije.
Primjer: Jednostavan primjer za stranicu za koju želite omogućiti glasovanje na Croportalu.
Dovoljno je samo postaviti ovaj kôd na stranicu. Ništa više.
<script src="http://www.croportal.net/assets/js/croportal.js" type="text/javascript"></script>
Primjer: Kada URL koji želite prijaviti nije isti kao URL na kojem se posjetitelj trenutno nalazi.
Što ako želite koristiti specifičan URL ili imate session podatke ili korisnički osjetljive podatke u URL-u? Nema problema, samo promjenite kôd da izgleda ovako:
<script type="text/javascript">
croportal_url = 'URL_KOJI_ŽELITE_POSLATI';
</script>
<script src="http://www.croportal.net/assets/js/croportal.js" type="text/javascript"></script>
Zamjenite URL_KOJI_ŽELITE_POSLATI, sa URL-om koji želite koristiti. Ne morate brinuti o URL enkodiranju, naš integracijski kôd će to napraviti umjesto vas (barem bi trebao). Na primjer:
http://www.nekisajt.com/nekiurl/nekastranica.htmlOva metoda omogućuje postojanje više integracijskih komadića na istoj stranici vašeg site-a.
Primjer: Promjena dizajna i dodatne opcije
Što ako mi ne paše defaultni izgled sučelja? Što ako želim kompaktniju verziju? Što se sve može mijenjati?
<script type="text/javascript">
croportal_url = 'WEBSITE_URL';
croportal_skin = 'horizontal';
croportal_target = 'new';
</script>
<script src="http://www.croportal.net/assets/js/croportal.js" type="text/javascript"></script>
croportal_skin opcija kontrolira izgled widgeta. Ako nije specificirano, default je standardni croportal izgled. Ako je vrijednost varijable 'horizontal', onda će se prikazati manja, horizontalna verzija widgeta, koja u više slučajeva bolje paše na nekakvoj listi linkova i sl.
croportal_target opcija kontrolira da li se linkovi unutar widgeta otvaraju u novom ili u istom prozoru. Default je u novom prozoru, tako da je opcija potrebna samo ako ne želite da se linkovi otvaraju u novom prozoru, i dovoljno je upisati bilo što drugo osim 'new'.
Nove opcije i novi layouti widgeta biti će dopunjeni ovdje kako ćemo ih dodavati.
Primjer: Određivanje defaulta za automatsku prijavu linka na Croportal
Dakle, upravo ste pustili novi saržaj, i želite sugerirati vašim posjetiocima pod kojim naslovom, s kojim opisom, u koju kategoriju i sl. da dodaju link na Croportal. Nema frke, samo trebate postaviti sljedeće dodatne javascript varijable s kojima ćete odrediti pojedine vrijednosti (naravno, korisnici ih mogu samostalno mijenjati, ovo je samo sugestija):
<script type="text/javascript">
croportal_url = 'WEBSITE_URL';
croportal_title = 'NASLOV';
croportal_abstract = 'OPIS';
croportal_category = 'KATEGORIJA';
</script>
<script src="http://www.croportal.net/assets/js/croportal.js" type="text/javascript"></script>
Jednostavno zamjenite vrijednosti gornjih varijabli sa odgovarajućim sadržajem koji želite sugerirati korisnicima.
Kategoriju koja će automatski biti označena na formi za prijavu određujete pomoću croportal_category varijable. Postojeće kategorije su:
novostihrvatskasvijetiseljenistvocrna-kronikapolitika
gospodarstvotvrtke-i-trzistadioniceposlovna-karijera
sportnogometkosarkatenisautomoto-sportostali-sportovi
tehnologijainternethardversoftvertrendoviistrazivanjamobitelifoto-audio-videoracunalne-igrepodcast
lifestylemoda_i_ljepotazdravljeputovanjaObiteljlove-sex
showbizfilm-i-tvglazbakulturascenadogadjaji
automobili
zanimljivostivideofotografijeblogosferaostalo
Dokumentacija
Pripremili smo nekoliko alata koji će vam ubrzati korištenje Croportala.
WordPress plug-in
Postoji i WordPress plug-in za integraciju Croportal gumba za prijavu i glasanje, koji je nezavisno razvio Siniša Kolundžić.