1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192939495969798991001011021031041051061071081091101111121131141151161171181191201211221231241251261271281291301311321331341351361371381391401411421431441451461471481491501511521531541551561571581591601611621631641651661671681691701711721731741751761771781791801811821831841851861871881891901911921931941951961971981992002012022032042052062072082092102112122132142152162172182192202212222232242252262272282292302312322332342352362372382392402412422432442452462472482492502512522532542552562572582592602612622632642652662672682692702712722732742752762772782792802812822832842852862872882892902912922932942952962972982993003013023033043053063073083093103113123133143153163173183193203213223233243253263273283293303313323333343353363373383393403413423433443453463473483493503513523533543553563573583593603613623633643653663673683693703713723733743753763773783793803813823833843853863873883893903913923933943953963973983994004014024034044054064074084094104114124134144154164174184194204214224234244254264274284294304314324334344354364374384394404414424434444454464474484494504514524534544554564574584594604614624634644654664674684694704714724734744754764774784794804814824834844854864874884894904914924934944954964974984995005015025035045055065075085095105115125135145155165175185195205215225235245255265275285295305315325335345355365375385395405415425435445455465475485495505515525535545555565575585595605615625635645655665675685695705715725735745755765775785795805815825835845855865875885895905915925935945955965975985996006016026036046056066076086096106116126136146156166176186196206216226236246256266276286296306316326336346356366376386396406416426436446456466476486496506516526536546556566576586596606616626636646656666676686696706716726736746756766776786796806816826836846856866876886896906916926936946956966976986997007017027037047057067077087097107117127137147157167177187197207217227237247257267277287297307317327337347357367377387397407417427437447457467477487497507517527537547557567577587597607617627637647657667677687697707717727737747757767777787797807817827837847857867877887897907917927937947957967977987998008018028038048058068078088098108118128138148158168178188198208218228238248258268278288298308318328338348358368378388398408418428438448458468478488498508518528538548558568578588598608618628638648658668678688698708718728738748758768778788798808818828838848858868878888898908918928938948958968978988999009019029039049059069079089099109119129139149159169179189199209219229239249259269279289299309319329339349359369379389399409419429439449459469479489499509519529539549559569579589599609619629639649659669679689699709719729739749759769779789799809819829839849859869879889899909919929939949959969979989991000100110021003100410051006100710081009101010111012101310141015101610171018101910201021102210231024102510261027102810291030103110321033103410351036103710381039104010411042104310441045104610471048104910501051105210531054105510561057105810591060106110621063106410651066106710681069107010711072107310741075107610771078107910801081108210831084108510861087108810891090109110921093109410951096109710981099110011011102110311041105110611071108110911101111111211131114111511161117111811191120112111221123112411251126112711281129113011311132113311341135113611371138113911401141114211431144114511461147114811491150115111521153115411551156115711581159116011611162116311641165116611671168116911701171117211731174117511761177117811791180118111821183118411851186118711881189119011911192119311941195119611971198119912001201120212031204120512061207120812091210121112121213121412151216121712181219122012211222122312241225122612271228122912301231123212331234123512361237123812391240124112421243124412451246124712481249125012511252125312541255125612571258125912601261126212631264126512661267126812691270127112721273127412751276127712781279128012811282128312841285128612871288128912901291129212931294129512961297129812991300130113021303130413051306130713081309131013111312131313141315131613171318131913201321132213231324132513261327132813291330133113321333133413351336133713381339134013411342134313441345134613471348134913501351135213531354135513561357135813591360136113621363136413651366136713681369137013711372137313741375137613771378137913801381138213831384138513861387138813891390139113921393139413951396139713981399140014011402140314041405140614071408140914101411141214131414141514161417141814191420142114221423142414251426142714281429143014311432143314341435143614371438143914401441144214431444144514461447144814491450145114521453145414551456145714581459146014611462146314641465146614671468146914701471147214731474147514761477147814791480148114821483148414851486148714881489149014911492149314941495149614971498149915001501150215031504150515061507150815091510151115121513151415151516151715181519152015211522152315241525152615271528152915301531153215331534153515361537153815391540154115421543154415451546154715481549155015511552155315541555155615571558155915601561156215631564156515661567156815691570157115721573157415751576157715781579158015811582158315841585158615871588158915901591159215931594159515961597159815991600160116021603160416051606160716081609161016111612161316141615161616171618161916201621162216231624162516261627162816291630163116321633163416351636163716381639164016411642164316441645164616471648164916501651165216531654165516561657165816591660166116621663166416651666166716681669167016711672167316741675167616771678167916801681168216831684168516861687168816891690169116921693169416951696169716981699170017011702170317041705170617071708170917101711171217131714171517161717171817191720172117221723172417251726172717281729173017311732173317341735173617371738173917401741174217431744174517461747174817491750175117521753175417551756175717581759176017611762176317641765176617671768176917701771177217731774177517761777177817791780178117821783178417851786178717881789179017911792179317941795179617971798179918001801180218031804180518061807180818091810181118121813181418151816181718181819182018211822182318241825182618271828182918301831183218331834183518361837183818391840184118421843184418451846184718481849185018511852185318541855185618571858185918601861186218631864186518661867186818691870187118721873187418751876187718781879188018811882188318841885188618871888188918901891189218931894189518961897189818991900190119021903190419051906190719081909191019111912191319141915191619171918191919201921192219231924192519261927192819291930193119321933193419351936193719381939194019411942194319441945194619471948194919501951195219531954195519561957195819591960196119621963196419651966196719681969197019711972197319741975197619771978197919801981198219831984198519861987198819891990199119921993199419951996199719981999200020012002200320042005200620072008200920102011201220132014201520162017201820192020202120222023202420252026202720282029203020312032203320342035203620372038203920402041204220432044204520462047204820492050205120522053205420552056205720582059206020612062206320642065206620672068206920702071207220732074207520762077207820792080208120822083208420852086208720882089209020912092209320942095209620972098209921002101210221032104210521062107210821092110211121122113211421152116211721182119212021212122212321242125212621272128212921302131213221332134213521362137213821392140214121422143214421452146214721482149215021512152215321542155215621572158215921602161216221632164216521662167216821692170217121722173217421752176217721782179218021812182218321842185218621872188218921902191219221932194219521962197219821992200220122022203220422052206220722082209221022112212221322142215221622172218221922202221222222232224222522262227222822292230223122322233223422352236223722382239224022412242224322442245224622472248224922502251225222532254225522562257225822592260226122622263226422652266226722682269227022712272227322742275227622772278227922802281228222832284228522862287228822892290229122922293229422952296229722982299230023012302230323042305230623072308230923102311231223132314231523162317231823192320232123222323232423252326232723282329233023312332233323342335233623372338233923402341234223432344234523462347234823492350235123522353235423552356235723582359236023612362236323642365236623672368236923702371237223732374237523762377237823792380238123822383238423852386238723882389239023912392239323942395239623972398239924002401240224032404240524062407240824092410241124122413241424152416241724182419242024212422242324242425242624272428242924302431243224332434243524362437243824392440244124422443244424452446244724482449245024512452245324542455245624572458245924602461246224632464246524662467246824692470247124722473247424752476247724782479248024812482248324842485248624872488248924902491249224932494249524962497249824992500250125022503250425052506250725082509251025112512251325142515251625172518251925202521252225232524252525262527252825292530253125322533253425352536253725382539254025412542254325442545254625472548254925502551255225532554255525562557255825592560256125622563256425652566256725682569257025712572257325742575257625772578257925802581258225832584258525862587258825892590259125922593259425952596259725982599260026012602260326042605260626072608260926102611261226132614261526162617261826192620262126222623262426252626262726282629263026312632263326342635263626372638263926402641264226432644264526462647264826492650265126522653265426552656265726582659266026612662266326642665266626672668266926702671267226732674267526762677267826792680268126822683268426852686268726882689269026912692269326942695269626972698269927002701270227032704270527062707270827092710271127122713271427152716271727182719272027212722272327242725272627272728272927302731273227332734273527362737273827392740274127422743274427452746274727482749275027512752275327542755275627572758275927602761276227632764276527662767276827692770277127722773277427752776277727782779278027812782278327842785278627872788278927902791279227932794279527962797279827992800280128022803280428052806280728082809281028112812281328142815281628172818281928202821282228232824282528262827282828292830283128322833283428352836283728382839284028412842284328442845284628472848284928502851285228532854285528562857285828592860286128622863286428652866286728682869287028712872287328742875287628772878287928802881288228832884288528862887288828892890289128922893289428952896289728982899290029012902290329042905290629072908290929102911291229132914291529162917291829192920292129222923292429252926292729282929293029312932293329342935293629372938293929402941294229432944294529462947294829492950295129522953295429552956295729582959296029612962296329642965296629672968296929702971297229732974297529762977297829792980298129822983298429852986298729882989299029912992299329942995299629972998299930003001300230033004300530063007300830093010301130123013301430153016301730183019302030213022302330243025302630273028302930303031303230333034303530363037303830393040304130423043304430453046304730483049305030513052305330543055305630573058305930603061306230633064306530663067306830693070307130723073307430753076307730783079308030813082308330843085308630873088308930903091309230933094309530963097309830993100310131023103310431053106310731083109311031113112311331143115311631173118311931203121312231233124312531263127312831293130313131323133313431353136313731383139314031413142314331443145314631473148314931503151315231533154315531563157315831593160316131623163316431653166316731683169317031713172317331743175317631773178317931803181318231833184318531863187318831893190319131923193319431953196319731983199320032013202320332043205320632073208320932103211321232133214321532163217321832193220322132223223322432253226322732283229323032313232323332343235323632373238323932403241324232433244324532463247324832493250325132523253325432553256325732583259326032613262326332643265326632673268326932703271327232733274327532763277327832793280328132823283328432853286328732883289329032913292329332943295329632973298329933003301330233033304330533063307330833093310331133123313331433153316331733183319332033213322332333243325332633273328332933303331333233333334333533363337333833393340334133423343334433453346334733483349335033513352335333543355335633573358335933603361336233633364336533663367336833693370337133723373337433753376337733783379338033813382338333843385338633873388338933903391339233933394339533963397339833993400340134023403340434053406340734083409341034113412341334143415341634173418341934203421342234233424342534263427342834293430343134323433343434353436343734383439344034413442344334443445344634473448344934503451345234533454345534563457345834593460346134623463346434653466346734683469347034713472347334743475347634773478347934803481348234833484348534863487348834893490349134923493349434953496349734983499350035013502350335043505350635073508350935103511351235133514351535163517351835193520352135223523352435253526352735283529353035313532353335343535353635373538353935403541354235433544354535463547354835493550355135523553355435553556355735583559356035613562356335643565356635673568356935703571357235733574357535763577357835793580358135823583358435853586358735883589359035913592359335943595359635973598359936003601360236033604360536063607360836093610361136123613361436153616361736183619362036213622362336243625362636273628362936303631363236333634363536363637363836393640364136423643364436453646364736483649365036513652365336543655365636573658365936603661366236633664366536663667366836693670367136723673367436753676367736783679368036813682368336843685368636873688368936903691369236933694369536963697369836993700370137023703370437053706370737083709371037113712371337143715371637173718371937203721372237233724372537263727372837293730373137323733373437353736373737383739374037413742374337443745374637473748374937503751375237533754375537563757375837593760376137623763376437653766376737683769377037713772377337743775377637773778377937803781378237833784378537863787378837893790379137923793379437953796379737983799380038013802380338043805380638073808380938103811381238133814381538163817381838193820382138223823382438253826382738283829383038313832383338343835383638373838383938403841384238433844384538463847384838493850385138523853385438553856385738583859386038613862386338643865386638673868386938703871387238733874387538763877387838793880388138823883388438853886388738883889389038913892389338943895389638973898389939003901390239033904390539063907390839093910391139123913391439153916391739183919392039213922392339243925392639273928392939303931393239333934393539363937393839393940394139423943394439453946394739483949395039513952395339543955395639573958395939603961396239633964396539663967 |
- <?php
- /* For licensing terms, see /license.txt */
- use Chamilo\CourseBundle\Entity\CSurvey;
- use Chamilo\CourseBundle\Entity\CSurveyAnswer;
- use ChamiloSession as Session;
- /**
- * This class offers a series of general utility functions for survey querying and display.
- */
- 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 int $survey_id Survey ID (database ID)
- * @param bool $continue Optional. Whether to continue the current
- * process or exit when breaking condition found. Defaults to true (do not break).
- */
- public static function check_first_last_question($survey_id, $continue = true)
- {
- // Table definitions
- $tbl_survey_question = Database::get_course_table(TABLE_SURVEY_QUESTION);
- $course_id = api_get_course_int_id();
- $survey_id = (int) $survey_id;
- // Getting the information of the question
- $sql = "SELECT * FROM $tbl_survey_question
- WHERE c_id = $course_id AND survey_id='".$survey_id."'
- ORDER BY sort ASC";
- $result = Database::query($sql);
- $total = Database::num_rows($result);
- $counter = 1;
- $error = false;
- while ($row = Database::fetch_array($result, 'ASSOC')) {
- if ($counter == 1 && $row['type'] == 'pagebreak') {
- echo Display::return_message(get_lang('The page break cannot be the first'), 'error', false);
- $error = true;
- }
- if ($counter == $total && $row['type'] == 'pagebreak') {
- echo Display::return_message(get_lang('The page break cannot be the last one'), 'error', false);
- $error = true;
- }
- $counter++;
- }
- if (!$continue && $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 int The survey id
- * @param int The question id
- * @param int The option id
- *
- * @author Patrick Cool <patrick.cool@UGent.be>, Ghent University
- *
- * @version January 2007
- */
- public static function remove_answer($user, $survey_id, $question_id, $course_id)
- {
- $course_id = intval($course_id);
- // table definition
- $table = Database::get_course_table(TABLE_SURVEY_ANSWER);
- $sql = "DELETE FROM $table
- WHERE
- c_id = $course_id AND
- user = '".Database::escape_string($user)."' AND
- survey_id = '".intval($survey_id)."' AND
- question_id = '".intval($question_id)."'";
- Database::query($sql);
- }
- /**
- * 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 int Survey id
- * @param int Question id
- * @param int Option id
- * @param string Option value
- * @param array $survey_data Survey data settings
- *
- * @return bool False if insufficient data, true otherwise
- *
- * @author Patrick Cool <patrick.cool@UGent.be>, Ghent University
- *
- * @version January 2007
- */
- public static function store_answer(
- $user,
- $survey_id,
- $question_id,
- $option_id,
- $option_value,
- $survey_data
- ) {
- // If the question_id is empty, don't store an answer
- if (empty($question_id)) {
- return false;
- }
- // Table definition
- $table_survey_answer = Database::get_course_table(TABLE_SURVEY_ANSWER);
- // Make the survey anonymous
- if ($survey_data['anonymous'] == 1) {
- $surveyUser = Session::read('surveyuser');
- if (empty($surveyUser)) {
- $user = md5($user.time());
- Session::write('surveyuser', $user);
- } else {
- $user = Session::read('surveyuser');
- }
- }
- $answer = new CSurveyAnswer();
- $answer
- ->setCId($survey_data['c_id'])
- ->setUser($user)
- ->setSurveyId($survey_id)
- ->setQuestionId($question_id)
- ->setOptionId($option_id)
- ->setValue($option_value)
- ;
- $em = Database::getManager();
- $em->persist($answer);
- $em->flush();
- $insertId = $answer->getIid();
- if ($insertId) {
- $sql = "UPDATE $table_survey_answer SET answer_id = $insertId
- WHERE iid = $insertId";
- Database::query($sql);
- }
- return true;
- }
- /**
- * This function checks the parameters that are used in this page.
- *
- * @return string $people_filled 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
- */
- public static function check_parameters($people_filled)
- {
- $error = false;
- // Getting the survey data
- $survey_data = SurveyManager::get_survey($_GET['survey_id']);
- // $_GET['survey_id'] has to be numeric
- if (!is_numeric($_GET['survey_id'])) {
- $error = get_lang('Unknown survey id');
- }
- // $_GET['action']
- $allowed_actions = [
- 'overview',
- 'questionreport',
- 'userreport',
- 'comparativereport',
- 'completereport',
- 'deleteuserreport',
- ];
- if (isset($_GET['action']) && !in_array($_GET['action'], $allowed_actions)) {
- $error = get_lang('Action not allowed');
- }
- // User report
- if (isset($_GET['action']) && $_GET['action'] == 'userreport') {
- 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']) && !in_array($_GET['user'], $people_filled_userids)) {
- $error = get_lang('Unknow user');
- }
- }
- // Question report
- if (isset($_GET['action']) && $_GET['action'] == 'questionreport') {
- if (isset($_GET['question']) && !is_numeric($_GET['question'])) {
- $error = get_lang('Unknown question');
- }
- }
- if ($error) {
- $tool_name = get_lang('Reporting');
- Display::addFlash(
- Display::return_message(
- get_lang('Error').': '.$error,
- 'error',
- false
- )
- );
- Display::display_header($tool_name);
- Display::display_footer();
- exit;
- } else {
- return true;
- }
- }
- /**
- * This function deals with the action handling.
- *
- * @param array $survey_data
- * @param array $people_filled
- *
- * @author Patrick Cool <patrick.cool@UGent.be>, Ghent University
- *
- * @version February 2007
- */
- public static function handle_reporting_actions($survey_data, $people_filled)
- {
- $action = isset($_GET['action']) ? $_GET['action'] : '';
- // Getting the number of question
- $temp_questions_data = SurveyManager::get_questions($_GET['survey_id']);
- // Sorting like they should be displayed and removing the non-answer question types (comment and pagebreak)
- $my_temp_questions_data = $temp_questions_data == null ? [] : $temp_questions_data;
- $questions_data = [];
- foreach ($my_temp_questions_data as $key => &$value) {
- if ($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);
- switch ($action) {
- case 'questionreport':
- self::display_question_report($survey_data);
- break;
- case 'userreport':
- self::displayUserReport($survey_data, $people_filled);
- break;
- case 'comparativereport':
- self::display_comparative_report();
- break;
- case 'completereport':
- echo self::displayCompleteReport($survey_data);
- break;
- case 'deleteuserreport':
- self::delete_user_report($_GET['survey_id'], $_GET['user']);
- break;
- }
- }
- /**
- * This function deletes the report of an user who wants to retake the survey.
- *
- * @param int $survey_id
- * @param int $user_id
- *
- * @author Christian Fasanando Flores <christian.fasanando@dokeos.com>
- *
- * @version November 2008
- */
- public static function delete_user_report($survey_id, $user_id)
- {
- $table_survey_answer = Database::get_course_table(TABLE_SURVEY_ANSWER);
- $table_survey_invitation = Database::get_course_table(TABLE_SURVEY_INVITATION);
- $table_survey = Database::get_course_table(TABLE_SURVEY);
- $course_id = api_get_course_int_id();
- $survey_id = (int) $survey_id;
- $user_id = Database::escape_string($user_id);
- if (!empty($survey_id) && !empty($user_id)) {
- // delete data from survey_answer by user_id and survey_id
- $sql = "DELETE FROM $table_survey_answer
- WHERE c_id = $course_id AND survey_id = '".$survey_id."' AND user = '".$user_id."'";
- Database::query($sql);
- // update field answered from survey_invitation by user_id and survey_id
- $sql = "UPDATE $table_survey_invitation SET answered = '0'
- WHERE
- c_id = $course_id AND
- survey_code = (
- SELECT code FROM $table_survey
- WHERE
- c_id = $course_id AND
- survey_id = '".$survey_id."'
- ) AND
- user = '".$user_id."'";
- $result = Database::query($sql);
- }
- if ($result !== false) {
- $message = get_lang('The user\'s answers to the survey have been succesfully removed.').'<br />
- <a href="'.api_get_path(WEB_CODE_PATH).'survey/reporting.php?action=userreport&survey_id='
- .$survey_id.'">'.
- get_lang('Go back').'</a>';
- echo Display::return_message($message, 'confirmation', false);
- }
- }
- /**
- * @param array $survey_data
- * @param array $people_filled
- *
- * @return string
- */
- public static function displayUserReportForm($survey_data, $people_filled)
- {
- $surveyId = $survey_data['survey_id'];
- if (empty($survey_data)) {
- return '';
- }
- // Step 1: selection of the user
- echo "<script>
- function jumpMenu(targ,selObj,restore) {
- eval(targ+\".location='\"+selObj.options[selObj.selectedIndex].value+\"'\");
- if (restore) selObj.selectedIndex=0;
- }
- </script>";
- echo get_lang('Select user who filled the survey').'<br />';
- echo '<select name="user" onchange="jumpMenu(\'parent\',this,0)">';
- echo '<option value="'.api_get_path(WEB_CODE_PATH).'survey/reporting.php?action='
- .Security::remove_XSS($_GET['action']).'&survey_id='.$surveyId.'&'.api_get_cidreq().'">'
- .get_lang('User').'</option>';
- foreach ($people_filled as $key => &$person) {
- if ($survey_data['anonymous'] == 0) {
- $name = $person['user_info']['complete_name_with_username'];
- $id = $person['user_id'];
- if ($id == '') {
- $id = $person['invited_user'];
- $name = $person['invited_user'];
- }
- } else {
- $name = get_lang('Anonymous').' '.($key + 1);
- $id = $person;
- }
- echo '<option value="'.api_get_path(WEB_CODE_PATH).'survey/reporting.php?action='
- .Security::remove_XSS($_GET['action']).'&survey_id='.$surveyId.'&user='
- .Security::remove_XSS($id).'&'.api_get_cidreq().'" ';
- if (isset($_GET['user']) && $_GET['user'] == $id) {
- echo 'selected="selected"';
- }
- echo '>'.$name.'</option>';
- }
- echo '</select>';
- }
- /**
- * @param int $userId
- * @param array $survey_data
- * @param bool $addMessage
- */
- public static function displayUserReportAnswers($userId, $survey_data, $addMessage = true)
- {
- // 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);
- $course_id = (int) $survey_data['c_id'];
- $surveyId = (int) $survey_data['survey_id'];
- $userId = Database::escape_string($userId);
- $content = '';
- // Step 2: displaying the survey and the answer of the selected users
- if (!empty($userId)) {
- if ($addMessage) {
- $content .= Display::return_message(
- get_lang('This screen displays an exact copy of the form as it was filled by the user'),
- 'normal',
- 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 AND
- survey_question_option.c_id = $course_id
- WHERE
- survey_question NOT LIKE '%{{%' AND
- survey_question.survey_id = '".$surveyId."' AND
- survey_question.c_id = $course_id
- ORDER BY survey_question.sort, survey_question_option.sort ASC";
- $result = Database::query($sql);
- while ($row = Database::fetch_array($result, 'ASSOC')) {
- 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
- c_id = $course_id AND
- survey_id = '".$surveyId."' AND
- user = '".$userId."'";
- $result = Database::query($sql);
- while ($row = Database::fetch_array($result, 'ASSOC')) {
- $answers[$row['question_id']][] = $row['option_id'];
- $all_answers[$row['question_id']][] = $row;
- }
- // Displaying all the questions
- foreach ($questions as &$question) {
- // If the question type is a scoring then we have to format the answers differently
- switch ($question['type']) {
- case 'score':
- $finalAnswer = [];
- if (is_array($question) && is_array($all_answers)) {
- foreach ($all_answers[$question['question_id']] as $key => &$answer_array) {
- $finalAnswer[$answer_array['option_id']] = $answer_array['value'];
- }
- }
- break;
- case 'multipleresponse':
- $finalAnswer = isset($answers[$question['question_id']])
- ? $answers[$question['question_id']]
- : '';
- break;
- default:
- $finalAnswer = '';
- if (isset($all_answers[$question['question_id']])) {
- $finalAnswer = $all_answers[$question['question_id']][0]['option_id'];
- }
- break;
- }
- $display = survey_question::createQuestion($question['type']);
- $url = api_get_self();
- $form = new FormValidator('question', 'post', $url);
- $form->addHtml('<div class="survey_question_wrapper"><div class="survey_question">');
- $form->addHtml($question['survey_question']);
- $display->render($form, $question, $finalAnswer);
- $form->addHtml('</div></div>');
- $content .= $form->returnForm();
- }
- }
- return $content;
- }
- /**
- * 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
- */
- public static function displayUserReport($survey_data, $people_filled, $addActionBar = true)
- {
- if (empty($survey_data)) {
- return '';
- }
- $surveyId = $survey_data['survey_id'];
- $reportingUrl = api_get_path(WEB_CODE_PATH).'survey/reporting.php?survey_id='.$surveyId.'&'.api_get_cidreq();
- // Actions bar
- if ($addActionBar) {
- echo '<div class="actions">';
- echo '<a href="'.$reportingUrl.'">'.
- Display::return_icon(
- 'back.png',
- get_lang('Back to').' '.get_lang('Reporting overview'),
- '',
- ICON_SIZE_MEDIUM
- )
- .'</a>';
- if (isset($_GET['user'])) {
- if (api_is_allowed_to_edit()) {
- // The delete link
- echo '<a href="'.$reportingUrl.'&action=deleteuserreport&user='.Security::remove_XSS($_GET['user']).'" >'.
- Display::return_icon('delete.png', get_lang('Delete'), '', ICON_SIZE_MEDIUM).'</a>';
- }
- // Export the user report
- echo '<a href="javascript: void(0);" onclick="document.form1a.submit();">'
- .Display::return_icon('export_csv.png', get_lang('CSV export'), '', ICON_SIZE_MEDIUM).'</a> ';
- echo '<a href="javascript: void(0);" onclick="document.form1b.submit();">'
- .Display::return_icon('export_excel.png', get_lang('Excel export'), '', ICON_SIZE_MEDIUM).'</a> ';
- echo '<form id="form1a" name="form1a" method="post" action="'.api_get_self().'?action='
- .Security::remove_XSS($_GET['action']).'&survey_id='.$surveyId.'&'.api_get_cidreq().'&user_id='
- .Security::remove_XSS($_GET['user']).'">';
- 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='.$surveyId.'&'.api_get_cidreq().'&user_id='
- .Security::remove_XSS($_GET['user']).'">';
- 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='.$surveyId.'&'.api_get_cidreq().'">';
- }
- echo '</div>';
- }
- echo self::displayUserReportForm($survey_data, $people_filled);
- if (isset($_GET['user'])) {
- echo self::displayUserReportAnswers($_GET['user'], $survey_data);
- }
- }
- /**
- * 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
- */
- public static function display_question_report($survey_data)
- {
- $singlePage = isset($_GET['single_page']) ? (int) $_GET['single_page'] : 0;
- // Determining the offset of the sql statement (the n-th question of the survey)
- $offset = !isset($_GET['question']) ? 0 : (int) $_GET['question'];
- $currentQuestion = isset($_GET['question']) ? (int) $_GET['question'] : 0;
- $surveyId = (int) $_GET['survey_id'];
- $action = Security::remove_XSS($_GET['action']);
- $course_id = api_get_course_int_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);
- $questions = [];
- echo '<div class="actions">';
- echo '<a href="'.api_get_path(WEB_CODE_PATH).'survey/reporting.php?survey_id='.$surveyId.'&'.api_get_cidreq().'">'.
- Display::return_icon(
- 'back.png',
- get_lang('Back to').' '.get_lang('Reporting overview'),
- '',
- ICON_SIZE_MEDIUM
- ).'</a>';
- echo '</div>';
- if ($survey_data['number_of_questions'] > 0) {
- $limitStatement = null;
- if (!$singlePage) {
- echo '<div id="question_report_questionnumbers" class="pagination">';
- if ($currentQuestion != 0) {
- echo '<li><a href="'.api_get_path(WEB_CODE_PATH).'survey/reporting.php?action='.$action.'&'
- .api_get_cidreq().'&survey_id='.$surveyId.'&question='.($offset - 1).'">'
- .get_lang('Previous question').'</a></li>';
- }
- for ($i = 1; $i <= $survey_data['number_of_questions']; $i++) {
- if ($offset != $i - 1) {
- echo '<li><a href="'.api_get_path(WEB_CODE_PATH).'survey/reporting.php?action='.$action.'&'
- .api_get_cidreq().'&survey_id='.$surveyId.'&question='.($i - 1).'">'.$i.'</a></li>';
- } else {
- echo '<li class="disabled"s><a href="#">'.$i.'</a></li>';
- }
- }
- if ($currentQuestion < ($survey_data['number_of_questions'] - 1)) {
- echo '<li><a href="'.api_get_path(WEB_CODE_PATH).'survey/reporting.php?action='.$action.'&'
- .api_get_cidreq().'&survey_id='.$surveyId.'&question='.($offset + 1).'">'
- .get_lang('Next question').'</li></a>';
- }
- echo '</ul>';
- echo '</div>';
- $limitStatement = " LIMIT $offset, 1";
- }
- // Getting the question information
- $sql = "SELECT * FROM $table_survey_question
- WHERE
- c_id = $course_id AND
- survey_id='".$surveyId."' AND
- survey_question NOT LIKE '%{{%' AND
- type <>'pagebreak'
- ORDER BY sort ASC
- $limitStatement";
- $result = Database::query($sql);
- while ($row = Database::fetch_array($result)) {
- $questions[$row['question_id']] = $row;
- }
- }
- foreach ($questions as $question) {
- $chartData = [];
- $options = [];
- $questionId = (int) $question['question_id'];
- echo '<div class="title-question">';
- echo strip_tags(isset($question['survey_question']) ? $question['survey_question'] : null);
- echo '</div>';
- if ($question['type'] == 'score') {
- /** @todo This function should return the options as this is needed further in the code */
- $options = self::display_question_report_score($survey_data, $question, $offset);
- } elseif ($question['type'] == 'open' || $question['type'] == 'comment') {
- /** @todo Also get the user who has answered this */
- $sql = "SELECT * FROM $table_survey_answer
- WHERE
- c_id = $course_id AND
- survey_id='".$surveyId."' AND
- question_id = '".$questionId."'";
- $result = Database::query($sql);
- while ($row = Database::fetch_array($result, 'ASSOC')) {
- echo $row['option_id'].'<hr noshade="noshade" size="1" />';
- }
- } else {
- // Getting the options ORDER BY sort ASC
- $sql = "SELECT * FROM $table_survey_question_option
- WHERE
- c_id = $course_id AND
- survey_id='".$surveyId."'
- AND question_id = '".$questionId."'
- ORDER BY sort ASC";
- $result = Database::query($sql);
- while ($row = Database::fetch_array($result, 'ASSOC')) {
- $options[$row['question_option_id']] = $row;
- }
- // Getting the answers
- $sql = "SELECT *, count(answer_id) as total FROM $table_survey_answer
- WHERE
- c_id = $course_id AND
- survey_id='".$surveyId."'
- AND question_id = '".$questionId."'
- GROUP BY option_id, value";
- $result = Database::query($sql);
- $number_of_answers = [];
- $data = [];
- while ($row = Database::fetch_array($result, 'ASSOC')) {
- if (!isset($number_of_answers[$row['question_id']])) {
- $number_of_answers[$row['question_id']] = 0;
- }
- $number_of_answers[$row['question_id']] += $row['total'];
- $data[$row['option_id']] = $row;
- }
- foreach ($options as $option) {
- $optionText = strip_tags($option['option_text']);
- $optionText = html_entity_decode($optionText);
- $votes = isset($data[$option['question_option_id']]['total']) ?
- $data[$option['question_option_id']]['total'] : '0';
- array_push($chartData, ['option' => $optionText, 'votes' => $votes]);
- }
- $chartContainerId = 'chartContainer'.$question['question_id'];
- echo '<div id="'.$chartContainerId.'" class="col-md-12">';
- echo self::drawChart($chartData, false, $chartContainerId);
- // displaying the table: headers
- echo '<table class="display-survey table">';
- echo ' <tr>';
- echo ' <th> </th>';
- echo ' <th>'.get_lang('Absolute total').'</th>';
- echo ' <th>'.get_lang('Percentage').'</th>';
- echo ' <th>'.get_lang('Graphic').'</th>';
- echo ' <tr>';
- // Displaying the table: the content
- if (is_array($options)) {
- foreach ($options as $key => &$value) {
- $absolute_number = null;
- if (isset($data[$value['question_option_id']])) {
- $absolute_number = $data[$value['question_option_id']]['total'];
- }
- if ($question['type'] == 'percentage' && empty($absolute_number)) {
- continue;
- }
- $number_of_answers[$option['question_id']] = isset($number_of_answers[$option['question_id']])
- ? $number_of_answers[$option['question_id']]
- : 0;
- if ($number_of_answers[$option['question_id']] == 0) {
- $answers_number = 0;
- } else {
- $answers_number = $absolute_number / $number_of_answers[$option['question_id']] * 100;
- }
- echo ' <tr>';
- echo ' <td class="center">'.$value['option_text'].'</td>';
- echo ' <td class="center">';
- if ($absolute_number != 0) {
- echo '<a href="'.api_get_path(WEB_CODE_PATH).'survey/reporting.php?action='.$action
- .'&survey_id='.$surveyId.'&question='.$offset.'&viewoption='
- .$value['question_option_id'].'">'.$absolute_number.'</a>';
- } else {
- echo '0';
- }
- echo ' </td>';
- echo ' <td class="center">'.round($answers_number, 2).' %</td>';
- echo ' <td class="center">';
- $size = $answers_number * 2;
- if ($size > 0) {
- echo '<div style="border:1px solid #264269; background-color:#aecaf4; height:10px; width:'
- .$size.'px"> </div>';
- } else {
- echo '<div style="text-align: left;">'.get_lang("No data available").'</div>';
- }
- echo ' </td>';
- echo ' </tr>';
- }
- }
- $optionResult = '';
- if (isset($option['question_id']) && isset($number_of_answers[$option['question_id']])) {
- if ($number_of_answers[$option['question_id']] == 0) {
- $optionResult = '0';
- } else {
- $optionResult = $number_of_answers[$option['question_id']];
- }
- }
- // displaying the table: footer (totals)
- echo ' <tr>';
- echo ' <td class="total"><b>'.get_lang('Total').'</b></td>';
- echo ' <td class="total"><b>'.$optionResult.'</b></td>';
- echo ' <td class="total"> </td>';
- echo ' <td class="total"> </td>';
- echo ' </tr>';
- echo '</table>';
- echo '</div>';
- }
- }
- if (isset($_GET['viewoption'])) {
- echo '<div class="answered-people">';
- echo '<h4>'.get_lang('People who have chosen this answer').': '
- .strip_tags($options[Security::remove_XSS($_GET['viewoption'])]['option_text']).'</h4>';
- if (is_numeric($_GET['value'])) {
- $sql_restriction = "AND value='".Database::escape_string($_GET['value'])."'";
- }
- $sql = "SELECT user FROM $table_survey_answer
- WHERE
- c_id = $course_id AND
- option_id = '".Database::escape_string($_GET['viewoption'])."'
- $sql_restriction";
- $result = Database::query($sql);
- echo '<ul>';
- while ($row = Database::fetch_array($result, 'ASSOC')) {
- $user_info = api_get_user_info($row['user']);
- echo '<li><a href="'.api_get_path(WEB_CODE_PATH).'survey/reporting.php?action=userreport&survey_id='
- .$surveyId.'&user='.$row['user'].'">'
- .$user_info['complete_name_with_username']
- .'</a></li>';
- }
- echo '</ul>';
- echo '</div>';
- }
- }
- /**
- * Display score data about a survey question.
- *
- * @param array Question info
- * @param int The offset of results shown
- */
- public static function display_question_report_score($survey_data, $question, $offset)
- {
- // Database table definitions
- $action = isset($_GET['action']) ? Security::remove_XSS($_GET['action']) : '';
- $table_survey_question_option = Database::get_course_table(TABLE_SURVEY_QUESTION_OPTION);
- $table_survey_answer = Database::get_course_table(TABLE_SURVEY_ANSWER);
- $course_id = api_get_course_int_id();
- // Getting the options
- $sql = "SELECT * FROM $table_survey_question_option
- WHERE
- c_id = $course_id AND
- survey_id='".intval($_GET['survey_id'])."' AND
- question_id = '".intval($question['question_id'])."'
- ORDER BY sort ASC";
- $result = Database::query($sql);
- 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
- c_id = $course_id AND
- survey_id='".intval($_GET['survey_id'])."' AND
- question_id = '".Database::escape_string($question['question_id'])."'
- GROUP BY option_id, value";
- $result = Database::query($sql);
- $number_of_answers = 0;
- while ($row = Database::fetch_array($result)) {
- $number_of_answers += $row['total'];
- $data[$row['option_id']][$row['value']] = $row;
- }
- $chartData = [];
- foreach ($options as $option) {
- $optionText = strip_tags($option['option_text']);
- $optionText = html_entity_decode($optionText);
- for ($i = 1; $i <= $question['max_value']; $i++) {
- $votes = $data[$option['question_option_id']][$i]['total'];
- if (empty($votes)) {
- $votes = '0';
- }
- array_push(
- $chartData,
- [
- 'serie' => $optionText,
- 'option' => $i,
- 'votes' => $votes,
- ]
- );
- }
- }
- echo '<div id="chartContainer" class="col-md-12">';
- echo self::drawChart($chartData, true);
- echo '</div>';
- // Displaying the table: headers
- echo '<table class="data_table">';
- echo ' <tr>';
- echo ' <th> </th>';
- echo ' <th>'.get_lang('Score').'</th>';
- echo ' <th>'.get_lang('Absolute total').'</th>';
- echo ' <th>'.get_lang('Percentage').'</th>';
- echo ' <th>'.get_lang('Graphic').'</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="'.api_get_path(WEB_CODE_PATH).'survey/reporting.php?action='.$action
- .'&survey_id='.intval($_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.
- *
- * @param array $survey_data
- * @param int $userId
- * @param bool $addActionBar
- * @param bool $addFilters
- * @param bool $addExtraFields
- *
- * @return string
- */
- public static function displayCompleteReport(
- $survey_data,
- $userId = 0,
- $addActionBar = true,
- $addFilters = true,
- $addExtraFields = true
- ) {
- // 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);
- $surveyId = (int) $survey_data['survey_id'];
- $course_id = (int) $survey_data['c_id'];
- if (empty($surveyId) || empty($course_id)) {
- return '';
- }
- $action = isset($_GET['action']) ? Security::remove_XSS($_GET['action']) : '';
- $content = '';
- if ($addActionBar) {
- $content .= '<div class="actions">';
- $content .= '<a
- href="'.api_get_path(WEB_CODE_PATH).'survey/reporting.php?survey_id='.$surveyId.'&'.api_get_cidreq().'">'
- .Display::return_icon(
- 'back.png',
- get_lang('Back to').' '.get_lang('Reporting overview'),
- [],
- ICON_SIZE_MEDIUM
- )
- .'</a>';
- $content .= '<a class="survey_export_link" href="javascript: void(0);" onclick="document.form1a.submit();">'
- .Display::return_icon('export_csv.png', get_lang('CSV export'), '', ICON_SIZE_MEDIUM).'</a>';
- $content .= '<a class="survey_export_link" href="javascript: void(0);" onclick="document.form1b.submit();">'
- .Display::return_icon('export_excel.png', get_lang('Excel export'), '', ICON_SIZE_MEDIUM).'</a>';
- $content .= '</div>';
- // The form
- $content .= '<form id="form1a" name="form1a" method="post" action="'.api_get_self(
- ).'?action='.$action.'&survey_id='
- .$surveyId.'&'.api_get_cidreq().'">';
- $content .= '<input type="hidden" name="export_report" value="export_report">';
- $content .= '<input type="hidden" name="export_format" value="csv">';
- $content .= '</form>';
- $content .= '<form id="form1b" name="form1b" method="post" action="'.api_get_self(
- ).'?action='.$action.'&survey_id='
- .$surveyId.'&'.api_get_cidreq().'">';
- $content .= '<input type="hidden" name="export_report" value="export_report">';
- $content .= '<input type="hidden" name="export_format" value="xls">';
- $content .= '</form>';
- }
- $content .= '<form id="form2" name="form2" method="post" action="'.api_get_self().'?action='.$action.'&survey_id='
- .$surveyId.'&'.api_get_cidreq().'">';
- // The table
- $content .= '<br /><table class="data_table" border="1">';
- // Getting the number of options per question
- $content .= ' <tr>';
- $content .= ' <th>';
- if ($addFilters) {
- if ((isset($_POST['submit_question_filter']) && $_POST['submit_question_filter']) ||
- (isset($_POST['export_report']) && $_POST['export_report'])
- ) {
- $content .= '<button class="cancel"
- type="submit"
- name="reset_question_filter" value="'.get_lang('Reset filter').'">'.
- get_lang('Reset filter').'</button>';
- }
- $content .= '<button
- class = "save"
- type="submit" name="submit_question_filter" value="'.get_lang('Filter').'">'.
- get_lang('Filter').'</button>';
- $content .= '</th>';
- }
- $display_extra_user_fields = false;
- if ($addExtraFields) {
- if (!(isset($_POST['submit_question_filter']) && $_POST['submit_question_filter'] ||
- isset($_POST['export_report']) && $_POST['export_report']) ||
- !empty($_POST['fields_filter'])
- ) {
- // Show user fields section with a big th colspan that spans over all fields
- $extra_user_fields = UserManager::get_extra_fields(
- 0,
- 0,
- 5,
- 'ASC',
- false,
- true
- );
- $num = count($extra_user_fields);
- if ($num > 0) {
- $content .= '<th '.($num > 0 ? ' colspan="'.$num.'"' : '').'>';
- $content .= '<label>';
- if ($addFilters) {
- $content .= '<input type="checkbox" name="fields_filter" value="1" checked="checked"/> ';
- }
- $content .= get_lang('Profile attributes');
- $content .= '</label>';
- $content .= '</th>';
- $display_extra_user_fields = true;
- }
- }
- }
- $sql = "SELECT
- q.question_id,
- q.type,
- q.survey_question,
- count(o.question_option_id) as number_of_options
- FROM $table_survey_question q
- LEFT JOIN $table_survey_question_option o
- ON q.question_id = o.question_id AND q.c_id = o.c_id
- WHERE
- survey_question NOT LIKE '%{{%' AND
- q.survey_id = '".$surveyId."' AND
- q.c_id = $course_id
- GROUP BY q.question_id
- ORDER BY q.sort ASC";
- $result = Database::query($sql);
- $questions = [];
- 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 (!(isset($_POST['submit_question_filter']) && $_POST['submit_question_filter']) ||
- (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'] != 'pagebreak') {
- $content .= ' <th';
- if ($row['number_of_options'] > 0 && $row['type'] != 'percentage') {
- $content .= ' colspan="'.$row['number_of_options'].'"';
- }
- $content .= '>';
- $content .= '<label>';
- if ($addFilters) {
- $content .= '<input
- type="checkbox"
- name="questions_filter[]" value="'.$row['question_id'].'" checked="checked"/>';
- }
- $content .= $row['survey_question'];
- $content .= '</label>';
- $content .= '</th>';
- }
- // No column at all if it's not a question
- }
- $questions[$row['question_id']] = $row;
- }
- $content .= ' </tr>';
- // Getting all the questions and options
- $content .= ' <tr>';
- $content .= ' <th> </th>'; // the user column
- if (!(isset($_POST['submit_question_filter']) && $_POST['submit_question_filter'] ||
- isset($_POST['export_report']) && $_POST['export_report']) || !empty($_POST['fields_filter'])
- ) {
- if ($addExtraFields) {
- // show the fields names for user fields
- foreach ($extra_user_fields as &$field) {
- $content .= '<th>'.$field[3].'</th>';
- }
- }
- }
- // cells with option (none for open question)
- $sql = "SELECT
- sq.question_id,
- sq.survey_id,
- sq.survey_question,
- sq.display,
- sq.sort,
- sq.type,
- sqo.question_option_id,
- sqo.option_text,
- sqo.sort as option_sort
- FROM $table_survey_question sq
- LEFT JOIN $table_survey_question_option sqo
- ON sq.question_id = sqo.question_id AND sq.c_id = sqo.c_id
- WHERE
- survey_question NOT LIKE '%{{%' AND
- sq.survey_id = '".$surveyId."' AND
- sq.c_id = $course_id
- ORDER BY sq.sort ASC, sqo.sort ASC";
- $result = Database::query($sql);
- $display_percentage_header = 1;
- $possible_answers = [];
- // in order to display only once the cell option (and not 100 times)
- 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 question filter but the question is selected for display
- if (!(isset($_POST['submit_question_filter']) && $_POST['submit_question_filter']) ||
- (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'] == 'open' || $row['type'] == 'comment') {
- $content .= '<th> - </th>';
- $possible_answers[$row['question_id']][$row['question_option_id']] = $row['question_option_id'];
- $display_percentage_header = 1;
- } elseif ($row['type'] == 'percentage' && $display_percentage_header) {
- $content .= '<th> % </th>';
- $possible_answers[$row['question_id']][$row['question_option_id']] = $row['question_option_id'];
- $display_percentage_header = 0;
- } elseif ($row['type'] == 'percentage') {
- $possible_answers[$row['question_id']][$row['question_option_id']] = $row['question_option_id'];
- } elseif ($row['type'] != 'pagebreak' && $row['type'] != 'percentage') {
- $content .= '<th>';
- $content .= $row['option_text'];
- $content .= '</th>';
- $possible_answers[$row['question_id']][$row['question_option_id']] = $row['question_option_id'];
- $display_percentage_header = 1;
- }
- }
- }
- $content .= ' </tr>';
- $userCondition = '';
- if (!empty($userId)) {
- $userId = (int) $userId;
- $userCondition = " AND user = $userId ";
- }
- // Getting all the answers of the users
- $old_user = '';
- $answers_of_user = [];
- $sql = "SELECT * FROM $table_survey_answer
- WHERE
- c_id = $course_id AND
- survey_id = $surveyId
- $userCondition
- ORDER BY answer_id, user ASC";
- $result = Database::query($sql);
- $i = 1;
- while ($row = Database::fetch_array($result)) {
- if ($old_user != $row['user'] && $old_user != '') {
- $userParam = $old_user;
- if ($survey_data['anonymous'] != 0) {
- $userParam = $i;
- $i++;
- }
- $content .= self::display_complete_report_row(
- $survey_data,
- $possible_answers,
- $answers_of_user,
- $userParam,
- $questions,
- $display_extra_user_fields
- );
- $answers_of_user = [];
- }
- if (isset($questions[$row['question_id']]) &&
- $questions[$row['question_id']]['type'] != 'open' &&
- $questions[$row['question_id']]['type'] != 'comment'
- ) {
- $answers_of_user[$row['question_id']][$row['option_id']] = $row;
- } else {
- $answers_of_user[$row['question_id']][0] = $row;
- }
- $old_user = $row['user'];
- }
- $userParam = $old_user;
- if ($survey_data['anonymous'] != 0) {
- $userParam = $i;
- $i++;
- }
- $content .= self::display_complete_report_row(
- $survey_data,
- $possible_answers,
- $answers_of_user,
- $userParam,
- $questions,
- $display_extra_user_fields
- );
- // This is to display the last user
- $content .= '</table>';
- $content .= '</form>';
- return $content;
- }
- /**
- * Return user answers in a row.
- *
- * @param $survey_data
- * @param $possible_options
- * @param $answers_of_user
- * @param $user
- * @param $questions
- * @param bool $display_extra_user_fields
- *
- * @return string
- */
- public static function display_complete_report_row(
- $survey_data,
- $possible_options,
- $answers_of_user,
- $user,
- $questions,
- $display_extra_user_fields = false
- ) {
- $user = Security::remove_XSS($user);
- $surveyId = (int) $survey_data['survey_id'];
- if (empty($surveyId)) {
- return '';
- }
- $content = '<tr>';
- $url = api_get_path(WEB_CODE_PATH).'survey/reporting.php?survey_id='.$surveyId.'&'.api_get_cidreq();
- if ($survey_data['anonymous'] == 0) {
- if (intval($user) !== 0) {
- $userInfo = api_get_user_info($user);
- $user_displayed = '-';
- if (!empty($userInfo)) {
- $user_displayed = $userInfo['complete_name_with_username'];
- }
- $content .= '<th>
- <a href="'.$url.'&action=userreport&user='.$user.'">'
- .$user_displayed.'</a>
- </th>'; // the user column
- } else {
- $content .= '<th>'.$user.'</th>'; // the user column
- }
- } else {
- $content .= '<th>'.get_lang('Anonymous').' '.$user.'</th>';
- }
- if ($display_extra_user_fields) {
- // Show user fields data, if any, for this user
- $user_fields_values = UserManager::get_extra_user_data(
- $user,
- false,
- false,
- false,
- true
- );
- foreach ($user_fields_values as &$value) {
- $content .= '<td align="center">'.$value.'</td>';
- }
- }
- if (is_array($possible_options)) {
- foreach ($possible_options as $question_id => &$possible_option) {
- if ($questions[$question_id]['type'] == 'open' || $questions[$question_id]['type'] == 'comment') {
- $content .= '<td align="center">';
- if (isset($answers_of_user[$question_id]) && isset($answers_of_user[$question_id]['0'])) {
- $content .= $answers_of_user[$question_id]['0']['option_id'];
- }
- $content .= '</td>';
- } else {
- foreach ($possible_option as $option_id => &$value) {
- if ($questions[$question_id]['type'] == 'percentage') {
- if (!empty($answers_of_user[$question_id][$option_id])) {
- $content .= "<td align='center'>";
- $content .= $answers_of_user[$question_id][$option_id]['value'];
- $content .= "</td>";
- }
- } else {
- $content .= '<td align="center">';
- if (!empty($answers_of_user[$question_id][$option_id])) {
- if ($answers_of_user[$question_id][$option_id]['value'] != 0) {
- $content .= $answers_of_user[$question_id][$option_id]['value'];
- } else {
- $content .= 'v';
- }
- }
- }
- }
- }
- }
- }
- $content .= '</tr>';
- return $content;
- }
- /**
- * 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
- */
- public static function export_complete_report($survey_data, $user_id = 0)
- {
- $surveyId = isset($_GET['survey_id']) ? (int) $_GET['survey_id'] : 0;
- if (empty($surveyId)) {
- return false;
- }
- $course_id = api_get_course_int_id();
- $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 = ';';
- // Show extra fields blank space (enough for extra fields on next line)
- $extra_user_fields = UserManager::get_extra_fields(
- 0,
- 0,
- 5,
- 'ASC',
- false,
- true
- );
- $num = count($extra_user_fields);
- $return .= str_repeat(';', $num);
- $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
- options.c_id = questions.c_id
- WHERE
- survey_question NOT LIKE '%{{%' AND
- questions.type <> 'pagebreak' AND
- questions.survey_id = $surveyId AND
- questions.c_id = $course_id
- GROUP BY questions.question_id
- ORDER BY questions.sort ASC";
- $result = Database::query($sql);
- 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 (!(isset($_POST['submit_question_filter'])) ||
- (isset($_POST['submit_question_filter']) &&
- is_array($_POST['questions_filter']) &&
- in_array($row['question_id'], $_POST['questions_filter']))
- ) {
- if ($row['number_of_options'] == 0) {
- $return .= str_replace(
- "\r\n",
- ' ',
- api_html_entity_decode(strip_tags($row['survey_question']), ENT_QUOTES)
- )
- .';';
- } else {
- for ($ii = 0; $ii < $row['number_of_options']; $ii++) {
- $return .= str_replace(
- "\r\n",
- ' ',
- api_html_entity_decode(strip_tags($row['survey_question']), ENT_QUOTES)
- )
- .';';
- }
- }
- }
- }
- $return .= "\n";
- // Getting all the questions and options
- $return .= ';';
- // Show the fields names for user fields
- if (!empty($extra_user_fields)) {
- foreach ($extra_user_fields as &$field) {
- $return .= '"'
- .str_replace(
- "\r\n",
- ' ',
- api_html_entity_decode(strip_tags($field[3]), ENT_QUOTES)
- )
- .'";';
- }
- }
- $sql = "SELECT DISTINCT
- 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 AND
- survey_question_option.c_id = survey_question.c_id
- WHERE
- survey_question NOT LIKE '%{{%' AND
- survey_question.type <> 'pagebreak' AND
- survey_question.survey_id = $surveyId AND
- survey_question.c_id = $course_id
- ORDER BY survey_question.sort ASC, survey_question_option.sort ASC";
- $result = Database::query($sql);
- $possible_answers = [];
- $possible_answers_type = [];
- 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 question filter but the question is selected for display
- if (!(isset($_POST['submit_question_filter'])) || (
- is_array($_POST['questions_filter']) &&
- in_array($row['question_id'], $_POST['questions_filter'])
- )
- ) {
- $row['option_text'] = str_replace(["\r", "\n"], ['', ''], $row['option_text']);
- $return .= api_html_entity_decode(strip_tags($row['option_text']), ENT_QUOTES).';';
- $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 = [];
- $sql = "SELECT * FROM $table_survey_answer
- WHERE
- c_id = $course_id AND
- survey_id='".$surveyId."'
- ";
- if ($user_id != 0) {
- $sql .= "AND user='".Database::escape_string($user_id)."' ";
- }
- $sql .= ' ORDER BY user ASC ';
- $questionIdList = array_keys($possible_answers_type);
- $open_question_iterator = 1;
- $result = Database::query($sql);
- while ($row = Database::fetch_array($result, 'ASSOC')) {
- if (!in_array($row['question_id'], $questionIdList)) {
- continue;
- }
- if ($old_user != $row['user'] && $old_user != '') {
- $return .= self::export_complete_report_row(
- $survey_data,
- $possible_answers,
- $answers_of_user,
- $old_user,
- true
- );
- $answers_of_user = [];
- }
- if ($possible_answers_type[$row['question_id']] == 'open' ||
- $possible_answers_type[$row['question_id']] == 'comment'
- ) {
- $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'];
- }
- // This is to display the last user
- $return .= self::export_complete_report_row(
- $survey_data,
- $possible_answers,
- $answers_of_user,
- $old_user,
- true
- );
- 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
- * @param bool Whether to display user fields or not
- *
- * @return string One line of the csv file
- *
- * @author Patrick Cool <patrick.cool@UGent.be>, Ghent University
- *
- * @version February 2007
- */
- public static function export_complete_report_row(
- $survey_data,
- $possible_options,
- $answers_of_user,
- $user,
- $display_extra_user_fields = false
- ) {
- $return = '';
- if ($survey_data['anonymous'] == 0) {
- if (intval($user) !== 0) {
- $userInfo = api_get_user_info($user);
- if (!empty($userInfo)) {
- $user_displayed = $userInfo['complete_name_with_username'];
- } else {
- $user_displayed = '-';
- }
- $return .= $user_displayed.';';
- } else {
- $return .= $user.';';
- }
- } else {
- $return .= '-;'; // The user column
- }
- if ($display_extra_user_fields) {
- // Show user fields data, if any, for this user
- $user_fields_values = UserManager::get_extra_user_data(
- $user,
- false,
- false,
- false,
- true
- );
- foreach ($user_fields_values as &$value) {
- $return .= '"'.str_replace('"', '""', api_html_entity_decode(strip_tags($value), ENT_QUOTES)).'";';
- }
- }
- 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) {
- $my_answer_of_user = !isset($answers_of_user[$question_id]) || isset($answers_of_user[$question_id]) && $answers_of_user[$question_id] == null ? [] : $answers_of_user[$question_id];
- $key = array_keys($my_answer_of_user);
- if (isset($key[0]) && substr($key[0], 0, 4) == 'open') {
- $return .= '"'.
- str_replace(
- '"',
- '""',
- api_html_entity_decode(
- strip_tags(
- $answers_of_user[$question_id][$key[0]]['option_id']
- ),
- ENT_QUOTES
- )
- ).
- '"';
- } elseif (!empty($answers_of_user[$question_id][$option_id])) {
- //$return .= 'v';
- if ($answers_of_user[$question_id][$option_id]['value'] != 0) {
- $return .= $answers_of_user[$question_id][$option_id]['value'];
- } else {
- $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
- */
- public static function export_complete_report_xls($survey_data, $filename, $user_id = 0)
- {
- $course_id = api_get_course_int_id();
- $user_id = (int) $user_id;
- $surveyId = isset($_GET['survey_id']) ? (int) $_GET['survey_id'] : 0;
- if (empty($course_id) || empty($surveyId)) {
- return false;
- }
- // Show extra fields blank space (enough for extra fields on next line)
- // Show user fields section with a big th colspan that spans over all fields
- $extra_user_fields = UserManager::get_extra_fields(
- 0,
- 0,
- 5,
- 'ASC',
- false,
- true
- );
- $list = [];
- $num = count($extra_user_fields);
- for ($i = 0; $i < $num; $i++) {
- $list[0][] = '';
- }
- $display_extra_user_fields = true;
- // 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);
- // First line (questions)
- $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
- options.c_id = questions.c_id
- WHERE
- survey_question NOT LIKE '%{{%' AND
- questions.type <> 'pagebreak' AND
- questions.survey_id = $surveyId AND
- questions.c_id = $course_id
- GROUP BY questions.question_id
- ORDER BY questions.sort ASC";
- $result = Database::query($sql);
- $line = 1;
- $column = 1;
- 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 (!(isset($_POST['submit_question_filter'])) ||
- (isset($_POST['submit_question_filter']) && 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'] != 'pagebreak') {
- if ($row['number_of_options'] == 0 && ($row['type'] == 'open' || $row['type'] == 'comment')) {
- $list[$line][$column] = api_html_entity_decode(
- strip_tags($row['survey_question']),
- ENT_QUOTES
- );
- $column++;
- } else {
- for ($ii = 0; $ii < $row['number_of_options']; $ii++) {
- $list[$line][$column] = api_html_entity_decode(
- strip_tags($row['survey_question']),
- ENT_QUOTES
- );
- $column++;
- }
- }
- }
- }
- }
- $line++;
- $column = 1;
- // Show extra field values
- if ($display_extra_user_fields) {
- // Show the fields names for user fields
- foreach ($extra_user_fields as &$field) {
- $list[$line][$column] = api_html_entity_decode(strip_tags($field[3]), ENT_QUOTES);
- $column++;
- }
- }
- // Getting all the questions and options (second line)
- $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 AND
- survey_question_option.c_id = survey_question.c_id
- WHERE
- survey_question NOT LIKE '%{{%' AND
- survey_question.type <> 'pagebreak' AND
- survey_question.survey_id = $surveyId AND
- survey_question.c_id = $course_id
- ORDER BY survey_question.sort ASC, survey_question_option.sort ASC";
- $result = Database::query($sql);
- $possible_answers = [];
- $possible_answers_type = [];
- 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 (!isset($_POST['submit_question_filter']) ||
- (isset($_POST['questions_filter']) && 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'] != 'pagebreak') {
- $list[$line][$column] = api_html_entity_decode(
- strip_tags($row['option_text']),
- ENT_QUOTES
- );
- $possible_answers[$row['question_id']][$row['question_option_id']] = $row['question_option_id'];
- $possible_answers_type[$row['question_id']] = $row['type'];
- $column++;
- }
- }
- }
- // Getting all the answers of the users
- $line++;
- $column = 0;
- $old_user = '';
- $answers_of_user = [];
- $sql = "SELECT * FROM $table_survey_answer
- WHERE c_id = $course_id AND survey_id = $surveyId";
- if ($user_id != 0) {
- $sql .= " AND user='".$user_id."' ";
- }
- $sql .= ' ORDER BY user ASC';
- $open_question_iterator = 1;
- $result = Database::query($sql);
- while ($row = Database::fetch_array($result)) {
- if ($old_user != $row['user'] && $old_user != '') {
- $return = self::export_complete_report_row_xls(
- $survey_data,
- $possible_answers,
- $answers_of_user,
- $old_user,
- true
- );
- foreach ($return as $elem) {
- $list[$line][$column] = $elem;
- $column++;
- }
- $answers_of_user = [];
- $line++;
- $column = 0;
- }
- if ($possible_answers_type[$row['question_id']] == 'open' || $possible_answers_type[$row['question_id']] == 'comment') {
- $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 = self::export_complete_report_row_xls(
- $survey_data,
- $possible_answers,
- $answers_of_user,
- $old_user,
- true
- );
- // this is to display the last user
- foreach ($return as $elem) {
- $list[$line][$column] = $elem;
- $column++;
- }
- Export::arrayToXls($list, $filename);
- 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
- * @param bool Whether to display user fields or not
- *
- * @return string One line of the csv file
- */
- public static function export_complete_report_row_xls(
- $survey_data,
- $possible_options,
- $answers_of_user,
- $user,
- $display_extra_user_fields = false
- ) {
- $return = [];
- if ($survey_data['anonymous'] == 0) {
- if (intval($user) !== 0) {
- $userInfo = api_get_user_info($user);
- if ($userInfo) {
- $user_displayed = $userInfo['complete_name_with_username'];
- } else {
- $user_displayed = '-';
- }
- $return[] = $user_displayed;
- } else {
- $return[] = $user;
- }
- } else {
- $return[] = '-'; // The user column
- }
- if ($display_extra_user_fields) {
- //show user fields data, if any, for this user
- $user_fields_values = UserManager::get_extra_user_data(
- $user,
- false,
- false,
- false,
- true
- );
- foreach ($user_fields_values as $value) {
- $return[] = api_html_entity_decode(strip_tags($value), ENT_QUOTES);
- }
- }
- 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) {
- $my_answers_of_user = isset($answers_of_user[$question_id])
- ? $answers_of_user[$question_id]
- : [];
- $key = array_keys($my_answers_of_user);
- if (isset($key[0]) && substr($key[0], 0, 4) == 'open') {
- $return[] = api_html_entity_decode(
- strip_tags($answers_of_user[$question_id][$key[0]]['option_id']),
- ENT_QUOTES
- );
- } elseif (!empty($answers_of_user[$question_id][$option_id])) {
- if ($answers_of_user[$question_id][$option_id]['value'] != 0) {
- $return[] = $answers_of_user[$question_id][$option_id]['value'];
- } else {
- $return[] = 'v';
- }
- } else {
- $return[] = '';
- }
- }
- }
- }
- }
- 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
- * answered positive on both options.
- *
- * @return string HTML code
- *
- * @author Patrick Cool <patrick.cool@UGent.be>, Ghent University
- *
- * @version February 2007
- */
- public static function display_comparative_report()
- {
- // Allowed question types for comparative report
- $allowed_question_types = [
- 'yesno',
- 'multiplechoice',
- 'multipleresponse',
- 'dropdown',
- 'percentage',
- 'score',
- ];
- $surveyId = isset($_GET['survey_id']) ? (int) $_GET['survey_id'] : 0;
- // Getting all the questions
- $questions = SurveyManager::get_questions($surveyId);
- // Actions bar
- echo '<div class="actions">';
- echo '<a href="'.api_get_path(WEB_CODE_PATH).'survey/reporting.php?survey_id='.$surveyId.'&'.api_get_cidreq()
- .'">'
- .Display::return_icon(
- 'back.png',
- get_lang('Back to').' '.get_lang('Reporting overview'),
- [],
- ICON_SIZE_MEDIUM
- )
- .'</a>';
- echo '</div>';
- // Displaying an information message that only the questions with predefined answers can be used in a comparative report
- echo Display::return_message(get_lang('Only questions with predefined answers can be used'), 'normal', false);
- $xAxis = isset($_GET['xaxis']) ? Security::remove_XSS($_GET['xaxis']) : '';
- $yAxis = isset($_GET['yaxis']) ? Security::remove_XSS($_GET['yaxis']) : '';
- $url = api_get_self().'?'.api_get_cidreq().'&action='.Security::remove_XSS($_GET['action'])
- .'&survey_id='.$surveyId.'&xaxis='.$xAxis.'&y='.$yAxis;
- $form = new FormValidator('compare', 'get', $url);
- $form->addHidden('action', Security::remove_XSS($_GET['action']));
- $form->addHidden('survey_id', $surveyId);
- $optionsX = ['----'];
- $optionsY = ['----'];
- $defaults = [];
- foreach ($questions as $key => &$question) {
- // Ignored tagged questions
- if ($question) {
- if (strpos($question['question'], '{{') !== false) {
- $question = null;
- continue;
- }
- }
- if (is_array($allowed_question_types)) {
- if (in_array($question['type'], $allowed_question_types)) {
- if (isset($_GET['xaxis']) && $_GET['xaxis'] == $question['question_id']) {
- $defaults['xaxis'] = $question['question_id'];
- }
- if (isset($_GET['yaxis']) && $_GET['yaxis'] == $question['question_id']) {
- $defaults['yaxis'] = $question['question_id'];
- }
- $optionsX[$question['question_id']] = api_substr(strip_tags($question['question']), 0, 90);
- $optionsY[$question['question_id']] = api_substr(strip_tags($question['question']), 0, 90);
- }
- }
- }
- $form->addSelect('xaxis', get_lang('Select the question on the X axis'), $optionsX);
- $form->addSelect('yaxis', get_lang('Select the question on the Y axis'), $optionsY);
- $form->addButtonSearch(get_lang('Compare questions'));
- $form->setDefaults($defaults);
- $form->display();
- // Getting all the information of the x axis
- if (is_numeric($xAxis)) {
- $question_x = SurveyManager::get_question($xAxis);
- }
- // Getting all the information of the y axis
- if (is_numeric($yAxis)) {
- $question_y = SurveyManager::get_question($yAxis);
- }
- if (is_numeric($xAxis) && is_numeric($yAxis)) {
- // Getting the answers of the two questions
- $answers_x = self::get_answers_of_question_by_user($surveyId, $xAxis);
- $answers_y = self::get_answers_of_question_by_user($surveyId, $yAxis);
- // Displaying the table
- $tableHtml = '<table border="1" class="data_table">';
- $xOptions = [];
- // The header
- $tableHtml .= '<tr>';
- for ($ii = 0; $ii <= count($question_x['answers']); $ii++) {
- if ($ii == 0) {
- $tableHtml .= '<th> </th>';
- } else {
- if ($question_x['type'] == 'score') {
- for ($x = 1; $x <= $question_x['maximum_score']; $x++) {
- $tableHtml .= '<th>'.$question_x['answers'][($ii - 1)].'<br />'.$x.'</th>';
- }
- $x = '';
- } else {
- $tableHtml .= '<th>'.$question_x['answers'][($ii - 1)].'</th>';
- }
- $optionText = strip_tags($question_x['answers'][$ii - 1]);
- $optionText = html_entity_decode($optionText);
- array_push($xOptions, trim($optionText));
- }
- }
- $tableHtml .= '</tr>';
- $chartData = [];
- // The main part
- for ($ij = 0; $ij < count($question_y['answers']); $ij++) {
- $currentYQuestion = strip_tags($question_y['answers'][$ij]);
- $currentYQuestion = html_entity_decode($currentYQuestion);
- // 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++) {
- $tableHtml .= '<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) {
- $tableHtml .= '<th>'.$question_y['answers'][($ij)].' '.$y.'</th>';
- break;
- } else {
- $tableHtml .= '<td align="center">';
- $votes = self::comparative_check(
- $answers_x,
- $answers_y,
- $question_x['answersid'][($ii - 1)],
- $question_y['answersid'][($ij)],
- $x,
- $y
- );
- $tableHtml .= $votes;
- array_push(
- $chartData,
- [
- 'serie' => [$currentYQuestion, $xOptions[$ii - 1]],
- 'option' => $x,
- 'votes' => $votes,
- ]
- );
- $tableHtml .= '</td>';
- }
- }
- } else {
- if ($ii == 0) {
- $tableHtml .= '<th>'.$question_y['answers'][$ij].' '.$y.'</th>';
- } else {
- $tableHtml .= '<td align="center">';
- $votes = self::comparative_check(
- $answers_x,
- $answers_y,
- $question_x['answersid'][($ii - 1)],
- $question_y['answersid'][($ij)],
- 0,
- $y
- );
- $tableHtml .= $votes;
- array_push(
- $chartData,
- [
- 'serie' => [$currentYQuestion, $xOptions[$ii - 1]],
- 'option' => $y,
- 'votes' => $votes,
- ]
- );
- $tableHtml .= '</td>';
- }
- }
- }
- $tableHtml .= '</tr>';
- }
- } else {
- // The Y axis is NOT a score question type so the number of rows = the number of options
- $tableHtml .= '<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) {
- $tableHtml .= '<th>'.$question_y['answers'][$ij].'</th>';
- break;
- } else {
- $tableHtml .= '<td align="center">';
- $votes = self::comparative_check(
- $answers_x,
- $answers_y,
- $question_x['answersid'][($ii - 1)],
- $question_y['answersid'][($ij)],
- $x,
- 0
- );
- $tableHtml .= $votes;
- array_push(
- $chartData,
- [
- 'serie' => [$currentYQuestion, $xOptions[$ii - 1]],
- 'option' => $x,
- 'votes' => $votes,
- ]
- );
- $tableHtml .= '</td>';
- }
- }
- } else {
- if ($ii == 0) {
- $tableHtml .= '<th>'.$question_y['answers'][($ij)].'</th>';
- } else {
- $tableHtml .= '<td align="center">';
- $votes = self::comparative_check(
- $answers_x,
- $answers_y,
- $question_x['answersid'][($ii - 1)],
- $question_y['answersid'][($ij)]
- );
- $tableHtml .= $votes;
- array_push(
- $chartData,
- [
- 'serie' => $xOptions[$ii - 1],
- 'option' => $currentYQuestion,
- 'votes' => $votes,
- ]
- );
- $tableHtml .= '</td>';
- }
- }
- }
- $tableHtml .= '</tr>';
- }
- }
- $tableHtml .= '</table>';
- echo '<div id="chartContainer" class="col-md-12">';
- echo self::drawChart($chartData, true);
- echo '</div>';
- echo $tableHtml;
- }
- }
- /**
- * Get all the answers of a question grouped by user.
- *
- * @param int $survey_id Survey ID
- * @param int $question_id 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
- */
- public static function get_answers_of_question_by_user($survey_id, $question_id)
- {
- $course_id = api_get_course_int_id();
- $table_survey_answer = Database::get_course_table(TABLE_SURVEY_ANSWER);
- $sql = "SELECT * FROM $table_survey_answer
- WHERE
- c_id = $course_id AND
- survey_id='".intval($survey_id)."' AND
- question_id='".intval($question_id)."'
- ORDER BY USER ASC";
- $result = Database::query($sql);
- $return = [];
- 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 int x axis value (= the option_id of the first question)
- * @param int y axis value (= the option_id of the second question)
- *
- * @return int Number of users who have answered positively to both options
- *
- * @author Patrick Cool <patrick.cool@UGent.be>, Ghent University
- *
- * @version February 2007
- */
- public static 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;
- if (is_array($answers_x)) {
- 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 (!is_null($answers_y[$user]) &&
- in_array($check_y, $answers_y[$user])
- ) {
- $counter++;
- }
- }
- }
- }
- return $counter;
- }
- /**
- * Save the invitation mail.
- *
- * @param string Text of the e-mail
- * @param int 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
- */
- public static function save_invite_mail($mailtext, $mail_subject, $reminder = 0)
- {
- $course_id = api_get_course_int_id();
- // 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_subject='".Database::escape_string($mail_subject)."',
- $mail_field = '".Database::escape_string($mailtext)."'
- WHERE c_id = $course_id AND survey_id = '".intval($_GET['survey_id'])."'";
- Database::query($sql);
- }
- /**
- * This function saves all the invitations of course users
- * and additional users in the database
- * and sends the invitations by email.
- *
- * @param $users_array Users $array array can be both a list of course uids AND a list of additional emailaddresses
- * @param $invitation_title Title $string of the invitation, used as the title of the mail
- * @param $invitation_text Text $string 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
- * @param int $reminder
- * @param bool $sendmail
- * @param int $remindUnAnswered
- * @param bool $isAdditionalEmail
- * @param bool $hideLink
- *
- * @author Patrick Cool <patrick.cool@UGent.be>, Ghent University
- * @author Julio Montoya - Adding auto-generated link support
- *
- * @version January 2007
- */
- public static function saveInvitations(
- $users_array,
- $invitation_title,
- $invitation_text,
- $reminder = 0,
- $sendmail = false,
- $remindUnAnswered = 0,
- $isAdditionalEmail = false,
- $hideLink = false
- ) {
- if (!is_array($users_array)) {
- // Should not happen
- return 0;
- }
- // Getting the survey information
- $survey_data = SurveyManager::get_survey($_GET['survey_id']);
- $survey_invitations = self::get_invitations($survey_data['survey_code']);
- $already_invited = self::get_invited_users($survey_data['code']);
- // Remind unanswered is a special version of remind all reminder
- $exclude_users = [];
- if ($remindUnAnswered == 1) {
- // Remind only unanswered users
- $reminder = 1;
- $exclude_users = SurveyManager::get_people_who_filled_survey($_GET['survey_id']);
- }
- $counter = 0; // Nr of invitations "sent" (if sendmail option)
- $course_id = api_get_course_int_id();
- $session_id = api_get_session_id();
- if ($isAdditionalEmail == false) {
- $result = CourseManager::separateUsersGroups($users_array);
- $groupList = $result['groups'];
- $users_array = $result['users'];
- foreach ($groupList as $groupId) {
- $userGroupList = GroupManager::getStudents($groupId, true);
- $userGroupIdList = array_column($userGroupList, 'user_id');
- $users_array = array_merge($users_array, $userGroupIdList);
- $params = [
- 'c_id' => $course_id,
- 'session_id' => $session_id,
- 'group_id' => $groupId,
- 'survey_code' => $survey_data['code'],
- ];
- $invitationExists = self::invitationExists(
- $course_id,
- $session_id,
- $groupId,
- $survey_data['code']
- );
- if (empty($invitationExists)) {
- self::save_invitation($params);
- }
- }
- }
- $users_array = array_unique($users_array);
- foreach ($users_array as $key => $value) {
- if (!isset($value) || $value == '') {
- continue;
- }
- // Skip user if reminding only unanswered people
- if (in_array($value, $exclude_users)) {
- continue;
- }
- // Get the unique invitation code if we already have it
- if ($reminder == 1 && array_key_exists($value, $survey_invitations)) {
- $invitation_code = $survey_invitations[$value]['invitation_code'];
- } else {
- $invitation_code = md5($value.microtime());
- }
- $new_user = false; // User not already invited
- // Store the invitation if user_id not in $already_invited['course_users'] OR email is not in $already_invited['additional_users']
- $addit_users_array = isset($already_invited['additional_users']) && !empty($already_invited['additional_users'])
- ? explode(';', $already_invited['additional_users'])
- : [];
- $my_alredy_invited = $already_invited['course_users'] == null ? [] : $already_invited['course_users'];
- if ((is_numeric($value) && !in_array($value, $my_alredy_invited)) ||
- (!is_numeric($value) && !in_array($value, $addit_users_array))
- ) {
- $new_user = true;
- if (!array_key_exists($value, $survey_invitations)) {
- $params = [
- 'c_id' => $course_id,
- 'session_id' => $session_id,
- 'user' => $value,
- 'survey_code' => $survey_data['code'],
- 'invitation_code' => $invitation_code,
- 'invitation_date' => api_get_utc_datetime(),
- ];
- self::save_invitation($params);
- }
- }
- // Send the email if checkboxed
- if (($new_user || $reminder == 1) && $sendmail) {
- // Make a change for absolute url
- if (isset($invitation_text)) {
- $invitation_text = api_html_entity_decode($invitation_text, ENT_QUOTES);
- $invitation_text = str_replace('src="../../', 'src="'.api_get_path(WEB_PATH), $invitation_text);
- $invitation_text = trim(stripslashes($invitation_text));
- }
- self::send_invitation_mail(
- $value,
- $invitation_code,
- $invitation_title,
- $invitation_text,
- $hideLink
- );
- $counter++;
- }
- }
- return $counter; // Number of invitations sent
- }
- /**
- * @param $params
- *
- * @return bool|int
- */
- public static function save_invitation($params)
- {
- // Database table to store the invitations data
- $table = Database::get_course_table(TABLE_SURVEY_INVITATION);
- if (!empty($params['c_id']) &&
- (!empty($params['user']) || !empty($params['group_id'])) &&
- !empty($params['survey_code'])
- ) {
- if (!isset($params['survey_invitation_id'])) {
- $params['survey_invitation_id'] = 0;
- }
- if (!isset($params['answered'])) {
- $params['answered'] = 0;
- }
- if (!isset($params['group_id'])) {
- $params['group_id'] = 0;
- }
- $insertId = Database::insert($table, $params);
- if ($insertId) {
- $sql = "UPDATE $table
- SET survey_invitation_id = $insertId
- WHERE iid = $insertId";
- Database::query($sql);
- }
- return $insertId;
- }
- return false;
- }
- /**
- * @param int $courseId
- * @param int $sessionId
- * @param int $groupId
- * @param string $surveyCode
- *
- * @return int
- */
- public static function invitationExists($courseId, $sessionId, $groupId, $surveyCode)
- {
- $table = Database::get_course_table(TABLE_SURVEY_INVITATION);
- $courseId = (int) $courseId;
- $sessionId = (int) $sessionId;
- $groupId = (int) $groupId;
- $surveyCode = Database::escape_string($surveyCode);
- $sql = "SELECT survey_invitation_id FROM $table
- WHERE
- c_id = $courseId AND
- session_id = $sessionId AND
- group_id = $groupId AND
- survey_code = '$surveyCode'
- ";
- $result = Database::query($sql);
- return Database::num_rows($result);
- }
- /**
- * Send the invitation by mail.
- *
- * @param int invitedUser - the userId (course user) or emailaddress of additional user
- * $param string $invitation_code - the unique invitation code for the URL
- */
- public static function send_invitation_mail(
- $invitedUser,
- $invitation_code,
- $invitation_title,
- $invitation_text,
- $hideLink = false
- ) {
- $_user = api_get_user_info();
- $_course = api_get_course_info();
- $sessionId = api_get_session_id();
- // Replacing the **link** part with a valid link for the user
- $link = self::generateFillSurveyLink($invitation_code, $_course, $sessionId);
- if ($hideLink) {
- $full_invitation_text = str_replace('**link**', '', $invitation_text);
- } else {
- $text_link = '<a href="'.$link.'">'.get_lang('Click here to answer the survey')."</a><br />\r\n<br />\r\n"
- .get_lang('or copy paste the following url :')." <br /> \r\n <br /> \r\n ".$link;
- $replace_count = 0;
- $full_invitation_text = api_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;
- }
- }
- // Sending the mail
- $sender_name = api_get_person_name($_user['firstName'], $_user['lastName'], null, PERSON_NAME_EMAIL_ADDRESS);
- $sender_email = $_user['mail'];
- $sender_user_id = api_get_user_id();
- $replyto = [];
- 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;
- $sender_user_id = null;
- }
- }
- // Optionally: finding the e-mail of the course user
- if (is_numeric($invitedUser)) {
- MessageManager::send_message(
- $invitedUser,
- $invitation_title,
- $full_invitation_text,
- [],
- [],
- null,
- null,
- null,
- null,
- $sender_user_id,
- true
- );
- } else {
- @api_mail_html(
- '',
- $invitedUser,
- $invitation_title,
- $full_invitation_text,
- $sender_name,
- $sender_email,
- $replyto
- );
- }
- }
- /**
- * This function recalculates the number of users who have been invited and updates the survey table with this
- * value.
- *
- * @param string Survey code
- * @param int $courseId
- * @param int $sessionId
- *
- * @return int
- *
- * @author Patrick Cool <patrick.cool@UGent.be>, Ghent University
- *
- * @version January 2007
- */
- public static function update_count_invited($survey_code, $courseId = 0, $sessionId = 0)
- {
- $survey_code = Database::escape_string($survey_code);
- $courseId = (int) $courseId;
- $sessionId = (int) $sessionId;
- $courseId = $courseId ?: api_get_course_int_id();
- $sessionId = $sessionId ?: api_get_session_id();
- $sessionCondition = api_get_session_condition($sessionId);
- // 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
- c_id = $courseId AND
- survey_code = '".$survey_code."' AND
- user <> ''
- $sessionCondition
- ";
- $result = Database::query($sql);
- $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
- c_id = $courseId AND
- code = '".$survey_code."'
- $sessionCondition
- ";
- Database::query($sql);
- return $total_invited;
- }
- /**
- * This function gets all the invited users for a given survey code.
- *
- * @param string Survey code
- * @param string optional - course database
- *
- * @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
- * @author Julio Montoya, adding c_id fixes - Dec 2012
- *
- * @version January 2007
- */
- public static function get_invited_users($survey_code, $course_code = '', $session_id = 0)
- {
- $session_id = (int) $session_id;
- $survey_code = Database::escape_string($survey_code);
- $course_code = Database::escape_string($course_code);
- $course_id = api_get_course_int_id();
- if (!empty($course_code)) {
- $course_info = api_get_course_info($course_code);
- if ($course_info) {
- $course_id = $course_info['real_id'];
- }
- }
- if (empty($session_id)) {
- $session_id = api_get_session_id();
- }
- $table_survey_invitation = Database::get_course_table(TABLE_SURVEY_INVITATION);
- $table_user = Database::get_main_table(TABLE_MAIN_USER);
- // Selecting all the invitations of this survey AND the additional emailaddresses (the left join)
- $order_clause = api_sort_by_first_name() ? ' ORDER BY firstname, lastname' : ' ORDER BY lastname, firstname';
- $sql = "SELECT user, group_id
- FROM $table_survey_invitation as table_invitation
- WHERE
- table_invitation.c_id = $course_id AND
- survey_code='".$survey_code."' AND
- session_id = $session_id
- ";
- $defaults = [];
- $defaults['course_users'] = [];
- $defaults['additional_users'] = []; // Textarea
- $defaults['users'] = []; // user and groups
- $result = Database::query($sql);
- while ($row = Database::fetch_array($result)) {
- if (is_numeric($row['user'])) {
- $defaults['course_users'][] = $row['user'];
- $defaults['users'][] = 'USER:'.$row['user'];
- } else {
- if (!empty($row['user'])) {
- $defaults['additional_users'][] = $row['user'];
- }
- }
- if (isset($row['group_id']) && !empty($row['group_id'])) {
- $defaults['users'][] = 'GROUP:'.$row['group_id'];
- }
- }
- if (!empty($defaults['course_users'])) {
- $user_ids = implode("','", $defaults['course_users']);
- $sql = "SELECT user_id FROM $table_user WHERE user_id IN ('$user_ids') $order_clause";
- $result = Database::query($sql);
- $fixed_users = [];
- while ($row = Database::fetch_array($result)) {
- $fixed_users[] = $row['user_id'];
- }
- $defaults['course_users'] = $fixed_users;
- }
- if (!empty($defaults['additional_users'])) {
- $defaults['additional_users'] = implode(';', $defaults['additional_users']);
- }
- 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
- */
- public static function get_invitations($survey_code)
- {
- $course_id = api_get_course_int_id();
- $sessionId = api_get_session_id();
- // Database table definition
- $table_survey_invitation = Database::get_course_table(TABLE_SURVEY_INVITATION);
- $sql = "SELECT * FROM $table_survey_invitation
- WHERE
- c_id = $course_id AND
- session_id = $sessionId AND
- survey_code = '".Database::escape_string($survey_code)."'";
- $result = Database::query($sql);
- $return = [];
- while ($row = Database::fetch_array($result)) {
- $return[$row['user']] = $row;
- }
- return $return;
- }
- /**
- * This function displays the form for searching a survey.
- *
- * @author Patrick Cool <patrick.cool@UGent.be>, Ghent University
- *
- * @version January 2007
- *
- * @todo consider moving this to surveymanager.inc.lib.php
- */
- public static function display_survey_search_form()
- {
- $url = api_get_path(WEB_CODE_PATH).'survey/survey_list.php?search=advanced&'.api_get_cidreq();
- $form = new FormValidator('search', 'get', $url);
- $form->addHeader(get_lang('Search a survey'));
- $form->addText('keyword_title', get_lang('Title'));
- $form->addText('keyword_code', get_lang('Course code'));
- $form->addSelectLanguage('keyword_language', get_lang('Language'));
- $form->addHidden('cidReq', api_get_course_id());
- $form->addButtonSearch(get_lang('Search'), 'do_search');
- $form->display();
- }
- /**
- * Show table only visible by DRH users.
- */
- public static function displaySurveyListForDrh()
- {
- $parameters = [];
- $parameters['cidReq'] = api_get_course_id();
- // Create a sortable table with survey-data
- $table = new SortableTable(
- 'surveys',
- 'get_number_of_surveys',
- 'get_survey_data_drh',
- 2
- );
- $table->set_additional_parameters($parameters);
- $table->set_header(0, '', false);
- $table->set_header(1, get_lang('Survey name'));
- $table->set_header(2, get_lang('SurveyCourse code'));
- $table->set_header(3, get_lang('Questions'));
- $table->set_header(4, get_lang('Author'));
- $table->set_header(5, get_lang('Available from'));
- $table->set_header(6, get_lang('Until'));
- $table->set_header(7, get_lang('Invite'));
- $table->set_header(8, get_lang('Anonymous'));
- if (api_get_configuration_value('allow_mandatory_survey')) {
- $table->set_header(9, get_lang('Mandatory?'));
- $table->set_header(10, get_lang('Edit'), false, 'width="150"');
- $table->set_column_filter(9, 'anonymous_filter');
- $table->set_column_filter(10, 'modify_filter_drh');
- } else {
- $table->set_header(9, get_lang('Edit'), false, 'width="150"');
- $table->set_column_filter(9, 'modify_filter_drh');
- }
- $table->set_column_filter(8, 'anonymous_filter');
- $table->display();
- }
- /**
- * This function displays the sortable table with all the surveys.
- *
- *
- * @author Patrick Cool <patrick.cool@UGent.be>, Ghent University
- *
- * @version January 2007
- */
- public static function display_survey_list()
- {
- $parameters = [];
- $parameters['cidReq'] = api_get_course_id();
- if (isset($_GET['do_search']) && $_GET['do_search']) {
- $message = get_lang('Display search results').'<br />';
- $message .= '<a href="'.api_get_self().'?'.api_get_cidreq().'">'.get_lang('Display all').'</a>';
- echo Display::return_message($message, 'normal', 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('Survey name'));
- $table->set_header(2, get_lang('SurveyCourse code'));
- $table->set_header(3, get_lang('Questions'));
- $table->set_header(4, get_lang('Author'));
- //$table->set_header(5, get_lang('Language'));
- //$table->set_header(6, get_lang('Shared'));
- $table->set_header(5, get_lang('Available from'));
- $table->set_header(6, get_lang('Until'));
- $table->set_header(7, get_lang('Invite'));
- $table->set_header(8, get_lang('Anonymous'));
- if (api_get_configuration_value('allow_mandatory_survey')) {
- $table->set_header(9, get_lang('Mandatory?'));
- $table->set_header(10, get_lang('Edit'), false, 'width="150"');
- $table->set_column_filter(8, 'anonymous_filter');
- $table->set_column_filter(10, 'modify_filter');
- } else {
- $table->set_header(9, get_lang('Edit'), false, 'width="150"');
- $table->set_column_filter(9, 'modify_filter');
- }
- $table->set_column_filter(8, 'anonymous_filter');
- $table->set_form_actions(['delete' => get_lang('Delete survey')]);
- $table->display();
- }
- /**
- * Survey list for coach.
- */
- public static function display_survey_list_for_coach()
- {
- $parameters = [];
- $parameters['cidReq'] = api_get_course_id();
- if (isset($_GET['do_search'])) {
- $message = get_lang('Display search results').'<br />';
- $message .= '<a href="'.api_get_self().'?'.api_get_cidreq().'">'.get_lang('Display all').'</a>';
- echo Display::return_message($message, 'normal', false);
- }
- // Create a sortable table with survey-data
- $table = new SortableTable(
- 'surveys_coach',
- 'get_number_of_surveys_for_coach',
- 'get_survey_data_for_coach',
- 2
- );
- $table->set_additional_parameters($parameters);
- $table->set_header(0, '', false);
- $table->set_header(1, get_lang('Survey name'));
- $table->set_header(2, get_lang('SurveyCourse code'));
- $table->set_header(3, get_lang('Questions'));
- $table->set_header(4, get_lang('Author'));
- $table->set_header(5, get_lang('Available from'));
- $table->set_header(6, get_lang('Until'));
- $table->set_header(7, get_lang('Invite'));
- $table->set_header(8, get_lang('Anonymous'));
- if (api_get_configuration_value('allow_mandatory_survey')) {
- $table->set_header(9, get_lang('Edit'), false, 'width="130"');
- $table->set_header(10, get_lang('Edit'), false, 'width="130"');
- $table->set_column_filter(8, 'anonymous_filter');
- $table->set_column_filter(10, 'modify_filter_for_coach');
- } else {
- $table->set_header(9, get_lang('Edit'), false, 'width="130"');
- $table->set_column_filter(9, 'modify_filter_for_coach');
- }
- $table->set_column_filter(8, 'anonymous_filter');
- $table->display();
- }
- /**
- * Check if the hide_survey_edition configurations setting is enabled.
- *
- * @param string $surveyCode
- *
- * @return bool
- */
- public static function checkHideEditionToolsByCode($surveyCode)
- {
- $hideSurveyEdition = api_get_configuration_value('hide_survey_edition');
- if (false === $hideSurveyEdition) {
- return false;
- }
- if ('*' === $hideSurveyEdition['codes']) {
- return true;
- }
- if (in_array($surveyCode, $hideSurveyEdition['codes'])) {
- return true;
- }
- return false;
- }
- /**
- * This function changes the modify column of the sortable table.
- *
- * @param int $survey_id the id of the survey
- * @param bool $drh
- *
- * @throws \Doctrine\ORM\ORMException
- * @throws \Doctrine\ORM\OptimisticLockException
- * @throws \Doctrine\ORM\TransactionRequiredException
- *
- * @author Patrick Cool <patrick.cool@UGent.be>, Ghent University
- *
- * @return string html code that are the actions that can be performed on any survey
- *
- * @version January 2007
- */
- public static function modify_filter($survey_id, $drh = false)
- {
- /** @var CSurvey $survey */
- $survey = Database::getManager()->find('ChamiloCourseBundle:CSurvey', $survey_id);
- $hideSurveyEdition = self::checkHideEditionToolsByCode($survey->getCode());
- if ($hideSurveyEdition) {
- return '';
- }
- if (empty($survey)) {
- return '';
- }
- $survey_id = $survey->getSurveyId();
- $actions = [];
- $hideReportingButton = api_get_configuration_value('hide_survey_reporting_button');
- $codePath = api_get_path(WEB_CODE_PATH);
- $params = [];
- parse_str(api_get_cidreq(), $params);
- $reportingLink = Display::url(
- Display::return_icon('statistics.png', get_lang('Reporting')),
- $codePath.'survey/reporting.php?'.http_build_query($params + ['survey_id' => $survey_id])
- );
- if ($drh) {
- return $hideReportingButton ? '-' : $reportingLink;
- }
- $type = $survey->getSurveyType();
- // Coach can see that only if the survey is in his session
- if (api_is_allowed_to_edit() ||
- api_is_element_in_the_session(TOOL_SURVEY, $survey_id)
- ) {
- $editUrl = $codePath.'survey/create_new_survey.php?'.
- http_build_query($params + ['action' => 'edit', 'survey_id' => $survey_id]);
- if ($survey->getSurveyType() == 3) {
- $editUrl = $codePath.'survey/edit_meeting.php?'.
- http_build_query($params + ['action' => 'edit', 'survey_id' => $survey_id]);
- }
- $actions[] = Display::url(
- Display::return_icon('edit.png', get_lang('Edit')),
- $editUrl
- );
- if (SurveyManager::survey_generation_hash_available()) {
- $actions[] = Display::url(
- Display::return_icon('new_link.png', get_lang('Generate survey access link')),
- $codePath.'survey/generate_link.php?'.http_build_query($params + ['survey_id' => $survey_id])
- );
- }
- if ($type != 3) {
- $actions[] = Display::url(
- Display::return_icon('backup.png', get_lang('Copy survey')),
- $codePath.'survey/copy_survey.php?'.http_build_query($params + ['survey_id' => $survey_id])
- );
- $actions[] = Display::url(
- Display::return_icon('copy.png', get_lang('Duplicate survey')),
- $codePath.'survey/survey_list.php?'
- .http_build_query($params + ['action' => 'copy_survey', 'survey_id' => $survey_id])
- );
- $actions[] = Display::url(
- Display::return_icon('multiplicate_survey.png', get_lang('Multiplicate questions')),
- $codePath.'survey/survey_list.php?'
- .http_build_query($params + ['action' => 'multiplicate', 'survey_id' => $survey_id])
- );
- $actions[] = Display::url(
- Display::return_icon('multiplicate_survey_na.png', get_lang('RemoveMultiplicate questions')),
- $codePath.'survey/survey_list.php?'
- .http_build_query($params + ['action' => 'remove_multiplicate', 'survey_id' => $survey_id])
- );
- $warning = addslashes(api_htmlentities(get_lang('Empty survey').'?', ENT_QUOTES));
- $actions[] = Display::url(
- Display::return_icon('clean.png', get_lang('Empty survey')),
- $codePath.'survey/survey_list.php?'
- .http_build_query($params + ['action' => 'empty', 'survey_id' => $survey_id]),
- [
- 'onclick' => "javascript: if (!confirm('".$warning."')) return false;",
- ]
- );
- }
- }
- if ($type != 3) {
- $actions[] = Display::url(
- Display::return_icon('preview_view.png', get_lang('Preview')),
- $codePath.'survey/preview.php?'.http_build_query($params + ['survey_id' => $survey_id])
- );
- }
- $actions[] = Display::url(
- Display::return_icon('mail_send.png', get_lang('Publish')),
- $codePath.'survey/survey_invite.php?'.http_build_query($params + ['survey_id' => $survey_id])
- );
- if ($type != 3) {
- $actions[] = $hideReportingButton ? null : $reportingLink;
- }
- if (api_is_allowed_to_edit() ||
- api_is_element_in_the_session(TOOL_SURVEY, $survey_id)
- ) {
- $actions[] = self::getAdditionalTeacherActions($survey_id);
- $warning = addslashes(api_htmlentities(get_lang('Delete survey').'?', ENT_QUOTES));
- $actions[] = Display::url(
- Display::return_icon('delete.png', get_lang('Delete')),
- $codePath.'survey/survey_list.php?'
- .http_build_query($params + ['action' => 'delete', 'survey_id' => $survey_id]),
- [
- 'onclick' => "javascript: if (!confirm('".$warning."')) return false;",
- ]
- );
- }
- return implode(PHP_EOL, $actions);
- }
- /**
- * Get the additional actions added in survey_additional_teacher_modify_actions configuration.
- *
- * @param int $surveyId
- * @param int $iconSize
- *
- * @return string
- */
- public static function getAdditionalTeacherActions($surveyId, $iconSize = ICON_SIZE_SMALL)
- {
- $additionalActions = api_get_configuration_value('survey_additional_teacher_modify_actions') ?: [];
- if (empty($additionalActions)) {
- return '';
- }
- $actions = [];
- foreach ($additionalActions as $additionalAction) {
- $actions[] = call_user_func(
- $additionalAction,
- ['survey_id' => $surveyId, 'icon_size' => $iconSize]
- );
- }
- return implode(PHP_EOL, $actions);
- }
- /**
- * @param int $survey_id
- *
- * @return string
- */
- public static function modify_filter_for_coach($survey_id)
- {
- $survey_id = (int) $survey_id;
- $actions = [];
- $codePath = api_get_path(WEB_CODE_PATH);
- $params = [];
- parse_str(api_get_cidreq(), $params);
- $actions[] = Display::url(
- Display::return_icon('preview_view.png', get_lang('Preview')),
- $codePath.'survey/preview.php?'.http_build_query($params + ['survey_id' => $survey_id])
- );
- $actions[] = Display::url(
- Display::return_icon('mail_send.png', get_lang('Publish')),
- $codePath.'survey/survey_invite.php?'.http_build_query($params + ['survey_id' => $survey_id])
- );
- $warning = addslashes(api_htmlentities(get_lang('Empty survey').'?', ENT_QUOTES));
- $actions[] = Display::url(
- Display::return_icon('clean.png', get_lang('Empty survey')),
- $codePath.'survey/survey_list.php?'
- .http_build_query($params + ['action' => 'empty', 'survey_id' => $survey_id]),
- [
- 'onclick' => "javascript: if(!confirm('".$warning."')) return false;",
- ]
- );
- return implode(PHP_EOL, $actions);
- }
- /**
- * Returns "yes" when given parameter is one, "no" for any other value.
- *
- * @param int Whether anonymous or not
- *
- * @return string "Yes" or "No" in the current language
- */
- public static 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
- */
- public static function survey_search_restriction()
- {
- if (isset($_GET['do_search'])) {
- if ($_GET['keyword_title'] != '') {
- $search_term[] = 'title like "%" \''.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']).'\'';
- }
- $my_search_term = ($search_term == null) ? [] : $search_term;
- $search_restriction = implode(' AND ', $my_search_term);
- return $search_restriction;
- } else {
- return false;
- }
- }
- /**
- * This function calculates the total number of surveys.
- *
- * @return int Total number of surveys
- *
- * @author Patrick Cool <patrick.cool@UGent.be>, Ghent University
- *
- * @version January 2007
- */
- public static function get_number_of_surveys()
- {
- $table_survey = Database::get_course_table(TABLE_SURVEY);
- $course_id = api_get_course_int_id();
- $search_restriction = self::survey_search_restriction();
- if ($search_restriction) {
- $search_restriction = 'WHERE c_id = '.$course_id.' AND '.$search_restriction;
- } else {
- $search_restriction = "WHERE c_id = $course_id";
- }
- $sql = "SELECT count(survey_id) AS total_number_of_items
- FROM $table_survey $search_restriction";
- $res = Database::query($sql);
- $obj = Database::fetch_object($res);
- return $obj->total_number_of_items;
- }
- /**
- * @return int
- */
- public static function get_number_of_surveys_for_coach()
- {
- $survey_tree = new SurveyTree();
- return count($survey_tree->surveylist);
- }
- /**
- * This function gets all the survey data that is to be displayed in the sortable table.
- *
- * @param int $from
- * @param int $number_of_items
- * @param int $column
- * @param string $direction
- * @param bool $isDrh
- *
- * @return array
- *
- * @author Patrick Cool <patrick.cool@UGent.be>, Ghent University
- * @author Julio Montoya <gugli100@gmail.com>, Beeznest - Adding intvals
- *
- * @version January 2007
- */
- public static function get_survey_data(
- $from,
- $number_of_items,
- $column,
- $direction,
- $isDrh = false
- ) {
- $table_survey = Database::get_course_table(TABLE_SURVEY);
- $table_user = Database::get_main_table(TABLE_MAIN_USER);
- $table_survey_question = Database::get_course_table(TABLE_SURVEY_QUESTION);
- $mandatoryAllowed = api_get_configuration_value('allow_mandatory_survey');
- $_user = api_get_user_info();
- $allowSurveyAvailabilityDatetime = api_get_configuration_value('allow_survey_availability_datetime');
- // Searching
- $search_restriction = self::survey_search_restriction();
- if ($search_restriction) {
- $search_restriction = ' AND '.$search_restriction;
- }
- $from = (int) $from;
- $number_of_items = (int) $number_of_items;
- $column = (int) $column;
- if (!in_array(strtolower($direction), ['asc', 'desc'])) {
- $direction = 'asc';
- }
- // Condition for the session
- $session_id = api_get_session_id();
- $condition_session = api_get_session_condition($session_id);
- $course_id = api_get_course_int_id();
- $sql = "
- SELECT
- survey.survey_id AS col0,
- survey.title AS col1,
- survey.code AS col2,
- count(survey_question.question_id) AS col3, "
- .(api_is_western_name_order()
- ? "CONCAT(user.firstname, ' ', user.lastname)"
- : "CONCAT(user.lastname, ' ', user.firstname)")
- ." AS col4,
- survey.avail_from AS col5,
- survey.avail_till AS col6,
- survey.invited AS col7,
- survey.anonymous AS col8,
- survey.iid AS col9,
- survey.session_id AS session_id,
- survey.answered,
- survey.invited,
- survey.survey_type
- FROM $table_survey survey
- LEFT JOIN $table_survey_question survey_question
- ON (survey.survey_id = survey_question.survey_id AND survey_question.c_id = $course_id)
- LEFT JOIN $table_user user
- ON (survey.author = user.user_id)
- WHERE survey.c_id = $course_id
- $search_restriction
- $condition_session
- GROUP BY survey.survey_id
- ORDER BY col$column $direction
- LIMIT $from,$number_of_items
- ";
- $res = Database::query($sql);
- $surveys = [];
- $array = [];
- $efv = new ExtraFieldValue('survey');
- while ($survey = Database::fetch_array($res)) {
- $array[0] = $survey[0];
- if (self::checkHideEditionToolsByCode($survey['col2'])) {
- $array[1] = $survey[1];
- } else {
- // Doodle
- if ($survey['survey_type'] == 3) {
- $array[1] = Display::url(
- $survey[1],
- api_get_path(WEB_CODE_PATH).'survey/meeting.php?survey_id='.$survey[0].'&'.api_get_cidreq()
- );
- } else {
- $array[1] = Display::url(
- $survey[1],
- api_get_path(WEB_CODE_PATH).'survey/survey.php?survey_id='.$survey[0].'&'.api_get_cidreq()
- );
- }
- }
- // Validation when belonging to a session
- $session_img = api_get_session_image($survey['session_id'], $_user['status']);
- $array[2] = $survey[2].$session_img;
- $array[3] = $survey[3];
- $array[4] = $survey[4];
- // Dates
- $array[5] = '';
- if (!empty($survey[5]) && $survey[5] !== '0000-00-00' && $survey[5] !== '0000-00-00 00:00:00') {
- $array[5] = api_convert_and_format_date(
- $survey[5],
- $allowSurveyAvailabilityDatetime ? DATE_TIME_FORMAT_LONG : DATE_FORMAT_LONG
- );
- }
- $array[6] = '';
- if (!empty($survey[6]) && $survey[6] !== '0000-00-00' && $survey[6] !== '0000-00-00 00:00:00') {
- $array[6] = api_convert_and_format_date(
- $survey[6],
- $allowSurveyAvailabilityDatetime ? DATE_TIME_FORMAT_LONG : DATE_FORMAT_LONG
- );
- }
- $array[7] =
- Display::url(
- $survey['answered'],
- api_get_path(WEB_CODE_PATH).'survey/survey_invitation.php?view=answered&survey_id='.$survey[0].'&'
- .api_get_cidreq()
- ).' / '.
- Display::url(
- $survey['invited'],
- api_get_path(WEB_CODE_PATH).'survey/survey_invitation.php?view=invited&survey_id='.$survey[0].'&'
- .api_get_cidreq()
- );
- // Anon
- $array[8] = $survey['col8'];
- if ($mandatoryAllowed) {
- $efvMandatory = $efv->get_values_by_handler_and_field_variable(
- $survey[9],
- 'is_mandatory'
- );
- $array[9] = $efvMandatory ? $efvMandatory['value'] : 0;
- // Survey id
- $array[10] = $survey['col9'];
- } else {
- // Survey id
- $array[9] = $survey['col9'];
- }
- if ($isDrh) {
- $array[1] = $survey[1];
- $array[7] = strip_tags($array[7]);
- }
- $surveys[] = $array;
- }
- return $surveys;
- }
- /**
- * @param $from
- * @param $number_of_items
- * @param $column
- * @param $direction
- *
- * @return array
- */
- public static function get_survey_data_for_coach($from, $number_of_items, $column, $direction)
- {
- $mandatoryAllowed = api_get_configuration_value('allow_mandatory_survey');
- $allowSurveyAvailabilityDatetime = api_get_configuration_value('allow_survey_availability_datetime');
- $survey_tree = new SurveyTree();
- $last_version_surveys = $survey_tree->surveylist;
- $list = [];
- foreach ($last_version_surveys as &$survey) {
- $list[] = $survey['id'];
- }
- if (count($list) > 0) {
- $list_condition = " AND survey.survey_id IN (".implode(',', $list).") ";
- } else {
- $list_condition = '';
- }
- $from = (int) $from;
- $number_of_items = (int) $number_of_items;
- $column = (int) $column;
- if (!in_array(strtolower($direction), ['asc', 'desc'])) {
- $direction = 'asc';
- }
- $table_survey = Database::get_course_table(TABLE_SURVEY);
- $table_survey_question = Database::get_course_table(TABLE_SURVEY_QUESTION);
- $table_user = Database::get_main_table(TABLE_MAIN_USER);
- $course_id = api_get_course_int_id();
- $efv = new ExtraFieldValue('survey');
- $sql = "
- SELECT
- survey.survey_id AS col0,
- survey.title AS col1,
- survey.code AS col2,
- count(survey_question.question_id) AS col3,
- "
- .(api_is_western_name_order()
- ? "CONCAT(user.firstname, ' ', user.lastname)"
- : "CONCAT(user.lastname, ' ', user.firstname)")
- ." AS col4,
- survey.avail_from AS col5,
- survey.avail_till AS col6,
- 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 col7,
- survey.anonymous AS col8,
- survey.survey_id AS col9
- FROM $table_survey survey
- LEFT JOIN $table_survey_question survey_question
- ON (survey.survey_id = survey_question.survey_id AND survey.c_id = survey_question.c_id),
- $table_user user
- WHERE survey.author = user.user_id AND survey.c_id = $course_id $list_condition
- ";
- $sql .= ' GROUP BY survey.survey_id';
- $sql .= " ORDER BY col$column $direction ";
- $sql .= " LIMIT $from,$number_of_items";
- $res = Database::query($sql);
- $surveys = [];
- while ($survey = Database::fetch_array($res)) {
- $survey['col5'] = api_convert_and_format_date(
- $survey['col5'],
- $allowSurveyAvailabilityDatetime ? DATE_TIME_FORMAT_LONG : DATE_FORMAT_LONG
- );
- $survey['col6'] = api_convert_and_format_date(
- $survey['col6'],
- $allowSurveyAvailabilityDatetime ? DATE_TIME_FORMAT_LONG : DATE_FORMAT_LONG
- );
- if ($mandatoryAllowed) {
- $survey['col10'] = $survey['col9'];
- $efvMandatory = $efv->get_values_by_handler_and_field_variable(
- $survey['col9'],
- 'is_mandatory'
- );
- $survey['col9'] = $efvMandatory['value'];
- }
- $surveys[] = $survey;
- }
- return $surveys;
- }
- /**
- * Display all the active surveys for the given course user.
- *
- * @param int $user_id
- *
- * @author Patrick Cool <patrick.cool@UGent.be>, Ghent University
- *
- * @version April 2007
- */
- public static function getSurveyList($user_id)
- {
- $_course = api_get_course_info();
- $course_id = $_course['real_id'];
- $user_id = (int) $user_id;
- $sessionId = api_get_session_id();
- $mandatoryAllowed = api_get_configuration_value('allow_mandatory_survey');
- $allowSurveyAvailabilityDatetime = api_get_configuration_value('allow_survey_availability_datetime');
- // Database table definitions
- $table_survey_invitation = Database::get_course_table(TABLE_SURVEY_INVITATION);
- $table_survey = Database::get_course_table(TABLE_SURVEY);
- echo '<table id="list-survey" class="table ">';
- echo '<thead>';
- echo '<tr>';
- echo ' <th>'.get_lang('Survey name').'</th>';
- echo ' <th class="text-center">'.get_lang('Anonymous').'</th>';
- if ($mandatoryAllowed) {
- echo '<th class="text-center">'.get_lang('Mandatory?').'</th>';
- }
- echo '</tr>';
- echo '</thead>';
- echo '<tbody>';
- /** @var \DateTime $now */
- $now = api_get_utc_datetime(null, false, true);
- $filterDate = $allowSurveyAvailabilityDatetime ? $now->format('Y-m-d H:i') : $now->format('Y-m-d');
- $sql = "SELECT survey_invitation.answered,
- survey_invitation.invitation_code,
- survey_invitation.session_id,
- survey.title,
- survey.visible_results,
- survey.survey_id,
- survey.anonymous
- FROM $table_survey survey
- INNER JOIN
- $table_survey_invitation survey_invitation
- ON (
- survey.code = survey_invitation.survey_code AND
- survey.c_id = survey_invitation.c_id AND
- survey.session_id = survey_invitation.session_id
- )
- WHERE
- survey_invitation.user = $user_id AND
- survey.avail_from <= '$filterDate' AND
- survey.avail_till >= '$filterDate' AND
- survey.c_id = $course_id AND
- survey.session_id = $sessionId AND
- survey_invitation.c_id = $course_id
- ";
- $result = Database::query($sql);
- $efv = new ExtraFieldValue('survey');
- $surveyIds = [];
- while ($row = Database::fetch_array($result, 'ASSOC')) {
- if (in_array($row['survey_id'], $surveyIds)) {
- continue;
- }
- echo '<tr>';
- if ($row['answered'] == 0) {
- echo '<td>';
- echo Display::return_icon(
- 'statistics.png',
- get_lang('Create survey'),
- [],
- ICON_SIZE_TINY
- );
- $url = self::generateFillSurveyLink($row['invitation_code'], $_course, $row['session_id']);
- echo '<a href="'.$url.'">
- '.$row['title']
- .'</a></td>';
- } else {
- $isDrhOfCourse = CourseManager::isUserSubscribedInCourseAsDrh(
- $user_id,
- $_course
- );
- $icon = Display::return_icon(
- 'statistics_na.png',
- get_lang('Survey'),
- [],
- ICON_SIZE_TINY
- );
- $showLink = (!api_is_allowed_to_edit(false, true) || $isDrhOfCourse)
- && $row['visible_results'] != SURVEY_VISIBLE_TUTOR;
- echo '<td>';
- echo $showLink
- ? Display::url(
- $icon.PHP_EOL.$row['title'],
- api_get_path(WEB_CODE_PATH).'survey/reporting.php?'.api_get_cidreq().'&'.http_build_query([
- 'action' => 'questionreport',
- 'survey_id' => $row['survey_id'],
- ])
- )
- : $icon.PHP_EOL.$row['title'];
- echo '</td>';
- }
- echo '<td class="text-center">';
- echo ($row['anonymous'] == 1) ? get_lang('Yes') : get_lang('No');
- echo '</td>';
- if ($mandatoryAllowed) {
- $efvMandatory = $efv->get_values_by_handler_and_field_variable(
- $row['survey_id'],
- 'is_mandatory'
- );
- echo '<td class="text-center">'.($efvMandatory['value'] ? get_lang('Yes') : get_lang('No')).'</td>';
- }
- echo '</tr>';
- $surveyIds[] = $row['survey_id'];
- }
- echo '</tbody>';
- echo '</table>';
- }
- /**
- * Creates a multi array with the user fields that we can show.
- * We look the visibility with the api_get_setting function
- * The username is always NOT able to change it.
- *
- * @author Julio Montoya Armas <gugli100@gmail.com>, Chamilo: Personality Test modification
- *
- * @return array array[value_name][name], array[value_name][visibilty]
- */
- public static function make_field_list()
- {
- // LAST NAME and FIRST NAME
- $field_list_array = [];
- $field_list_array['lastname']['name'] = get_lang('Last name');
- $field_list_array['firstname']['name'] = get_lang('First name');
- if (api_get_setting('profile', 'name') != 'true') {
- $field_list_array['firstname']['visibility'] = 0;
- $field_list_array['lastname']['visibility'] = 0;
- } else {
- $field_list_array['firstname']['visibility'] = 1;
- $field_list_array['lastname']['visibility'] = 1;
- }
- $field_list_array['username']['name'] = get_lang('Username');
- $field_list_array['username']['visibility'] = 0;
- // OFFICIAL CODE
- $field_list_array['official_code']['name'] = get_lang('OfficialCourse code');
- if (api_get_setting('profile', 'officialcode') != 'true') {
- $field_list_array['official_code']['visibility'] = 1;
- } else {
- $field_list_array['official_code']['visibility'] = 0;
- }
- // EMAIL
- $field_list_array['email']['name'] = get_lang('e-mail');
- if (api_get_setting('profile', 'email') != 'true') {
- $field_list_array['email']['visibility'] = 1;
- } else {
- $field_list_array['email']['visibility'] = 0;
- }
- // PHONE
- $field_list_array['phone']['name'] = get_lang('Phone');
- if (api_get_setting('profile', 'phone') != 'true') {
- $field_list_array['phone']['visibility'] = 0;
- } else {
- $field_list_array['phone']['visibility'] = 1;
- }
- // LANGUAGE
- $field_list_array['language']['name'] = get_lang('Language');
- if (api_get_setting('profile', 'language') != 'true') {
- $field_list_array['language']['visibility'] = 0;
- } else {
- $field_list_array['language']['visibility'] = 1;
- }
- // EXTRA FIELDS
- $extra = UserManager::get_extra_fields(0, 50, 5, 'ASC');
- foreach ($extra as $id => $field_details) {
- if ($field_details[6] == 0) {
- continue;
- }
- switch ($field_details[2]) {
- case UserManager::USER_FIELD_TYPE_TEXT:
- $field_list_array['extra_'.$field_details[1]]['name'] = $field_details[3];
- if ($field_details[7] == 0) {
- $field_list_array['extra_'.$field_details[1]]['visibility'] = 0;
- } else {
- $field_list_array['extra_'.$field_details[1]]['visibility'] = 1;
- }
- break;
- case UserManager::USER_FIELD_TYPE_TEXTAREA:
- $field_list_array['extra_'.$field_details[1]]['name'] = $field_details[3];
- if ($field_details[7] == 0) {
- $field_list_array['extra_'.$field_details[1]]['visibility'] = 0;
- } else {
- $field_list_array['extra_'.$field_details[1]]['visibility'] = 1;
- }
- break;
- case UserManager::USER_FIELD_TYPE_RADIO:
- $field_list_array['extra_'.$field_details[1]]['name'] = $field_details[3];
- if ($field_details[7] == 0) {
- $field_list_array['extra_'.$field_details[1]]['visibility'] = 0;
- } else {
- $field_list_array['extra_'.$field_details[1]]['visibility'] = 1;
- }
- break;
- case UserManager::USER_FIELD_TYPE_SELECT:
- $get_lang_variables = false;
- if (in_array(
- $field_details[1],
- ['mail_notify_message', 'mail_notify_invitation', 'mail_notify_group_message']
- )
- ) {
- $get_lang_variables = true;
- }
- if ($get_lang_variables) {
- $field_list_array['extra_'.$field_details[1]]['name'] = get_lang($field_details[3]);
- } else {
- $field_list_array['extra_'.$field_details[1]]['name'] = $field_details[3];
- }
- if ($field_details[7] == 0) {
- $field_list_array['extra_'.$field_details[1]]['visibility'] = 0;
- } else {
- $field_list_array['extra_'.$field_details[1]]['visibility'] = 1;
- }
- break;
- case UserManager::USER_FIELD_TYPE_SELECT_MULTIPLE:
- $field_list_array['extra_'.$field_details[1]]['name'] = $field_details[3];
- if ($field_details[7] == 0) {
- $field_list_array['extra_'.$field_details[1]]['visibility'] = 0;
- } else {
- $field_list_array['extra_'.$field_details[1]]['visibility'] = 1;
- }
- break;
- case UserManager::USER_FIELD_TYPE_DATE:
- $field_list_array['extra_'.$field_details[1]]['name'] = $field_details[3];
- if ($field_details[7] == 0) {
- $field_list_array['extra_'.$field_details[1]]['visibility'] = 0;
- } else {
- $field_list_array['extra_'.$field_details[1]]['visibility'] = 1;
- }
- break;
- case UserManager::USER_FIELD_TYPE_DATETIME:
- $field_list_array['extra_'.$field_details[1]]['name'] = $field_details[3];
- if ($field_details[7] == 0) {
- $field_list_array['extra_'.$field_details[1]]['visibility'] = 0;
- } else {
- $field_list_array['extra_'.$field_details[1]]['visibility'] = 1;
- }
- break;
- case UserManager::USER_FIELD_TYPE_DOUBLE_SELECT:
- $field_list_array['extra_'.$field_details[1]]['name'] = $field_details[3];
- if ($field_details[7] == 0) {
- $field_list_array['extra_'.$field_details[1]]['visibility'] = 0;
- } else {
- $field_list_array['extra_'.$field_details[1]]['visibility'] = 1;
- }
- break;
- case UserManager::USER_FIELD_TYPE_DIVIDER:
- //$form->addElement('static',$field_details[1], '<br /><strong>'.$field_details[3].'</strong>');
- break;
- }
- }
- return $field_list_array;
- }
- /**
- * Display survey question chart.
- *
- * @param array $chartData
- * @param bool $hasSerie Tells if the chart has a serie. False by default
- * @param string $chartContainerId
- *
- * @return string (direct output)
- */
- public static function drawChart(
- $chartData,
- $hasSerie = false,
- $chartContainerId = 'chartContainer'
- ) {
- $htmlChart = '';
- if (api_browser_support('svg')) {
- $htmlChart .= api_get_js('d3/d3.v3.5.4.min.js');
- $htmlChart .= api_get_js('dimple.v2.1.2.min.js').'
- <script>
- var svg = dimple.newSvg("#'.$chartContainerId.'", "100%", 400);
- var data = [';
- $serie = [];
- $order = [];
- foreach ($chartData as $chartDataElement) {
- $htmlChart .= '{"';
- if (!$hasSerie) {
- $htmlChart .= get_lang("Option").'":"'.$chartDataElement['option'].'", "';
- array_push($order, $chartDataElement['option']);
- } else {
- if (!is_array($chartDataElement['serie'])) {
- $htmlChart .= get_lang("Option").'":"'.$chartDataElement['serie'].'", "'.
- get_lang("Score").'":"'.$chartDataElement['option'].'", "';
- array_push($serie, $chartDataElement['serie']);
- } else {
- $htmlChart .= get_lang("Serie").'":"'.$chartDataElement['serie'][0].'", "'.
- get_lang("Option").'":"'.$chartDataElement['serie'][1].'", "'.
- get_lang("Score").'":"'.$chartDataElement['option'].'", "';
- }
- }
- $htmlChart .= get_lang("Votes").'":"'.$chartDataElement['votes'].
- '"},';
- }
- rtrim($htmlChart, ",");
- $htmlChart .= '];
- var myChart = new dimple.chart(svg, data);
- myChart.addMeasureAxis("y", "'.get_lang("Votes").'");';
- if (!$hasSerie) {
- $htmlChart .= 'var xAxisCategory = myChart.addCategoryAxis("x", "'.get_lang("Option").'");
- xAxisCategory.addOrderRule('.json_encode($order).');
- myChart.addSeries("'.get_lang("Option").'", dimple.plot.bar);';
- } else {
- if (!is_array($chartDataElement['serie'])) {
- $serie = array_values(array_unique($serie));
- $htmlChart .= 'var xAxisCategory = myChart.addCategoryAxis("x", ["'.get_lang("Option").'","'
- .get_lang("Score").'"]);
- xAxisCategory.addOrderRule('.json_encode($serie).');
- xAxisCategory.addGroupOrderRule("'.get_lang("Score").'");
- myChart.addSeries("'.get_lang("Option").'", dimple.plot.bar);';
- } else {
- $htmlChart .= 'myChart.addCategoryAxis("x", ["'.get_lang("Option").'","'.get_lang("Score").'"]);
- myChart.addSeries("'.get_lang("Serie").'", dimple.plot.bar);';
- }
- }
- $htmlChart .= 'myChart.draw();
- </script>';
- }
- return $htmlChart;
- }
- /**
- * Set a flag to the current survey as answered by the current user.
- *
- * @param string $surveyCode The survey code
- * @param int $courseId The course ID
- */
- public static function flagSurveyAsAnswered($surveyCode, $courseId)
- {
- $currentUserId = api_get_user_id();
- $flag = sprintf('%s-%s-%d', $courseId, $surveyCode, $currentUserId);
- if (!isset($_SESSION['filled_surveys'])) {
- $_SESSION['filled_surveys'] = [];
- }
- $_SESSION['filled_surveys'][] = $flag;
- }
- /**
- * Check whether a survey was answered by the current user.
- *
- * @param string $surveyCode The survey code
- * @param int $courseId The course ID
- *
- * @return bool
- */
- public static function isSurveyAnsweredFlagged($surveyCode, $courseId)
- {
- $currentUserId = api_get_user_id();
- $flagToCheck = sprintf('%s-%s-%d', $courseId, $surveyCode, $currentUserId);
- if (!isset($_SESSION['filled_surveys'])) {
- return false;
- }
- if (!is_array($_SESSION['filled_surveys'])) {
- return false;
- }
- foreach ($_SESSION['filled_surveys'] as $flag) {
- if ($flagToCheck != $flag) {
- continue;
- }
- return true;
- }
- return false;
- }
- /**
- * Check if the current survey has answers.
- *
- * @param int $surveyId
- *
- * @return bool return true if the survey has answers, false otherwise
- */
- public static function checkIfSurveyHasAnswers($surveyId)
- {
- $tableSurveyAnswer = Database::get_course_table(TABLE_SURVEY_ANSWER);
- $courseId = api_get_course_int_id();
- $surveyId = (int) $surveyId;
- if (empty($courseId) || empty($surveyId)) {
- return false;
- }
- $sql = "SELECT * FROM $tableSurveyAnswer
- WHERE
- c_id = $courseId AND
- survey_id = '".$surveyId."'
- ORDER BY answer_id, user ASC";
- $result = Database::query($sql);
- $response = Database::affected_rows($result);
- return $response > 0;
- }
- /**
- * Get the pending surveys for a user.
- *
- * @param int $userId
- *
- * @return array
- */
- public static function getUserPendingInvitations($userId)
- {
- $now = api_get_utc_datetime(null, false, true);
- $dql = "
- SELECT s, si FROM ChamiloCourseBundle:CSurvey s
- INNER JOIN ChamiloCourseBundle:CSurveyInvitation si
- WITH (s.code = si.surveyCode AND s.cId = si.cId AND s.sessionId = si.sessionId )
- WHERE
- si.user = :user_id AND
- s.availFrom <= :now AND
- s.availTill >= :now AND
- si.answered = 0
- ORDER BY s.availTill ASC
- ";
- $pendingSurveys = Database::getManager()
- ->createQuery($dql)
- ->setParameters(['user_id' => $userId, 'now' => $now->format('Y-m-d')])
- ->getResult();
- return $pendingSurveys;
- }
- /**
- * @param string $surveyCode
- * @param int $courseId
- * @param int $sessionId
- *
- * @return array
- */
- public static function getSentInvitations($surveyCode, $courseId, $sessionId = 0)
- {
- $tblUser = Database::get_main_table(TABLE_MAIN_USER);
- $tblSurveyInvitation = Database::get_course_table(TABLE_SURVEY_INVITATION);
- $sessionCondition = api_get_session_condition($sessionId);
- $surveyCode = Database::escape_string($surveyCode);
- $courseId = (int) $courseId;
- $sql = "SELECT survey_invitation.*, user.firstname, user.lastname, user.email
- FROM $tblSurveyInvitation survey_invitation
- LEFT JOIN $tblUser user
- ON (survey_invitation.user = user.id AND survey_invitation.c_id = $courseId)
- WHERE
- survey_invitation.survey_code = '$surveyCode'
- AND survey_invitation.c_id = $courseId
- $sessionCondition";
- $query = Database::query($sql);
- return Database::store_result($query);
- }
- /**
- * @param string $code invitation code
- * @param array $courseInfo
- * @param int $sessionId
- * @param string $surveyCode
- *
- * @return string
- */
- public static function generateFillSurveyLink($code, $courseInfo, $sessionId, $surveyCode = '')
- {
- $code = Security::remove_XSS($code);
- $sessionId = (int) $sessionId;
- if (empty($courseInfo)) {
- return '';
- }
- $params = [
- 'invitationcode' => $code,
- 'cidReq' => $courseInfo['code'],
- 'course' => $courseInfo['code'],
- 'id_session' => $sessionId,
- ];
- if (!empty($surveyCode)) {
- $params['scode'] = Security::remove_XSS($surveyCode);
- }
- return api_get_path(WEB_CODE_PATH).'survey/fillsurvey.php?'.http_build_query($params);
- }
- }
|