Add SurveyExportCsv plugin - refs BT#15280

plugin/surveyexportcsv/README.md

@@ -0,0 +1,10 @@
+# Survey Export CSV
+
+Export surveys to CSV file.
+
+This plugin will add a new action button in survey list allowing export the survey.
+
+**Instructions**
+
+- Install plugin
+- Set enabled in configuration

plugin/surveyexportcsv/SurveyExportCsvPlugin.php

@@ -0,0 +1,94 @@
+<?php
+/* For licensing terms, see /license.txt */
+
+/**
+ * Class SurveyExportCsvPlugin.
+ */
+class SurveyExportCsvPlugin extends Plugin
+{
+    /**
+     * SurveyExportCsvPlugin constructor.
+     */
+    protected function __construct()
+    {
+        $settings = [
+            'enabled' => 'boolean',
+        ];
+
+        parent::__construct('0.1', 'Angel Fernando Quiroz Campos', $settings);
+    }
+
+    /**
+     * @return SurveyExportCsvPlugin|null
+     */
+    public static function create()
+    {
+        static $result = null;
+
+        return $result ? $result : $result = new self();
+    }
+
+    /**
+     * Installation process.
+     */
+    public function install()
+    {
+    }
+
+    /**
+     * Uninstallation process.
+     */
+    public function uninstall()
+    {
+    }
+
+    /**
+     * @param $id
+     *
+     * @return string
+     */
+    public static function filterModify($params)
+    {
+        $enabled = api_get_plugin_setting('surveyexportcsv', 'enabled');
+
+        if ($enabled !== 'true') {
+            return '';
+        }
+
+        $surveyId = isset($params['survey_id']) ? (int) $params['survey_id'] : 0;
+        $iconSize = isset($params['icon_size']) ? $params['icon_size'] : ICON_SIZE_SMALL;
+
+        if (empty($surveyId)) {
+            return '';
+        }
+
+        return Display::url(
+            Display::return_icon('export_csv.png', get_lang('ExportAsCSV'), [], $iconSize),
+            api_get_path(WEB_PLUGIN_PATH).'surveyexportcsv/export.php?survey='.$surveyId.'&'.api_get_cidreq()
+        );
+    }
+
+    /**
+     * Create tools for all courses.
+     */
+    private function createLinkToCourseTools()
+    {
+        $result = Database::getManager()
+            ->createQuery('SELECT c.id FROM ChamiloCoreBundle:Course c')
+            ->getResult();
+
+        foreach ($result as $item) {
+            $this->createLinkToCourseTool($this->get_name().':teacher', $item['id'], 'survey.png');
+        }
+    }
+
+    /**
+     * Remove all course tools created by plugin.
+     */
+    private function removeLinkToCourseTools()
+    {
+        Database::getManager()
+            ->createQuery('DELETE FROM ChamiloCourseBundle:CTool t WHERE t.link LIKE :link AND t.category = :category')
+            ->execute(['link' => 'surveyexportcsv/start.php%', 'category' => 'plugin']);
+    }
+}

plugin/surveyexportcsv/export.php

@@ -0,0 +1,203 @@
+<?php
+/* For licensing terms, see /license.txt */
+
+use Chamilo\CourseBundle\Entity\CSurveyAnswer;
+use Chamilo\CourseBundle\Entity\CSurveyQuestionOption;
+
+require_once __DIR__.'/../../main/inc/global.inc.php';
+
+api_protect_course_script(true);
+api_protect_teacher_script();
+
+$surveyId = isset($_GET['survey']) ? (int)$_GET['survey'] : 0;
+$surveyData = SurveyManager::get_survey($surveyId);
+$courseId = api_get_course_int_id();
+
+if (empty($surveyData)) {
+    api_not_allowed(true);
+}
+
+$plugin = SurveyExportCsvPlugin::create();
+
+if ($plugin->get('enabled') !== 'true') {
+    api_not_allowed(true);
+}
+
+$questionsData = SurveyManager::get_questions($surveyId, $courseId);
+// Sort questions by their "sort" field
+$questionsData = array_filter(
+    $questionsData,
+    function ($questionData) {
+        return in_array($questionData['type'], ['yesno', 'multiplechoice', 'open']);
+    }
+);
+usort(
+    $questionsData,
+    function ($qL, $qR) {
+        if ($qL['sort'] == $qR['sort']) {
+            return 0;
+        }
+
+        return $qL['sort'] < $qR['sort'] ? -1 : 1;
+    }
+);
+
+$content = [];
+$content[] = firstRow($questionsData);
+
+$surveyAnswers = getSurveyAnswers($courseId, $surveyId);
+
+// Process answers
+foreach ($surveyAnswers as $i => $answer) {
+    $row = otherRow($questionsData, $answer['user'], $courseId);
+    array_unshift($row, $i + 1);
+
+    $content[] = $row;
+}
+
+// Generate file
+$fileName = md5($surveyId.time());
+
+Export::arrayToCsv($content, $fileName);
+
+/**
+ * Generate the first row for file
+ *
+ * @param $questions
+ *
+ * @return array
+ */
+function firstRow($questions)
+{
+    array_pop($questions);
+    $positions = array_keys($questions);
+
+    $row = ['DATID'];
+
+    foreach ($positions as $position) {
+        $row[] = sprintf("P%02d", $position + 1);
+    }
+
+    $row[] = 'DATOBS';
+
+    return $row;
+}
+
+/**
+ * Get unique answer for surveys by users
+ *
+ * @param int $courseId
+ * @param int $surveyId
+ *
+ * @return array
+ */
+function getSurveyAnswers($courseId, $surveyId)
+{
+    $surveyAnswers = Database::getManager()
+        ->createQuery(
+            'SELECT sa.user, MIN(sa.iid) AS id FROM ChamiloCourseBundle:CSurveyAnswer sa
+        WHERE sa.cId = :course AND sa.surveyId = :survey
+        GROUP BY sa.user ORDER BY id ASC'
+        )
+        ->setParameters(['course' => $courseId, 'survey' => $surveyId])
+        ->getResult();
+
+    return $surveyAnswers;
+}
+
+/**
+ * @param string $user
+ * @param int    $courseId
+ * @param int    $surveyId
+ * @param int    $questionId
+ *
+ * @return array
+ */
+function getQuestionOptions($user, $courseId, $surveyId, $questionId)
+{
+    $options = Database::getManager()
+        ->createQuery(
+            'SELECT sqo FROM ChamiloCourseBundle:CSurveyQuestionOption sqo
+                INNER JOIN ChamiloCourseBundle:CSurveyAnswer sa
+                    WITH
+                        sqo.cId = sa.cId
+                        AND sqo.questionId = sa.questionId
+                        AND sqo.surveyId = sa.surveyId
+                        AND sqo.iid = sa.optionId
+                WHERE sa.user = :user AND sa.cId = :course AND sa.surveyId = :survey AND sa.questionId = :question'
+        )
+        ->setParameters(
+            [
+                'user' => $user,
+                'course' => $courseId,
+                'survey' => $surveyId,
+                'question' => $questionId,
+            ]
+        )
+        ->getResult();
+
+    return $options;
+}
+
+/**
+ * @param int    $questionId
+ * @param int    $surveyId
+ * @param int    $courseId
+ * @param string $user
+ *
+ * @throws \Doctrine\ORM\NonUniqueResultException
+ *
+ * @return CSurveyAnswer|null
+ */
+function getOpenAnswer($questionId, $surveyId, $courseId, $user)
+{
+    $answer = Database::getManager()
+        ->createQuery(
+            'SELECT sa FROM ChamiloCourseBundle:CSurveyAnswer sa
+            WHERE sa.cId = :course AND sa.surveyId = :survey AND sa.questionId = :question AND sa.user = :user'
+        )
+        ->setParameters(['course' => $courseId, 'survey' => $surveyId, 'question' => $questionId, 'user' => $user])
+        ->getOneOrNullResult();
+
+    return $answer;
+}
+
+/**
+ * Generate the content rows for file
+ *
+ * @param array  $questions
+ * @param string $user
+ * @param int    $courseId
+ *
+ * @throws \Doctrine\ORM\NonUniqueResultException
+ *
+ * @return array
+ */
+function otherRow($questions, $user, $courseId)
+{
+    $row = [];
+
+    foreach ($questions as $question) {
+        if ('open' === $question['type']) {
+            $answer = getOpenAnswer($question['question_id'], $question['survey_id'], $courseId, $user);
+
+            $row[] = Security::remove_XSS(
+                $answer->getOptionId()
+            );
+        } else {
+            $options = getQuestionOptions(
+                $user,
+                $courseId,
+                $question['survey_id'],
+                $question['question_id']
+            );
+
+            /** @var CSurveyQuestionOption $option */
+            foreach ($options as $option) {
+                $row[] = $option->getSort();
+            }
+        }
+    }
+
+    return $row;
+}

plugin/surveyexportcsv/install.php

@@ -0,0 +1,4 @@
+<?php
+/* For licensing terms, see /license.txt */
+
+SurveyExportCsvPlugin::create()->install();

plugin/surveyexportcsv/lang/english.php

@@ -0,0 +1,7 @@
+<?php
+/* For licensing terms, see /license.txt */
+
+$strings['plugin_title'] = "Survey Export CSV";
+$strings['plugin_comment'] = "Export surveys results to CSV file";
+
+$strings['enabled'] = 'Enabled';

plugin/surveyexportcsv/lang/spanish.php

@@ -0,0 +1,7 @@
+<?php
+/* For licensing terms, see /license.txt */
+
+$strings['plugin_title'] = "Survey Export CSV";
+$strings['plugin_comment'] = "Exportar resultados de encuestas en archivo CSV.";
+
+$strings['enabled'] = 'Habilitado';

plugin/surveyexportcsv/plugin.php

@@ -0,0 +1,4 @@
+<?php
+/* For licensing terms, see /license.txt */
+
+$plugin_info = SurveyExportCsvPlugin::create()->get_info();

plugin/surveyexportcsv/start.php

@@ -0,0 +1,50 @@
+<?php
+/* For licensing terms, see /license.txt */
+
+require_once __DIR__.'/../../main/inc/global.inc.php';
+
+api_protect_course_script(true);
+api_protect_teacher_script();
+
+$plugin = SurveyExportCsvPlugin::create();
+
+$courseCode = api_get_course_id();
+
+// Create a sortable table with survey-data
+$table = new SortableTable(
+    'surveys',
+    ['SurveyUtil', 'get_number_of_surveys'],
+    ['SurveyUtil', 'get_survey_data'],
+    2
+);
+$table->set_additional_parameters(['cidReq' => $courseCode]);
+$table->set_header(0, '', false);
+$table->setHideColumn(0);
+$table->set_header(1, get_lang('SurveyName'));
+$table->set_header(2, get_lang('SurveyCode'), true, ['class' => 'text-center'], ['class' => 'text-center']);
+$table->set_header(3, get_lang('NumberOfQuestions'), true, ['class' => 'text-right'], ['class' => 'text-right']);
+$table->set_header(4, get_lang('Author'));
+$table->set_header(5, get_lang('AvailableFrom'), true, ['class' => 'text-center'], ['class' => 'text-center']);
+$table->set_header(6, get_lang('AvailableUntil'), true, ['class' => 'text-center'], ['class' => 'text-center']);
+$table->set_header(7, get_lang('Invite'), true, ['class' => 'text-right'], ['class' => 'text-right']);
+$table->set_header(8, get_lang('Anonymous'), true, ['class' => 'text-center'], ['class' => 'text-center']);
+$table->set_column_filter(8, ['SurveyUtil', 'anonymous_filter']);
+
+if (api_get_configuration_value('allow_mandatory_survey')) {
+    $table->set_header(9, get_lang('IsMandatory'), true, ['class' => 'text-center'], ['class' => 'text-center']);
+    $table->set_header(10, get_lang('Export'), false, ['class' => 'text-center'], ['class' => 'text-center']);
+    $table->set_column_filter(10, ['SurveyExportCsvPlugin', 'filterModify']);
+} else {
+    $table->set_header(9, get_lang('Export'), false, ['class' => 'text-center'], ['class' => 'text-center']);
+    $table->set_column_filter(9, ['SurveyExportCsvPlugin', 'filterModify']);
+}
+
+$pageTitle = $plugin->get_title();
+
+$template = new Template($pageTitle);
+
+$content = $table->return_table();
+
+$template->assign('header', $pageTitle);
+$template->assign('content', $content);
+$template->display_one_col_template();

plugin/surveyexportcsv/uninstall.php

@@ -0,0 +1,4 @@
+<?php
+/* For licensing terms, see /license.txt */
+
+SurveyExportCsvPlugin::create()->uninstall();