WebSVN – Moodle – Diff – /question/bank/statistics/classes/helper.php

 // You should have received a copy of the GNU General Public License
 // along with Moodle.  If not, see <http://www.gnu.org/licenses/>.
-namespace qbank_statistics;
-use core_question\statistics\questions\all_calculated_for_qubaid_condition;
-use core_component;
+namespace qbank_statistics;
 /**
  * Helper for statistics
+ *
      * @var float Threshold to determine 'Needs checking?'
      */
     private const NEED_FOR_REVISION_UPPER_THRESHOLD = 50;
-    /**
-     * For a list of questions find all the places, defined by (component, contextid) where there are attempts.
-     *
-     * @param int[] $questionids array of question ids that we are interested in.
-     * @return \stdClass[] list of objects with fields ->component and ->contextid.
-     * @deprecated since Moodle 4.3 please use the method from statistics_bulk_loader.
-     * @todo MDL-78090 Final deprecation in Moodle 4.7
-     */
-    private static function get_all_places_where_questions_were_attempted(array $questionids): array {
-        global $DB;
-        [$questionidcondition, $params] = $DB->get_in_or_equal($questionids);
-        // The MIN(qu.id) is just to ensure that the rows have a unique key.
-        $places = $DB->get_records_sql("
-                SELECT MIN(qu.id) AS somethingunique, qu.component, qu.contextid, " .
-                       \context_helper::get_preload_record_columns_sql('ctx') . "
-                  FROM {question_usages} qu
-                  JOIN {question_attempts} qa ON qa.questionusageid = qu.id
-                  JOIN {context} ctx ON ctx.id = qu.contextid
-                 WHERE qa.questionid $questionidcondition
-              GROUP BY qu.component, qu.contextid, " .
-                       implode(', ', array_keys(\context_helper::get_preload_record_columns('ctx'))) . "
-              ORDER BY qu.contextid ASC
-                ", $params);
-        // Strip out the unwanted ids.
-        $places = array_values($places);
-        foreach ($places as $place) {
-            unset($place->somethingunique);
-            \context_helper::preload_from_record($place);
-        }
-        return $places;
-    }
-    /**
-     * Load the question statistics for all the attempts belonging to a particular component in a particular context.
-     *
-     * @param string $component frankenstyle component name, e.g. 'mod_quiz'.
-     * @param \context $context the context to load the statistics for.
-     * @return all_calculated_for_qubaid_condition|null question statistics.
+    /**
-     * @deprecated since Moodle 4.3 please use the method from statistics_bulk_loader.
-     * @todo MDL-78090 Final deprecation in Moodle 4.7
-     */
-    private static function load_statistics_for_place(string $component, \context $context): ?all_calculated_for_qubaid_condition {
-        // This check is basically if (component_exists).
-        if (empty(core_component::get_component_directory($component))) {
-            return null;
-        }
-        if (!component_callback_exists($component, 'calculate_question_stats')) {
-            return null;
-        }
-        return component_callback($component, 'calculate_question_stats', [$context]);
-    }
-    /**
-     * Extract the value for one question and one type of statistic from a set of statistics.
-     *
-     * @param all_calculated_for_qubaid_condition $statistics the batch of statistics.
-     * @param int $questionid a question id.
-     * @param string $item one of the field names in all_calculated_for_qubaid_condition, e.g. 'facility'.
-     * @return float|null the required value.
-     * @deprecated since Moodle 4.3 please use the method from statistics_bulk_loader.
-     * @todo MDL-78090 Final deprecation in Moodle 4.7
-     */
-    private static function extract_item_value(all_calculated_for_qubaid_condition $statistics,
-            int $questionid, string $item): ?float {
-        // Look in main questions.
-        foreach ($statistics->questionstats as $stats) {
-            if ($stats->questionid == $questionid && isset($stats->$item)) {
-                return $stats->$item;
-            }
-        }
-        // If not found, look in sub questions.
-        foreach ($statistics->subquestionstats as $stats) {
-            if ($stats->questionid == $questionid && isset($stats->$item)) {
-                return $stats->$item;
-            }
-        }
-        return null;
-    }
-    /**
-     * Calculate average for a stats item on a list of questions.
-     *
-     * @param int[] $questionids list of ids of the questions we are interested in.
-     * @param string $item one of the field names in all_calculated_for_qubaid_condition, e.g. 'facility'.
-     * @return array array keys are question ids and the corresponding values are the average values.
-     *      Only questions for which there are data are included.
-     * @deprecated since Moodle 4.3 please use the method from statistics_bulk_loader.
-     * @todo MDL-78090 Final deprecation in Moodle 4.7
-     */
-    private static function calculate_average_question_stats_item(array $questionids, string $item): array {
-        $places = self::get_all_places_where_questions_were_attempted($questionids);
-        $counts = [];
-        $sums = [];
-        foreach ($places as $place) {
-            $statistics = self::load_statistics_for_place($place->component,
-                    \context::instance_by_id($place->contextid));
-            if ($statistics === null) {
-                continue;
-            }
-            foreach ($questionids as $questionid) {
-                $value = self::extract_item_value($statistics, $questionid, $item);
-                if ($value === null) {
-                    continue;
-                }
-                $counts[$questionid] = ($counts[$questionid] ?? 0) + 1;
-                $sums[$questionid] = ($sums[$questionid] ?? 0) + $value;
-            }
-        }
-        // Return null if there is no quizzes.
-        $averages = [];
-        foreach ($sums as $questionid => $sum) {
-            $averages[$questionid] = $sum / $counts[$questionid];
-        }
-        return $averages;
-    }
-    /**
-     * Calculate average facility index
-     *
-     * @param int $questionid
-     * @return float|null
-     * @deprecated since Moodle 4.3 please use the method from statistics_bulk_loader.
-     * @todo MDL-78090 Final deprecation in Moodle 4.7
+     * @deprecated since Moodle 4.3 please use the method from statistics_bulk_loader.
+     */
+    #[\core\attribute\deprecated(
+        'statistics_bulk_loader or get_required_statistics_fields',
+        since: '4.3',
+        mdl: 'MDL-75576',
+        final: true
-     */
+    )]
     public static function calculate_average_question_facility(int $questionid): ?float {
-        debugging('Deprecated: please use statistics_bulk_loader instead, ' .
-                'or get_required_statistics_fields in your question bank column class.', DEBUG_DEVELOPER);
-        $averages = self::calculate_average_question_stats_item([$questionid], 'facility');
-        return $averages[$questionid] ?? null;
+        \core\deprecation::emit_deprecation([self::class, __FUNCTION__]);
+    }
-    /**
-     * Calculate average discriminative efficiency
-     *
      * @param int $questionid question id
-     * @return float|null
-     * @deprecated since Moodle 4.3 please use the method from statistics_bulk_loader.
+    /**
+     * @deprecated since Moodle 4.3 please use the method from statistics_bulk_loader.
+     */
+    #[\core\attribute\deprecated(
+        'statistics_bulk_loader or get_required_statistics_fields',
+        since: '4.3',
+        mdl: 'MDL-75576',
-     * @todo MDL-78090 Final deprecation in Moodle 4.7
+        final: true
-     */
+    )]
-    public static function calculate_average_question_discriminative_efficiency(int $questionid): ?float {
-        debugging('Deprecated: please use statistics_bulk_loader instead, ' .
-                'or get_required_statistics_fields in your question bank column class.', DEBUG_DEVELOPER);
-        $averages = self::calculate_average_question_stats_item([$questionid], 'discriminativeefficiency');
+    public static function calculate_average_question_discriminative_efficiency(int $questionid): ?float {
-        return $averages[$questionid] ?? null;
+        \core\deprecation::emit_deprecation([self::class, __FUNCTION__]);
-    }
-    /**
-     * Calculate average discriminative efficiency
+    }
-     * @param int $questionid question id
      * @return float|null
+    /**
+     * @deprecated since Moodle 4.3 please use the method from statistics_bulk_loader.
+     */
+    #[\core\attribute\deprecated(
+        'statistics_bulk_loader or get_required_statistics_fields',
+        since: '4.3',
-     * @deprecated since Moodle 4.3 please use the method from statistics_bulk_loader.
+        mdl: 'MDL-75576',
-     * @todo MDL-78090 Final deprecation in Moodle 4.7
+        final: true
-     */
-    public static function calculate_average_question_discrimination_index(int $questionid): ?float {
-        debugging('Deprecated: please use statistics_bulk_loader instead, ' .
-                'or get_required_statistics_fields in your question bank column class.', DEBUG_DEVELOPER);
+    )]
-        $averages = self::calculate_average_question_stats_item([$questionid], 'discriminationindex');
+    public static function calculate_average_question_discrimination_index(int $questionid): ?float {
-        return $averages[$questionid] ?? null;
+        \core\deprecation::emit_deprecation([self::class, __FUNCTION__]);
+    }

Proyectos de Subversion Moodle

(root)/question/bank/statistics/classes/helper.php – Rev 1 → 1441