-
-
Notifications
You must be signed in to change notification settings - Fork 2
/
Copy pathreadme.txt
292 lines (215 loc) · 13.5 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
=== WindPress - Tailwind CSS integration for WordPress ===
Contributors: suabahasa, rosua
Donate link: https://ko-fi.com/Q5Q75XSF7
Tags: tailwind, tailwindcss, tailwind css
Requires at least: 6.0
Tested up to: 6.7
Stable tag: 3.2.32
Requires PHP: 7.4
License: GPLv3
License URI: https://www.gnu.org/licenses/gpl-3.0.html
Integrate Tailwind CSS 3 or 4 into WordPress easily, in seconds. Works well with the block editor, page builders, plugins, themes, and custom code.
== Description ==
### WindPress: the only Tailwind CSS v3 and v4 integration plugin for WordPress.
WindPress is a platform agnostic [Tailwind CSS](https://tailwindcss.com/) integration plugin for WordPress that allows you to use the full power of Tailwind CSS within the WordPress ecosystem.
**Tailwind CSS version**:
- 3.4.17
- 4.0.8
### Features
WindPress is packed full of features designed to streamline your workflow. Some of our favorites are:
* **Dual Tailwind CSS version**: Tailwind CSS `3.x` and `4.x` ready.
* **Plug and play**: Start using Tailwind CSS in WordPress in seconds — no setup is required.
* **Customizable Configuration**: The plugin comes with a default Tailwind CSS configuration, but you can easily customize it to fit your needs.
* **Easy to use**: Simplified and intuitive settings to get you up and running quickly.
* **Lightweight**: The plugin dashboard built on top of WordPress REST API, and a modern JavaScript framework for an instant, responsive user experience. Yet it has a small footprint and won't slow down your site.
* **Blazingly fast**: Cache makes your WordPress site blazing fast. Generate the final optimized CSS file in the browser without server-side tools. None of your data is transferred over the network.
And some specific integrations also include the following features:
* **Autocompletion**: As you type, Tailwind CSS class names will be suggested automatically.
* **Variable Picker**: Easily select Tailwind CSS themes' colors, fonts, and other variables from a panel.
* **HTML to native elements**: Convert Tailwind CSS HTML to native elements in the editor.
* **Sort the classes**: Sort the Tailwind CSS classes on the input field.
* **Hover Preview the classes**: Hover over the classes to see the complete outputted CSS and the preview of the design canvas.
* **Ubiquitous Panel**: A floating panel that allows you to quickly access the WindPress settings from anywhere on the page.
Visit [our website](https://wind.press) for more information.
### Seamless Integration
It's easy to build design with Tailwind CSS thanks to the seamless integration with the most popular visual/page builders:
* [Gutenberg](https://wordpress.org/gutenberg) / Block Editor
* [GreenShift](https://greenshiftwp.com/)
* [Kadence WP](https://kadencewp.com)
* [LiveCanvas](https://livecanvas.com/?ref=4008)
* [Timber](https://upstatement.com/timber/)
* [Blockstudio](https://blockstudio.dev/?ref=7) — **Pro**
* [Breakdance](https://breakdance.com/ref/165/) — **Pro**
* [Bricks](https://bricksbuilder.io/) — **Pro**
* [Builderius](https://builderius.io/?referral=afdfca82c8) — **Pro**
* [Meta Box Views](https://metabox.io/plugins/mb-views/) — **Pro**
* [Oxygen](https://oxygenbuilder.com/) — **Pro**
* [WPCodeBox 2](https://wpcodebox.com/) — **Pro**
Planned / In Progress
* [Elementor](https://be.elementor.com/visit/?bta=209150&brand=elementor)
* [Divi](https://www.elegantthemes.com/affiliates/idevaffiliate.php?id=47622)
* [Pinegrow](https://pinegrow.com/wordpress)
* [Zion Builder](https://zionbuilder.io/)
Note: The core feature will remain available on all versions, but some integrations may be added or removed from the free version in the future.
### Bring Your Own Integration
WindPress is designed to be easily extensible, so you can build your integrations with Tailwind CSS. The plugin provides a simple API for adding integrations.
Check out our detailed [guide](https://wind.press/docs/integrations/custom-theme) to get started.
= Love WindPress? =
- Give a [5-star review](https://wordpress.org/support/plugin/windpress/reviews/?filter=5/#new-post)
- Purchase the [Pro version](https://wind.press)
- Join our [Facebook Group](https://www.facebook.com/groups/1142662969627943)
- Sponsor us on [GitHub](https://github.com/sponsors/suabahasa) or [Ko-fi](https://ko-fi.com/Q5Q75XSF7)
= Credits =
- Image by [Pixel perfect](https://www.flaticon.com/free-icon/wind_727964) on Flaticon
Affiliate Disclosure: This readme.txt may contain affiliate links. If you decide to make a purchase through these links, we may earn a commission at no extra cost to you.
== Screenshots ==
1. The WindPress settings page to choose the Tailwind CSS version or generate the cached CSS file.
2. The `tailwind.config.js` file editor, which let adding the Tailwind CSS plugins.
3. The `main.css` file editor, which let adding the custom CSS.
4. The Tailwind CSS class name suggestions feature on the Gutenberg editor.
5. Sort the Tailwind CSS classes on the input field.
6. Hover over the Tailwind CSS class name to see the complete outputted CSS and the preview of the design canvas.
7. The front-end page with the Tailwind CSS classes applied, as was added from the Gutenberg editor.
== Frequently Asked Questions ==
= Which version of Tailwind CSS is supported by WindPress? =
WindPress supports both Tailwind CSS versions 3 and 4 and will receive regular updates to support the latest version.
= Is WindPress support the Tailwind CSS plugins? =
Yes, WindPress supports Tailwind CSS plugins. You can add the plugins in the `tailwind.config.js` file editor. The Tailwind CSS plugins will be loaded from the `esm.sh` CDN.
= Do I need an internet connection to use WindPress? =
No, by default, you do not need an internet connection to use WindPress. However, an internet connection is required to load the Tailwind CSS plugins from the CDN.
= What themes is WindPress compatible with? =
WindPress is compatible with any WordPress theme. A small adjustment may be needed for the compiler scanner to detect the used classes in the theme.
== Changelog ==
Note: The Pro version has a version number with one higher minor version than the Free version.
For instance:
Free version 1.**0**.4
Pro version 1.**1**.4
= 3.2.32 =
* **New**: Upgraded to Tailwind CSS v4 (4.0.8 latest)
* **New**: [WPCodeBox 2](https://wpcodebox.com/) integration **[Pro]**
* **Improve**: Better performance on the generating cache process
* **Change**: Generating the CSS cache will remove unused CSS variables. To always keep it, add them within the `@theme static { }` block in the `main.css` file. Alternatively, you can replace the `@import 'tailwindcss/theme.css' layer(theme);` code to `@import "tailwindcss/theme.css" layer(theme) theme(static);` on your `main.css` file.
= 3.2.31 =
* **Fix**: Simple File System imported data are not loaded correctly
= 3.2.30 =
* **New**: Upgraded to Tailwind CSS v4 (4.0.7 latest)
* **Fix**: The `@source` directive is causing error when loaded in the page builders' editor
= 3.2.29 =
* **New**: Upgraded to Tailwind CSS v4 (4.0.6 latest)
* **New**: The `@source` directive is now supported but differs from the official Tailwind CSS version. Please refer to [our documentation](https://wind.press/docs/configuration/file-main-css#scanning-additional-sources) for details.
= 3.2.28 =
* **New**: Upgraded to Tailwind CSS v4 (4.0.5 latest)
= 3.2.27 =
* **New**: Simple File System data are now exportable and importable from the WindPress dashboard page
= 3.2.26 =
* **New**: Upgraded to Tailwind CSS v4 (4.0.4 latest)
= 3.2.25 =
* **New**: Upgraded to Tailwind CSS v4 (4.0.3 latest)
= 3.2.24 =
* **New**: Upgraded to Tailwind CSS v4 (4.0.1 latest)
= 3.2.23 =
* **New**: Upgraded to Tailwind CSS v4 (4.0.0 latest)
= 3.2.22 =
* **Fix**: [Gutenberg] The CSS class field autofocusing issue on the block editor
* **Fix**: [Gutenberg, Breakdance, Bricks, Builderius, LiveCanvas, Oxygen] The generate cache on save feature doesn't use the selected Tailwind CSS version
= 3.2.21 =
* **New**: Upgraded to Tailwind CSS v4 (4.0.0-beta.6 next)
* **Fix**: [Breakdance] Editor style is mixed with admin-bar style (margin-top)
= 3.2.20 =
* **Fix**: [Gutenberg, Breakdance, Bricks, Oxygen] The hover preview feature is too late to disappear when the mouse is moved away from the class name
* **Change**: Decouple the Gutenberg-based integrations' scanner
= 3.2.19 =
* **New**: [Blockstudio](https://blockstudio.dev/?ref=7) integration **[Pro]**
* **New**: Upgraded to Tailwind CSS v3 (3.4.16)
* **New**: Upgraded to Tailwind CSS v4 (4.0.0-beta.5 next)
= 3.2.18 =
* **New**: Upgraded to Tailwind CSS v4 (4.0.0-beta.4 next)
* **New**: [Meta Box Views](https://metabox.io/plugins/mb-views/) integration **[Pro]**
= 3.2.17 =
* **New**: The new website and documentation is now live at [wind.press](https://wind.press)
* **New**: Upgraded to Tailwind CSS v4 (4.0.0-beta.2 next)
* **Fix**: Scanned classes names are not unescaped correctly ([#4](https://github.com/wind-press/windpress/issues/4))
= 3.2.16 =
* **New**: Upgraded to Tailwind CSS v4 (4.0.0-beta.1 next)
= 3.2.15 =
* **New**: Upgraded to Tailwind CSS v3 (3.4.15)
* **New**: Upgraded to Tailwind CSS v4 (4.0.0-alpha.34 next)
* **Improve**: Test compatibility with WordPress 6.7
* **Fix**: [Gutenberg] Missing the WindPress data on the block editor
* **Change**: The [LiveCanvas](https://livecanvas.com/?ref=4008) integration is now available on the Free version
* **Change**: Tailwind CSS v3 stubs/default content are updated for the upcoming Wizard feature
= 3.2.13 =
* **Fix**: Settings page doesn't loaded
= 3.2.12 =
* **New**: Upgraded to Tailwind CSS v4 (4.0.0-alpha.33 next)
* **Improve**: [Breakdance, Bricks, Builderius, Oxygen] Variable Picker feature is now updated to the latest Tailwind CSS v4 variable names
* **Fix**: [Bricks] The Variable Picker panel is not showing correctly on the Bricks editor
* **Change**: Tailwind CSS v3 stubs are updated for the upcoming Wizard feature
= 3.2.10 =
* **New**: Upgraded to Tailwind CSS v4 (4.0.0-alpha.32 next)
= 3.2.9 =
* **New**: Upgraded to Tailwind CSS v4 (4.0.0-alpha.30 next)
= 3.2.8 =
* **New**: Upgraded to Tailwind CSS v4 (4.0.0-alpha.29 next)
= 3.2.7 =
* **New**: Upgraded to Tailwind CSS v4 (4.0.0-alpha.28 next)
= 3.2.6 =
* **New**: Upgraded to Tailwind CSS v3 (3.4.14)
* **New**: Upgraded to Tailwind CSS v4 (4.0.0-alpha.27 next)
* **New**: [Bricks] added settings to enable or disable WindPress' features. Right-click the WindPress icon on the Editor's top bar to access the settings.
= 3.2.5 =
* **Improve**: Reduce the number of Play modules loaded on the front-end page for non-admin users
* **Improve**: The Ubiquitous panel is now automatically hidden when outside of the panel is clicked
= 3.2.4 =
* **Fix**: Breakdance integration doesn't work on the editor due to fail to load the required JavaScript files
= 3.2.3 =
* **New**: Upgraded to Tailwind CSS v4 (4.0.0-alpha.26 next)
* **Improve**: Properly handling the local JavaScript modules
* **Change**: Renamed some action and filter hooks
* **Change**: Some integrations' features are conditionally loaded based on the supported Tailwind CSS version
= 3.2.1 =
* **New**: Porting the Tailwind CSS v4 specific integration features to the Tailwind CSS v3: Autocompletion, Sort, and Class name to CSS
* **Improve**: The Play Observer regenerates the CSS only if new classes are added to the DOM
= 3.2.0 =
* **New**: Tailwind CSS v3 support has been added
* **New**: Upgraded to Tailwind CSS v3 (3.4.13)
* **Change**: Disable the preflight styles by default on the new installation
* **Change**: The CSS and JavaScript files are now deletable by emptying the content
* **Change**: The `main.css` and `tailwind.config.js` files are now resettable by emptying the content
= 3.1.17 =
* **New**: Upgraded to Tailwind CSS v4 (4.0.0-alpha.25 next)
= 3.1.15 =
* **Improve**: Added the bundled Tailwind CSS version number on the settings page
* **Improve**: Relative path support for the local CSS and JavaScript files
= 3.1.14 =
* **New**: Upgraded to Tailwind CSS v4 (4.0.0-alpha.24 next)
* **New**: A simple local CSS and JavaScript file support to manage the Tailwind CSS customizations
* **Fix**: The Ubiquitous Panel feature issue on the Bricks editor
= 3.1.11 =
* **Change**: Temporary disable the Ubiquitous Panel feature on the Bricks editor due to causing issue with the integration.
= 3.1.10 =
* **New**: Upgraded to Tailwind CSS v4 (4.0.0-alpha.23 next)
* **New**: Initial support on Tailwind CSS configs loaded from CDN with the `@config` directive
* **Improve**: Internationalization (i18n) support on the admin dashboard
* **Fix**: Some style issues on the admin dashboard
= 3.1.9 =
* **New**: Upgraded to Tailwind CSS v4 (4.0.0-alpha.21 next)
* **New**: Initial support on Tailwind CSS plugins loaded from CDN with the `@plugin` directive
* **Improve**: Internationalization (i18n) support on the admin dashboard
= 3.1.8 =
* **New**: [Gutenberg](https://wordpress.org/gutenberg) integration.
* **New**: [GreenShift](https://greenshiftwp.com) integration.
* **New**: [Kadence WP](https://kadencewp.com) integration.
= 3.1.6 =
* **Improve**: Internationalization (i18n) support
= 3.1.0 =
* **New**: Upgraded to Tailwind CSS v4 (4.0.0-alpha.20 next)
* **New**: [Timber](https://upstatement.com/timber/) integration
* **New**: [Bricks](https://bricksbuilder.io/) integration **[Pro]**
* **New**: [Breakdance](https://breakdance.com/ref/165/) integration **[Pro]**
* **New**: [Builderius](https://builderius.io/?referral=afdfca82c8) integration **[Pro]**
* **New**: [LiveCanvas](https://livecanvas.com/?ref=4008) integration **[Pro]**
* **New**: [Oxygen](https://oxygenbuilder.com/) integration **[Pro]**
* **Improve**: Test compatibility with WordPress 6.6
= 1.1.0 =
* 🐣 Initial release.