This file describes API changes in /mod/feedback/*
Information provided here is intended especially for developers.

=== 4.3 ===

* The `$extradetails` parameter of the `\mod_feedback\output\summary` class constructor has been removed

=== 4.2 ===
* The external methods get_items() and get_page_items() now only return the items when the user can access the feedback; if the
user can't see them, a warning message will be returned, with the reasons.

=== 4.0 ===
* The following files and classes within them have been deprecated in favour of dynamic forms:
    * edit_form.php
    * use_templ_form.php
* The page delete_template.php has been removed as it is now handled within manage_templates.php

=== 3.11 ===
The $extradetails parameter in the constructor of the mod_feedback\output\summary class has been deprecated and is not used anymore.

=== 3.8 ===

* The following functions have been finally deprecated and can not be used anymore:
    * feedback_scale_used()

=== 3.6 ===

* The following functions have been finally deprecated and can not be used anymore:
  * feedback_print_item_preview()
  * feedback_print_item_complete()
  * feedback_print_item_show_value()
  * feedback_check_values()
  * feedback_clean_input_value()
  * feedback_get_context()
  * feedback_create_item()
  * feedback_delete_completedtmp()
  * feedback_get_page_to_continue()
  * feedback_save_values()
  * feedback_save_guest_values()
  * feedback_create_values()
  * feedback_update_values()
  * feedback_get_current_completed()
  * feedback_is_course_in_sitecourse_map()
  * feedback_is_feedback_in_sitecourse_map()
  * feedback_clean_up_sitecourse_map()
  * feedback_print_numeric_option_list()
* Web Service functions now support an optional courseid parameter (course where user completes the feedback).
  This new parameter was necessary to support site feedbacks.

=== 3.5 ===

* The following functions, previously used (exclusively) by upgrade steps are not available
  anymore because of the upgrade cleanup performed for this version. See MDL-59159 for more info:
    - mod_feedback_upgrade_delete_duplicate_values()
    - mod_feedback_upgrade_courseid()

=== 3.3.2 ===

* feedback_refresh_events() Now takes two additional parameters to refine the update to a specific instance. This function
  now optionally takes the module instance object or ID, and the course module object or ID. Please try to send the full
  objects instead of the ids to save DB calls.

=== 3.3 ===

* Method get_current_completed_tmp in mod_feedback_completion class is now public.
* Function feedback_set_tmp_values is not deprecated anymore.

=== 3.1 ===

* feedback_get_courses_from_sitecourse_map() now returns course id as 'id' attribute
* Base class for feedback items - feedback_item_base - has been significantly changed, all item types now
  must implement method complete_form_element() instead of print_item_preview(), print_item_complete(),
  print_item_show_value(), check_values(), clean_input_value() and value_is_array(). Rendering the items
  on complete form, feedback preview, feedback edit and when viewing response is done using moodleform.
* The following functions have been deprecated:
  * feedback_print_item_preview()
  * feedback_print_item_complete()
  * feedback_print_item_show_value
  * feedback_check_values()
  * feedback_clean_input_value()
  * feedback_get_context()
  * feedback_create_item()
  * feedback_set_tmp_values()
  * feedback_delete_completedtmp()
  * feedback_get_page_to_continue()
  * feedback_save_values()
  * feedback_save_guest_values()
  * feedback_create_values()
  * feedback_update_values()
  * feedback_get_current_completed()
  * feedback_is_course_in_sitecourse_map()
  * feedback_is_feedback_in_sitecourse_map()
  * feedback_clean_up_sitecourse_map()
  * feedback_print_numeric_option_list()

=== 2.7 ===

* The validation of the following events is now stricter (see MDL-45445):
    - \mod_feedback\event\response_deleted
    - \mod_feedback\event\response_submitted