-
Notifications
You must be signed in to change notification settings - Fork 0
/
Copy pathreadme.txt
146 lines (104 loc) · 5.92 KB
/
readme.txt
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
=== UCF FAQ CPT Plugin ===
Contributors: ucfwebcom
Tags: ucf, faq, ucf-plugin, custom post type
Requires at least: 4.7.3
Tested up to: 6.1
Stable tag: 2.0.4
License: GPLv3 or later
License URI: http://www.gnu.org/copyleft/gpl-3.0.html
== Description ==
Provides a custom post type for describing FAQs and creates supporting shortcodes. This plugin supports the [UCF Athena Framework](https://github.com/UCF/Athena-Framework) (Required by the Topic list's "card" layout, and optionally for the FAQ list "classic" layout).
The following templates can be overwritten in the plugin.
* single-faq.php
* archive-faq.php
* taxonomy-topic.php
== 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-FAQ-CPT/archive/master.zip`. See [WP-CLI Docs](http://wp-cli.org/commands/plugin/install/) for more command options.
### Required Plugins
These plugins *must* be activated for the plugin to function properly.
* [Advanced Custom Fields PRO](https://www.advancedcustomfields.com/pro/)
### Supported Plugins
The plugins listed below are extended upon in this plugin--this may include custom layouts for feeds, style modifications, etc. These plugins are not technically required on sites running this plugin, and shouldn't be activated on sites that don't require their features. A plugin does not have to be listed here to be compatible with this plugin.
* [UCF Spotlight](https://github.com/UCF/UCF-Spotlights-Plugin)
## Configuration
* Import field groups (`dev/acf-fields.json`) using the ACF importer under Custom Fields > Tools.
== Changelog ==
= 2.0.4 =
Enhancements:
* Added composer file.
= 2.0.3 =
Accessibility Fixes
* Updated question tags from h3 to strong
* Updated title to h2 tags instead of h2
= 2.0.2 =
Enhancements:
* Adjusted link underline styles in card layouts for FAQs and topics to support Athena v1.1.1+
* Adjusted text colors on FAQ question links and inner card contents to better support usage of FAQ lists against dark backgrounds with light text, e.g. `.bg-inverse`
* Upgraded packages
= 2.0.1 =
Bug Fixes:
* Fixed incorrect early usage of conditional query tags and `get_query_var()` in `ucf_faq_sort_order()`.
Enhancements:
* Upgraded packages
= 2.0.0 =
Enhancements:
* (Breaking change) Updated Handlebars and Typeahead to enqueue by default, since those were incorrectly set to _not_ enqueue out of the box. To do this, the existing Typeahead/Handlebars enqueue options have been completely removed and replaced with new options. You'll need to adjust these settings again if you depend on these scripts _not_ being enqueued.
* (Breaking change) Renamed Handlebars/Typeahead script handles for consistency with our other plugins
* Implemented late JS enqueueing, so that only pages that utilize the `[ucf-faq-search]` shortcode will load dependent JS files
* Renamed `ucf-faq-script.min.js` to `ucf-faq-search.min.js` for clarity
* Split out existing `Common` and `Shortcode` classes into their own separate files
* Added a display function for FAQ searches for consistency with other shortcodes
* Upgraded packages; added Github issue/PR templates and CONTRIBUTING doc
Bug fixes:
* Fixed issue with the `handlebars_handle` option being formatted as a boolean instead of `enqueue_handlebars`
* Fixed `option_{$option_name}` hook to actually work + use the correct option name
* Added `default_option_{$option_name}` hook to ensure defaults values get returned by `get_option()` when a unique default param isn't passed in
= 1.3.0 =
Enhancements:
* Added the ucf-faq-search shortcode
= 1.2.0 =
Enhancements:
* Adds the option to add structured microdata to FAQs.
= 1.1.6 =
Enhancements:
* Added option that sets the default sort order values to new FAQs to a very high number, which pushes them to the bottom of sorted FAQ lists.
= 1.1.5 =
Enhancements:
* Added REST API endpoint for FAQs
= 1.1.4 =
Enhancements:
* Added a Resource Link Search layout specifically for FAQs.
= 1.1.3 =
Enhancements:
* Appended plugin version number to enqueued stylesheet to ensure cache-busting between releases
* Reduced font size of FAQ questions to match Athena Framework font sizing at mobile
Bug fixes:
* Fixed issue with FAQ sort order values not working as expected
= 1.1.2 =
Enhancements:
* Moved collapse classes/attrs up to the FAQ's parent `<a>` tag to prevent issues with misclicks opening the single FAQ post instead of toggling the accordion
* Added `aria-expanded` attr to FAQ collapse links for improved accessibility
= 1.1.1 =
* Added ability to customize (and remove) View All FAQs call-to-action button on FAQ lists (`footer_cta_text` and `footer_cta_url` shortcode params). Either of these new shortcode params can be set to a blank value (e.g. `footer_cta_text=""` to disable the button entirely.)
= 1.1.0 =
* Upgraded packages to latest versions
* Moved topic and question fields to code
* Fixed pagination on admin FAQ list views
* Added line-height style to `.ucf-faq-question`
= 1.0.1 =
* Fixed a debug log message
= 1.0.0 =
* Initial release
== Upgrade Notice ==
= 2.0.0 =
Breaking changes:
* Updated Handlebars and Typeahead to enqueue by default, since those were incorrectly set to _not_ enqueue out of the box. To do this, the existing Typeahead/Handlebars enqueue options have been completely removed and replaced with new options. You'll need to adjust these settings again if you depend on these scripts _not_ being enqueued.
* Renamed Handlebars/Typeahead script handles for consistency with our other plugins
== Installation Requirements ==
None
== 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.