12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394959697989910010110210310410510610710810911011111211311411511611711811912012112212312412512612712812913013113213313413513613713813914014114214314414514614714814915015115215315415515615715815916016116216316416516616716816917017117217317417517617717817918018118218318418518618718818919019119219319419519619719819920020120220320420520620720820921021121221321421521621721821922022122222322422522622722822923023123223323423523623723823924024124224324424524624724824925025125225325425525625725825926026126226326426526626726826927027127227327427527627727827928028128228328428528628728828929029129229329429529629729829930030130230330430530630730830931031131231331431531631731831932032132232332432532632732832933033133233333433533633733833934034134234334434534634734834935035135235335435535635735835936036136236336436536636736836937037137237337437537637737837938038138238338438538638738838939039139239339439539639739839940040140240340440540640740840941041141241341441541641741841942042142242342442542642742842943043143243343443543643743843944044144244344444544644744844945045145245345445545645745845946046146246346446546646746846947047147247347447547647747847948048148248348448548648748848949049149249349449549649749849950050150250350450550650750850951051151251351451551651751851952052152252352452552652752852953053153253353453553653753853954054154254354454554654754854955055155255355455555655755855956056156256356456556656756856957057157257357457557657757857958058158258358458558658758858959059159259359459559659759859960060160260360460560660760860961061161261361461561661761861962062162262362462562662762862963063163263363463563663763863964064164264364464564664764864965065165265365465565665765865966066166266366466566666766866967067167267367467567667767867968068168268368468568668768868969069169269369469569669769869970070170270370470570670770870971071171271371471571671771871972072172272372472572672772872973073173273373473573673773873974074174274374474574674774874975075175275375475575675775875976076176276376476576676776876977077177277377477577677777877978078178278378478578678778878979079179279379479579679779879980080180280380480580680780880981081181281381481581681781881982082182282382482582682782882983083183283383483583683783883984084184284384484584684784884985085185285385485585685785885986086186286386486586686786886987087187287387487587687787887988088188288388488588688788888989089189289389489589689789889990090190290390490590690790890991091191291391491591691791891992092192292392492592692792892993093193293393493593693793893994094194294394494594694794894995095195295395495595695795895996096196296396496596696796896997097197297397497597697797897998098198298398498598698798898999099199299399499599699799899910001001100210031004100510061007100810091010101110121013101410151016101710181019102010211022102310241025102610271028102910301031103210331034103510361037103810391040104110421043104410451046104710481049105010511052105310541055105610571058105910601061106210631064106510661067106810691070107110721073107410751076107710781079108010811082108310841085108610871088108910901091109210931094109510961097109810991100110111021103110411051106110711081109111011111112111311141115111611171118111911201121112211231124112511261127112811291130113111321133113411351136113711381139114011411142114311441145114611471148114911501151115211531154115511561157115811591160116111621163116411651166116711681169117011711172117311741175117611771178117911801181118211831184118511861187118811891190119111921193119411951196119711981199120012011202120312041205120612071208120912101211121212131214121512161217121812191220122112221223122412251226122712281229123012311232123312341235123612371238123912401241124212431244124512461247124812491250125112521253125412551256125712581259126012611262126312641265126612671268126912701271127212731274127512761277127812791280128112821283128412851286128712881289129012911292129312941295129612971298129913001301130213031304130513061307130813091310131113121313131413151316131713181319132013211322132313241325132613271328132913301331133213331334133513361337133813391340134113421343134413451346134713481349135013511352135313541355135613571358135913601361136213631364136513661367136813691370137113721373137413751376137713781379138013811382138313841385138613871388138913901391139213931394139513961397139813991400140114021403140414051406140714081409141014111412141314141415141614171418141914201421142214231424142514261427142814291430143114321433143414351436143714381439144014411442144314441445144614471448144914501451145214531454145514561457145814591460146114621463146414651466146714681469147014711472147314741475147614771478147914801481148214831484148514861487148814891490149114921493149414951496149714981499150015011502150315041505150615071508150915101511151215131514151515161517151815191520152115221523152415251526152715281529153015311532153315341535153615371538153915401541154215431544154515461547154815491550155115521553155415551556155715581559156015611562156315641565156615671568156915701571157215731574157515761577157815791580158115821583158415851586158715881589159015911592159315941595159615971598159916001601160216031604160516061607160816091610161116121613161416151616161716181619162016211622162316241625162616271628162916301631163216331634163516361637163816391640164116421643164416451646164716481649165016511652165316541655165616571658165916601661166216631664166516661667166816691670167116721673167416751676167716781679168016811682168316841685168616871688168916901691169216931694169516961697169816991700170117021703170417051706170717081709171017111712171317141715171617171718171917201721172217231724172517261727172817291730173117321733173417351736173717381739174017411742174317441745174617471748174917501751175217531754175517561757175817591760176117621763176417651766176717681769177017711772177317741775177617771778177917801781178217831784178517861787178817891790179117921793179417951796179717981799180018011802180318041805180618071808180918101811181218131814181518161817181818191820182118221823182418251826182718281829183018311832183318341835183618371838183918401841184218431844184518461847184818491850185118521853185418551856185718581859186018611862186318641865186618671868186918701871187218731874187518761877187818791880188118821883188418851886188718881889189018911892189318941895189618971898189919001901190219031904190519061907190819091910191119121913191419151916191719181919192019211922192319241925192619271928192919301931193219331934193519361937193819391940194119421943194419451946194719481949195019511952195319541955195619571958195919601961196219631964196519661967196819691970197119721973197419751976197719781979198019811982198319841985198619871988198919901991199219931994199519961997199819992000200120022003200420052006200720082009201020112012201320142015201620172018201920202021202220232024202520262027202820292030203120322033203420352036203720382039204020412042204320442045204620472048204920502051205220532054205520562057205820592060206120622063206420652066206720682069207020712072207320742075207620772078207920802081208220832084208520862087208820892090209120922093209420952096209720982099210021012102210321042105210621072108210921102111211221132114211521162117211821192120212121222123212421252126212721282129213021312132213321342135213621372138213921402141214221432144214521462147214821492150215121522153215421552156215721582159216021612162216321642165216621672168216921702171217221732174217521762177217821792180218121822183218421852186218721882189219021912192219321942195219621972198219922002201220222032204220522062207220822092210221122122213221422152216221722182219222022212222222322242225222622272228222922302231223222332234223522362237223822392240224122422243224422452246224722482249225022512252225322542255225622572258225922602261226222632264226522662267226822692270227122722273227422752276227722782279228022812282228322842285228622872288228922902291229222932294229522962297229822992300230123022303230423052306230723082309231023112312231323142315231623172318231923202321232223232324232523262327232823292330233123322333233423352336233723382339234023412342234323442345234623472348234923502351235223532354235523562357235823592360236123622363236423652366236723682369237023712372237323742375237623772378237923802381238223832384238523862387238823892390239123922393239423952396239723982399240024012402240324042405240624072408240924102411241224132414241524162417241824192420242124222423242424252426242724282429243024312432243324342435243624372438243924402441244224432444244524462447244824492450245124522453245424552456245724582459246024612462246324642465246624672468246924702471247224732474247524762477247824792480248124822483248424852486248724882489249024912492249324942495249624972498249925002501250225032504250525062507250825092510251125122513251425152516251725182519252025212522252325242525252625272528252925302531253225332534253525362537253825392540254125422543254425452546254725482549255025512552255325542555255625572558255925602561256225632564256525662567256825692570257125722573257425752576257725782579258025812582258325842585258625872588258925902591259225932594259525962597259825992600260126022603260426052606260726082609261026112612261326142615261626172618261926202621262226232624262526262627262826292630263126322633263426352636263726382639264026412642264326442645264626472648264926502651265226532654265526562657265826592660266126622663266426652666266726682669267026712672267326742675267626772678267926802681268226832684268526862687268826892690269126922693269426952696269726982699270027012702270327042705270627072708270927102711271227132714271527162717271827192720272127222723272427252726272727282729273027312732273327342735273627372738273927402741274227432744274527462747274827492750275127522753275427552756275727582759276027612762276327642765276627672768276927702771277227732774277527762777277827792780278127822783278427852786278727882789279027912792279327942795279627972798279928002801280228032804280528062807280828092810281128122813281428152816281728182819282028212822282328242825282628272828282928302831283228332834283528362837283828392840284128422843284428452846284728482849285028512852285328542855285628572858285928602861286228632864286528662867286828692870287128722873287428752876287728782879288028812882288328842885288628872888288928902891289228932894289528962897289828992900290129022903290429052906290729082909291029112912291329142915291629172918291929202921292229232924292529262927292829292930293129322933293429352936293729382939294029412942294329442945294629472948294929502951295229532954295529562957295829592960296129622963296429652966296729682969297029712972297329742975297629772978297929802981298229832984298529862987298829892990299129922993299429952996299729982999300030013002300330043005300630073008300930103011301230133014301530163017301830193020302130223023302430253026302730283029303030313032303330343035303630373038303930403041304230433044304530463047304830493050305130523053305430553056305730583059306030613062306330643065306630673068306930703071307230733074307530763077307830793080308130823083308430853086308730883089309030913092309330943095309630973098309931003101310231033104310531063107310831093110311131123113311431153116311731183119312031213122312331243125312631273128312931303131313231333134313531363137313831393140314131423143314431453146314731483149315031513152315331543155315631573158315931603161316231633164316531663167316831693170317131723173317431753176317731783179318031813182318331843185318631873188318931903191319231933194319531963197319831993200320132023203320432053206320732083209321032113212321332143215321632173218321932203221322232233224322532263227322832293230323132323233323432353236323732383239324032413242324332443245324632473248324932503251325232533254325532563257325832593260326132623263326432653266326732683269327032713272327332743275327632773278327932803281328232833284328532863287328832893290329132923293329432953296329732983299330033013302330333043305330633073308330933103311331233133314331533163317331833193320332133223323332433253326332733283329333033313332333333343335333633373338333933403341334233433344334533463347334833493350335133523353335433553356335733583359336033613362336333643365336633673368336933703371337233733374337533763377337833793380338133823383338433853386338733883389339033913392339333943395339633973398339934003401340234033404340534063407340834093410341134123413341434153416341734183419342034213422342334243425342634273428342934303431343234333434343534363437343834393440344134423443344434453446344734483449345034513452345334543455345634573458345934603461346234633464346534663467346834693470347134723473347434753476347734783479348034813482348334843485348634873488348934903491349234933494349534963497349834993500350135023503350435053506350735083509351035113512351335143515351635173518351935203521352235233524352535263527352835293530353135323533353435353536353735383539354035413542354335443545354635473548354935503551355235533554355535563557355835593560356135623563356435653566356735683569357035713572357335743575357635773578357935803581358235833584358535863587358835893590359135923593359435953596359735983599360036013602360336043605360636073608360936103611361236133614361536163617361836193620362136223623362436253626362736283629363036313632363336343635363636373638363936403641364236433644364536463647364836493650365136523653365436553656365736583659366036613662366336643665366636673668366936703671367236733674367536763677367836793680368136823683368436853686368736883689369036913692369336943695369636973698369937003701370237033704370537063707370837093710371137123713371437153716371737183719372037213722372337243725372637273728372937303731373237333734373537363737373837393740374137423743374437453746374737483749 |
- <?php
- $config['survey']['debug'] = false;
- /*
- DOKEOS - elearning and course management software
- For a full list of contributors, see documentation/credits.html
- This program is free software; you can redistribute it and/or
- modify it under the terms of the GNU General Public License
- as published by the Free Software Foundation; either version 2
- of the License, or (at your option) any later version.
- See "documentation/licence.html" more details.
- Contact:
- Dokeos
- Rue des Palais 44 Paleizenstraat
- B-1030 Brussels - Belgium
- Tel. +32 (2) 211 34 56
- */
- /**
- * @package dokeos.survey
- * @author Patrick Cool <patrick.cool@UGent.be>, Ghent University: cleanup, refactoring and rewriting large parts (if not all) of the code
- * @version $Id: survey.lib.php 10680 2007-01-11 21:26:23Z pcool $
- *
- * @todo move this file to inc/lib
- * @todo use consistent naming for the functions (save vs store for instance)
- */
- class survey_manager
- {
- /******************************************************************************************************
- SURVEY FUNCTIONS
- *****************************************************************************************************/
- /**
- * This function retrieves all the survey information
- *
- * @param integer $survey_id the id of the survey
- * @param boolean $shared this parameter determines if we have to get the information of a survey from the central (shared) database or from the
- * course database
- *
- * @return array
- *
- * @author Patrick Cool <patrick.cool@UGent.be>, Ghent University
- * @version February 2007
- *
- * @todo this is the same function as in create_new_survey.php
- */
- function get_survey($survey_id,$shared=0)
- {
- global $_course;
- // table definition
- $table_survey = Database :: get_course_table(TABLE_SURVEY, $_course['db_name']);
- if ($shared<>0)
- {
- $table_survey = Database :: get_main_table(TABLE_MAIN_SHARED_SURVEY_QUESTION);
- }
- $sql = "SELECT * FROM $table_survey WHERE survey_id='".Database::escape_string($survey_id)."'";
- $result = api_sql_query($sql, __FILE__, __LINE__);
- $return = Database::fetch_array($result,'ASSOC');
- // we do this (temporarily) to have the array match the quickform elements immediately
- // idealiter the fields in the db match the quickform fields
- $return['survey_code'] = $return['code'];
- $return['survey_title'] = $return['title'];
- $return['survey_subtitle'] = $return['subtitle'];
- $return['survey_language'] = $return['lang'];
- $return['start_date'] = $return['avail_from'];
- $return['end_date'] = $return['avail_till'];
- $return['survey_share'] = $return['is_shared'];
- $return['survey_introduction'] = $return['intro'];
- $return['survey_thanks'] = $return['surveythanks'];
- return $return;
- }
- /**
- * This function stores a survey in the database.
- *
- * @param array $values
- * @return array $return the type of return message that has to be displayed and the message in it
- *
- * @author Patrick Cool <patrick.cool@UGent.be>, Ghent University
- * @version February 2007
- */
- function store_survey($values)
- {
- global $_user;
- // table defnitions
- $table_survey = Database :: get_course_table(TABLE_SURVEY);
- if ($values['survey_share']['survey_share'] !== '0')
- {
- $shared_survey_id = survey_manager::store_shared_survey($values);
- }
- if (!$values['survey_id'] OR !is_numeric($values['survey_id']))
- {
- if ($values['anonymous']=='')
- {
- $values['anonymous']=0;
- }
- $sql = "INSERT INTO $table_survey (code, title, subtitle, author, lang, avail_from, avail_till, is_shared, template, intro, surveythanks, creation_date, anonymous) VALUES (
- '".Database::escape_string($values['survey_code'])."',
- '".Database::escape_string($values['survey_title'])."',
- '".Database::escape_string($values['survey_subtitle'])."',
- '".Database::escape_string($_user['user_id'])."',
- '".Database::escape_string($values['survey_language'])."',
- '".Database::escape_string($values['start_date'])."',
- '".Database::escape_string($values['end_date'])."',
- '".Database::escape_string($shared_survey_id)."',
- '".Database::escape_string('template')."',
- '".Database::escape_string($values['survey_introduction'])."',
- '".Database::escape_string($values['survey_thanks'])."',
- '".date('Y-m-d H:i:s')."',
- '".Database::escape_string($values['anonymous'])."'
- )";
- $result = api_sql_query($sql, __FILE__, __LINE__);
- $survey_id = Database::insert_id();
- //$return['message'] = get_lang('SurveyCreatedSuccesfully').'<br />'.get_lang('YouCanNowAddQuestionToYourSurvey').': ';
- //$return['message'] .= '<a href="survey.php?survey_id='.$survey_id.'">'.get_lang('ClickHere').'</a>';
- $return['message'] = 'SurveyCreatedSuccesfully';
- $return['type'] = 'confirmation';
- $return['id'] = $survey_id;
- }
- else
- {
- if ($values['anonymous']=='')
- {
- $values['anonymous']=0;
- }
- $sql = "UPDATE $table_survey SET
- code = '".Database::escape_string($values['survey_code'])."',
- title = '".Database::escape_string($values['survey_title'])."',
- subtitle = '".Database::escape_string($values['survey_subtitle'])."',
- author = '".Database::escape_string($_user['user_id'])."',
- lang = '".Database::escape_string($values['survey_language'])."',
- avail_from = '".Database::escape_string($values['start_date'])."',
- avail_till = '".Database::escape_string($values['end_date'])."',
- is_shared = '".Database::escape_string($shared_survey_id)."',
- template = '".Database::escape_string('template')."',
- intro = '".Database::escape_string($values['survey_introduction'])."',
- surveythanks = '".Database::escape_string($values['survey_thanks'])."',
- anonymous = '".Database::escape_string($values['anonymous'])."'
- WHERE survey_id = '".Database::escape_string($values['survey_id'])."'";
- $result = api_sql_query($sql, __FILE__, __LINE__);
- //$return['message'] = get_lang('SurveyUpdatedSuccesfully').'<br />'.get_lang('YouCanNowAddQuestionToYourSurvey').': ';
- //$return['message'] .= '<a href="survey.php?survey_id='.$values['survey_id'].'">'.get_lang('Here').'</a>';
- //$return['message'] .= get_lang('OrReturnToSurveyOverview').'<a href="survey_list.php">'.get_lang('Here').'</a>';
- $return['message'] = 'SurveyUpdatedSuccesfully';
- $return['type'] = 'confirmation';
- $return['id'] = $values['survey_id'];
- }
- return $return;
- }
- /**
- * This function stores a shared survey in the central database.
- *
- * @param array $values
- * @return array $return the type of return message that has to be displayed and the message in it
- *
- * @author Patrick Cool <patrick.cool@UGent.be>, Ghent University
- * @version February 2007
- */
- function store_shared_survey($values)
- {
- global $_user;
- global $_course;
- // table defnitions
- $table_survey = Database :: get_main_table(TABLE_MAIN_SHARED_SURVEY);
- if (!$values['survey_id'] OR !is_numeric($values['survey_id']) OR $values['survey_share']['survey_share'] == 'true')
- {
- $sql = "INSERT INTO $table_survey (code, title, subtitle, author, lang, template, intro, surveythanks, creation_date, course_code) VALUES (
- '".Database::escape_string($values['survey_code'])."',
- '".Database::escape_string($values['survey_title'])."',
- '".Database::escape_string($values['survey_subtitle'])."',
- '".Database::escape_string($_user['user_id'])."',
- '".Database::escape_string($values['survey_language'])."',
- '".Database::escape_string('template')."',
- '".Database::escape_string($values['survey_introduction'])."',
- '".Database::escape_string($values['survey_thanks'])."',
- '".date('Y-m-d H:i:s')."',
- '".$_course['id']."')";
- $result = api_sql_query($sql, __FILE__, __LINE__);
- $return = Database::insert_id();
- }
- else
- {
- $sql = "UPDATE $table_survey SET
- code = '".Database::escape_string($values['survey_code'])."',
- title = '".Database::escape_string($values['survey_title'])."',
- subtitle = '".Database::escape_string($values['survey_subtitle'])."',
- author = '".Database::escape_string($_user['user_id'])."',
- lang = '".Database::escape_string($values['survey_language'])."',
- template = '".Database::escape_string('template')."',
- intro = '".Database::escape_string($values['survey_introduction'])."',
- surveythanks = '".Database::escape_string($values['survey_thanks'])."'
- WHERE survey_id = '".Database::escape_string($values['survey_share']['survey_share'])."'";
- $result = api_sql_query($sql, __FILE__, __LINE__);
- $return = $values['survey_share']['survey_share'];
- }
- return $return;
- }
- /**
- * This function deletes a survey (and also all the question in that survey
- *
- * @param $survey_id the id of the survey that has to be deleted
- * @return true
- *
- * @author Patrick Cool <patrick.cool@UGent.be>, Ghent University
- * @version January 2007
- */
- function delete_survey($survey_id, $shared=false)
- {
- // Database table definitions
- $table_survey = Database :: get_course_table(TABLE_SURVEY);
- if ($shared)
- {
- $table_survey = Database :: get_main_table(TABLE_MAIN_SHARED_SURVEY);
- }
- // deleting the survey
- $sql = "DELETE from $table_survey WHERE survey_id='".Database::escape_string($survey_id)."'";
- $res = api_sql_query($sql, __FILE__, __LINE__);
- // deleting the questions of the survey
- survey_manager::delete_all_survey_questions($survey_id, $shared);
- return true;
- }
-
- /**
- * This function duplicates a survey (and also all the question in that survey
- *
- * @param $survey_id the id of the survey that has to be duplicated
- * @return true
- *
- * @author Eric Marguin <e.marguin@elixir-interactive.com>, Elixir Interactive
- * @version October 2007
- */
- function empty_survey($survey_id)
- {
- // Database table definitions
- $table_survey_invitation = Database :: get_course_table(TABLE_SURVEY_INVITATION);
- $table_survey_answer = Database :: get_course_table(TABLE_SURVEY_ANSWER);
- $table_survey = Database :: get_course_table(TABLE_SURVEY);
-
- $datas = survey_manager::get_survey($survey_id);
- $sql = 'DELETE FROM '.$table_survey_invitation.' WHERE survey_code = "'.Database::escape_string($datas['code']).'"';
- api_sql_query($sql, __FILE__, __LINE__);
-
- $sql = 'DELETE FROM '.$table_survey_answer.' WHERE survey_id='.intval($survey_id);
- api_sql_query($sql, __FILE__, __LINE__);
-
- $sql = 'UPDATE '.$table_survey.' SET invited=0, answered=0 WHERE survey_id='.intval($survey_id);
- api_sql_query($sql, __FILE__, __LINE__);
- return true;
- }
- /**
- * This function recalculates the number of people who have taken the survey (=filled at least one question)
- *
- * @param $survey_id the id of the survey somebody
- * @return true
- *
- * @author Patrick Cool <patrick.cool@UGent.be>, Ghent University
- * @version February 2007
- */
- function update_survey_answered($survey_id, $user, $survey_code)
- {
- global $_course;
- // Database table definitions
- $table_survey = Database :: get_course_table(TABLE_SURVEY, $_course['db_name']);
- $table_survey_invitation = Database :: get_course_table(TABLE_SURVEY_INVITATION, $_course['db_name']);
- // getting a list with all the people who have filled the survey
- $people_filled = survey_manager::get_people_who_filled_survey($survey_id);
- $number = count($people_filled);
- // storing this value in the survey table
- $sql = "UPDATE $table_survey SET answered = '".Database::escape_string($number)."' WHERE survey_id = '".Database::escape_string($survey_id)."'";
- $res = api_sql_query($sql, __FILE__, __LINE__);
- // storing that the user has finished the survey.
- $sql = "UPDATE $table_survey_invitation SET answered='1' WHERE user='".Database::escape_string($user)."' AND survey_code='".Database::escape_string($survey_code)."'";
- $res = api_sql_query($sql, __FILE__, __LINE__);
- }
- /**
- * This function gets a complete structure of a survey (all survey information, all question information
- * of all the questions and all the options of all the questions.
- *
- * @param integer $survey_id the id of the survey
- * @param boolean $shared this parameter determines if we have to get the information of a survey from the central (shared) database or from the
- * course database
- *
- * @author Patrick Cool <patrick.cool@UGent.be>, Ghent University
- * @version February 2007
- */
- function get_complete_survey_structure($survey_id, $shared=0)
- {
- // Database table definitions
- $table_survey = Database :: get_course_table(TABLE_SURVEY);
- $table_survey_question = Database :: get_course_table(TABLE_SURVEY_QUESTION);
- $table_survey_question_option = Database :: get_course_table(TABLE_SURVEY_QUESTION_OPTION);
- if ($shared<>0)
- {
- $table_survey = Database :: get_main_table(TABLE_MAIN_SHARED_SURVEY_QUESTION);
- $table_survey_question = Database :: get_course_table(TABLE_SHARED_SURVEY_QUESTION);
- $table_survey_question_option = Database :: get_main_table(TABLE_MAIN_SHARED_SURVEY_QUESTION_OPTION);
- }
- $structure = survey_manager::get_survey($survey_id, $shared);
- $structure['questions'] = survey_manager::get_questions($survey_id);
- }
- /******************************************************************************************************
- SURVEY QUESTION FUNCTIONS
- *****************************************************************************************************/
- /**
- * This function return the "icon" of the question type
- *
- * @author Patrick Cool <patrick.cool@UGent.be>, Ghent University
- * @version February 2007
- */
- function icon_question($type)
- {
- // the possible question types
- $possible_types = array('yesno', 'multiplechoice', 'multipleresponse', 'open', 'dropdown', 'comment', 'pagebreak', 'percentage', 'score');
- // the images array
- $icon_question = array(
- 'yesno' => 'yesno.gif',
- 'multiplechoice' => 'mcua.gif',
- 'multipleresponse' => 'mcma.gif',
- 'open' => 'open_answer.gif',
- 'dropdown' => 'dropdown.gif',
- 'percentage' => 'percentagequestion.gif',
- 'score' => 'scorequestion.gif',
- 'comment' => 'commentquestion.gif',
- 'pagebreak' => 'page_end.gif',
- );
- if (in_array($type, $possible_types))
- {
- return $icon_question[$type];
- }
- else
- {
- return false;
- }
- }
- /**
- * This function retrieves all the information of a question
- *
- * @param integer $question_id the id of the question
- * @return array
- *
- * @author Patrick Cool <patrick.cool@UGent.be>, Ghent University
- * @version January 2007
- *
- * @todo one sql call should do the trick
- */
- function get_question($question_id, $shared=false)
- {
- // table definitions
- $tbl_survey_question = Database :: get_course_table(TABLE_SURVEY_QUESTION);
- $table_survey_question_option = Database :: get_course_table(TABLE_SURVEY_QUESTION_OPTION);
- if ($shared)
- {
- $tbl_survey_question = Database :: get_main_table(TABLE_MAIN_SHARED_SURVEY_QUESTION);
- $table_survey_question_option = Database :: get_main_table(TABLE_MAIN_SHARED_SURVEY_QUESTION_OPTION);
- }
- // getting the information of the question
- $sql = "SELECT * FROM $tbl_survey_question WHERE question_id='".Database::escape_string($question_id)."' ORDER BY `sort`";
- $result = api_sql_query($sql, __FILE__, __LINE__);
- $row = Database::fetch_array($result,'ASSOC');
- $return['survey_id'] = $row['survey_id'];
- $return['question_id'] = $row['question_id'];
- $return['type'] = $row['type'];
- $return['question'] = $row['survey_question'];
- $return['horizontalvertical'] = $row['display'];
- $return['shared_question_id'] = $row['shared_question_id'];
- $return['maximum_score'] = $row['max_value'];
- // getting the information of the question options
- $sql = "SELECT * FROM $table_survey_question_option WHERE question_id='".Database::escape_string($question_id)."' ORDER BY `sort` ";
- $result = api_sql_query($sql, __FILE__, __LINE__);
- while ($row = Database::fetch_array($result,'ASSOC'))
- {
- /** @todo this should be renamed to options instead of answers */
- $return['answers'][] = $row['option_text'];
- /** @todo this can be done more elegantly (used in reporting) */
- $return['answersid'][] = $row['question_option_id'];
- }
- return $return;
- }
- /**
- * This function gets all the question of any given survey
- *
- * @param integer $survey_id the id of the survey
- * @return array containing all the questions of the survey
- *
- * @author Patrick Cool <patrick.cool@UGent.be>, Ghent University
- * @version February 2007
- *
- * @todo one sql call should do the trick
- */
- function get_questions($survey_id)
- {
- // table definitions
- $tbl_survey_question = Database :: get_course_table(TABLE_SURVEY_QUESTION);
- $table_survey_question_option = Database :: get_course_table(TABLE_SURVEY_QUESTION_OPTION);
- // getting the information of the question
- $sql = "SELECT * FROM $tbl_survey_question WHERE survey_id='".Database::escape_string($survey_id)."'";
- $result = api_sql_query($sql, __FILE__, __LINE__);
- while ($row = Database::fetch_array($result,'ASSOC'))
- {
- $return[$row['question_id']]['survey_id'] = $row['survey_id'];
- $return[$row['question_id']]['question_id'] = $row['question_id'];
- $return[$row['question_id']]['type'] = $row['type'];
- $return[$row['question_id']]['question'] = $row['survey_question'];
- $return[$row['question_id']]['horizontalvertical'] = $row['display'];
- $return[$row['question_id']]['maximum_score'] = $row['max_value'];
- $return[$row['question_id']]['sort'] = $row['sort'];
- }
- // getting the information of the question options
- $sql = "SELECT * FROM $table_survey_question_option WHERE survey_id='".Database::escape_string($survey_id)."'";
- $result = api_sql_query($sql, __FILE__, __LINE__);
- while ($row = Database::fetch_array($result,'ASSOC'))
- {
- $return[$row['question_id']]['answers'][] = $row['option_text'];
- }
- return $return;
- }
- /**
- * This function saves a question in the database.
- * This can be either an update of an existing survey or storing a new survey
- *
- * @param array $form_content all the information of the form
- *
- * @author Patrick Cool <patrick.cool@UGent.be>, Ghent University
- * @version January 2007
- */
- function save_question($form_content)
- {
- if (strlen($form_content['question'])>1)
- { //checks lenght of the question
- $empty_answer=false;
-
- if ($form_content['type'] != 'percentage')
- {
- for($i=0;$i<count($form_content['answers']);$i++)
- {
- if (strlen($form_content['answers'][$i])<1)
- {
- $empty_answer=true;
- break;
- }
- }
- }
-
- if ($form_content['type'] == 'score' )
- {
- if (strlen($form_content['maximum_score'])<1)
- {
- $empty_answer=true;
- }
- }
-
- if (!$empty_answer)
- {
- global $_course;
- // table definitions
- $table_survey = Database :: get_course_table(TABLE_SURVEY, $_course['db_name']);
- $tbl_survey_question = Database :: get_course_table(TABLE_SURVEY_QUESTION, $_course['db_name']);
-
- // getting all the information of the survey
- $survey_data = survey_manager::get_survey($form_content['survey_id']);
-
- // storing the question in the shared database
- if (is_numeric($survey_data['survey_share']) AND $survey_data['survey_share'] <> 0)
- {
- $shared_question_id = survey_manager::save_shared_question($form_content, $survey_data);
- $form_content['shared_question_id'] = $shared_question_id;
- }
-
- // storing a new question
- if ($form_content['question_id'] == '' OR !is_numeric($form_content['question_id']))
- {
- // finding the max sort order of the questions in the given survey
- $sql = "SELECT max(sort) AS max_sort FROM $tbl_survey_question WHERE survey_id='".Database::escape_string($form_content['survey_id'])."'";
- $result = api_sql_query($sql, __FILE__, __LINE__);
- $row = Database::fetch_array($result,'ASSOC');
- $max_sort = $row['max_sort'];
-
- // adding the question to the survey_question table
- $sql = "INSERT INTO $tbl_survey_question (survey_id,survey_question,survey_question_comment,type,display, sort, shared_question_id, max_value) VALUES (
- '".Database::escape_string($form_content['survey_id'])."',
- '".Database::escape_string($form_content['question'])."',
- '".Database::escape_string($form_content['question_comment'])."',
- '".Database::escape_string($form_content['type'])."',
- '".Database::escape_string($form_content['horizontalvertical'])."',
- '".Database::escape_string($max_sort+1)."',
- '".Database::escape_string($form_content['shared_question_id'])."',
- '".Database::escape_string($form_content['maximum_score'])."'
- )";
- $result = api_sql_query($sql, __FILE__, __LINE__);
- $question_id = Database::insert_id();
- $form_content['question_id'] = $question_id;
- $return_message = 'QuestionAdded';
- }
- // updating an existing question
- else
- {
- // adding the question to the survey_question table
- $sql = "UPDATE $tbl_survey_question SET
- survey_question = '".Database::escape_string($form_content['question'])."',
- survey_question_comment = '".Database::escape_string($form_content['question_comment'])."',
- display = '".Database::escape_string($form_content['horizontalvertical'])."',
- max_value = '".Database::escape_string($form_content['maximum_score'])."'
- WHERE question_id = '".Database::escape_string($form_content['question_id'])."'";
- $result = api_sql_query($sql, __FILE__, __LINE__);
- $return_message = 'QuestionUpdated';
- }
- // storing the options of the question
- $message_options=survey_manager::save_question_options($form_content, $survey_data);
- }
- else
- {
- $return_message='PleasFillAllAnswer';
- }
- }
- else
- {
- $return_message='PleaseEnterAQuestion';
- }
- return $return_message;
- }
- /**
- * This function saves the question in the shared database
- *
- * @param array $form_content all the information of the form
- * @param array $survey_data all the information of the survey
- *
- * @author Patrick Cool <patrick.cool@UGent.be>, Ghent University
- * @version February 2007
- *
- * @todo editing of a shared question
- */
- function save_shared_question($form_content, $survey_data)
- {
- global $_course;
-
- // table definitions
- $tbl_survey_question = Database :: get_main_table(TABLE_MAIN_SHARED_SURVEY_QUESTION);
-
- // storing a new question
- if ($form_content['shared_question_id'] == '' OR !is_numeric($form_content['shared_question_id']))
- {
- // finding the max sort order of the questions in the given survey
- $sql = "SELECT max(sort) AS max_sort FROM $tbl_survey_question
- WHERE survey_id='".Database::escape_string($survey_data['survey_share'])."'
- AND code='".Database::escape_string($_course['id'])."'";
- $result = api_sql_query($sql, __FILE__, __LINE__);
- $row = Database::fetch_array($result,'ASSOC');
- $max_sort = $row['max_sort'];
-
- // adding the question to the survey_question table
- $sql = "INSERT INTO $tbl_survey_question (survey_id, survey_question, survey_question_comment, type, display, sort, code) VALUES (
- '".Database::escape_string($survey_data['survey_share'])."',
- '".Database::escape_string($form_content['question'])."',
- '".Database::escape_string($form_content['question_comment'])."',
- '".Database::escape_string($form_content['type'])."',
- '".Database::escape_string($form_content['horizontalvertical'])."',
- '".Database::escape_string($max_sort+1)."',
- '".Database::escape_string($_course['id'])."')";
- $result = api_sql_query($sql, __FILE__, __LINE__);
- $shared_question_id = Database::insert_id();
- }
- // updating an existing question
- else
- {
- // adding the question to the survey_question table
- $sql = "UPDATE $tbl_survey_question SET
- survey_question = '".Database::escape_string($form_content['question'])."',
- survey_question_comment = '".Database::escape_string($form_content['question_comment'])."',
- display = '".Database::escape_string($form_content['horizontalvertical'])."'
- WHERE question_id = '".Database::escape_string($form_content['shared_question_id'])."'
- AND code='".Database::escape_string($_course['id'])."'";
- $result = api_sql_query($sql, __FILE__, __LINE__);
- $shared_question_id = $form_content['shared_question_id'];
- }
-
- return $shared_question_id;
- }
- /**
- * This functions moves a question of a survey up or down
- *
- * @param string $direction
- * @param integer $survey_question_id
- * @param integer $survey_id
- *
- * @author Patrick Cool <patrick.cool@UGent.be>, Ghent University
- * @version January 2007
- */
- function move_survey_question($direction, $survey_question_id, $survey_id)
- {
- // table definition
- $table_survey_question = Database :: get_course_table(TABLE_SURVEY_QUESTION);
- if ($direction == 'moveup')
- {
- $sort = 'DESC';
- }
- if ($direction == 'movedown')
- {
- $sort = 'ASC';
- }
- // finding the two questions that needs to be swapped
- $sql = "SELECT * FROM $table_survey_question WHERE survey_id='".Database::escape_string($survey_id)."' ORDER BY sort $sort";
- $result = api_sql_query($sql, __FILE__, __LINE__);
- $found = false;
- while ($row = Database::fetch_array($result,'ASSOC'))
- {
- if ($found == true)
- {
- $question_id_two = $row['question_id'];
- $question_sort_two = $row['sort'];
- $found = false;
- }
- if ($row['question_id'] == $survey_question_id)
- {
- $found = true;
- $question_id_one = $row['question_id'];
- $question_sort_one = $row['sort'];
- }
- }
- $sql1 = "UPDATE $table_survey_question SET sort = '".Database::escape_string($question_sort_two)."' WHERE question_id='".Database::escape_string($question_id_one)."'";
- $result = api_sql_query($sql1, __FILE__, __LINE__);
- $sql2 = "UPDATE $table_survey_question SET sort = '".Database::escape_string($question_sort_one)."' WHERE question_id='".Database::escape_string($question_id_two)."'";
- $result = api_sql_query($sql2, __FILE__, __LINE__);
- }
- /**
- * This function deletes all the questions of a given survey
- * This function is normally only called when a survey is deleted
- *
- * @param $survey_id the id of the survey that has to be deleted
- * @return true
- *
- * @author Patrick Cool <patrick.cool@UGent.be>, Ghent University
- * @version January 2007
- */
- function delete_all_survey_questions($survey_id, $shared=false)
- {
- // table definitions
- $table_survey_question = Database :: get_course_table(TABLE_SURVEY_QUESTION);
- if ($shared)
- {
- $table_survey_question = Database :: get_main_table(TABLE_MAIN_SHARED_SURVEY_QUESTION);
- }
- // deleting the survey questions
- $sql = "DELETE from $table_survey_question WHERE survey_id='".Database::escape_string($survey_id)."'";
- $res = api_sql_query($sql, __FILE__, __LINE__);
- // deleting all the options of the questions of the survey
- survey_manager::delete_all_survey_questions_options($survey_id, $shared);
- // deleting all the answers on this survey
- survey_manager::delete_all_survey_answers($survey_id);
- }
- /**
- * This function deletes a survey question and all its options
- *
- * @param integer $survey_id the id of the survey
- * @param integer $question_id the id of the question
- * @param integer $shared
- *
- * @todo also delete the answers to this question
- *
- * @author Patrick Cool <patrick.cool@UGent.be>, Ghent University
- * @version March 2007
- */
- function delete_survey_question($survey_id, $question_id, $shared=false)
- {
- // table definitions
- $table_survey_question = Database :: get_course_table(TABLE_SURVEY_QUESTION);
- if ($shared)
- {
- survey_manager::delete_shared_survey_question($survey_id, $question_id);
- }
- // deleting the survey questions
- $sql = "DELETE from $table_survey_question WHERE survey_id='".Database::escape_string($survey_id)."' AND question_id='".Database::escape_string($question_id)."'";
- $res = api_sql_query($sql, __FILE__, __LINE__);
- // deleting the options of the question of the survey
- survey_manager::delete_survey_question_option($survey_id, $question_id, $shared);
- }
- /**
- * This function deletes a shared survey question from the main database and all its options
- *
- * @param integer $question_id the id of the question
- * @param integer $shared
- *
- * @todo delete all the options of this question
- *
- * @author Patrick Cool <patrick.cool@UGent.be>, Ghent University
- * @version March 2007
- */
- function delete_shared_survey_question($survey_id, $question_id)
- {
- // table definitions
- $table_survey_question = Database :: get_main_table(TABLE_MAIN_SHARED_SURVEY_QUESTION);
- $table_survey_question_option = Database :: get_main_table(TABLE_MAIN_SHARED_SURVEY_QUESTION_OPTION);
- // first we have to get the shared_question_id
- $question_data = survey_manager::get_question($question_id);
- // deleting the survey questions
- $sql = "DELETE FROM $table_survey_question WHERE question_id='".Database::escape_string($question_data['shared_question_id'])."'";
- $res = api_sql_query($sql, __FILE__, __LINE__);
- // deleting the options of the question of the survey question
- $sql = "DELETE FROM $table_survey_question_option WHERE question_id='".Database::escape_string($question_data['shared_question_id'])."'";
- $res = api_sql_query($sql, __FILE__, __LINE__);
- }
- /******************************************************************************************************
- SURVEY QUESTION OPTIONS FUNCTIONS
- *****************************************************************************************************/
- /**
- * This function stores the options of the questions in the table
- *
- * @param array $form_content
- * @return
- *
- * @author Patrick Cool <patrick.cool@UGent.be>, Ghent University
- * @version January 2007
- *
- * @todo writing the update statement when editing a question
- */
- function save_question_options($form_content, $survey_data)
- {
- // a percentage question type has options 1 -> 100
- if ($form_content['type'] == 'percentage')
- {
- for($i=1;$i<101;$i++)
- {
- $form_content['answers'][] = $i;
- }
- }
-
- if (is_numeric($survey_data['survey_share']) AND $survey_data['survey_share'] <> 0)
- {
- survey_manager::save_shared_question_options($form_content, $survey_data);
- }
- // table defintion
- $table_survey_question_option = Database :: get_course_table(TABLE_SURVEY_QUESTION_OPTION);
- // we are editing a question so we first have to remove all the existing options from the database
- if (is_numeric($form_content['question_id']))
- {
- $sql = "DELETE FROM $table_survey_question_option WHERE question_id = '".Database::escape_string($form_content['question_id'])."'";
- $result = api_sql_query($sql, __FILE__, __LINE__);
- }
- $counter=1;
- if(is_array($form_content['answers'])){
- foreach ($form_content['answers'] as $key=>$answer)
- {
- $sql = "INSERT INTO $table_survey_question_option (question_id, survey_id, option_text, sort) VALUES (
- '".Database::escape_string($form_content['question_id'])."',
- '".Database::escape_string($form_content['survey_id'])."',
- '".Database::escape_string($answer)."',
- '".Database::escape_string($counter)."')";
- $result = api_sql_query($sql, __FILE__, __LINE__);
- $counter++;
- }
- }
- }
- /**
- * This function stores the options of the questions in the shared table
- *
- * @param array $form_content
- * @return
- *
- * @author Patrick Cool <patrick.cool@UGent.be>, Ghent University
- * @version February 2007
- *
- * @todo writing the update statement when editing a question
- */
- function save_shared_question_options($form_content, $survey_data)
- {
- // table defintion
- $table_survey_question_option = Database :: get_main_table(TABLE_MAIN_SHARED_SURVEY_QUESTION_OPTION);
- // we are editing a question so we first have to remove all the existing options from the database
- $sql = "DELETE FROM $table_survey_question_option WHERE question_id = '".Database::escape_string($form_content['shared_question_id'])."'";
- $result = api_sql_query($sql, __FILE__, __LINE__);
- $counter = 1;
- foreach ($form_content['answers'] as $key=>$answer)
- {
- $sql = "INSERT INTO $table_survey_question_option (question_id, survey_id, option_text, sort) VALUES (
- '".Database::escape_string($form_content['shared_question_id'])."',
- '".Database::escape_string($survey_data['is_shared'])."',
- '".Database::escape_string($answer)."',
- '".Database::escape_string($counter)."')";
- $result = api_sql_query($sql, __FILE__, __LINE__);
- $counter++;
- }
- }
- /*
- if (is_numeric($survey_data['survey_share']) AND $survey_data['survey_share'] <> 0)
- {
- $form_content = survey_manager::save_shared_question($form_content, $survey_data);
- }
- */
- /**
- * This function deletes all the options of the questions of a given survey
- * This function is normally only called when a survey is deleted
- *
- * @param $survey_id the id of the survey that has to be deleted
- * @return true
- *
- * @author Patrick Cool <patrick.cool@UGent.be>, Ghent University
- * @version January 2007
- */
- function delete_all_survey_questions_options($survey_id, $shared=false)
- {
- // table definitions
- $table_survey_question_option = Database :: get_course_table(TABLE_SURVEY_QUESTION_OPTION);
- if ($shared)
- {
- $table_survey_question = Database :: get_main_table(TABLE_MAIN_SHARED_SURVEY_QUESTION_OPTION);
- }
- // deleting the options of the survey questions
- $sql = "DELETE from $table_survey_question_option WHERE survey_id='".Database::escape_string($survey_id)."'";
- $res = api_sql_query($sql, __FILE__, __LINE__);
- return true;
- }
- /**
- * This function deletes the options of a given question
- *
- * @param unknown_type $survey_id
- * @param unknown_type $question_id
- * @param unknown_type $shared
- * @return unknown
- *
- * @author Patrick Cool <patrick.cool@UGent.be>, Ghent University
- * @version March 2007
- */
- function delete_survey_question_option($survey_id, $question_id, $shared=false)
- {
- // table definitions
- $table_survey_question_option = Database :: get_course_table(TABLE_SURVEY_QUESTION_OPTION);
- if ($shared)
- {
- $table_survey_question = Database :: get_main_table(TABLE_MAIN_SHARED_SURVEY_QUESTION_OPTION);
- }
- // deleting the options of the survey questions
- $sql = "DELETE from $table_survey_question_option WHERE survey_id='".Database::escape_string($survey_id)."' AND question_id='".Database::escape_string($question_id)."'";
- $res = api_sql_query($sql, __FILE__, __LINE__);
- return true;
- }
- /******************************************************************************************************
- SURVEY ANSWERS FUNCTIONS
- *****************************************************************************************************/
- /**
- * This function deletes all the answers anyone has given on this survey
- * This function is normally only called when a survey is deleted
- *
- * @param $survey_id the id of the survey that has to be deleted
- * @return true
- *
- * @todo write the function
- *
- * @author Patrick Cool <patrick.cool@UGent.be>, Ghent University
- * @version January 2007
- */
- function delete_all_survey_answers($survey_id)
- {
- return true;
- }
- /**
- * This function gets all the persons who have filled the survey
- *
- * @param integer $survey_id
- * @return array
- *
- * @author Patrick Cool <patrick.cool@UGent.be>, Ghent University
- * @version February 2007
- */
- function get_people_who_filled_survey($survey_id, $all_user_info = false)
- {
- global $_course;
- // Database table definition
- $table_survey_answer = Database :: get_course_table(TABLE_SURVEY_ANSWER, $_course['db_name']);
- $table_user = Database :: get_main_table('user');
- // variable initialisation
- $return = array();
-
- // getting the survey information
- $survey_data = survey_manager::get_survey($survey_id);
- if ($all_user_info)
- {
- $sql = "SELECT DISTINCT answered_user.user as invited_user, user.firstname, user.lastname, user.user_id
- FROM $table_survey_answer answered_user
- LEFT JOIN $table_user as user
- ON answered_user.user = user.user_id
- WHERE survey_id= '".Database::escape_string($survey_data['survey_id'])."'";
- }
- else
- {
- $sql = "SELECT DISTINCT user FROM $table_survey_answer WHERE survey_id= '".Database::escape_string($survey_data['survey_id'])."'";
- }
- $res = api_sql_query($sql, __FILE__, __LINE__);
- while ($row = Database::fetch_array($res,'ASSOC'))
- {
- if ($all_user_info)
- {
- $return[] = $row;
- }
- else
- {
- $return[] = $row['user'];
- }
- }
- return $return;
- }
- }
- class question
- {
- // the html code of the form
- public $html;
- /**
- * This function does the generic part of any survey question: the question field
- *
- * @return unknown
- */
- /**
- * This function does the generic part of any survey question: the question field
- *
- * @author Patrick Cool <patrick.cool@UGent.be>, Ghent University
- * @version January 2007
- *
- * @todo the form_text has to become a wysiwyg editor or adding a question_comment field
- * @todo consider adding a question_comment form element
- */
- function create_form($form_content)
- {
- global $fck_attribute;
- $this->html = '<form id="question_form" name="question_form" method="post" action="'.api_get_self().'?action='.$_GET['action'].'&type='.$_GET['type'].'&survey_id='.$_GET['survey_id'].'&question_id='.$_GET['question_id'].'">';
- $this->html .= ' <input type="hidden" name="survey_id" id="survey_id" value="'.$_GET['survey_id'].'"/>';
- $this->html .= ' <input type="hidden" name="question_id" id="question_id" value="'.$_GET['question_id'].'"/>';
- $this->html .= ' <input type="hidden" name="shared_question_id" id="shared_question_id" value="'.$form_content['shared_question_id'].'"/>';
- $this->html .= ' <input type="hidden" name="type" id="type" value="'.$_GET['type'].'"/>';
- $this->html .= '<table>';
- $this->html .= ' <tr>';
- $this->html .= ' <td colspan="3"><strong>'.get_lang('Question').'</strong></td>';
- $this->html .= ' </tr>';
- $this->html .= ' <tr>';
- //$this->html .= ' <td><label for="question">'.get_lang('Question').'</label></td>';
- $fck_attribute['Width'] = '100%';
- $fck_attribute['Height'] = '100';
- $fck_attribute['ToolbarSet'] = 'Survey';
- //$this->html .= ' <td><input type="text" name="question" id="question" value="'.$form_content['question'].'"/></td>';
- $this->html .= ' <td colspan="3" width="500">'.api_return_html_area('question', html_entity_decode(stripslashes($form_content['question']))).'</td>';
- $this->html .= ' </tr>';
- /*
- $this->html .= ' <tr>';
- $this->html .= ' <td><label for="question_comment">'.get_lang('QuestionComment').'</label></td>';
- $this->html .= ' <td><input type="text" name="question_comment" id="question_comment" value="'.$form_content['question_comment'].'"/></td>';
- $this->html .= ' <td> </td>';
- $this->html .= ' </tr>';
- */
- $this->html .=' <tr>
- <td colspan=""> </td>
- </tr>';
- return $this->html;
- }
- /**
- * This functions displays the form after the html variable has correctly been finished
- * (adding a submit button, closing the table and closing the form)
- *
- * @author Patrick Cool <patrick.cool@UGent.be>, Ghent University
- * @version January 2007
- *
- */
- function render_form()
- {
- $this->html .= ' <tr>';
- $this->html .= ' <td> </td>';
- $this->html .= ' <td> <input type="submit" name="save_question" value="'.get_lang('SaveQuestion').'" /></td>';
- $this->html .= ' <td> </td>';
- $this->html .= ' </tr>';
- $this->html .= '</table>';
- $this->html .= '</form>';
- echo $this->html;
- }
- /**
- * This function handles the actions on a question and its answers
- *
- * @todo consider using $form_content instead of $_POST
- *
- * @author Patrick Cool <patrick.cool@UGent.be>, Ghent University
- * @version January 2007
- */
- function handle_action($form_content)
- {
- global $config;
- // moving an answer up
- if ($_POST['move_up'])
- {
- foreach ($_POST['move_up'] as $key=>$value)
- {
- $id1 = $key;
- $content1 = $form_content['answers'][$id1];
- $id2 = $key-1;
- $content2 = $form_content['answers'][$id2];
- $form_content['answers'][$id1] = $content2;
- $form_content['answers'][$id2] = $content1;
- }
- }
- // moving an answer down
- if ($_POST['move_down'])
- {
- foreach ($_POST['move_down'] as $key=>$value)
- {
- $id1 = $key;
- $content1 = $form_content['answers'][$id1];
- $id2 = $key+1;
- $content2 = $form_content['answers'][$id2];
- $form_content['answers'][$id1] = $content2;
- $form_content['answers'][$id2] = $content1;
- }
- }
- // adding an answer
- if ($_POST['add_answer'])
- {
- $form_content['answers'][]='';
- }
- // removing an answer
- if ($_POST['remove_answer'])
- {
- $max_answer = count($form_content['answers']);
- unset($form_content['answers'][$max_answer-1]);
- }
- // saving a question
- if ($_POST['save_question'])
- {
- $message = survey_manager::save_question($form_content);
-
- if ($message == 'QuestionAdded' || $message == 'QuestionUpdated' ) {
- if ($config['survey']['debug'])
- {
- Display :: display_header();
- Display :: display_confirmation_message($message.'<br />'.get_lang('ReturnTo').' <a href="survey.php?survey_id='.$_GET['survey_id'].'">'.get_lang('Survey').'</a>', false);
- }
- else
- {
- header('location:survey.php?survey_id='.Security::remove_XSS($_GET['survey_id']).'&message='.$message);
- }
- }
- else
- {
- if ($message == 'PleaseEnterAQuestion' || $message=='PleasFillAllAnswer'){
- $_SESSION['temp_user_message']=$form_content['question'];
- $_SESSION['temp_sys_message']=$message;
- $_SESSION['temp_answers']=$form_content['answers'];
- header('location:question.php?'.api_get_cidreq().'&survey_id='.Security::remove_XSS($_GET['survey_id']).'&action='.Security::remove_XSS($_GET['action']).'&type='.Security::remove_XSS($_GET['type']).'');
- }
-
- }
- }
- /**
- * This solution is a little bit strange but I could not find a different solution.
- */
- if ($_POST['delete_answer'])
- {
- foreach ($_POST['delete_answer'] as $key=>$value)
- {
- unset($form_content['answers'][$key]);
- $deleted = $key;
- }
- foreach ($form_content['answers'] as $key=>$value)
- {
- if ($key>$deleted)
- {
- $form_content['answers'][$key-1] = $form_content['answers'][$key];
- unset($form_content['answers'][$key]);
- }
- }
- }
- return $form_content;
- }
- /**
- * This functions adds two buttons. One to add an option, one to remove an option
- *
- * @param unknown_type $form_content
- * @return html code
- *
- * @author Patrick Cool <patrick.cool@UGent.be>, Ghent University
- * @version January 2007
- */
- function add_remove_buttons($form_content)
- {
- if (count($form_content['answers'])<=2)
- {
- $remove_answer_attribute = 'disabled="disabled"';
- }
- $return .= ' <tr>';
- $return .= ' <td align="right"> </td>';
- $return .= ' <td colspan="2">';
- $return .= ' <input type="submit" name="remove_answer" value="'.get_lang('RemoveAnswer').'" '.$remove_answer_attribute.' />';
- $return .= ' <input type="submit" name="add_answer" value="'.get_lang('AddAnswer').'" />';
- $return .= ' </td>';
- $return .= ' </tr>';
- return $return;
- }
- /**
- * render the question. In this case this starts with the form tag
- *
- * @param unknown_type $form_content
- *
- * @author Patrick Cool <patrick.cool@UGent.be>, Ghent University
- * @version January 2007
- */
- function render_question($form_content)
- {
- $this->html = '<form id="question" name="question" method="post" action="'.api_get_self().'?survey_id='.$_GET['survey_id'].'">';
- echo $this->html;
- }
- }
- class yesno extends question
- {
- /**
- * This function creates the form elements for the yesno questions
- *
- * @author Patrick Cool <patrick.cool@UGent.be>, Ghent University
- * @version January 2007
- */
- function create_form($form_content)
- {
- $this->html = parent::create_form($form_content);
- // Horizontal or vertical
- $this->html .= ' <tr>';
- $this->html .= ' <td colspan="2"><strong>'.get_lang('DisplayAnswersHorVert').'</strong></td>';
- $this->html .= ' </tr>';
- $this->html .= ' <tr>';
- $this->html .= ' <td align="right" valign="top"> </td>';
- $this->html .= ' <td>';
- $this->html .= ' <input name="horizontalvertical" type="radio" value="horizontal" ';
- if ($form_content['horizontalvertical'] == 'horizontal')
- {
- $this->html .= 'checked="checked"';
- }
- $this->html .= '/>'.get_lang('Horizontal').'</label><br />';
- $this->html .= ' <input name="horizontalvertical" type="radio" value="vertical" ';
- if ($form_content['horizontalvertical'] == 'vertical')
- {
- $this->html .= 'checked="checked"';
- }
- $this->html .= ' />'.get_lang('Vertical').'</label>';
- $this->html .= ' </td>';
- $this->html .= ' <td> </td>';
- $this->html .= ' </tr>';
- $this->html .=' <tr>
- <td colspan=""> </td>
- </tr>';
- // The options
- $this->html .= ' <tr>';
- $this->html .= ' <td colspan="3"><strong>'.get_lang('AnswerOptions').'</strong></td>';
- $this->html .= ' </tr>';
- $this->html .= ' <tr>';
- $this->html .= ' <td align="right"><label for="answers[0]">1</label></td>';
- //$this->html .= ' <td><input type="text" name="answers[0]" id="answers[0]" value="'.$form_content['answers'][0].'" /></td>';
- $this->html .= ' <td>'.api_return_html_area('answers[0]', stripslashes($form_content['answers'][0])).'</td>';
- $this->html .= ' <td><input type="image" src="../img/down.gif" value="move_down[0]" name="move_down[0]"/></td>';
- $this->html .= ' </tr>';
- $this->html .= ' <tr>';
- $this->html .= ' <td align="right"><label for="answers[1]">2</label></td>';
- //$this->html .= ' <td><input type="text" name="answers[1]" id="answers[1]" value="'.$form_content['answers'][1].'" /></td>';
- $this->html .= ' <td>'.api_return_html_area('answers[1]', stripslashes($form_content['answers'][1])).'</td>';
- $this->html .= ' <td><input type="image" src="../img/up.gif" value="move_up[1]" name="move_up[1]" /></td>';
- $this->html .= ' </tr>';
- }
- /**
- * Render the yes not question type
- *
- * @param unknown_type $form_content
- *
- * @author Patrick Cool <patrick.cool@UGent.be>, Ghent University
- * @version January 2007
- */
- function render_question($form_content, $answers=array())
- {
- foreach ($form_content['options'] as $key=>$value)
- {
- $this->html .= '<label><input name="question'.$form_content['question_id'].'" type="radio" value="'.$key.'"';
- if (in_array($key,$answers))
- {
- $this->html .= 'checked="checked"';
- }
- $this->html .= '/>'.$value.'</label>';
- if ($form_content['display'] == 'vertical')
- {
- $this->html .= '<br />';
- }
- }
- echo '<div class="survey_question_wrapper">';
- echo '<div class="survey_question">'.$form_content['survey_question'].'</div>';
- echo '<div class="survey_question_options">';
- echo $this->html;
- echo '</div>';
- echo '</div>';
- }
- }
- class multiplechoice extends question
- {
- /**
- * This function creates the form elements for the multiple choice questions
- *
- * @author Patrick Cool <patrick.cool@UGent.be>, Ghent University
- * @version January 2007
- */
- function create_form($form_content)
- {
- $this->html = parent::create_form($form_content);
- $this->html .= ' <tr>';
- $this->html .= ' <td colspan="2"><strong>'.get_lang('DisplayAnswersHorVert').'</strong></td>';
- $this->html .= ' </tr>';
- // Horizontal or vertical
- $this->html .= ' <tr>';
- $this->html .= ' <td align="right" valign="top"> </td>';
- $this->html .= ' <td>';
- $this->html .= ' <input name="horizontalvertical" type="radio" value="horizontal" ';
- if ($form_content['horizontalvertical'] == 'horizontal')
- {
- $this->html .= 'checked="checked"';
- }
- $this->html .= '/>'.get_lang('Horizontal').'</label><br />';
- $this->html .= ' <input name="horizontalvertical" type="radio" value="vertical" ';
- if ($form_content['horizontalvertical'] == 'vertical')
- {
- $this->html .= 'checked="checked"';
- }
- $this->html .= ' />'.get_lang('Vertical').'</label>'; $this->html .= ' </td>';
- $this->html .= ' <td> </td>';
- $this->html .= ' </tr>';
- $this->html .=' <tr>
- <td colspan=""> </td>
- </tr>';
- // The Options
- $this->html .= ' <tr>';
- $this->html .= ' <td colspan="3"><strong>'.get_lang('AnswerOptions').'</strong></td>';
- $this->html .= ' </tr>';
- $total_number_of_answers = count($form_content['answers']);
- foreach ($form_content['answers'] as $key=>$value)
- {
- $this->html .= ' <tr>';
- $this->html .= ' <td align="right"><label for="answers['.$key.']">'.($key+1).'</label></td>';
- //$this->html .= ' <td><input type="text" name="answers['.$key.']" id="answers['.$key.']" value="'.$form_content['answers'][$key].'" /></td>';
- $this->html .= ' <td width="500">'.api_return_html_area('answers['.$key.']', html_entity_decode(stripslashes($form_content['answers'][$key]))).'</td>';
- $this->html .= ' <td>';
- if ($key<$total_number_of_answers-1)
- {
- $this->html .= ' <input type="image" src="../img/down.gif" value="move_down['.$key.']" name="move_down['.$key.']"/>';
- }
- else
- {
- $this->html .= ' <img src="../img/spacer.gif" alt="'.get_lang('Empty').'" title="'.get_lang('Empty').'" />';
- }
- if ($key>0)
- {
- $this->html .= ' <input type="image" src="../img/up.gif" value="move_up['.$key.']" name="move_up['.$key.']"/>';
- }
- else
- {
- $this->html .= ' <img src="../img/spacer.gif" alt="'.get_lang('Empty').'" title="'.get_lang('Empty').'" />';
- }
- if ($total_number_of_answers> 2)
- {
- $this->html .= ' <input type="image" src="../img/delete.gif" value="delete_answer['.$key.']" name="delete_answer['.$key.']"/>';
- }
- $this->html .= ' </td>';
- $this->html .= ' </tr>';
- }
- // The buttons for adding or removing
- $this->html .= parent :: add_remove_buttons($form_content);
- }
- /**
- * render the multiple choice question type
- *
- * @param unknown_type $form_content
- *
- * @todo it would make more sense to consider yesno as a special case of multiplechoice and not the other way around
- *
- * @author Patrick Cool <patrick.cool@UGent.be>, Ghent University
- * @version January 2007
- */
- function render_question($form_content, $answers=array())
- {
- $question = new yesno();
- $question->render_question($form_content, $answers);
- }
- }
- class multipleresponse extends question
- {
- /**
- * This function creates the form elements for the multiple response questions
- *
- * @author Patrick Cool <patrick.cool@UGent.be>, Ghent University
- * @version January 2007
- */
- function create_form($form_content)
- {
- $this->html = parent::create_form($form_content);
- $this->html .= ' <tr>';
- $this->html .= ' <td colspan="2"><strong>'.get_lang('DisplayAnswersHorVert').'</strong></td>';
- $this->html .= ' </tr>';
- // Horizontal or vertical
- $this->html .= ' <tr>';
- $this->html .= ' <td align="right" valign="top"> </td>';
- $this->html .= ' <td>';
- $this->html .= ' <input name="horizontalvertical" type="radio" value="horizontal" ';
- if ($form_content['horizontalvertical'] == 'horizontal')
- {
- $this->html .= 'checked="checked"';
- }
- $this->html .= '/>'.get_lang('Horizontal').'</label><br />';
- $this->html .= ' <input name="horizontalvertical" type="radio" value="vertical" ';
- if ($form_content['horizontalvertical'] == 'vertical')
- {
- $this->html .= 'checked="checked"';
- }
- $this->html .= ' />'.get_lang('Vertical').'</label>'; $this->html .= ' </td>';
- $this->html .= ' <td> </td>';
- $this->html .= ' </tr>';
- $this->html .=' <tr>
- <td colspan=""> </td>
- </tr>';
- // The options
- $this->html .= ' <tr>';
- $this->html .= ' <td colspan="3"><strong>'.get_lang('AnswerOptions').'</strong></td>';
- $this->html .= ' </tr>';
- $total_number_of_answers = count($form_content['answers']);
- foreach ($form_content['answers'] as $key=>$value)
- {
- $this->html .= ' <tr>';
- $this->html .= ' <td align="right"><label for="answers['.$key.']">'.($key+1).'</label></td>';
- //$this->html .= ' <td><input type="text" name="answers['.$key.']" id="answers['.$key.']" value="'.$form_content['answers'][$key].'" /></td>';
- $this->html .= ' <td width="500">'.api_return_html_area('answers['.$key.']', html_entity_decode(stripslashes($form_content['answers'][$key]))).'</td>';
- $this->html .= ' <td>';
- if ($key<$total_number_of_answers-1)
- {
- $this->html .= ' <input type="image" src="../img/down.gif" value="move_down['.$key.']" name="move_down['.$key.']"/>';
- }
- else
- {
- $this->html .= ' <img src="../img/spacer.gif" alt="'.get_lang('Empty').'" title="'.get_lang('Empty').'" />';
- }
- if ($key>0)
- {
- $this->html .= ' <input type="image" src="../img/up.gif" value="move_up['.$key.']" name="move_up['.$key.']"/>';
- }
- else
- {
- $this->html .= ' <img src="../img/spacer.gif" alt="'.get_lang('Empty').'" title="'.get_lang('Empty').'" />';
- }
- if ($total_number_of_answers> 2)
- {
- $this->html .= ' <input type="image" src="../img/delete.gif" value="delete_answer['.$key.']" name="delete_answer['.$key.']"/>';
- }
- $this->html .= ' </td>';
- $this->html .= ' </tr>';
- }
- // The buttons for adding or removing
- $this->html .= parent :: add_remove_buttons($form_content);
- }
- /**
- * Render the multiple response question type
- *
- * @param unknown_type $form_content
- *
- * @author Patrick Cool <patrick.cool@UGent.be>, Ghent University
- * @version January 2007
- */
- function render_question($form_content, $answers=array())
- {
- foreach ($form_content['options'] as $key=>$value)
- {
- $this->html .= '<label><input name="question'.$form_content['question_id'].'[]" type="checkbox" value="'.$key.'"';
- if (in_array($key,$answers))
- {
- $this->html .= 'checked="checked"';
- }
- $this->html .= ' />'.$value.'</label>';
- if ($form_content['display'] == 'vertical')
- {
- $this->html .= '<br />';
- }
- }
- echo '<div class="survey_question_wrapper">';
- echo '<div class="survey_question">'.$form_content['survey_question'].'</div>';
- echo '<div class="survey_question_options">';
- echo $this->html;
- echo '</div>';
- }
- }
- class dropdown extends question
- {
- /**
- * This function creates the form elements for the dropdown questions
- *
- * @author Patrick Cool <patrick.cool@UGent.be>, Ghent University
- * @version January 2007
- */
- function create_form($form_content)
- {
- $this->html = parent::create_form($form_content);
- // The answers
- $this->html .= ' <tr>';
- $this->html .= ' <td colspan="3"><strong>'.get_lang('AnswerOptions').'</strong></td>';
- $this->html .= ' </tr>';
- $total_number_of_answers = count($form_content['answers']);
- foreach ($form_content['answers'] as $key=>$value)
- {
- $this->html .= ' <tr>';
- $this->html .= ' <td align="right"><label for="answers['.$key.']">'.($key+1).'</label></td>';
- $this->html .= ' <td><input type="text" name="answers['.$key.']" id="answers['.$key.']" value="'.stripslashes(htmlentities($form_content['answers'][$key])).'" /></td>';
- $this->html .= ' <td>';
- if ($key<$total_number_of_answers-1)
- {
- $this->html .= ' <input type="image" src="../img/down.gif" value="move_down['.$key.']" name="move_down['.$key.']"/>';
- }
- if ($key>0)
- {
- $this->html .= ' <input type="image" src="../img/up.gif" value="move_up['.$key.']" name="move_up['.$key.']"/>';
- }
- if ($total_number_of_answers> 2)
- {
- $this->html .= ' <input type="image" src="../img/delete.gif" value="delete_answer['.$key.']" name="delete_answer['.$key.']"/>';
- }
- $this->html .= ' </td>';
- $this->html .= ' </tr>';
- }
- // The buttons for adding or removing
- $this->html .= parent :: add_remove_buttons($form_content);
- }
- /**
- * Render the dropdown question type
- *
- * @param unknown_type $form_content
- *
- * @author Patrick Cool <patrick.cool@UGent.be>, Ghent University
- * @version January 2007
- */
- function render_question($form_content, $answers=array())
- {
- foreach ($form_content['options'] as $key=>$value)
- {
- $this->html .= '<option value="'.$key.'" ';
- if (in_array($key,$answers))
- {
- $this->html .= 'selected="selected"';
- }
- $this->html .= '>'.$value.'</option>';
- }
- echo '<div class="survey_question_wrapper">';
- echo '<div class="survey_question">'.$form_content['survey_question'].'</div>';
- echo '<div class="survey_question_options">';
- echo '<select name="question'.$form_content['question_id'].'" id="select">';
- echo $this->html;
- echo '</select>';
- echo '</div>';
- /*
- <option value="test">test</option>
- */
- }
- }
- class open extends question
- {
- /**
- * This function creates the form elements for the open questions
- *
- * @author Patrick Cool <patrick.cool@UGent.be>, Ghent University
- * @version January 2007
- *
- * @todo add a limit for the number of characters that can be type
- * @todo add a checkbox weither the answer is a textarea or a wysiwyg editor
- */
- function create_form($form_content)
- {
- $this->html = parent::create_form($form_content);
- }
- /**
- * render the open question type
- *
- * @param unknown_type $form_content
- *
- * @author Patrick Cool <patrick.cool@UGent.be>, Ghent University
- * @version January 2007
- */
- function render_question($form_content, $answers=array())
- {
- echo '<div class="survey_question_wrapper">';
- echo '<div class="survey_question">'.$form_content['survey_question'].'</div>';
- echo '<div class="survey_question_options">';
- if (is_array($answers))
- {
- $content = implode('',$answers);
- }
- else
- {
- $content = $answers;
- }
- echo '<label for="question'.$form_content['question_id'].'"></label><textarea name="question'.$form_content['question_id'].'" id="textarea" style="width: 400px; height: 130px;">'.$content.'</textarea>';
- echo '</div>';
- }
- }
- class comment extends question
- {
- /**
- * This function creates the form elements for a comment.
- * A comment is nothing more than a block of text that the user can read
- *
- * @author Patrick Cool <patrick.cool@UGent.be>, Ghent University
- * @version January 2007
- *
- * @param array $form_content
- */
- function create_form($form_content)
- {
- $this->html = parent::create_form($form_content);
- }
- /**
- * Render the comment "question" type
- *
- * @param unknown_type $form_content
- *
- * @author Patrick Cool <patrick.cool@UGent.be>, Ghent University
- * @version January 2007
- */
- function render_question($form_content)
- {
- echo '<div class="survey_question_wrapper">';
- echo '<div class="survey_question">'.$form_content['survey_question'].'</div>';
- echo '</div>';
- echo "\n";
- }
- }
- class pagebreak extends question
- {
- /**
- * This function creates the form elements for a comment.
- * A comment is nothing more than a block of text that the user can read
- *
- * @author Patrick Cool <patrick.cool@UGent.be>, Ghent University
- * @version January 2007
- *
- * @param array $form_content
- */
- function create_form($form_content)
- {
- $this->html = parent::create_form($form_content);
- }
- }
- class percentage extends question
- {
- function create_form($form_content)
- {
- $this->html = parent::create_form($form_content);
- }
- function render_question($form_content, $answers=array())
- {
- $this->html .= '<option value="--">--</option>';
- foreach ($form_content['options'] as $key=>$value)
- {
- $this->html .= '<option value="'.$key.'" ';
- if (in_array($key,$answers))
- {
- $this->html .= 'selected="selected"';
- }
- $this->html .= '>'.$value.'</option>';
- }
- echo '<div class="survey_question_wrapper">';
- echo '<div class="survey_question">'.$form_content['survey_question'].'</div>';
- echo '<div class="survey_question_options">';
- echo '<select name="question'.$form_content['question_id'].'" id="select">';
- echo $this->html;
- echo '</select>';
- echo '</div>';
- }
- }
- class score extends question
- {
- function create_form($form_content)
- {
- $this->html = parent::create_form($form_content);
- // the maximum score that can be given
- $this->html .= ' <tr>';
- $this->html .= ' <td colspan="3"><strong>'.get_lang('MaximumScore').'</strong></td>';
- $this->html .= ' </tr>';
- $this->html .= ' <tr>
- <td colspan="3"><input type="text" name="maximum_score" value="'.$form_content['maximum_score'].'"></td>
- </tr>';
- // The answers
- $this->html .= ' <tr>';
- $this->html .= ' <td colspan="3"><strong>'.get_lang('AnswerOptions').'</strong></td>';
- $this->html .= ' </tr>';
- $total_number_of_answers = count($form_content['answers']);
- foreach ($form_content['answers'] as $key=>$value)
- {
- $this->html .= ' <tr>';
- $this->html .= ' <td align="right"><label for="answers['.$key.']">'.($key+1).'</label></td>';
- //$this->html .= ' <td><input type="text" name="answers['.$key.']" id="answers['.$key.']" value="'.$form_content['answers'][$key].'" /></td>';
- $this->html .= ' <td width="500">'.api_return_html_area('answers['.$key.']', stripslashes($form_content['answers'][$key])).'</td>';
- $this->html .= ' <td>';
- if ($key<$total_number_of_answers-1)
- {
- $this->html .= ' <input type="image" src="../img/down.gif" value="move_down['.$key.']" name="move_down['.$key.']"/>';
- }
- if ($key>0)
- {
- $this->html .= ' <input type="image" src="../img/up.gif" value="move_up['.$key.']" name="move_up['.$key.']"/>';
- }
- if ($total_number_of_answers> 2)
- {
- $this->html .= ' <input type="image" src="../img/delete.gif" value="delete_answer['.$key.']" name="delete_answer['.$key.']"/>';
- }
- $this->html .= ' </td>';
- $this->html .= ' </tr>';
- }
- // The buttons for adding or removing
- $this->html .= parent :: add_remove_buttons($form_content);
- }
- function render_question($form_content, $answers=array())
- {
- /*
- echo '<div style="border: 1px solid red;">';
- echo '<pre>';
- print_r($answers);
- echo '</pre></div>';
- */
- $this->html = '<table>';
- foreach ($form_content['options'] as $key=>$value)
- {
- $this->html .= '<tr>
- <td>'.$value.'</td>';
- $this->html .= ' <td>';
- $this->html .= '<select name="question'.$form_content['question_id'].'['.$key.']">';
- $this->html .= '<option value="--">--</option>';
- for($i=1; $i<=$form_content['maximum_score']; $i++)
- {
- $this->html .= '<option value="'.$i.'"';
- if ($answers[$key] == $i)
- {
- $this->html .= 'selected="selected" ';
- }
- $this->html .= '>'.$i.'</option>';
- }
- $this->html .= '</select>';
- $this->html .= ' </td>';
- $this->html .= '</tr>';
- }
- $this->html .= '</table>';
- echo '<div class="survey_question_wrapper">';
- echo '<div class="survey_question">'.$form_content['survey_question'].'</div>';
- echo '<div class="survey_question_options">';
- //echo '<select name="question'.$form_content['question_id'].'" id="select">';
- echo $this->html;
- //echo '</select>';
- echo '</div>';
- }
- }
- /**
- * This class offers a series of general utility functions for survey querying and display
- * @package dokeos.survey
- */
- class SurveyUtil {
- /**
- * Checks whether the given survey has a pagebreak question as the first or the last question.
- * If so, break the current process, displaying an error message
- * @param integer Survey ID (database ID)
- * @param boolean Optional. Whether to continue the current process or exit when breaking condition found. Defaults to true (do not break).
- * @return void
- */
- function check_first_last_question($survey_id, $continue=true)
- {
- // table definitions
- $tbl_survey_question = Database :: get_course_table(TABLE_SURVEY_QUESTION);
- $table_survey_question_option = Database :: get_course_table(TABLE_SURVEY_QUESTION_OPTION);
-
- // getting the information of the question
- $sql = "SELECT * FROM $tbl_survey_question WHERE survey_id='".Database::escape_string($survey_id)."' ORDER BY sort ASC";
- $result = api_sql_query($sql, __FILE__, __LINE__);
- $total = Database::num_rows($result);
- $counter=1;
- $error = false;
- while ($row = Database::fetch_array($result,'ASSOC'))
- {
- if ($counter == 1 AND $row['type'] == 'pagebreak')
- {
- Display::display_error_message(get_lang('PagebreakNotFirst'), false);
- $error = true;
- }
- if ($counter == $total AND $row['type'] == 'pagebreak')
- {
- Display::display_error_message(get_lang('PagebreakNotLast'), false);
- $error = true;
- }
- $counter++;
- }
-
- if (!$continue AND $error)
- {
- Display::display_footer();
- exit;
- }
- }
- /**
- * This function removes an (or multiple) answer(s) of a user on a question of a survey
- *
- * @param mixed The user id or email of the person who fills the survey
- * @param integer The survey id
- * @param integer The question id
- * @param integer The option id
- *
- * @author Patrick Cool <patrick.cool@UGent.be>, Ghent University
- * @version January 2007
- */
- function remove_answer($user, $survey_id, $question_id)
- {
- global $_course;
- // table definition
- $table_survey_answer = Database :: get_course_table(TABLE_SURVEY_ANSWER, $_course['db_name']);
- $sql = "DELETE FROM $table_survey_answer
- WHERE user = '".Database::escape_string($user)."'
- AND survey_id = '".Database::escape_string($survey_id)."'
- AND question_id = '".Database::escape_string($question_id)."'";
- $result = api_sql_query($sql, __FILE__, __LINE__);
- }
- /**
- * This function stores an answer of a user on a question of a survey
- *
- * @param mixed The user id or email of the person who fills the survey
- * @param integer Survey id
- * @param integer Question id
- * @param integer Option id
- * @param string Option value
- * @param array Survey data settings
- *
- * @author Patrick Cool <patrick.cool@UGent.be>, Ghent University
- * @version January 2007
- */
- function store_answer($user, $survey_id, $question_id, $option_id, $option_value, $survey_data)
- {
- global $_course;
- global $types;
- // table definition
- $table_survey_answer = Database :: get_course_table(TABLE_SURVEY_ANSWER, $_course['db_name']);
-
- // make the survey anonymous
- if ($survey_data['anonymous'] == 1)
- {
- if (!$_SESSION['surveyuser'])
- {
- $user = md5($user.time());
- $_SESSION['surveyuser'] = $user;
- }
- else
- {
- $user = $_SESSION['surveyuser'];
- }
- }
- $sql = "INSERT INTO $table_survey_answer (user, survey_id, question_id, option_id, value) VALUES (
- '".Database::escape_string($user)."',
- '".Database::escape_string($survey_id)."',
- '".Database::escape_string($question_id)."',
- '".Database::escape_string($option_id)."',
- '".Database::escape_string($option_value)."'
- )";
- $result = api_sql_query($sql, __FILE__, __LINE__);
- }
- /**
- * This function checks the parameters that are used in this page
- *
- * @return string The header, an error and the footer if any parameter fails, else it returns true
- * @author Patrick Cool <patrick.cool@UGent.be>, Ghent University
- * @version February 2007
- */
- function check_parameters()
- {
- $error = false;
-
- // getting the survey data
- $survey_data = survey_manager::get_survey($_GET['survey_id']);
-
- // $_GET['survey_id'] has to be numeric
- if (!is_numeric($_GET['survey_id']))
- {
- $error = get_lang('IllegalSurveyId');
- }
-
- // $_GET['action']
- $allowed_actions = array('overview', 'questionreport', 'userreport', 'comparativereport', 'completereport');
- if (isset($_GET['action']) AND !in_array($_GET['action'], $allowed_actions))
- {
- $error = get_lang('ActionNotAllowed');
- }
-
- // user report
- if ($_GET['action'] == 'userreport')
- {
- global $people_filled;
- if ($survey_data['anonymous'] == 0)
- {
- $people_filled_full_data = true;
- }
- else
- {
- $people_filled_full_data = false;
- }
- $people_filled = survey_manager::get_people_who_filled_survey($_GET['survey_id'], $people_filled_full_data);
- if ($survey_data['anonymous'] == 0)
- {
- foreach ($people_filled as $key=>$value)
- {
- $people_filled_userids[]=$value['invited_user'];
- }
- }
- else
- {
- $people_filled_userids = $people_filled;
- }
-
- if (isset($_GET['user']) AND !in_array($_GET['user'], $people_filled_userids))
- {
- $error = get_lang('UnknowUser');
- }
- }
-
- // question report
- if ($_GET['action'] == 'questionreport')
- {
- if (isset($_GET['question'])AND !is_numeric($_GET['question']))
- {
- $error = get_lang('UnknowQuestion');
- }
- }
-
- if ($error)
- {
- $tool_name = get_lang('Reporting');
- Display::display_header($tool_name);
- Display::display_error_message(get_lang('Error').': '.$error, false);
- Display::display_footer();
- exit;
- }
- else
- {
- return true;
- }
- }
-
- /**
- * This function deals with the action handling
- * @return void
- * @author Patrick Cool <patrick.cool@UGent.be>, Ghent University
- * @version February 2007
- */
- function handle_reporting_actions()
- {
- // getting the number of question
- $temp_questions_data = survey_manager::get_questions($_GET['survey_id']);
-
- // sorting like they should be displayed and removing the non-answer question types (comment and pagebreak)
- foreach ($temp_questions_data as $key=>$value)
- {
- if ($value['type'] <> 'comment' AND $value['type']<>'pagebreak')
- {
- $questions_data[$value['sort']]=$value;
- }
- }
-
- // counting the number of questions that are relevant for the reporting
- $survey_data['number_of_questions'] = count($questions_data);
-
- if ($_GET['action'] == 'questionreport')
- {
- SurveyUtil::display_question_report($survey_data);
- }
- if ($_GET['action'] == 'userreport')
- {
- SurveyUtil::display_user_report();
- }
- if ($_GET['action'] == 'comparativereport')
- {
- SurveyUtil::display_comparative_report();
- }
- if ($_GET['action'] == 'completereport')
- {
- SurveyUtil::display_complete_report();
- }
- }
-
- /**
- * This function displays the user report which is basically nothing more than a one-page display of all the questions
- * of the survey that is filled with the answers of the person who filled the survey.
- *
- * @return string html code of the one-page survey with the answers of the selected user
- * @author Patrick Cool <patrick.cool@UGent.be>, Ghent University
- * @version February 2007 - Updated March 2008
- */
- function display_user_report()
- {
- global $people_filled, $survey_data;
-
- // Database table definitions
- $table_survey_question = Database :: get_course_table(TABLE_SURVEY_QUESTION);
- $table_survey_question_option = Database :: get_course_table(TABLE_SURVEY_QUESTION_OPTION);
- $table_survey_answer = Database :: get_course_table(TABLE_SURVEY_ANSWER);
-
- // step 1: selection of the user
- echo "<script language=\"JavaScript\" type=\"text/JavaScript\">
- <!--
- function jumpMenu(targ,selObj,restore)
- {
- eval(targ+\".location='\"+selObj.options[selObj.selectedIndex].value+\"'\");
- if (restore) selObj.selectedIndex=0;
- }
- //-->
- </script>
- ";
- echo get_lang('SelectUserWhoFilledSurvey').'<br />';
- echo '<select name="user" onchange="jumpMenu(\'parent\',this,0)">';
- echo '<option value="reporting.php?action='.Security::remove_XSS($_GET['action']).'&survey_id='.Security::remove_XSS($_GET['survey_id']).'">'.get_lang('SelectUser').'</option>';
-
- foreach ($people_filled as $key=>$person)
- {
- if ($survey_data['anonymous'] == 0)
- {
- $name = $person['firstname'].' '.$person['lastname'];
- $id = $person['user_id'];
- }
- else
- {
- $name = $key+1;
- $id = $person;
- }
- echo '<option value="reporting.php?action='.Security::remove_XSS($_GET['action']).'&survey_id='.Security::remove_XSS($_GET['survey_id']).'&user='.$id.'" ';
- if ($_GET['user'] == $person)
- {
- echo 'selected="selected"';
- }
- echo '>'.$name.'</option>';
- }
- echo '</select>';
-
- // step 2: displaying the survey and the answer of the selected users
- if (isset($_GET['user']))
- {
- Display::display_normal_message(get_lang('AllQuestionsOnOnePage'), false);
-
- // getting all the questions and options
- $sql = "SELECT survey_question.question_id, survey_question.survey_id, survey_question.survey_question, survey_question.display, survey_question.max_value, survey_question.sort, survey_question.type,
- survey_question_option.question_option_id, survey_question_option.option_text, survey_question_option.sort as option_sort
- FROM $table_survey_question survey_question
- LEFT JOIN $table_survey_question_option survey_question_option
- ON survey_question.question_id = survey_question_option.question_id
- WHERE survey_question.survey_id = '".Database::escape_string($_GET['survey_id'])."'
- ORDER BY survey_question.sort ASC";
- $result = api_sql_query($sql, __FILE__, __LINE__);
- while ($row = mysql_fetch_assoc($result))
- {
- if($row['type'] <> 'pagebreak')
- {
- $questions[$row['sort']]['question_id'] = $row['question_id'];
- $questions[$row['sort']]['survey_id'] = $row['survey_id'];
- $questions[$row['sort']]['survey_question'] = $row['survey_question'];
- $questions[$row['sort']]['display'] = $row['display'];
- $questions[$row['sort']]['type'] = $row['type'];
- $questions[$row['sort']]['maximum_score'] = $row['max_value'];
- $questions[$row['sort']]['options'][$row['question_option_id']] = $row['option_text'];
- }
- }
-
- // getting all the answers of the user
- $sql = "SELECT * FROM $table_survey_answer WHERE survey_id = '".Database::escape_string($_GET['survey_id'])."' AND user = '".Database::escape_string($_GET['user'])."'";
- $result = api_sql_query($sql, __FILE__, __LINE__);
- while ($row = mysql_fetch_assoc($result))
- {
- $answers[$row['question_id']][] = $row['option_id'];
- $all_answers[$row['question_id']][] = $row;
- }
- // displaying all the questions
- foreach ($questions as $key=>$question)
- {
- // if the question type is a scoring then we have to format the answers differently
- if ($question['type'] == 'score')
- {
- foreach($all_answers[$question['question_id']] as $key=>$answer_array)
- {
- $second_parameter[$answer_array['option_id']] = $answer_array['value'];
- }
- }
- else
- {
- $second_parameter = $answers[$question['question_id']];
- if ($question['type'] == 'open')
- {
- $second_parameter = array();
- $second_parameter[] = $all_answers[$question['question_id']][0]['option_id'];
- }
- }
- $display = new $question['type'];
- $display->render_question($question, $second_parameter);
- }
- }
- }
-
- /**
- * This function displays the report by question.
- *
- * It displays a table with all the options of the question and the number of users who have answered positively on the option.
- * The number of users who answered positive on a given option is expressed in an absolute number, in a percentage of the total
- * and graphically using bars
- * By clicking on the absolute number you get a list with the persons who have answered this.
- * You can then click on the name of the person and you will then go to the report by user where you see all the
- * answers of that user.
- *
- * @param array All the survey data
- * @return string html code that displays the report by question
- * @todo allow switching between horizontal and vertical.
- * @todo multiple response: percentage are probably not OK
- * @todo the question and option text have to be shortened and should expand when the user clicks on it.
- * @todo the pagebreak and comment question types should not be shown => removed from $survey_data before
- * @author Patrick Cool <patrick.cool@UGent.be>, Ghent University
- * @version February 2007 - Updated March 2008
- */
- function display_question_report($survey_data)
- {
- // Database table definitions
- $table_survey_question = Database :: get_course_table(TABLE_SURVEY_QUESTION);
- $table_survey_question_option = Database :: get_course_table(TABLE_SURVEY_QUESTION_OPTION);
- $table_survey_answer = Database :: get_course_table(TABLE_SURVEY_ANSWER);
-
- // determining the offset of the sql statement (the n-th question of the survey)
- if (!isset($_GET['question']))
- {
- $offset = 0;
- }
- else
- {
- $offset = Database::escape_string($_GET['question']);
- }
-
- echo '<div id="question_report_questionnumbers">';
- for($i=1; $i<=($survey_data['number_of_questions']); $i++ )
- {
- if ($offset <> $i-1)
- {
- echo '<a href="reporting.php?action=questionreport&survey_id='.(int)$_GET['survey_id'].'&question='.($i-1).'">'.$i.'</a>';
- }
- else
- {
- echo $i;
- }
- if ($i < $survey_data['number_of_questions'])
- {
- echo ' | ';
- }
- }
- echo '</div>';
-
- // getting the question information
- $sql = "SELECT * FROM $table_survey_question WHERE survey_id='".Database::escape_string($_GET['survey_id'])."' AND type<>'pagebreak' AND type<>'comment' ORDER BY sort ASC LIMIT ".$offset.",1";
- $result = api_sql_query($sql, __FILE__, __LINE__);
- $question = Database::fetch_array($result);
-
- // navigate through the questions (next and previous)
- if ($_GET['question'] <> 0)
- {
- echo '<a href="reporting.php?action='.Security::remove_XSS($_GET['action']).'&survey_id='.$_GET['survey_id'].'&question='.Security::remove_XSS($offset-1).'"> << '.get_lang('PreviousQuestion').'</a> ';
- }
- else
- {
- echo '<<'.get_lang('PreviousQuestion').' ';
- }
- echo ' | ';
- if ($_GET['question'] < ($survey_data['number_of_questions']-1))
- {
- echo '<a href="reporting.php?action='.$_GET['action'].'&survey_id='.Security::remove_XSS($_GET['survey_id']).'&question='.Security::remove_XSS($offset+1).'">'.get_lang('NextQuestion').'>> </a>';
- }
- else
- {
- echo get_lang('NextQuestion'). '>>';
- }
- echo '<br />';
-
- echo $question['survey_question'];
-
- echo '<br />';
-
- if ($question['type'] == 'score')
- {
- /** @todo this function should return the options as this is needed further in the code */
- $options = SurveyUtil::display_question_report_score($survey_data, $question, $offset);
- }
- elseif ($question['type'] == 'open')
- {
- /** @todo also get the user who has answered this */
- $sql = "SELECT * FROM $table_survey_answer WHERE survey_id='".Database::escape_string($_GET['survey_id'])."'
- AND question_id = '".Database::escape_string($question['question_id'])."'";
- $result = api_sql_query($sql, __FILE__, __LINE__);
- while ($row = Database::fetch_array($result))
- {
- echo $row['option_id'].'<hr noshade="noshade" size="1" />';
- }
-
- }
- else
- {
- // getting the options
- $sql = "SELECT * FROM $table_survey_question_option
- WHERE survey_id='".Database::escape_string($_GET['survey_id'])."'
- AND question_id = '".Database::escape_string($question['question_id'])."'
- ORDER BY sort ASC";
- $result = api_sql_query($sql, __FILE__, __LINE__);
- while ($row = Database::fetch_array($result))
- {
- $options[$row['question_option_id']] = $row;
- }
- // getting the answers
- $sql = "SELECT *, count(answer_id) as total FROM $table_survey_answer
- WHERE survey_id='".Database::escape_string($_GET['survey_id'])."'
- AND question_id = '".Database::escape_string($question['question_id'])."'
- GROUP BY option_id, value";
- $result = api_sql_query($sql, __FILE__, __LINE__);
- while ($row = Database::fetch_array($result))
- {
- $number_of_answers += $row['total'];
- $data[$row['option_id']] = $row;
- }
- //echo '<pre>';
- //print_r($data);
- //echo '<pre>';
-
- // displaying the table: headers
- echo '<table>';
- echo ' <tr>';
- echo ' <th> </th>';
- echo ' <th>'.get_lang('AbsoluteTotal').'</th>';
- echo ' <th>'.get_lang('Percentage').'</th>';
- echo ' <th>'.get_lang('VisualRepresentation').'</th>';
- echo ' <tr>';
-
-
- // displaying the table: the content
- foreach ($options as $key=>$value)
- {
- $absolute_number = $data[$value['question_option_id']]['total'];
- if($number_of_answers == 0)
- {
- $answers_number = 0;
- }
- else
- {
- $answers_number = $absolute_number/$number_of_answers*100;
- }
- echo ' <tr>';
- echo ' <td>'.$value['option_text'].'</td>';
- echo ' <td align="right"><a href="reporting.php?action='.Security::remove_XSS($_GET['action']).'&survey_id='.Security::remove_XSS($_GET['survey_id']).'&question='.Security::remove_XSS($offset).'&viewoption='.$value['question_option_id'].'">'.$absolute_number.'</a></td>';
- echo ' <td align="right">'.round($answers_number, 2).' %</td>';
- echo ' <td align="right">';
- $size = $answers_number*2;
- if ($size > 0)
- {
- echo '<div style="border:1px solid #264269; background-color:#aecaf4; height:10px; width:'.$size.'px"> </div>';
- }
- echo ' </td>';
- echo ' </tr>';
- }
-
- // displaying the table: footer (totals)
- echo ' <tr>';
- echo ' <td style="border-top:1px solid black;"><b>'.get_lang('Total').'</b></td>';
- echo ' <td style="border-top:1px solid black;" align="right"><b>'.($number_of_answers==0?'0':$number_of_answers).'</b></td>';
- echo ' <td style="border-top:1px solid black;"> </td>';
- echo ' <td style="border-top:1px solid black;"> </td>';
- echo ' </tr>';
-
- echo '</table>';
- }
-
- if (isset($_GET['viewoption']))
- {
- echo get_lang('PeopleWhoAnswered').': '.$options[$_GET['viewoption']]['option_text'].'<br />';
-
- if (is_numeric($_GET['value']))
- {
- $sql_restriction = "AND value='".Database::escape_string($_GET['value'])."'";
- }
-
- $sql = "SELECT user FROM $table_survey_answer WHERE option_id = '".Database::escape_string($_GET['viewoption'])."' $sql_restriction";
- $result = api_sql_query($sql, __FILE__, __LINE__);
- while ($row = Database::fetch_array($result))
- {
- echo '<a href="reporting.php?action=userreport&survey_id='.Security::remove_XSS($_GET['survey_id']).'&user='.$row['user'].'">'.$row['user'].'</a><br />';
- }
- }
- }
- /**
- * Display score data about a survey question
- * @param array Question info
- * @param integer The offset of results shown
- * @return void (direct output)
- */
- function display_question_report_score($survey_data, $question, $offset)
- {
- // Database table definitions
- $table_survey_question = Database :: get_course_table(TABLE_SURVEY_QUESTION);
- $table_survey_question_option = Database :: get_course_table(TABLE_SURVEY_QUESTION_OPTION);
- $table_survey_answer = Database :: get_course_table(TABLE_SURVEY_ANSWER);
-
- // getting the options
- $sql = "SELECT * FROM $table_survey_question_option
- WHERE survey_id='".Database::escape_string($_GET['survey_id'])."'
- AND question_id = '".Database::escape_string($question['question_id'])."'
- ORDER BY sort ASC";
- $result = api_sql_query($sql, __FILE__, __LINE__);
- while ($row = Database::fetch_array($result))
- {
- $options[$row['question_option_id']] = $row;
- }
-
- // getting the answers
- $sql = "SELECT *, count(answer_id) as total FROM $table_survey_answer
- WHERE survey_id='".Database::escape_string($_GET['survey_id'])."'
- AND question_id = '".Database::escape_string($question['question_id'])."'
- GROUP BY option_id, value";
- $result = api_sql_query($sql, __FILE__, __LINE__);
- while ($row = Database::fetch_array($result))
- {
- $number_of_answers += $row['total'];
- $data[$row['option_id']][$row['value']] = $row;
- }
- // displaying the table: headers
- echo '<table>';
- echo ' <tr>';
- echo ' <th> </th>';
- echo ' <th>'.get_lang('Score').'</th>';
- echo ' <th>'.get_lang('AbsoluteTotal').'</th>';
- echo ' <th>'.get_lang('Percentage').'</th>';
- echo ' <th>'.get_lang('VisualRepresentation').'</th>';
- echo ' <tr>';
- // displaying the table: the content
- foreach ($options as $key=>$value)
- {
- for ($i=1; $i<=$question['max_value']; $i++)
- {
- $absolute_number = $data[$value['question_option_id']][$i]['total'];
-
- echo ' <tr>';
- echo ' <td>'.$value['option_text'].'</td>';
- echo ' <td>'.$i.'</td>';
- echo ' <td><a href="reporting.php?action='.Security::remove_XSS($_GET['action']).'&survey_id='.Security::remove_XSS($_GET['survey_id']).'&question='.Security::remove_XSS($offset).'&viewoption='.$value['question_option_id'].'&value='.$i.'">'.$absolute_number.'</a></td>';
- echo ' <td>'.round($absolute_number/$number_of_answers*100, 2).' %</td>';
- echo ' <td>';
- $size = ($absolute_number/$number_of_answers*100*2);
- if ($size > 0)
- {
- echo ' <div style="border:1px solid #264269; background-color:#aecaf4; height:10px; width:'.$size.'px"> </div>';
- }
- echo ' </td>';
- echo ' </tr>';
- }
- }
- // displaying the table: footer (totals)
- echo ' <tr>';
- echo ' <td style="border-top:1px solid black"><b>'.get_lang('Total').'</b></td>';
- echo ' <td style="border-top:1px solid black"> </td>';
- echo ' <td style="border-top:1px solid black"><b>'.$number_of_answers.'</b></td>';
- echo ' <td style="border-top:1px solid black"> </td>';
- echo ' <td style="border-top:1px solid black"> </td>';
- echo ' </tr>';
-
- echo '</table>';
- }
-
- /**
- * This functions displays the complete reporting
- * @return string HTML code
- * @todo open questions are not in the complete report yet.
- * @author Patrick Cool <patrick.cool@UGent.be>, Ghent University
- * @version February 2007
- */
- function display_complete_report()
- {
- // Database table definitions
- $table_survey_question = Database :: get_course_table(TABLE_SURVEY_QUESTION);
- $table_survey_question_option = Database :: get_course_table(TABLE_SURVEY_QUESTION_OPTION);
- $table_survey_answer = Database :: get_course_table(TABLE_SURVEY_ANSWER);
-
- // the form
- echo '<form id="form1a" name="form1a" method="post" action="'.api_get_self().'?action='.Security::remove_XSS($_GET['action']).'&survey_id='.Security::remove_XSS($_GET['survey_id']).'">';
- echo '<input type="hidden" name="export_report" value="export_report">';
- echo '<input type="hidden" name="export_format" value="csv">';
- echo '</form>';
- echo '<form id="form1b" name="form1b" method="post" action="'.api_get_self().'?action='.Security::remove_XSS($_GET['action']).'&survey_id='.Security::remove_XSS($_GET['survey_id']).'">';
- echo '<input type="hidden" name="export_report" value="export_report">';
- echo '<input type="hidden" name="export_format" value="xls">';
- echo '</form>';
- echo '<form id="form2" name="form2" method="post" action="'.api_get_self().'?action='.Security::remove_XSS($_GET['action']).'&survey_id='.Security::remove_XSS($_GET['survey_id']).'">';
- echo '<a href="#" onclick="document.form1a.submit();"><img align="absbottom" src="'.api_get_path(WEB_IMG_PATH).'excel.gif"> '.get_lang('ExportCurrentReportAsCSV').'</a>';
- echo '<a href="#" onclick="document.form1b.submit();"><img align="absbottom" src="'.api_get_path(WEB_IMG_PATH).'excel.gif"> '.get_lang('ExportCurrentReportAsXLS').'</a>';
- // the table
- echo '<table class="data_table" border="1">';
- // getting the number of options per question
- echo ' <tr>';
- echo ' <th>';
- if ($_POST['submit_question_filter'] OR $_POST['export_report'])
- {
- echo ' <input type="submit" name="reset_question_filter" value="'.get_lang('ResetQuestionFilter').'" />';
- }
- echo ' <input type="submit" name="submit_question_filter" value="'.get_lang('SubmitQuestionFilter').'" />';
- echo '</th>';
- $sql = "SELECT questions.question_id, questions.type, questions.survey_question, count(options.question_option_id) as number_of_options
- FROM $table_survey_question questions LEFT JOIN $table_survey_question_option options
- ON questions.question_id = options.question_id
- WHERE questions.question_id = options.question_id
- AND questions.survey_id = '".Database::escape_string($_GET['survey_id'])."'
- GROUP BY questions.question_id";
- $result = api_sql_query($sql, __FILE__, __LINE__);
- while ($row = Database::fetch_array($result))
- {
- // we show the questions if
- // 1. there is no question filter and the export button has not been clicked
- // 2. there is a quesiton filter but the question is selected for display
- if (!($_POST['submit_question_filter'] OR $_POST['export_report']) OR in_array($row['question_id'], $_POST['questions_filter']))
- {
- // we do not show comment and pagebreak question types
- if ($row['type'] <> 'comment' AND $row['type'] <> 'pagebreak')
- {
- echo ' <th';
- if ($row['number_of_options'] >0)
- {
- echo ' colspan="'.$row['number_of_options'].'"';
- }
- echo '>';
-
- echo '<label><input type="checkbox" name="questions_filter[]" value="'.$row['question_id'].'" checked="checked"/> ';
- echo $row['survey_question'];
- echo '</label>';
- echo '</th>';
- }
- }
- $questions[$row['question_id']] = $row;
- }
- echo ' </tr>';
- // getting all the questions and options
- echo ' <tr>';
- echo ' <th> </th>'; // the user column
- $sql = "SELECT survey_question.question_id, survey_question.survey_id, survey_question.survey_question, survey_question.display, survey_question.sort, survey_question.type,
- survey_question_option.question_option_id, survey_question_option.option_text, survey_question_option.sort as option_sort
- FROM $table_survey_question survey_question
- LEFT JOIN $table_survey_question_option survey_question_option
- ON survey_question.question_id = survey_question_option.question_id
- WHERE survey_question.survey_id = '".Database::escape_string($_GET['survey_id'])."'
- ORDER BY survey_question.sort ASC";
- $result = api_sql_query($sql, __FILE__, __LINE__);
- while ($row = Database::fetch_array($result))
- {
- // we show the options if
- // 1. there is no question filter and the export button has not been clicked
- // 2. there is a quesiton filter but the question is selected for display
- if (!($_POST['submit_question_filter'] OR $_POST['export_report']) OR in_array($row['question_id'], $_POST['questions_filter']))
- {
- // we do not show comment and pagebreak question types
- if ($row['type'] <> 'comment' AND $row['type'] <> 'pagebreak')
- {
- echo ' <th>';
- echo $row['option_text'];
- echo '</th>';
- $possible_answers[$row['question_id']][$row['question_option_id']] =$row['question_option_id'];
- }
- }
- }
- echo ' </tr>';
-
- // getting all the answers of the users
- $old_user='';
- $answers_of_user = array();
- $sql = "SELECT * FROM $table_survey_answer WHERE survey_id='".Database::escape_string($_GET['survey_id'])."' ORDER BY user ASC";
- $result = api_sql_query($sql, __FILE__, __LINE__);
- while ($row = Database::fetch_array($result))
- {
- if ($old_user <> $row['user'] AND $old_user<>'')
- {
- SurveyUtil::display_complete_report_row($possible_answers, $answers_of_user, $old_user, $questions);
- $answers_of_user=array();
- }
- if ($questions[$row['question_id']]['type']<> 'open')
- {
- $answers_of_user[$row['question_id']][$row['option_id']] = $row;
- }
- else
- {
- $answers_of_user[$row['question_id']][0] = $row;
- }
- $old_user = $row['user'];
- }
- SurveyUtil::display_complete_report_row($possible_answers, $answers_of_user, $old_user, $questions); // this is to display the last user
-
- echo '</table>';
-
- echo '</form>';
- }
-
-
- /**
- * This function displays a row (= a user and his/her answers) in the table of the complete report.
- *
- * @param array Possible options
- * @param array User answers
- * @param mixed User ID or user details string
- * @author Patrick Cool <patrick.cool@UGent.be>, Ghent University
- * @version February 2007 - Updated March 2008
- */
- function display_complete_report_row($possible_options, $answers_of_user, $user, $questions)
- {
- global $survey_data;
-
- $table_survey_question = Database :: get_course_table(TABLE_SURVEY_QUESTION);
- echo '<tr>';
- if ($survey_data['anonymous'] == 0)
- {
- if(intval($user)!==0)
- {
- $sql = 'SELECT firstname, lastname FROM '.Database::get_main_table(TABLE_MAIN_USER).' WHERE user_id='.intval($user);
- $rs = api_sql_query($sql, __FILE__, __LINE__);
- if($row = Database::fetch_array($rs))
- {
- $user_displayed = $row['lastname'].' '.$row['firstname'];
- }
- else
- {
- $user_displayed = '-';
- }
- echo ' <th><a href="'.api_get_self().'?action=userreport&survey_id='.Security::remove_XSS($_GET['survey_id']).'&user='.$user.'">'.$user_displayed.'</a></th>'; // the user column
- }
- else
- {
- echo ' <th>'.$user.'</th>'; // the user column
- }
- }
- else
- {
- echo '<th>-</th>';
- }
-
-
- foreach ($possible_options as $question_id=>$possible_option)
- {
- if ($questions[$question_id]['type'] == 'open')
- {
- echo '<td align="center">';
- echo $answers_of_user[$question_id]['0']['option_id'];
- echo '</td>';
- }
- else
- {
- foreach ($possible_option as $option_id=>$value)
- {
- echo '<td align="center">';
- if (!empty($answers_of_user[$question_id][$option_id]))
- {
- if ($answers_of_user[$question_id][$option_id]['value']<>0)
- {
- echo $answers_of_user[$question_id][$option_id]['value'];
- }
- else
- {
- echo 'v';
- }
- }
- }
- }
-
- }
- echo '</tr>';
- }
-
-
- /**
- * Quite similar to display_complete_report(), returns an HTML string
- * that can be used in a csv file
- * @todo consider merging this function with display_complete_report
- * @return string The contents of a csv file
- * @author Patrick Cool <patrick.cool@UGent.be>, Ghent University
- * @version February 2007
- */
- function export_complete_report()
- {
- // Database table definitions
- $table_survey_question = Database :: get_course_table(TABLE_SURVEY_QUESTION);
- $table_survey_question_option = Database :: get_course_table(TABLE_SURVEY_QUESTION_OPTION);
- $table_survey_answer = Database :: get_course_table(TABLE_SURVEY_ANSWER);
-
- // the first column
- $return = ';';
-
- $sql = "SELECT questions.question_id, questions.type, questions.survey_question, count(options.question_option_id) as number_of_options
- FROM $table_survey_question questions LEFT JOIN $table_survey_question_option options
- ON questions.question_id = options.question_id "
- ." AND questions.survey_id = '".Database::escape_string($_GET['survey_id'])."'
- GROUP BY questions.question_id";
- $result = api_sql_query($sql, __FILE__, __LINE__);
- while ($row = Database::fetch_array($result))
- {
- // we show the questions if
- // 1. there is no question filter and the export button has not been clicked
- // 2. there is a quesiton filter but the question is selected for display
- if (!($_POST['submit_question_filter']) OR (is_array($_POST['questions_filter']) && in_array($row['question_id'], $_POST['questions_filter'])))
- {
- // we do not show comment and pagebreak question types
- if ($row['type'] <> 'comment' AND $row['type'] <> 'pagebreak')
- {
- if($row['number_of_options'] == 0 && $row['type']=='open')
- {
- $return .= str_replace("\r\n",' ',html_entity_decode(strip_tags($row['survey_question']))).';';
- }
- else
- {
- for ($ii = 0; $ii < $row['number_of_options']; $ii ++)
- {
- $return .= str_replace("\r\n",' ',html_entity_decode(strip_tags($row['survey_question']))).';';
- }
- }
- }
- }
- }
- $return .= "\n";
-
- // getting all the questions and options
- $return .= ';';
- $sql = "SELECT survey_question.question_id, survey_question.survey_id, survey_question.survey_question, survey_question.display, survey_question.sort, survey_question.type,
- survey_question_option.question_option_id, survey_question_option.option_text, survey_question_option.sort as option_sort
- FROM $table_survey_question survey_question
- LEFT JOIN $table_survey_question_option survey_question_option
- ON survey_question.question_id = survey_question_option.question_id
- WHERE survey_question.survey_id = '".Database::escape_string($_GET['survey_id'])."'
- ORDER BY survey_question.sort ASC";
- $result = api_sql_query($sql, __FILE__, __LINE__);
- $possible_answers = array();
- $possible_answers_type = array();
- while ($row = Database::fetch_array($result))
- {
- // we show the options if
- // 1. there is no question filter and the export button has not been clicked
- // 2. there is a quesiton filter but the question is selected for display
- if (!($_POST['submit_question_filter']) OR (is_array($_POST['questions_filter']) && in_array($row['question_id'], $_POST['questions_filter'])))
- {
- // we do not show comment and pagebreak question types
- if ($row['type'] <> 'comment' AND $row['type'] <> 'pagebreak')
- {
- $return .= html_entity_decode(strip_tags($row['option_text'])).';';
- $possible_answers[$row['question_id']][$row['question_option_id']] =$row['question_option_id'];
- $possible_answers_type[$row['question_id']] = $row['type'];
- }
- }
- }
- $return .= "\n";
-
- // getting all the answers of the users
- $old_user='';
- $answers_of_user = array();
- $sql = "SELECT * FROM $table_survey_answer WHERE survey_id='".Database::escape_string($_GET['survey_id'])."' ORDER BY user ASC";
-
- $open_question_iterator = 1;
- $result = api_sql_query($sql, __FILE__, __LINE__);
- while ($row = Database::fetch_array($result))
- {
- if ($old_user <> $row['user'] AND $old_user <> '')
- {
- $return .= SurveyUtil::export_complete_report_row($possible_answers, $answers_of_user, $old_user);
- $answers_of_user=array();
- }
- if($possible_answers_type[$row['question_id']] == 'open')
- {
- $temp_id = 'open'.$open_question_iterator;
- $answers_of_user[$row['question_id']][$temp_id] = $row;
- $open_question_iterator++;
- }
- else
- {
- $answers_of_user[$row['question_id']][$row['option_id']] = $row;
- }
- $old_user = $row['user'];
- }
- $return .= SurveyUtil::export_complete_report_row($possible_answers, $answers_of_user, $old_user); // this is to display the last user
- return $return;
- }
-
-
- /**
- * Add a line to the csv file
- *
- * @param array Possible answers
- * @param array User's answers
- * @param mixed User ID or user details as string - Used as a string in the result string
- * @return string One line of the csv file
- * @author Patrick Cool <patrick.cool@UGent.be>, Ghent University
- * @version February 2007
- */
- function export_complete_report_row($possible_options, $answers_of_user, $user)
- {
- $return = $user.';'; // the user column
-
- if(is_array($possible_options))
- {
- foreach ($possible_options as $question_id=>$possible_option)
- {
- if(is_array($possible_option) && count($possible_option)>0)
- {
- foreach ($possible_option as $option_id=>$value)
- {
- $key = array_keys($answers_of_user[$question_id]);
- if(substr($key[0],0,4)=='open')
- {
- $return .= '"'.str_replace('"','""',html_entity_decode(strip_tags($answers_of_user[$question_id][$key[0]]['option_id']))).'"';
- }
- elseif (!empty($answers_of_user[$question_id][$option_id]))
- {
- $return .= 'v';
- }
- $return .= ';';
- }
- }
- }
- }
- $return .= "\n";
- return $return;
- }
- /**
- * Quite similar to display_complete_report(), returns an HTML string
- * that can be used in a csv file
- * @todo consider merging this function with display_complete_report
- * @return string The contents of a csv file
- * @author Patrick Cool <patrick.cool@UGent.be>, Ghent University
- * @version February 2007
- */
- function export_complete_report_xls($filename)
- {
- require_once(api_get_path(LIBRARY_PATH).'pear/Spreadsheet_Excel_Writer/Writer.php');
- $workbook = new Spreadsheet_Excel_Writer();
- $workbook->send($filename);
- $worksheet =& $workbook->addWorksheet('Report 1');
- $line = 0;
- $column = 0;
-
- //$worksheet->write($line, 0, 'Name');
-
- // Database table definitions
- $table_survey_question = Database :: get_course_table(TABLE_SURVEY_QUESTION);
- $table_survey_question_option = Database :: get_course_table(TABLE_SURVEY_QUESTION_OPTION);
- $table_survey_answer = Database :: get_course_table(TABLE_SURVEY_ANSWER);
-
- // the first column
-
- $column ++; //skip the first column (row titles)
- $sql = "SELECT questions.question_id, questions.type, questions.survey_question, count(options.question_option_id) as number_of_options
- FROM $table_survey_question questions LEFT JOIN $table_survey_question_option options
- ON questions.question_id = options.question_id "
- ." AND questions.survey_id = '".Database::escape_string($_GET['survey_id'])."'
- GROUP BY questions.question_id";
- $result = api_sql_query($sql, __FILE__, __LINE__);
- while ($row = Database::fetch_array($result))
- {
- // we show the questions if
- // 1. there is no question filter and the export button has not been clicked
- // 2. there is a quesiton filter but the question is selected for display
- if (!($_POST['submit_question_filter']) OR (is_array($_POST['questions_filter']) && in_array($row['question_id'], $_POST['questions_filter'])))
- {
- // we do not show comment and pagebreak question types
- if ($row['type'] <> 'comment' AND $row['type'] <> 'pagebreak')
- {
- if($row['number_of_options'] == 0 && $row['type']=='open')
- {
- $worksheet->write($line,$column,html_entity_decode(strip_tags($row['survey_question'])));
- $column ++;
- }
- else
- {
- for ($ii = 0; $ii < $row['number_of_options']; $ii ++)
- {
- $worksheet->write($line,$column,html_entity_decode(strip_tags($row['survey_question'])));
- $column ++;
- }
- }
- }
- }
- }
- $line++;
- $column = 1;
-
- // getting all the questions and options
- $sql = "SELECT survey_question.question_id, survey_question.survey_id, survey_question.survey_question, survey_question.display, survey_question.sort, survey_question.type,
- survey_question_option.question_option_id, survey_question_option.option_text, survey_question_option.sort as option_sort
- FROM $table_survey_question survey_question
- LEFT JOIN $table_survey_question_option survey_question_option
- ON survey_question.question_id = survey_question_option.question_id
- WHERE survey_question.survey_id = '".Database::escape_string($_GET['survey_id'])."'
- ORDER BY survey_question.sort ASC";
- $result = api_sql_query($sql, __FILE__, __LINE__);
- $possible_answers = array();
- $possible_answers_type = array();
- while ($row = Database::fetch_array($result))
- {
- // we show the options if
- // 1. there is no question filter and the export button has not been clicked
- // 2. there is a quesiton filter but the question is selected for display
- if (!($_POST['submit_question_filter']) OR (is_array($_POST['questions_filter']) && in_array($row['question_id'], $_POST['questions_filter'])))
- {
- // we do not show comment and pagebreak question types
- if ($row['type'] <> 'comment' AND $row['type'] <> 'pagebreak')
- {
- $worksheet->write($line,$column,html_entity_decode(strip_tags($row['option_text'])));
- $possible_answers[$row['question_id']][$row['question_option_id']] =$row['question_option_id'];
- $possible_answers_type[$row['question_id']] = $row['type'];
- }
- }
- }
- $line ++;
- $column = 0;
-
- // getting all the answers of the users
- $old_user='';
- $answers_of_user = array();
- $sql = "SELECT * FROM $table_survey_answer WHERE survey_id='".Database::escape_string($_GET['survey_id'])."' ORDER BY user ASC";
-
- $open_question_iterator = 1;
- $result = api_sql_query($sql, __FILE__, __LINE__);
- while ($row = Database::fetch_array($result))
- {
- if ($old_user <> $row['user'] AND $old_user <> '')
- {
- $return = SurveyUtil::export_complete_report_row_xls($possible_answers, $answers_of_user, $old_user);
- foreach($return as $elem)
- {
- $worsheet->write($line,$column,$elem);
- $column++;
- }
- $line++;
- $column=0;
- $answers_of_user=array();
- }
- if($possible_answers_type[$row['question_id']] == 'open')
- {
- $temp_id = 'open'.$open_question_iterator;
- $answers_of_user[$row['question_id']][$temp_id] = $row;
- $open_question_iterator++;
- }
- else
- {
- $answers_of_user[$row['question_id']][$row['option_id']] = $row;
- }
- $old_user = $row['user'];
- }
- $return = SurveyUtil::export_complete_report_row_xls($possible_answers, $answers_of_user, $old_user); // this is to display the last user
- foreach($return as $elem)
- {
- $worksheet->write($line,$column,$elem);
- $column++;
- }
- $workbook->close();
- return null;
- }
-
-
- /**
- * Add a line to the csv file
- *
- * @param array Possible answers
- * @param array User's answers
- * @param mixed User ID or user details as string - Used as a string in the result string
- * @return string One line of the csv file
- */
- function export_complete_report_row_xls($possible_options, $answers_of_user, $user)
- {
- $return = array();
- $return[] = $user; // the user column
-
- if(is_array($possible_options))
- {
- foreach ($possible_options as $question_id=>$possible_option)
- {
- if(is_array($possible_option) && count($possible_option)>0)
- {
- foreach ($possible_option as $option_id=>$value)
- {
- $key = array_keys($answers_of_user[$question_id]);
- if(substr($key[0],0,4)=='open')
- {
- $return[] = html_entity_decode(strip_tags($answers_of_user[$question_id][$key[0]]['option_id']));
- }
- elseif (!empty($answers_of_user[$question_id][$option_id]))
- {
- $return[] = 'v';
- }
- }
- }
- }
- }
- return $return;
- }
-
- /**
- * This function displays the comparative report which allows you to compare two questions
- * A comparative report creates a table where one question is on the x axis and a second question is on the y axis.
- * In the intersection is the number of people who have answerd positive on both options.
- *
- * @return string HTML code
- *
- * @author Patrick Cool <patrick.cool@UGent.be>, Ghent University
- * @version February 2007
- */
- function display_comparative_report()
- {
- // allowed question types for comparative report
- $allowed_question_types = array('yesno', 'multiplechoice', 'multipleresponse', 'dropdown', 'percentage', 'score');
-
- // getting all the questions
- $questions = survey_manager::get_questions($_GET['survey_id']);
-
- // displaying an information message that only the questions with predefined answers can be used in a comparative report
- Display::display_normal_message(get_lang('OnlyQuestionsWithPredefinedAnswers'), false);
-
- // The form for selecting the axis of the table
- echo '<form id="form1" name="form1" method="get" action="'.api_get_self().'?action='.Security::remove_XSS($_GET['action']).'&survey_id='.Security::remove_XSS($_GET['survey_id']).'&xaxis='.Security::remove_XSS($_GET['xaxis']).'&y='.Security::remove_XSS($_GET['yaxis']).'">';
- // survey_id
- echo '<input type="hidden" name="action" value="'.Security::remove_XSS($_GET['action']).'"/>';
- echo '<input type="hidden" name="survey_id" value="'.(int)$_GET['survey_id'].'"/>';
- // X axis
- echo get_lang('SelectXAxis').': ';
- echo '<select name="xaxis">';
- echo '<option value="">---</option>';
- foreach ($questions as $key=>$question)
- {
- if (in_array($question['type'], $allowed_question_types))
- {
- echo '<option value="'.$question['question_id'].'"';
- if ($_GET['xaxis'] == $question['question_id'])
- {
- echo ' selected="selected"';
- }
- echo '">'.substr(strip_tags($question['question']), 0, 50).'</option>';
- }
- }
- echo '</select><br /><br />';
- // Y axis
- echo get_lang('SelectYAxis').': ';
- echo '<select name="yaxis">';
- echo '<option value="">---</option>';
- foreach ($questions as $key=>$question)
- {
- if (in_array($question['type'], $allowed_question_types))
- {
- echo '<option value="'.$question['question_id'].'"';
- if ($_GET['yaxis'] == $question['question_id'])
- {
- echo ' selected="selected"';
- }
- echo '">'.substr(strip_tags($question['question']), 0, 50).'</option>';
- }
- }
- echo '</select><br /><br />';
- echo '<input type="submit" name="Submit" value="Submit" />';
- echo '</form>';
-
- // getting all the information of the x axis
- if (isset($_GET['xaxis']) AND is_numeric($_GET['xaxis']))
- {
- $question_x = survey_manager::get_question($_GET['xaxis']);
- }
-
- // getting all the information of the y axis
- if (isset($_GET['yaxis']) AND is_numeric($_GET['yaxis']))
- {
- $question_y = survey_manager::get_question($_GET['yaxis']);
- }
-
- if (isset($_GET['xaxis']) AND is_numeric($_GET['xaxis']) AND isset($_GET['yaxis']) AND is_numeric($_GET['yaxis']))
- {
- // getting the answers of the two questions
- $answers_x = SurveyUtil::get_answers_of_question_by_user($_GET['survey_id'], $_GET['xaxis']);
- $answers_y = SurveyUtil::get_answers_of_question_by_user($_GET['survey_id'], $_GET['yaxis']);
-
- // displaying the table
- echo '<table border="1" class="data_table">';
-
- // the header
- echo ' <tr>';
- for ($ii=0; $ii<=count($question_x['answers']); $ii++)
- {
- if ($ii == 0)
- {
- echo ' <th> </th>';
- }
- else
- {
- if ($question_x['type']=='score')
- {
- for($x=1; $x<=$question_x['maximum_score']; $x++)
- {
- echo ' <th>'.$question_x['answers'][($ii-1)].'<br />'.$x.'</th>';
- }
- $x='';
- }
- else
- {
- echo ' <th>'.$question_x['answers'][($ii-1)].'</th>';
- }
- }
- }
- echo ' </tr>';
-
- // the main part
- for ($ij=0; $ij<count($question_y['answers']); $ij++)
- {
- // The Y axis is a scoring question type so we have more rows than the options (actually options * maximum score)
- if ($question_y['type'] == 'score')
- {
- for($y=1; $y<=$question_y['maximum_score']; $y++)
- {
- echo ' <tr>';
- for ($ii=0; $ii<=count($question_x['answers']); $ii++)
- {
- if ($question_x['type']=='score')
- {
- for($x=1; $x<=$question_x['maximum_score']; $x++)
- {
- if ($ii == 0)
- {
- echo ' <th>'.$question_y['answers'][($ij)].' '.$y.'</th>';
- break;
- }
- else
- {
- echo ' <td align="center">';
- echo SurveyUtil::comparative_check($answers_x, $answers_y, $question_x['answersid'][($ii-1)], $question_y['answersid'][($ij)], $x, $y);
- echo '</td>';
- }
- }
- }
- else
- {
- if ($ii == 0)
- {
- echo ' <th>'.$question_y['answers'][($ij)].' '.$y.'</th>';
- }
- else
- {
- echo ' <td align="center">';
- echo SurveyUtil::comparative_check($answers_x, $answers_y, $question_x['answersid'][($ii-1)], $question_y['answersid'][($ij)], 0, $y);
- echo '</td>';
- }
- }
- }
- echo ' </tr>';
- }
- }
- // The Y axis is NOT a score question type so the number of rows = the number of options
- else
- {
- echo ' <tr>';
- for ($ii=0; $ii<=count($question_x['answers']); $ii++)
- {
- if ($question_x['type']=='score')
- {
- for($x=1; $x<=$question_x['maximum_score']; $x++)
- {
- if ($ii == 0)
- {
- echo ' <th>'.$question_y['answers'][($ij)].'</th>';
- break;
- }
- else
- {
- echo ' <td align="center">';
- echo SurveyUtil::comparative_check($answers_x, $answers_y, $question_x['answersid'][($ii-1)], $question_y['answersid'][($ij)], $x, 0);
- echo '</td>';
- }
- }
- }
- else
- {
- if ($ii == 0)
- {
- echo ' <th>'.$question_y['answers'][($ij)].'</th>';
- }
- else
- {
- echo ' <td align="center">';
- echo SurveyUtil::comparative_check($answers_x, $answers_y, $question_x['answersid'][($ii-1)], $question_y['answersid'][($ij)]);
- echo '</td>';
- }
- }
- }
- echo ' </tr>';
- }
- }
- echo '</table>';
- }
- }
-
- /**
- * Get all the answers of a question grouped by user
- *
- * @param integer Survey ID
- * @param integer Question ID
- * @return Array Array containing all answers of all users, grouped by user
- *
- * @author Patrick Cool <patrick.cool@UGent.be>, Ghent University
- * @version February 2007 - Updated March 2008
- */
- function get_answers_of_question_by_user($survey_id, $question_id)
- {
- // Database table definitions
- $table_survey_question = Database :: get_course_table(TABLE_SURVEY_QUESTION);
- $table_survey_question_option = Database :: get_course_table(TABLE_SURVEY_QUESTION_OPTION);
- $table_survey_answer = Database :: get_course_table(TABLE_SURVEY_ANSWER);
-
- $sql = "SELECT * FROM $table_survey_answer
- WHERE survey_id='".Database::escape_string($survey_id)."'
- AND question_id='".Database::escape_string($question_id)."'
- ORDER BY USER ASC";
- $result = api_sql_query($sql, __FILE__, __LINE__);
- while ($row = Database::fetch_array($result))
- {
- if ($row['value'] == 0)
- {
- $return[$row['user']][] = $row['option_id'];
- }
- else
- {
- $return[$row['user']][] = $row['option_id'].'*'.$row['value'];
- }
-
- }
- return $return;
- }
-
-
- /**
- * Count the number of users who answer positively on both options
- *
- * @param array All answers of the x axis
- * @param array All answers of the y axis
- * @param integer x axis value (= the option_id of the first question)
- * @param integer y axis value (= the option_id of the second question)
- * @return integer Number of users who have answered positively to both options
- *
- * @author Patrick Cool <patrick.cool@UGent.be>, Ghent University
- * @version February 2007
- */
- function comparative_check($answers_x, $answers_y, $option_x, $option_y, $value_x=0, $value_y=0)
- {
- if ($value_x==0)
- {
- $check_x = $option_x;
- }
- else
- {
- $check_x = $option_x.'*'.$value_x;
- }
- if ($value_y==0)
- {
- $check_y = $option_y;
- }
- else
- {
- $check_y = $option_y.'*'.$value_y;
- }
- $counter = 0;
- foreach ($answers_x as $user => $answers)
- {
- // check if the user has given $option_x as answer
- if (in_array($check_x, $answers))
- {
- // check if the user has given $option_y as an answer
- if (in_array($check_y, $answers_y[$user]))
- {
- $counter++;
- }
- }
- }
- return $counter;
- }
- /**
- * Get all the information about the invitations of a certain survey
- *
- * @return array Lines of invitation [user, code, date, empty element]
- *
- * @author Patrick Cool <patrick.cool@UGent.be>, Ghent University
- * @version January 2007
- *
- * @todo use survey_id parameter instead of $_GET
- */
- function get_survey_invitations_data()
- {
- // Database table definition
- $table_survey_invitation = Database :: get_course_table(TABLE_SURVEY_INVITATION);
- $table_user = Database :: get_main_table(TABLE_MAIN_USER);
-
- $sql = "SELECT
- survey_invitation.user as col1,
- survey_invitation.invitation_code as col2,
- survey_invitation.invitation_date as col3,
- '' as col4
- FROM $table_survey_invitation survey_invitation
- LEFT JOIN $table_user user ON survey_invitation.user = user.user_id
- WHERE survey_invitation.survey_id = '".Database::escape_string($_GET['survey_id'])."'";
- $res = api_sql_query($sql, __FILE__, __LINE__);
- while ($row = Database::fetch_array($res))
- {
- $survey_invitation_data[] = $row;
- }
- return $survey_invitation_data;
- }
-
- /**
- * Get the total number of survey invitations for a given survey (through $_GET['survey_id'])
- *
- * @return integer Total number of survey invitations
- *
- * @todo use survey_id parameter instead of $_GET
- *
- * @author Patrick Cool <patrick.cool@UGent.be>, Ghent University
- * @version January 2007
- */
- function get_number_of_survey_invitations()
- {
- // Database table definition
- $table_survey_invitation = Database :: get_course_table(TABLE_SURVEY_INVITATION);
-
- $sql = "SELECT count(user) AS total FROM $table_survey_invitation WHERE survey_id='".Database::escape_string($_GET['survey_id'])."'";
- $res = api_sql_query($sql, __FILE__, __LINE__);
- $row = mysql_fetch_assoc($res);
- return $row['total'];
- }
- /**
- * Save the invitation mail
- *
- * @param string Text of the e-mail
- * @param integer Whether the mail contents are for invite mail (0, default) or reminder mail (1)
- *
- * @author Patrick Cool <patrick.cool@UGent.be>, Ghent University
- * @version January 2007
- */
- function save_invite_mail($mailtext, $reminder=0)
- {
- // Database table definition
- $table_survey = Database :: get_course_table(TABLE_SURVEY);
-
- // reminder or not
- if ($reminder == 0)
- {
- $mail_field = 'invite_mail';
- }
- else
- {
- $mail_field = 'reminder_mail';
- }
-
- $sql = "UPDATE $table_survey SET $mail_field = '".Database::escape_string($mailtext)."' WHERE survey_id = '".Database::escape_string($_GET['survey_id'])."'";
- $result = api_sql_query($sql, __FILE__, __LINE__);
- }
-
- /**
- * This function saves all the invitations of course users and additional users in the
- *
- * @param array Users array
- * @param string Title of the invitation, used as the title of the mail
- * @param string Text of the invitation, used as the text of the mail.
- * The text has to contain a **link** string or this will automatically be added to the end
- *
- * @author Patrick Cool <patrick.cool@UGent.be>, Ghent University
- * @version January 2007
- *
- * @todo create the survey link
- */
- function save_invitations($users_array, $invitation_title, $invitation_text, $reminder=0)
- {
- global $_user;
- global $_course;
- global $_configuration;
-
- // getting the survey information
- $survey_data = survey_manager::get_survey($_GET['survey_id']);
-
- // Database table definition
- $table_survey_invitation = Database :: get_course_table(TABLE_SURVEY_INVITATION);
- $table_user = Database :: get_main_table(TABLE_MAIN_USER);
-
- $already_invited = array();
- $survey_invitations = array();
- // get the people who are already invited
- if ($reminder == 1)
- {
- $survey_invitations = SurveyUtil::get_invitations($survey_data['survey_code']);
- }
- else
- {
- $already_invited = SurveyUtil::get_invited_users($survey_data['code']);
- }
-
- $counter = 0;
- if (is_array($users_array))
- {
- foreach ($users_array as $key=>$value)
- {
- if(isset($value))
- {
- // generating the unique code
- if(is_array($survey_invitations))
- {
- if ($reminder == 1 AND array_key_exists($value,$survey_invitations))
- {
- $invitation_code = $survey_invitations[$value]['invitation_code'];
- }
- else
- {
- $invitation_code = md5($value.microtime());
- }
- }
- $survey_link = '';
- $full_invitation_text= '';
-
- // storing the invitation (only if the user_id is not in $already_invited['course_users'] OR email is not in $already_invited['additional_users']
- $add_users_array = explode(';',$already_invited['additional_users']);
- if ((is_numeric($value) AND !in_array($value,$already_invited['course_users'])) OR (!is_numeric($value) AND !in_array($value,$add_users_array)))
- {
- if(is_array($survey_invitations))
- {
- if (!array_key_exists($value,$survey_invitations))
- {
- $sql = "INSERT INTO $table_survey_invitation (user, survey_code, invitation_code, invitation_date) VALUES
- ('".Database::escape_string($value)."','".Database::escape_string($survey_data['code'])."','".Database::escape_string($invitation_code)."','".Database::escape_string(date('Y-m-d H:i:s'))."')";
- $result = api_sql_query($sql, __FILE__, __LINE__);
- }
- }
- // replacing the **link** part with a valid link for the user
- $survey_link = $_configuration['root_web'].$_configuration['code_append'].'survey/'.'fillsurvey.php?course='.$_course['sysCode'].'&invitationcode='.$invitation_code;
- $text_link = '<a href="'.$survey_link.'">'.get_lang('ClickHereToAnswerTheSurvey')."</a><br />\r\n<br />\r\n".get_lang('OrCopyPasteTheFollowingUrl')." <br />\r\n ".$survey_link;
-
- $replace_count = 0;
- $full_invitation_text = str_ireplace('**link**', $text_link ,$invitation_text, $replace_count);
- if ($replace_count < 1)
- {
- $full_invitation_text = $full_invitation_text . "<br />\r\n<br />\r\n".$text_link;
- }
-
-
- // optionally: finding the e-mail of the course user
- if (is_numeric($value))
- {
- $sql = "SELECT firstname, lastname, email FROM $table_user WHERE user_id='".Database::escape_string($value)."'";
- $result = api_sql_query($sql, __FILE__, __LINE__);
- $row = Database::fetch_array($result);
- $recipient_email = $row['email'];
- $recipient_name = $row['firstname'].' '.$row['lastname'];
- }
- else
- {
- /** @todo check if the $value is a valid email */
- $recipient_email = $value;
- }
-
- // sending the mail
- $sender_name = $_user['firstName'].' '.$_user['lastName'];
- $sender_email = $_user['mail'];
-
- $replyto = array();
- if(api_get_setting('survey_email_sender_noreply')=='noreply')
- {
- $noreply = api_get_setting('noreply_email_address');
- if(!empty($noreply))
- {
- $replyto['Reply-to'] = $noreply;
- $sender_name = $noreply;
- $sender_email = $noreply;
- }
- }
- api_mail_html($recipient_name, $recipient_email, $invitation_title, $full_invitation_text, $sender_name, $sender_email, $replyto);
- //mail($recipient_email, strip_tags($invitation_title), strip_tags($invitation_text));
- $counter++;
- }
- }
- }
- }
-
- return $counter;
- }
-
- /**
- * This function recalculates the number of users who have been invited and updates the survey table with this value.
- *
- * @param string Survey code
- * @return void
- * @author Patrick Cool <patrick.cool@UGent.be>, Ghent University
- * @version January 2007
- */
- function update_count_invited($survey_code)
- {
- // Database table definition
- $table_survey_invitation = Database :: get_course_table(TABLE_SURVEY_INVITATION);
- $table_survey = Database :: get_course_table(TABLE_SURVEY);
-
- // counting the number of people that are invited
- $sql = "SELECT count(user) as total FROM $table_survey_invitation WHERE survey_code = '".Database::escape_string($survey_code)."'";
- $result = api_sql_query($sql, __FILE__, __LINE__);
- $row = Database::fetch_array($result);
- $total_invited = $row['total'];
-
- // updating the field in the survey table
- $sql = "UPDATE $table_survey SET invited = '".Database::escape_string($total_invited)."' WHERE code = '".Database::escape_string($survey_code)."'";
- $result = api_sql_query($sql, __FILE__, __LINE__);
- }
-
- /**
- * This function gets all the invited users for a given survey code.
- *
- * @param string Survey code
- * @return array Array containing the course users and additional users (non course users)
- *
- * @todo consider making $defaults['additional_users'] also an array
- *
- * @author Patrick Cool <patrick.cool@UGent.be>, Ghent University
- * @version January 2007
- */
- function get_invited_users($survey_code)
- {
- // Database table definition
- $table_survey_invitation = Database :: get_course_table(TABLE_SURVEY_INVITATION);
-
- // Selecting all the invitations of this survey
- $sql = "SELECT user FROM $table_survey_invitation WHERE survey_code='".Database::escape_string($survey_code)."'";
-
- $defaults = array();
- $defaults['course_users'] = array();
- $defaults['additional_users'] = '';
- $result = api_sql_query($sql, __FILE__, __LINE__);
- while ($row = Database::fetch_array($result))
- {
- if (is_numeric($row['user']))
- {
- $defaults['course_users'][] = $row['user'];
- }
- else
- {
- if (empty($defaults['additional_users']))
- {
- $defaults['additional_users'] = $row['user'];
- }
- else
- {
- $defaults['additional_users'] .= ';'.$row['user'];
- }
- }
- }
- return $defaults;
- }
- /**
- * Get all the invitations
- *
- * @param string Survey code
- * @return array Database rows matching the survey code
- *
- * @author Patrick Cool <patrick.cool@UGent.be>, Ghent University
- * @version September 2007
- */
- function get_invitations($survey_code)
- {
- // Database table definition
- $table_survey_invitation = Database :: get_course_table(TABLE_SURVEY_INVITATION);
-
- $sql = "SELECT * FROM $table_survey_invitation WHERE survey_code = '".Database::escape_string($survey_code)."'";
- $result = api_sql_query($sql, __FILE__, __LINE__);
- $return = array();
- while ($row = Database::fetch_array($result))
- {
- $return[$row['user']] = $row;
- }
- return $return;
- }
- /**
- * This function displays the form for searching a survey
- *
- * @return void (direct output)
- *
- * @author Patrick Cool <patrick.cool@UGent.be>, Ghent University
- * @version January 2007
- *
- * @todo use quickforms
- * @todo consider moving this to surveymanager.inc.lib.php
- */
- function display_survey_search_form()
- {
- echo '<form method="get" action="survey_list.php?search=advanced">';
- echo '<table>
- <tr>
- <td>'.get_lang('Title').'</td>
- <td><input type="text" name="keyword_title"/></td>
- </tr>
- <tr>
- <td>'.get_lang('Code').'</td>
- <td><input type="text" name="keyword_code"/></td>
- </tr>
- <tr>
- <td>'.get_lang('Language').'</td>
- <td>
- <select name="keyword_language"><option value="%">'.get_lang('All').'</option>';
- $languages = api_get_languages();
- foreach ($languages['name'] as $index => $name)
- {
- echo '<option value="'.$languages['folder'][$index].'">'.$name.'</option>';
- }
- echo ' </select>
- </td>
- </tr>
- <tr>
- <td> </td>
- <td><input type="submit" name="do_search" value="'.get_lang('Ok').'"/></td>
- </tr>
- </table>
- </form>';
- }
-
- /**
- * This function displays the sortable table with all the surveys
- *
- * @return void (direct output)
- *
- * @author Patrick Cool <patrick.cool@UGent.be>, Ghent University
- * @version January 2007
- */
- function display_survey_list()
- {
- $parameters = array();
- if ($_GET['do_search'])
- {
- $message = get_lang('DisplaySearchResults').'<br />';
- $message .= '<a href="'.api_get_self().'">'.get_lang('DisplayAll').'</a>';
- Display::display_normal_message($message, false);
- }
-
- // Create a sortable table with survey-data
- $table = new SortableTable('surveys', 'get_number_of_surveys', 'get_survey_data',2);
- $table->set_additional_parameters($parameters);
- $table->set_header(0, '', false);
- $table->set_header(1, get_lang('SurveyName'));
- $table->set_header(2, get_lang('SurveyCode'));
- $table->set_header(3, get_lang('NumberOfQuestions'));
- $table->set_header(4, get_lang('Author'));
- $table->set_header(5, get_lang('Language'));
- $table->set_header(6, get_lang('Shared'));
- $table->set_header(7, get_lang('AvailableFrom'));
- $table->set_header(8, get_lang('AvailableUntill'));
- $table->set_header(9, get_lang('Invite'));
- $table->set_header(10, get_lang('Anonymous'));
- $table->set_header(11, get_lang('Modify'), false);
- $table->set_column_filter(10, 'anonymous_filter');
- $table->set_column_filter(11, 'modify_filter');
- $table->set_form_actions(array ('delete' => get_lang('DeleteSurvey')));
- $table->display();
-
- }
-
- /**
- * This function changes the modify column of the sortable table
- *
- * @param integer $survey_id the id of the survey
- * @return html code that are the actions that can be performed on any survey
- *
- * @author Patrick Cool <patrick.cool@UGent.be>, Ghent University
- * @version January 2007
- */
- function modify_filter($survey_id)
- {
- global $charset;
- $survey_id = Security::remove_XSS($survey_id);
- $return = '<a href="create_new_survey.php?'.api_get_cidreq().'&action=edit&survey_id='.$survey_id.'">'.Display::return_icon('edit.gif', get_lang('Edit')).'</a>';
- $return .= '<a href="survey_list.php?'.api_get_cidreq().'&action=delete&survey_id='.$survey_id.'" onclick="javascript:if(!confirm(\''.addslashes(htmlentities(get_lang("DeleteSurvey").'?',ENT_QUOTES,$charset)).'\')) return false;">'.Display::return_icon('delete.gif', get_lang('Delete')).'</a>';
- //$return .= '<a href="create_survey_in_another_language.php?id_survey='.$survey_id.'">'.Display::return_icon('copy.gif', get_lang('Copy')).'</a>';
- //$return .= '<a href="survey.php?survey_id='.$survey_id.'">'.Display::return_icon('add.gif', get_lang('Add')).'</a>';
- $return .= '<a href="preview.php?'.api_get_cidreq().'&survey_id='.$survey_id.'">'.Display::return_icon('preview.gif', get_lang('Preview')).'</a>';
- $return .= '<a href="survey_invite.php?'.api_get_cidreq().'&survey_id='.$survey_id.'">'.Display::return_icon('survey_publish.gif', get_lang('Publish')).'</a>';
- $return .= '<a href="survey_list.php?'.api_get_cidreq().'&action=empty&survey_id='.$survey_id.'" onclick="javascript:if(!confirm(\''.addslashes(htmlentities(get_lang("EmptySurvey").'?')).'\')) return false;">'.Display::return_icon('empty.gif', get_lang('EmptySurvey')).'</a>';
- $return .= '<a href="reporting.php?'.api_get_cidreq().'&survey_id='.$survey_id.'">'.Display::return_icon('statistics.gif', get_lang('Reporting')).'</a>';
- return $return;
- }
- /**
- * Returns "yes" when given parameter is one, "no" for any other value
- * @param integer Whether anonymous or not
- * @return string "Yes" or "No" in the current language
- */
- function anonymous_filter($anonymous)
- {
- if ($anonymous == 1)
- {
- return get_lang('Yes');
- }
- else
- {
- return get_lang('No');
- }
- }
-
-
- /**
- * This function handles the search restriction for the SQL statements
- *
- * @return string Part of a SQL statement or false on error
- *
- * @author Patrick Cool <patrick.cool@UGent.be>, Ghent University
- * @version January 2007
- */
- function survey_search_restriction()
- {
- if ($_GET['do_search'])
- {
- if ($_GET['keyword_title']<>'')
- {
- $search_term[] = 'title =\''.Database::escape_string($_GET['keyword_title']).'\'';
- }
- if ($_GET['keyword_code']<>'')
- {
- $search_term[] = 'code =\''.Database::escape_string($_GET['keyword_code']).'\'';
- }
- if ($_GET['keyword_language']<>'%')
- {
- $search_term[] = 'lang =\''.Database::escape_string($_GET['keyword_language']).'\'';
- }
-
- $search_restriction = implode(' AND ', $search_term);
- return $search_restriction;
- }
- else
- {
- return false;
- }
- }
- /**
- * This function calculates the total number of surveys
- *
- * @return integer Total number of surveys
- *
- * @author Patrick Cool <patrick.cool@UGent.be>, Ghent University
- * @version January 2007
- */
- function get_number_of_surveys()
- {
- global $table_survey;
-
- $search_restriction = SurveyUtil::survey_search_restriction();
- if ($search_restriction)
- {
- $search_restriction = 'WHERE '.$search_restriction;
- }
-
- $sql = "SELECT count(survey_id) AS total_number_of_items FROM ".$table_survey.' '.$search_restriction;
- $res = api_sql_query($sql, __FILE__, __LINE__);
- $obj = Database::fetch_object($res);
- return $obj->total_number_of_items;
-
- }
-
- /**
- * This function gets all the survey data that is to be displayed in the sortable table
- *
- * @param unknown_type $from
- * @param unknown_type $number_of_items
- * @param unknown_type $column
- * @param unknown_type $direction
- * @return unknown
- *
- * @author Patrick Cool <patrick.cool@UGent.be>, Ghent University
- * @version January 2007
- */
- function get_survey_data($from, $number_of_items, $column, $direction)
- {
- global $table_survey;
- global $table_user;
- global $table_survey_question;
-
- // searching
- $search_restriction = SurveyUtil::survey_search_restriction();
- if ($search_restriction)
- {
- $search_restriction = ' AND '.$search_restriction;
- }
- $sql = "SELECT
- survey.survey_id AS col0,
- CONCAT('<a href=\"survey.php?survey_id=',survey.survey_id,'\">',survey.title,'</a>') AS col1,
- survey.code AS col2,
- count(survey_question.question_id) AS col3,
- CONCAT(user.firstname, ' ', user.lastname) AS col4,
- survey.lang AS col5,
- IF(is_shared<>0,'V','-') AS col6,
- survey.avail_from AS col7,
- survey.avail_till AS col8,
- CONCAT('<a href=\"survey_invitation.php?view=answered&survey_id=',survey.survey_id,'\">',survey.answered,'</a> / <a href=\"survey_invitation.php?view=invited&survey_id=',survey.survey_id,'\">',survey.invited, '</a>') AS col9,
- survey.anonymous AS col10,
- survey.survey_id AS col11
- FROM $table_survey survey
- LEFT JOIN $table_survey_question survey_question ON survey.survey_id = survey_question.survey_id
- , $table_user user
- WHERE survey.author = user.user_id
- $search_restriction
- ";
- $sql .= " GROUP BY survey.survey_id";
- $sql .= " ORDER BY col$column $direction ";
- $sql .= " LIMIT $from,$number_of_items";
- $res = api_sql_query($sql, __FILE__, __LINE__);
- $surveys = array ();
- while ($survey = Database::fetch_array($res))
- {
- $surveys[] = $survey;
- }
- return $surveys;
- }
- }
- ?>
|