-
-
Notifications
You must be signed in to change notification settings - Fork 1
/
Copy pathreadme.txt
313 lines (238 loc) · 15.9 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
300
301
302
303
304
305
306
307
308
309
310
311
312
313
=== PWA — easy way to Progressive Web App ===
Contributors: iworks
Donate link: https://ko-fi.com/iworks?utm_source=iworks-pwa&utm_medium=readme-donate
Tags: PWA, Progressive Web Application, progressive web app, progressive, manifest.json
Requires at least: PLUGIN_REQUIRES_WORDPRESS
Tested up to: PLUGIN_TESTED_WORDPRESS
Stable tag: PLUGIN_VERSION
Requires PHP: PLUGIN_REQUIRES_PHP
License: GPLv3 or later
PLUGIN_TAGLINE
== Description ==
Progressive Web Apps (PWA) is a technology that combines the best of mobile web and the best of mobile apps to create a superior mobile web experience. They are installed on the phone like a normal app (web app) and can be accessed from the home screen.
Users can come back to your website by launching the app from their home screen and interact with your website through an app-like interface. Your return visitors will experience almost-instant loading times and enjoy the great performance benefits of your PWA!
iWorks PWA makes it easy for you to convert your WordPress website into a Progressive Web App instantly!
Once this plugin is installed, users browsing your website from a supported mobile device will see a “Add To Home Screen” notice (from the bottom of the screen) and will be able to ‘install your website’ on the home screen of their device.
iWorks PWA allow to add shortcuts for context menu to be displayed by the operating system when a user engages with the web app's icon.
iWorks PWA is easy to configure, it takes less than a minute to set-up your Progressive Web App!
= See room for improvement? =
Great! There are several ways you can get involved to help make PWA — easy way to Progressive Web App better:
1. **Report Bugs:** If you find a bug, error or other problem, please report it! You can do this by [creating a new topic](https://wordpress.org/support/plugin/iworks-pwa/) in the plugin forum. Once a developer can verify the bug by reproducing it, they will create an official bug report in GitHub where the bug will be worked on.
2. **Suggest New Features:** Have an awesome idea? Please share it! Simply [create a new topic](https://wordpress.org/support/plugin/iworks-pwa/) in the plugin forum to express your thoughts on why the feature should be included and get a discussion going around your idea.
3. **Issue Pull Requests:** If you're a developer, the easiest way to get involved is to help out on [issues already reported](https://github.com/iworks/iworks-pwa/issues) in GitHub. Be sure to check out the [contributing guide](https://github.com/iworks/iworks-pwa/blob/master/contributing.md) for developers.
Thank you for wanting to make PWA — easy way to Progressive Web App better for everyone!
== Installation ==
There are 3 ways to install this plugin:
= 1. The super easy way =
1. In your Admin, go to menu Plugins > Add.
1. Search for `iWorks PWA`.
1. Click to install.
1. Activate the plugin.
1. A new menu `PWA` in `Settings` will appear in your Admin.
1. A new location `PWA Shortcuts Menu` in `Display location` will appear in Appearance -> Menu.
= 2. The easy way =
1. Download the plugin (.zip file) on the right column of this page.
1. In your Admin, go to menu Plugins > Add.
1. Select button `Upload Plugin`.
1. Upload the .zip file you just downloaded.
1. Activate the plugin.
1. A new menu `PWA` in `Settings` will appear in your Admin.
1. A new location `PWA Shortcuts Menu` in `Display location` will appear in Appearance -> Menu.
= 3. The old and reliable way (FTP) =
1. Upload `iworks-pwa` folder to the `/wp-content/plugins/` directory.
1. Activate the plugin through the 'Plugins' menu in WordPress.
1. A new menu `PWA` in `Settings` will appear in your Admin.
1. A new location `PWA Shortcuts Menu` in `Display location` will appear in Appearance -> Menu.
== Frequently Asked Questions ==
= How can I translate manifest.json values?
It is only possible with WPML package.
1. Install and activate `WPML Multilingual CMS` and `WPML String Translation` plugins.
1. Save `manifest.json` data on `WP Admin` -> `Settings` -> `WPA`.
1. Open `WP Admin` -> `WPML` -> String translation`.
1. Select domain `iworks-pwa`.
1. Translate strings.
= How can I add a context menu? =
The shortcuts member defines an array of shortcuts or links to key tasks or pages within a web app. A user agent can use these values to assemble a context menu to be displayed by the operating system when a user engages with the web app's icon.
1. Install [Menu Icons by ThemeIsle](https://wordpress.org/plugins/menu-icons/) plugin.
1. Go to WPA -> Appearance -> Menu.
1. Open "Menu Icon Setting" from the "Add menu items" column (it should be on the bottom).
1. Be sure you have "Image" checked.
1. Create a custom menu and set "Display location" to "PWA Shortcuts Menu".
1. Add item.
1. Select icon - it is recommended that you use a single 192x192 pixel icon.
1. Save the menu.
= What is "Add to Home screen"? =
Add to Home screen (or A2HS for short) is a feature available in modern browsers that allows a user to "install" a web app, ie. add a shortcut to their Home screen representing their favourite web app (or site) so they can subsequently access it with a single tap.
A2HS is supported in all mobile browsers, except iOS web view. It's also supported in some Chromium desktop browsers.
== Screenshots ==
1. General configuration.
1. Generic configuration.
1. Apple configuration.
1. Microsoft configuration.
1. Installation app on Android.
1. Shortcuts menu on Android.
== Changelog ==
= 1.6.9 (2025-01-xx) =
* Warnings during AJAX calls has been fixed.
= 1.6.8 (2024-12-31) =
* An error occurred during activation has been fixed. [#11](https://github.com/iworks/iworks-pwa/issues/11) Props for [carameldavid](https://wordpress.org/support/users/carameldavid/).
= 1.6.7 (2024-12-09) =
* Loading integrations action has been fixed.
= 1.6.6 (2024-12-06) =
* Few "translators" comments where been added.[#9](https://github.com/iworks/iworks-pwa/issues/9)
* The [iWorks Rate](https://github.com/iworks/iworks-rate) module has been updated to 2.2.1.
* Translation loading time has been fixed. [#10](https://github.com/iworks/iworks-pwa/issues/10)
* The "orientation" field has been updated. [#8](https://github.com/iworks/iworks-pwa/issues/8)
= 1.6.5 (2024-11-12) =
* Detailed explanation for missing `manifest.json` and `ieconfig.xml` requests where been added. [#2](https://github.com/iworks/iworks-pwa/issues/2)
* Wrong `purpose` value has been fixed. Props for [vitalii-work](https://github.com/vitalii-work). [#6](https://github.com/iworks/iworks-pwa/issues/6)
= 1.6.4 (2024-10-01) =
* Ability to upload SVG file has been removed due to Stored Cross-Site Scripting vulnerability. We recommended to install [Safe SVG](https://wordpress.org/plugins/safe-svg/) to allow upload SVG files. Props for discovering and reporting for [Francesco Carlucci](https://francescocarlucci.com/).
= 1.6.3 (2024-09-16) =
* All empty values where been removed from `manifest.json`.
* The categories element has been added into `manifest.json`.
* The deprecated key `apple-mobile-web-app-capable` has been changed into `mobile-web-app-capable`.
= 1.6.2 (2024-08-26) =
* The scope value is now relative to or limited to the site URL. Props for [leighcc](https://wordpress.org/support/users/leighcc/). Check configuration screen for new option.
* The plugin version has been added to cache key, to force refresh data after plugin update.
= 1.6.1 (2024-08-20) =
* The meta viewport check request has been limited to one per day. Props for [skyfly024](https://wordpress.org/support/users/skyfly024/).
* The [iWorks Rate](https://github.com/iworks/iworks-rate) module has been updated to 2.2.0.
= 1.6.0 (2024-07-04) =
* The filter `iworks-pwa/manifest/data` has been added. It's allowed to modify entire content of the `manifest.json` file. Props for [jdwf0658](https://wordpress.org/support/users/jdwf0658/).
* The `.editorconfig` file has been added.
* The [iWorks Rate](https://github.com/iworks/iworks-rate) module has been updated to 2.1.9.
= 1.5.9 (2024-02-24) =
* A few sizes have been added. [#3](https://github.com/iworks/iworks-pwa/issues/4). Props for [wfrank94](https://wordpress.org/support/users/wfrank94/).
* The plugin URL has been changed to [github](https://github.com/iworks/iworks-pwa).
* The [iWorks Options](https://github.com/iworks/wordpress-options-class) module has been updated to 2.9.2.
* The [iWorks Rate](https://github.com/iworks/iworks-rate) module has been updated to 2.1.8.
= 1.5.8 (2023-12-27) =
* The check for a tag meta with the "viewport" value has been added after changes in plugins activations.
* The dynamic property has been fixed.
* The function `parse_url()` has been replaced by the function `wp_parse_url()`.
* The [iWorks Options](https://github.com/iworks/wordpress-options-class) module has been updated to 2.9.0.
* The [iWorks Rate](https://github.com/iworks/iworks-rate) module has been updated to 2.1.6.
* The nonce check has been added to check "viewport" feature.
= 1.5.7 (2023-11-17) =
* [Empty shortcuts in the `manifest.json` file have been fixed](https://github.com/iworks/iworks-pwa/issues/4). Props for [elmando111](https://wordpress.org/support/users/elmando111/).
* The filter `iworks-pwa/manifest/shortcuts` has been added. It's allowed to modify the shortcuts array in the `manifest.json` file.
* The filter `iworks-pwa/manifest/shortcuts/element/url/campain` has been added. It's allowed to modify the campaign in shortcuts urls.
* The [iWorks Options](https://github.com/iworks/wordpress-options-class) module has been updated to 2.8.8.
= 1.5.6 (2023-10-27) =
* Wrong function name `get_color_background()` has been fixed. Props for [bodhisattvac](https://wordpress.org/support/users/bodhisattvac/).
* The [iWorks Options](https://github.com/iworks/wordpress-options-class) module has been updated to 2.8.7.
* The [iWorks Rate](https://github.com/iworks/iworks-rate) module has been updated to 2.1.3.
= 1.5.5 (2023-07-10) =
* A check for PWA files required to work has been added.
* The [iWorks Options](https://github.com/iworks/wordpress-options-class) module has been updated to 2.8.5.
* The [iWorks Rate](https://github.com/iworks/iworks-rate) module has been updated to 2.1.2.
= 1.5.4 (2023-06-30) =
* The meta tag `apple-mobile-web-app-capable` has been added.
* Trailing slashes from `link` and `meta` tags have been removed.
* The Apple-related PWA has been completely rewritten. Props for [James](https://wordpress.org/support/users/glidem/).
= 1.5.3 (2022-11-16) =
* Fixed translation string.
* Added id property to manifest.json. [Read more](https://developer.chrome.com/blog/pwa-manifest-id/).
* Added manifest.json property `name` limit on plugin install to 45 characters.
* Added manifest.json property `short_name` limit on plugin install to 15 characters.
= 1.5.2 (2022-09-26) =
* Fixed issue with "apple-touch-icon" - it wasn't used even defined.
* Updated iWorks Rate to 2.1.1.
= 1.5.1 (2022-09-10) =
* Added check for a tag meta with the "viewport" value. Add it if it is missing. Props for [Bert](https://wordpress.org/support/users/bertluch/)
* Changed [iWorks Rate Module](https://github.com/iworks/iworks-rate) repository to GitHub.
= 1.5.0 (2022-08-03) =
* Added `Add to Home screen` button to show browser prompt to install "app". Check [Browser compatibility](https://developer.mozilla.org/en-US/docs/Web/API/BeforeInstallPromptEvent#browser_compatibility).
* Added google campaign track to "start_url" in the `manifest.json` file.
= 1.4.3 (2022-05-06) =
* Fixed issue with Microsoft Square Icon. Props for [chickendipper](https://wordpress.org/support/users/chickendipper/).
* Fixed issues lower than 8 PHP. Props for [bamsik001](https://wordpress.org/support/users/bamsik001/).
* Added cache for HTML head with Microsoft data.
= 1.4.2 (2022-04-08) =
* Added params defaults to function called in action `wp_nav_menu_item_custom_fields` to avoid PHP warning for an improper call. Props for [vmaxs](https://wordpress.org/support/users/vmaxs/)
* Added permanent hide for menu pointer when a user visits the PWA Settings page.
= 1.4.1 (2022-04-05) =
* Updated iWorks Options to 2.8.3. (Fixed PHP 7.x compatibility).
= 1.4.0 (2022-04-05) =
* Added [Menu Icons by ThemeIsle](https://wordpress.org/plugins/menu-icons/) plugin integration for PWA Shortcuts.
* Added a message when the site permalink is installed in a sub-directory - this plugin does not support it.
* Added PWA Shortcuts Menu. [Read more about PWA Shortcuts](https://developer.mozilla.org/en-US/docs/Web/Manifest/shortcuts).
* Updated iWorks Options to 2.8.3.
= 1.3.3 (2022-03-22) =
* Replaced cache function o proper one.
* Fixed problem with deleting general icon.
= 1.3.2 (2022-03-22) =
* Fixed wrong option name.
= 1.3.1 (2022-03-22) =
* Added `/ieconfig.xml` link on debug tab.
* Fixed long site title on the offline page. Props for [tanohex](https://wordpress.org/support/users/tanohex/).
* Fixed missed translation domain in a few strings.
* Improved usage of the transient cache. Props for [tanohex](https://wordpress.org/support/users/tanohex/).
* Removed images from debug tab.
= 1.3.0 (2022-03-16) =
* Added object cache for settings.
* Fixed `protected $option_name_icons` warning.
= 1.2.3 (2022-02-23) =
* Removed `console.log` from JavaScript files.
= 1.2.2 (2022-02-21) =
* Added filter `iworks_plugin_get_options' to allow filtering plugin core configuration.
* Added [OG — Better Share on Social Media](https://wordpress.org/plugins/og/) plugin integration.
* Added plugin information into PWA script elements.
* Added purpose "any maskable" to the biggest icon. Props for [vmaxs](https://wordpress.org/support/users/vmaxs/).
* Updated iWorks Options to 2.8.2.
* Updated iWorks Rate to 2.1.0.
= 1.2.1 (2022-02-16) =
* Added a message when the site permalink is "plain" - this plugin does not support it.
* Updated iWorks Options to 2.8.1.
= 1.2.0 (2022-02-15) =
* Added the ability to change the text of the offline page.
* Added version to cache control.
* Added WPML plugin integration.
* Moved worker JavaScript from PHP class to separate template.
= 1.1.6 (2022-01-27) =
* Added screenshots to `readme.txt`.
* Removed debug functions.
= 1.1.5 (2022-01-27) =
* Added Apple Pinned Tab Icon.
* Added Apple Launch Icon Title.
* Added Microsoft Pinned Site.
* Added Microsoft Live Tile for IE11.
* Added HTML prefetch for `manifest.json`.
* Refactored options.
= 1.1.4 (2022-01-24) =
* Fixed typo.
= 1.1.3 (2022-01-24) =
* Fixed class load order issue.
= 1.1.2 (2022-01-24) =
* Added `method_exists` to check iWorks Option Class has method `set_plugin`.
* Changed plugin name into "PWA — easy way to Progressive Web App".
* Cleared `manifest.json` from unwanted values.
* Improved handle `/manifest.json`.
= 1.1.1 (2022-01-23) =
* Added configuration for Apple Splash Screen Icons.
* Added configuration for Apple Touch Icon.
* Added configuration for IE11.
* Added configuration for Microsoft Tile Icons.
= 1.1.0 (2022-01-21) =
* Added configuration for the application name.
* Added configuration for application colours.
* Added configuration for application description.
* Added configuration for application display.
* Added configuration for application icons.
* Added configuration for application orientation.
* Added configuration for application short name.
* Changed plugin name from "iWorks PWA" to "PWA — simple way to Progressive Web App".
* Updated iWorks Options to 2.8.0.
* Updated iWorks Rate to 2.0.6.
= 1.0.0 (2022-01-04) =
* First stable release.
* Added check for the non-SSL site - SSL is required for PWA.
* Added "Rate" module.
* Fixed duplicates in offline URLs set.
* Bumped offline version to 2.
= 0.0.2 (2021-04-26) =
* Added meta `theme-color`. Props for [forexonlineproductionltd](https://wordpress.org/support/users/forexonlineproductionltd/).
= 0.0.1 (2021-03-18) =
* Init.
== Upgrade Notice ==