-
Notifications
You must be signed in to change notification settings - Fork 0
Expand file tree
/
Copy pathreadme.txt
More file actions
255 lines (192 loc) · 11.1 KB
/
readme.txt
File metadata and controls
255 lines (192 loc) · 11.1 KB
1
2
3
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
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
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
=== UCF Degree Search Plugin ===
Contributors: ucfwebcom
Tags: ucf, degree, search, typeahead
Requires at least: 4.5.3
Tested up to: 6.1
Stable tag: 0.10.3
Requires PHP: 5.4
License: GPLv3 or later
License URI: http://www.gnu.org/copyleft/gpl-3.0.html
Provides utilities for listing and searching against UCF Degrees.
== Description ==
Provides utilities for listing and searching against UCF Degrees. Includes shortcodes for a [typeahead](https://github.com/UCF/UCF-Degree-Search-Plugin/wiki/Typeahead-Shortcode), an [angular search interface](https://github.com/UCF/UCF-Degree-Search-Plugin/wiki/Angular-Shortcode), and a [generic list of degrees](https://github.com/UCF/UCF-Degree-Search-Plugin/wiki/External-Degree-List-Shortcode).
== Installation ==
= Manual Installation =
1. Upload the plugin files (unzipped) to the `/wp-content/plugins` directory, or install the plugin through the WordPress plugins screen directly.
2. Activate the plugin through the "Plugins" screen in WordPress
= WP CLI Installation =
1. `$ wp plugin install --activate https://github.com/UCF/UCF-Degree-Search-Plugin/archive/master.zip`. See [WP-CLI Docs](http://wp-cli.org/commands/plugin/install/) for more command options.
NOTE: Nesting pages under any page that includes the angular degree search in WordPress is **strongly discouraged**. Doing so complicates the url routing the angular degree search performs.
== Changelog ==
= 0.10.3 =
Bug Fixes:
* Corrected deprecation issues
= 0.10.2 =
Bug Fixes:
* Updated the routing logic to not use a trailing slash
= 0.10.1 =
Bug Fixes:
* Corrects an issue with query parameters getting encoded and added as the program type on page load for the degree search angular shortcode.
= 0.10.0 =
Enhancements:
* Added the departments filter to the external degree list shortcode.
= 0.9.0 =
Enhancements:
* Added the group_heading, list_classes, list_item_classes and anchor_classes attributes to the ucf-external-degree-list shortcode.
= 0.8.7 =
Bug Fixes:
* Additional fix for the encoding bug regarding the angular search.
= 0.8.6 =
Bug Fixes:
* Corrected bug where the search query was being double encoded before it was set as the input value on the form.
= 0.8.5 =
Accessibility:
* Added aria-label to degree-search results
* Correctly formatted online link
= 0.8.4 =
Bug Fixes:
* Updated routing to redirect hashbang URLs.
= 0.8.3 =
Bug Fixes:
* Ensure trailing slash is present on URLs.
= 0.8.2 =
Enhancements:
- Added composer file.
= 0.8.1 =
Bug Fix:
- Fixed bug with pagination
= 0.8.0 =
Enhancements:
- Upgraded Angular and updated the degree search
= 0.7.10 =
Bug fixes:
- Fixed redundant/mismatched aria-labels on the angular degree search pagination
- Moved grouped search result headings out of `<ul>` containing degree search results in angular degree search
- Modified markup around angular degree search input to fix invalid usage of `role="search"` and add `type="search"` to the text input
Enhancements:
- Replaced usage of `wp.a11y.speak()` on the angular degree search with addition of `aria-live="polite"` on existing result count + no result found wrapper elements.
- Upgraded packages
= 0.7.9 =
Bug Fixes:
- Removed empty UL tags from degree search results.
- Updated default API URLs
= 0.7.8 =
Enhancements:
- Added a new action hook, `ucf_degree_search_enqueue_scripts_after`, for themes/other plugins to enqueue dependent scripts or perform other actions when degree search js late-enqueues.
= 0.7.7 =
Enhancements:
- Added late script enqueueing
- Updated script handles for enqueued Typeahead and Handlebars scripts for consistency with our other plugins
- Split out the degree picker asset enqueueing from the `[ucf-degree-search]` shortcode. The existing `ucf-degree-search-common.min.js` has been renamed to `ucf-degree-picker.min.js`, and it and its localization settings have been moved to only enqueue when the `[ucf-degree-picker]` shortcode is called.
- Removed some redundant script enqueues.
- Upgraded packages where possible; added linter configs and Github issue/PR templates
Bug Fixes:
- Added missing global variable declarations at the top of the angular degree search's `app.ts` and `handlebar-helpers.ts`.
- Added missing jquery script dependencies for the `ucf-degree-search-js` and `ucf-degree-picker-js` scripts, and `wp-a11y` and Handlebars dependencies for `ucf-degree-search-angular-js`.
= 0.7.6 =
Enhancements:
- Added cache-busting to enqueued JS files
Bug Fixes:
- Added polyfill for `URLSearchParams` to angularjs app for IE11 compatibility
= 0.7.5 =
Bug Fixes:
- Increased the 'per_page' limit to 30 for the Program results returned in the `[ucf-degree-picker]`.
= 0.7.4 =
Bug Fixes:
- Corrected bug with the `[ucf-degree-picker]` where the URL was being improperly formed because of a missing trailing slash.
= 0.7.3 =
Enhancements:
- Added the `[ucf-degree-picker]` shortcode which provides a multistep dropdown solution for finding a degree.
Bug Fixes:
- Updated the way degree typeahead auto initialization works. The script will now look for a specific css class (`.degree-search-typeahead`) and data attribute (`data-degree-search-init`), and initialize those objects automatically. If none are found, the `.degree-search-typeahead` selector is still used by default (for backwards compatibility with theme specific initialization scripts).
- Updated plugin to use data attributes to override typeahead's `result-count` and `query-params`. This removes the need to have the script localized on the fly when the shortcode is processed and cuts down on a number of potential issues - i.e. multiple `UCF_DEGREE_SEARCH` data objects, values being overridden because of multiple data objects, etc.
= 0.7.2 =
Bug Fixes:
- Fixed warnings thrown when [ucf-degree-search] is used with no params.
= 0.7.1 =
Enhancements:
- Added a note to the readme that discourages nesting of pages within WordPress under pages that include the angular degree search. Resolved #58.
Bug Fixes:
- Updated the default `angular_title` value to "Degree Search". Resolved #63.
- Updated the default `query_params` value to "?search=%q". Resolved #62.
- Corrected spelling of the `$defaults` variable under the `add_options()` function. That misspelling was causing the default values for text fields not to be set after activating the plugin.
= 0.7.0 =
Enhancements:
- Added the `[ucf-external-degree-list]` shortcode, which displays a basic list of degrees from an external source. The feed value set in the "Angular Degree Search Rest API" plugin option is used to fetch external degrees.
= 0.6.0 =
Enhancements:
- Adds an additional `form_action` shortcode attribute. This allows the typeahead to submit a GET request to the action URL placed in the `form_action` field.
- Adds dynamic shortcode attributes for adding additional form fields. For example, `form_query_1_name="program-types"` and `form_query_1_value="doctoral"` will add a hidden input with a name of "program-types" and a value of "doctoral" to the typeahead form.
- Updated angular search to use html5Mode, which removes the hashbang format of URLs. Hashbang URLs can, and **should**, still be used to pass specific filters into a URL.
- Added functionality for passing various query parameters into a page containing the angular search. The following parameters are now available (some are provided for backward compatibility):
- `colleges`, i.e. `colleges=arts-humanities`
- `college[0]`, i.e. `college[0]=arts-humanities`
- `program_types`, i.e. `program_types=doctoral`
- `program-type[0]`, i.e. `program-type[0]=doctoral`
- `search`, i.e. `search=History`
Bug Fixes:
- Forces default of typeahead results to 5, instead of 0.
= 0.5.1 =
Bug Fixes:
- Removed Bloodhound prefetching from the degree search typeahead JS until a more suitable utilization of prefetching is found
= 0.5.0 =
Enhancements:
- Added updates for compatibility with UCF-Degree-CPT-Plugin v3.0.0 and the new UCF Search Service
= 0.4.1 =
Enhancements:
- Added a filter for each template so that they can be overridden in themes.
- Added documentation links into the fields for the Handlebars title and heading.
= 0.4.0 =
Enhancements:
- Added configuration settings for setting the title and heading templates for the Degree Search angular app.
- Added the `textarea` and `wysiwyg` controls to the config class.
- Added two custom handlebars helper functions for stripping "degree(s)" and "program(s)" from a program type string (or any string) and to capitalize the first letter of each word within a string.
- Added `hasFilter` boolean field and logic to set it whenever input or filters change.
- Added logic for building title and heading using handlebars. If the handlebars template it not set, the default title and heading will be static.
= 0.3.1 =
Bug Fixes
- Added function to handle character encoding issues.
= 0.3.0 =
Enhancements:
- Added an angular degree search. The angular search consists of multiple componenets which can added separately via shortcode for custom layouts.
= 0.2.4 =
Bug Fixes:
- Updated degree suggestion default template to render raw rendered title to help HTML entities display properly.
= 0.2.3 =
Bug Fixes:
- Javascript assets are included on all pages when the option is checked.
= 0.2.2 =
Bug Fixes:
- Updated to force `tt-menu` to scroll to top when new results are shown.
= 0.2.1 =
Enhancements:
- Added queryTokenizer override.
- Added prepare override.
= 0.2.0 =
Enhancements:
- Added a wrapper class for configuring typeahead and bloodound
- Added configurable options:
- `limit`: Sets the number of suggestions to display.
- `transform`: Assigns a function to transform the data.
- `identify`: Assigns a function to set the identity of each item.
- `displayKey`: Assigns a function to return the displayKey.
- `empty`: Assigns the template for no results found.
- `suggestion`: Assigns the template for each suggestion.
- `footer`: Assigns the template for the suggestion footer.
- `datumTokenizer`: Assigns the function that sets each data's queriable token array.
- `onSelect`: Assigns a function to be run when a suggestion is selected.
- Added WordPress filters:
- `ucf_degree_search_empty`: The markup to display when no results are found.
- `ucf_degree_search_footer`: The markup to display in the suggestions footer.
= 0.1.0 =
- Initial Commit
== Upgrade Notice ==
= 0.6.0 =
In version 0.6.0, the angular degree search's "hashbang" URLs were replaced with clean URLs, which require usage of the HTML5 History API. Browsers that don't support the HTML5 History API (e.g. IE9 and older) will no longer render the angular degree search correctly.
== Installation Requirements ==
* typeahead.js with bloodhound v0.11.1+ (Can serve from CDN with plugin option)
* angular and angular-route v1.6.4+ (Can serve from CDN with plugin option)
* The angular degree search currently depends on the [Athena Framework](https://github.com/UCF/Athena-Framework) for default styles.
* As of v0.6.0, the angular degree search only supports browsers that support the HTML5 History API.
== Development & Contributing ==
NOTE: this plugin's readme.md file is automatically generated. Please only make modifications to the readme.txt file, and make sure the `gulp readme` command has been run before committing readme changes.