upgrade.txt 4.09 KB
Newer Older
1
2
3
This files describes API changes in tagging, information provided
here is intended especially for developers.

4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
=== 3.6 ===

* The following functions have been finally deprecated and can not be used anymore:
  * tag_type_set()
  * tag_description_set()
  * tag_get_tags()
  * tag_get_tags_array()
  * tag_get_tags_csv()
  * tag_get_tags_ids()
  * tag_get_id()
  * tag_rename()
  * tag_delete_instance()
  * tag_add()
  * tag_assign()
  * tag_record_count()
  * tag_record_tagged_with()
  * tag_set_flag()
  * tag_unset_flag()
  * tag_print_cloud()
  * tag_print_description_box()
  * tag_print_management_box()
  * tag_print_search_box()
  * tag_print_search_results()
  * tag_print_tagged_users_table()
  * tag_print_user_box()
  * tag_print_user_list()
  * tag_display_name
  * tag_normalize
  * tag_get_related_tags_csv()
  * tag_set()
  * tag_set_add()
  * tag_set_delete()
  * tag_get()
  * tag_get_related_tags()
  * tag_delete
  * tag_delete_instances()
  * tag_cleanup()
  * tag_bulk_delete_instances()
  * tag_compute_correlations()
  * tag_process_computed_correlation()
  * tag_cron()
  * tag_find_tags()
  * tag_get_name()
  * tag_get_correlated()
  * tag_cloud_sort()

50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
=== 3.1 ===

* Each plugin must define the tag areas it uses in plugindir/db/tag.php
  See https://docs.moodle.org/dev/Tag_API for more details.
* When adding a 'tags' form element the component and itemtype must be specified
  in the element attributes.
* Tag name is no longer a unique field in 'tag' table, tags may be separated in
  tag collections
* Specifying component is also required when retrieving item tags. This will allow
  different components to add tags to the same table (for example blog and forum
  posts) and even suggest alternative tagging for the same items.
* All tag_* functions were deprecated because they now require either tag
  collection id or component, some were moved to the new class core_tag_tag and
  some - to the renderers or templates. As usual, the deprecated function code
  and debugging message will provide you with the suggestions of the alternative.
  Please note that all deprecated functions will be removed after several major releases.
  - tag_type_set
  - tag_description_set
  - tag_get_tags
  - tag_get_tags_array
  - tag_get_tags_csv
  - tag_get_tags_ids
  - tag_get_id
  - tag_rename
  - tag_delete_instance
  - tag_find_records
  - tag_add
  - tag_assign
  - tag_record_count
  - tag_record_tagged_with
  - tag_set_flag
  - tag_unset_flag
  - tag_print_cloud
  - tag_print_description_box
  - tag_print_management_box
  - tag_print_search_box
  - tag_print_search_results
  - tag_print_tagged_users_table
  - tag_print_user_box
  - tag_print_user_list
  - tag_display_name
  - tag_normalize
  - tag_get_related_tags_csv
  - tag_set
  - tag_set_add
  - tag_set_delete
  - tag_get
  - tag_get_related_tags
  - tag_delete
  - tag_delete_instances
  - tag_cleanup
  - tag_bulk_delete_instances
  - tag_compute_correlations
  - tag_process_computed_correlation
  - tag_cron
  - tag_find_tags
  - tag_get_name
  - tag_get_correlated
  - tag_cloud_sort
109
* Char field 'tagtype' in database table 'tag' is replaced with int (0 or 1) field 'isstandard'.
110

111
112
113
114
115
116
117
=== 3.0 ===

* Tagging courses is now implemented without user id - through course edit form or
  special "Course tags" form. All coursetag_* functions in /tag/coursetagslib.php
  were deprecated without replacement and related JS code was removed. Config variable
  $CFG->block_tags_showcoursetags was removed.

118
119
120
121
122
=== 2.7 ===

* The functions tag_set, tag_set_add, tag_set_delete and tag_assign now expect the component
and contextid of the item being tagged.

123
124
125
126
127
128
129
130
=== 2.6 ===

More cleanup was done to tag cloud sorting which involved some API changes, see MDL_39800
* tag_print_cloud() arguments were changed.
* coursetag_get_tags() arguments were changed.
* coursetag_get_all_tags() arguments were changed.
* coursetag_sort() was removed.

131
132
133
134
135
136
137
138
=== 2.4 ===

Significant cleanup was done to course tags which involved some API
changes, see MDL-15471
* tag_print_cloud() arguments were changed
* coursetag_print_cloud() was removed.
* coursetag_get_official_keywords() was removed
* coursetag_rss_feeds() was removed