#############################################
#         -----------------
#         CGI eXa-Kviz v6.0
#         -----------------
#
#         File: README.txt
#         Opis: Ovo je instalacioni i upustveni .txt file. Sluzi Vam da na pravilan nacin 
#               manipulisete CGI Scriptom i njenim neiscrpnim mogucnostima.
#        Autor: Salko Bijedic - Q_Line
#       E-Mail: admin@extragency.co.ba
#          WEB: http://www.extragency.co.ba/
#      Verzija: v6.0
#
# (c) 2001 - eXtragency
# (r) Q_Line NETWORK
# Ova scripta nije "freeware" i za slobodnu upotrebu! Molim da procitate 
# obavezno ovaj "README" file za sva upustva oko registracije ili koristenja. 
#############################################


# eXtragency Vam nudi zanimljiv CGI Script koji Vam omogucuje da na interaktivan nacin
  stupite u testanje znanja Usera koji posjete Vasu WEB stranicu. Dakle, otvarate im
  mogucnost, kao i Vama samima, da praveci ovaj Kviz promovirate i "ovu stranu" CGI
  interaktivnosti. Za razliku od dosadasnjih CGI Scripti vecinu podesavanja ove scripte
  necete raditi u .cgi fileu nego ce to biti vas kviz.html file sa formularom za pitanja
  (ako ga vec tako i nazovete) i .odg file unutar koga se nalaze tacni odgovori sa
  objasnjenjem istih. Dakle, dobro dosli u:



			CGI eXa-Kviz v6.0



# Kako radi ovaj Kviz? Za potreban rad ove CGI aplikacije morate imati:

  - Server koji podrzava CGI aplikacije,
  - "CHMOD via FTP", tj. mogucnost da svakom "izvrsnom" fileu tipa .cgi na Vasem
    serveru mozete putem Vaseg FTP-a dodjeliti odredjenu "premisiju" (bos. - dozvolu)
    za njegovo "izvrsavanje".


# Sta sve trebate podesiti za ispravan rad ove aplikacije! Kao prvo podesite i otvorite,
  iz instalacionoig .zip filea ove Scripte, file eXa_kviz.cgi . Unutar ovog filea
  podesite varijable koje se traze od Vas. One su tamo eksplicitno i tacno navedene sta,
  kako i gdje da upisete podatke koje se traze od Vas (samo 2 podatka trebate podesiti).
  Vecinu podesavanja cete raditi u Demo.html fileu ove CGI Scripte. Kao prvo ako Vam se
  ne svidja naziv tog .html filea, slobodno ga promjenite u npr. kviz.html file. Obrisite
  upustva na toj stranici i objasnjenja koja Vam kasnije nece trebati kad taj .html file
  budete prezentirali na Vasoj WEB stranici (obrisite dio na vrhu i dnu stranice koji
  nije na sivoj pozadini tog .html filea, jer taj tekst zapravo predstavlja "interna"
  upustva o radu Scripta i mjestu gdje je mozete naci "online" i u punoj upotrebi).

# Dakle, unutar tog .html filea mozete pronaci i podesiti slijedece:
  1) Kao prvo moracete otvoriti taj .html file tako da mu mozete vidjeti HTML kod. Iza
  <form varijable u HTML kodu mozete naci slijedece:


 	<form action="http://www.vas-server.com/cgi-bin/eXa_kviz.cgi" method="POST">


  , sto naravno trebate podesiti u skladu sa URL adresom eXa_kviz.cgi filea na Vasem
  WEB serveru.

  2) Slijedeca Varijabla koju je moguce podesiti u HTML kodu, jeste:


	name="eXa-Kviz"


  , koja zapravo kazuje naziv Kviza. Morate paziti da ako u HTML kodu promjenite naziv
  Kviza, to cete isto morati pronaci i uraditi u eXa_kviz.cgi fileu zbog toga da ta .cgi
  Scripta zna sa kojim Kvizom ce da radi.

  3) Odmah iza gornje varijable u HTML kodu mozete naci i  podesiti:


	value="eXa1"


  , sto je zapravo naziv .odg filea (filea sa tacnim odgovorima i objasnjenjima istih).
  Dakle ako ovdje stavite npr. eXa1 , Vas file sa tacnim odgovorima i objasnjenjima se
  mora zvati eXa1.odg .

  4) Posljednja varijabla u HTML kodu koju trebate podesiti je:


	name="BrojPitanja" value="15">


  , a ona je zapravo ta koja govori koliko cete ukupno imati pitanja u Vasem kvizu.
  Ovdje mozete mjenjati SAMO broj, ostalo ostavite kako jeste da ne biste imali problema
  sa .cgi fileom.


# Slijedeca podesavanja su zapravo upisi pitanja u taj .html file. Obicnim tekstom bas
  kao sto je to u Demo.html fileu i uradjeno navedite broj pitanja kao i pitanje. Ispod
  pitanja ponudite odgovora koliko zelite pomocu "radio buttona". Kad budete pisali moguce
  odgovore na neko od pitanja morate paziti na slijedece. Kao primjer navodimo pitanje br
  1:

	1. Poznato kupaliste na Neretvi je:
           0 Posmaz   0 Bunur   0 Murve   0 Ganar

  , unutar HTML koda "radio buttona" za ovo pitanje br.1 morate podesiti slijedece
   podatke:


	name="1" value="Posmaz"
	name="1" value="Bunur"
	name="1" value="Murve"
	name="1" value="Ganar"


  , gdje name="1" govori da je to pitanje br.1, a value="Posmaz" govori da je to moguci
  odgovor unutar tog pitanja br.1 . Ovako isto navodite za onoliko pitanja koliko ih
  imate unutar kviza mjenjajuci unutar name="1" broj 1 u broj pitanja ( npr. name="12" )
  za koji definisete moguce odgovore.

# Slijedeca podesavanja su ona nad Vasim .odg fileom. To je ovdje eXa1.odg file sa
  tacnim odgovorima i objasnjenjima istih. Kad otvorite taj file vidjecete sistem upisa
  tacnog odgovora i objasnjenja odgovora. On izgleda na slijedeci nacin:


	Broj pitanja|Tacan odgovor|Kratko pojasnjenje tacnog odgovora


  sto bi za pitanje br.1 iz Demo.html filea izgledalo kao:


	1|Bunur|Poznato kupaliste na Neretvi je Bunur.


  , dakle, ovdje je za pitanje br.1 tacan odgovor Bunur, a iza | je dato i objasnjenje
  tog odgovora, itd. za onoliko pitanja koliko ih definisete.

# Ovo bi bila sva objasnjenja kako da podesite ovaj CGI Script da radi na ispravan nacin.
  Za pravilan rad Kviz scripte morate .cgi i .odg fileove postaviti u isti direktoij
  gdje se mogu izvrsavati Vase CGI Scripte. Koji je to direktorij, zavisi od Vas kako
  ga upisete u eXa_kviz.cgi fileu u opciji:


	$basedir = "/home/vas/path/cgi-bin/eXa-kviz"


# I na kraju, jos samo trebate izvrsiti CHMOD naredbe nad slijedecim fileovima na Vasem
  WEB Serveru:

  - eXa_kviz.cgi  -  CHMOD 755
  - eXa1.odg  -  CHMOD 760

# Instalacioni exa_kviz6_0.zip sadrzi slijedece potrebne fileove:

  - Demo.html (kratki demo file)
  - eXa_kviz.cgi (glavni CGI file)
  - eXa1.odg (primjer .odg filea sa tacnim odgovrima Kviza)
  - README.txt (ovaj file)

# Demo primjer CGI eXa-Kviz v6.0 Scripta mozete naci takodje i na nasim stranicama na
  adresi: http://www.normala-brato.net unutar linka "Kviz" gdje mozete pogledati ovu
  CGI Scriptu u punoj akciji.

# Za probleme oko ovog CGI Scripta i upustva za postavku kviza, pitanja i definisanju
  .odg filea mozete nam pisati na neku od nasih E-Mail adresa:



		scripte@extragency.co.ba
		scripte@extragency.com



#############################################

Agencija "eXtragency"
WEB Publishing & AutoCAD Design
Mostar, Bosna i Hercegovina
http://www.extragency.co.ba
extragency@extragency.co.ba
ICQ UIN: 13935497 - Q_Line
