forked from JoryHogeveen/off-canvas-sidebars
-
Notifications
You must be signed in to change notification settings - Fork 0
/
readme.txt
299 lines (203 loc) · 15.2 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
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
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
=== Off-Canvas Sidebars & Menus (Slidebars) ===
Contributors: keraweb
Donate link: https://www.keraweb.nl/donate.php?for=off-canvas-sidebars
Tags: off-canvas, menus, widgets, sidebars, slidebars, panels, jQuery, app, mobile, tablet, responsive, genesis
Requires at least: 4.1
Tested up to: 5.6
Requires PHP: 5.2.4
Stable tag: 0.5.7
Add off-canvas sidebars (Slidebars) containing widgets, menus or other content using the Slidebars jQuery plugin.
== Description ==
This plugin will add various options to implement off-canvas sidebars in your WordPress theme based on the Slidebars jQuery plugin.
= Overview / Features =
* Add off-canvas sidebars to the left, right, top and bottom of your website.
* Use sidebar areas (widget-ready areas), menu locations or [custom hooks](https://github.com/JoryHogeveen/off-canvas-sidebars/wiki/Actions-&-Filters) to place content into the off-canvas sidebars.
* You can add control buttons with a widget, menu item, [shortcode](https://github.com/JoryHogeveen/off-canvas-sidebars/wiki/Shortcodes) or with [custom code](https://github.com/JoryHogeveen/off-canvas-sidebars/wiki/Theme-setup).
* Various customisation options and settings available in the Appearances menu.
* Extensive API for [PHP](https://github.com/JoryHogeveen/off-canvas-sidebars/wiki/PHP-API) and [JS](https://github.com/JoryHogeveen/off-canvas-sidebars/wiki/JavaScript-API).
= Compatibility (IMPORTANT!) =
The structure of your theme is of great importance for this plugin. Please read the [installation guide](https://github.com/JoryHogeveen/off-canvas-sidebars/wiki/Theme-setup) carefully!!
This plugin should work with most themes and plugins although I can't be sure for all use-cases. Also note that at this point it's still a 0.x version...
If the plugin does not work for your theme, please let me know through the support and add a plugins and themes list and I will take a look!
**Fixed elements (like sticky menu's)**
There are known issues with fixed elements and Slidebars. [Click here for more information](https://www.adchsm.com/slidebars/help/advanced-usage/elements-with-fixed-positions/)
I've created two possible solutions for this:
1. Legacy CSS solution. Use basic CSS2 positioning instead of CSS3 transform with hardware acceleration.
2. JavaScript solution. It is slower but still allows the use of hardware acceleration for animations.
= It's not working! / I found a bug! =
Please let me know through [support](https://wordpress.org/support/plugin/off-canvas-sidebars) and add a plugins and themes list! :)
Or [submit an issue here on GitHub](https://github.com/JoryHogeveen/off-canvas-sidebars/issues)
= Credits =
* Slidebars jQuery plugin by [Adam](https://www.adchsm.com/slidebars/ "Adam"), thank you for this great plugin!
== Installation ==
Installation of this plugin works like any other plugin out there. Either:
1. Upload the zip file to the '/wp-content/plugins/' directory
2. Activate the plugin through the 'Plugins' menu in WordPress
Or search for "Off-Canvas Sidebars" via your plugins menu.
= Theme Setup =
Off-Canvas Sidebars won't work "out of the box" with most themes, please read the documentation!
[Click here for theme setup documentation.](https://github.com/JoryHogeveen/off-canvas-sidebars/wiki/Theme-setup)
== Frequently Asked Questions ==
= 1. Will this plugin work with any theme? =
No, due to the difference in structure not all theme's are compatible.
Though most themes can be *made* compatible with some modifications!
= 2. Can I add as many sidebars as I like? =
Yes you can, keep in mind that the more sidebars you add the heavier the load on the server (PHP) and browser (JS) will be.
= 3. How do I change the CSS for the sidebars? =
This plugin only provides the framework that handles the off-canvas part.
There are some settings that slightly change the display but this is very limited.
For more advanced customisations either:
1. Edit your theme style.css file (usually located in `/wp-content/themes/YOURTHEME/`).
2. Use a plugin such as [Simple Custom CSS](https://wordpress.org/plugins/simple-custom-css/).
== Screenshots ==
1. Settings page
2. Sidebars settings page (sidebars closed)
3. Sidebars settings page (sidebar opened)
4. Shortcode generator page
5. Control Widget
6. Menu item
7. Sidebar left (Push effect) -> image from Slidebars website
8. Sidebar left (Overlay effect) -> image from Slidebars website
9. Sidebar top (Push effect) -> image from Slidebars website
== Changelog ==
= 0.5.7 =
* **Enhancement:** Improved compatibility with the toolbar and fixed elements (legacy CSS mode).
* **Enhancement:** Update to data attributes.
* **Enhancement:** New filter `ocs_sidebar_attributes`.
* **Enhancement:** New filter `ocs_sidebar_element`.
* **Enhancement:** Added event action manager.
* **Enhancement:** Do not add the same triggers again on reinit.
* **Enhancement:** Load widget admin assets in site head instead of each widget separately.
* **UI** Use WP meta box functions for setting pages to enhance UI compatibility.
* **Fix:** Set slidebars script to plugin version to prevent browser cache issues.
Detailed info: [PR on GitHub](https://github.com/JoryHogeveen/off-canvas-sidebars/pull/99)
= 0.5.6 =
* **Feature:** Overwrite hook priority within the plugin settings.
* **Feature:** Basic theme hook setup validator. [#95](https://github.com/JoryHogeveen/off-canvas-sidebars/issues/95)
* **Enhancement:** Reorder settings page fields.
* **Enhancement:** Improve Slidebars init and allow reinit.
* **Enhancement:** Added `ocs_default_settings` and `ocs_default_sidebar_settings` filters.
* **Fix:** Make sure sidebars correctly overwrite global settings. [#91](https://github.com/JoryHogeveen/off-canvas-sidebars/issues/91)
* **Fix:** Escape all translated strings for HTML.
* **Fix:** Add `rel="noopener noreferrer"` to all links that open in a new tab.
Detailed info: [PR on GitHub](https://github.com/JoryHogeveen/off-canvas-sidebars/pull/92)
= 0.5.5 =
* **Compatibility**: Changed the CSS to be compatible with `position: sticky;` elements. [#83](https://github.com/JoryHogeveen/off-canvas-sidebars/issues/83)
* **Compatibility**: Fix default before and after widget args. Widget element changed to `<div>` instead of `<li>`. [#88](https://github.com/JoryHogeveen/off-canvas-sidebars/issues/88)
* **Enhancement**: Late init option. [#81](https://github.com/JoryHogeveen/off-canvas-sidebars/issues/81)
* **Enhancement**: Allow minimum value of 0 for numeric settings.
* **Fix**: Gutenberg notice that OCS couldn't be initialized.
* **UI**: Rename control elements to triggers (uniform names).
Detailed info: [PR on GitHub](https://github.com/JoryHogeveen/off-canvas-sidebars/pull/84)
= 0.5.4 =
* **Compatibility:** Support `wp_body_open` as `website_before` hook introduced in WordPress 5.2. [#70](https://github.com/JoryHogeveen/off-canvas-sidebars/issues/70)
* **Enhancement:** Allow Genesis Framework hooks to be overwritten in respect for `wp_body_open`.
* **Enhancement:** Use CSS `vh` unit for canvas container min-height instead of JavaScript.
* **Enhancement:** Better use of WP core UI elements.
* **Enhancement:** Code quality improvements.
Detailed info: [PR on GitHub](https://github.com/JoryHogeveen/off-canvas-sidebars/pull/71)
= 0.5.3 =
* **Enhancement:** Don't render triggers of disabled sidebars if auto-hide is enabled. [#56](https://github.com/JoryHogeveen/off-canvas-sidebars/issues/56)
* **Enhancement:** Support `wp_footer` as `website_after` hook. (Not compatible with all themes!)
* **Enhancement:** Filters to overwrite `website_before` and `website_after` hook priorities.
* **Enhancement:** Do not render inactive trigger buttons if auto-hide is enabled.
Detailed info: [PR on GitHub](https://github.com/JoryHogeveen/off-canvas-sidebars/pull/58)
= 0.5.2 =
* **Feature:** New filter: `ocs_is_sidebar_enabled` to filter whether a sidebar should be rendered or not.
* **Enhancement/Refactoring:** Class autoloader.
= 0.5.1 =
* **Fix:** Bug with creating sidebars on a new installation. [#52](https://github.com/JoryHogeveen/off-canvas-sidebars/issues/52)
* **Enhancement/Refactoring:** Control trigger rendering.
Detailed info: [PR on GitHub](https://github.com/JoryHogeveen/off-canvas-sidebars/pull/53)
= 0.5 =
* **Feature:** Make closing the slidebar after clicking a link an option. [#47](https://github.com/JoryHogeveen/off-canvas-sidebars/issues/47) & [#48](https://github.com/JoryHogeveen/off-canvas-sidebars/issues/48)
* **Feature:** Add icon options in control trigger API and shortcode.
* **Feature:** Enhance widget UI with advanced options for control triggers. [#27](https://github.com/JoryHogeveen/off-canvas-sidebars/issues/27)
* **Enhancement:** Setting page JS and UI enhancements.
* **Enhancement:** Use data attributes to conform [W3C HTML5 specifications](http://www.w3.org/TR/html5/dom.html#embedding-custom-non-visible-data-with-the-data-*-attributes). [#50](https://github.com/JoryHogeveen/off-canvas-sidebars/issues/50)
* **Enhancement:** Add support links on plugins overview page.
* **Refactoring:** Separate classes for tabs, page and settings/validation. Enhances plugin option validation. [#38](https://github.com/JoryHogeveen/off-canvas-sidebars/issues/38)
* **Refactoring:** Global OCS_DOMAIN constant.
* **Updated/Added:** Screenshots.
Detailed info: [PR on GitHub](https://github.com/JoryHogeveen/off-canvas-sidebars/pull/36)
= 0.4.2 =
* **Enhancement:** Keep scrollbar visible when scroll lock is active. [#44](https://github.com/JoryHogeveen/off-canvas-sidebars/issues/44) & [PR #45](https://github.com/JoryHogeveen/off-canvas-sidebars/pull/45)
* **Enhancement:** (Slidebars library) Make sure that percentage based widths are rounded to actual pixels to prevent 1px differences on display.
* **Fix:** PHP Notice on `fixed_elements` key.
* **Compatibility:** Tested with WordPress 4.9
Detailed info: [PR on GitHub](https://github.com/JoryHogeveen/off-canvas-sidebars/pull/43)
= 0.4.1 =
* **Fix:** Loading the correct menu in an off-canvas sidebar was not working correctly. [#37](https://github.com/JoryHogeveen/off-canvas-sidebars/issues/37)
* **Fix:** Scroll lock feature with CSS instead of JavaScript. [#39](https://github.com/JoryHogeveen/off-canvas-sidebars/issues/39)
* **Enhancement:** Add active sidebar ID to the html element classes. [#41](https://github.com/JoryHogeveen/off-canvas-sidebars/issues/41)
Detailed info: [PR on GitHub](https://github.com/JoryHogeveen/off-canvas-sidebars/pull/40)
= 0.4 =
* **Feature:** `[ocs_trigger]` shortcode to display trigger buttons/elements anywhere you like, [click here for documentation](https://github.com/JoryHogeveen/off-canvas-sidebars/wiki/Shortcodes). [#24](https://github.com/JoryHogeveen/off-canvas-sidebars/issues/24)
* Shortcode generator available in the settings page.
* Integrate a shortcode generator with the WP Editor. [#32](https://github.com/JoryHogeveen/off-canvas-sidebars/issues/32)
* **Enhancement:** New "Legacy CSS" mode. Modified the Slidebars library to support older CSS2 animations. Can fix a lot of issues with fixed elements. [#26](https://github.com/JoryHogeveen/off-canvas-sidebars/issues/26)
* **Compatibility:** Modified the default Slidebars CSS to support anchor links and common smooth scroll implementations.
* **Compatibility:** Some enhancements for compatibility with the WP Admin Bar.
* **UI:** Improve widget UI [#27](https://github.com/JoryHogeveen/off-canvas-sidebars/issues/27)
* **Fix:** Enhance the codebase to be more aligned with the WP coding standards with CodeClimate.
Detailed info: [PR on GitHub](https://github.com/JoryHogeveen/off-canvas-sidebars/pull/25)
= 0.3.1.1 =
* **Fix:** Settings page checkbox bug when saving
= 0.3.1 =
* **Feature:** Allow changing this plugin capability to show the settings page
* **Fix:** Update fixed element compat for the new Slidebars version (still experimental, Slidebars still doesn't fully support fixed elements within the site container)
* **Fix:** Don't echo empty sidebar CSS selectors if no styles are set
* **UI:** Set `.ocs-button` to `cursor: pointer;` by default
* Update textdomain hook
Detailed info: [PR on GitHub](https://github.com/JoryHogeveen/off-canvas-sidebars/pull/23)
= 0.3 =
* **Feature:** Allow sidebars to overwrite some general settings
* **Feature:** Option to set padding to sidebars
* **Feature:** Option to choose other content types than only a WP sidebar for an off-canvas sidebar
* **Feature:** Option to set your own CSS prefix (some classes are fixes to `ocs` and can't be changed, the prefix `ocs` is also the default prefix for new installations)
* **Feature:** Added various actions, filters and JS hooks - [Click here for info](https://github.com/JoryHogeveen/off-canvas-sidebars/wiki)
* **Feature:** OCS API functions to output off canvas sidebars in your theme instead of using this plugin frontend functions - [Click here for info](https://github.com/JoryHogeveen/off-canvas-sidebars/wiki/PHP-API)
* **Fix:** Sidebar ID validation wasn't correct
Detailed info: [PR on GitHub](https://github.com/JoryHogeveen/off-canvas-sidebars/pull/10)
= 0.2.2 =
* **Feature:** Option to set the animation speed for sidebars
* **Feature:** Option to use the FastClick library - [Click here for info](https://github.com/JoryHogeveen/off-canvas-sidebars/issues/9 "Click here for info")
* **Fix:** Disabling sidebars on global settings page didn't work
= 0.2.1 =
* **Fix:** Add touch events for iOS mobile device compatibility
* **Enhancement:** Added some actions for front-end (see Other Notes)
= 0.2.0.1 =
* **Fix:** Global variable bug
* **UI:** Improve settings page
= 0.2 =
* Update Slidebars plugin to v2.0.2: [click here for info](https://www.adchsm.com/slidebars/features/ "Slidebars Features")
* **Feature:** An unlimited amount of off-canvas sidebars (No longer just one left, one right)
* **Feature:** 2 new locations (top and bottom)
* **Feature:** 2 new effects (reveal and shift)
* **UI:** Improved settings pages
* **I18n:** Translations are now managed at [translate.wordpress.org](https://translate.wordpress.org/projects/wp-plugins/off-canvas-sidebars "translate.wordpress.org")
* Screenshots updated
* Tested with WordPress 4.6
= 0.1.2 =
* **Feature:** First experiment for compatibility with fixed elements within the site container with the use of `transform: translateZ` (needed for `-webkit-` and `-moz-` only). [See problem here](http://stackoverflow.com/questions/2637058/positions-fixed-doesnt-work-when-using-webkit-transform "See problem here")
* **Improvement:** Usage of a single instance of the class
= 0.1.1 =
* **Feature:** Added the option to change the website_before and website_after hook names
= 0.1 =
Created from nothingness just to be one of the cool kids. Yay!
== Other Notes ==
= You can find me here: =
* [GitHub](https://github.com/JoryHogeveen/off-canvas-sidebars/ "GitHub")
* [Keraweb](http://www.keraweb.nl/ "Keraweb")
* [LinkedIn](https://nl.linkedin.com/in/joryhogeveen "LinkedIn profile")
= Actions | Filters | API =
* [See Wiki on GitHub](https://github.com/JoryHogeveen/off-canvas-sidebars/wiki)
= Credits =
* Slidebars jQuery plugin by [Adam](https://www.adchsm.com/slidebars/ "Adam"), thank you for this great plugin!
= Ideas? =
Please let me know through the support page!
== Upgrade Notice ==
= 0.4 =
Version 0.4 introduces some radical code changes to the plugin. Please clear your cache after updating
= 0.2 =
Version 0.2 introduces some radical code changes to the plugin. Please clear your cache after updating