-
Notifications
You must be signed in to change notification settings - Fork 1
/
readme.txt
326 lines (242 loc) · 9.13 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
314
315
316
317
318
319
320
321
322
323
324
325
326
=== Videomail for Ninja Forms ===
Contributors: michael.heuberger, kbjohnson90
Tags: form, video, email, audio, webcam, recorder, sign language, deaf
Requires at least: 6.0
Tested up to: 6.2.2
Stable tag: 5.1.0
Requires PHP: 7.4.0
Donate link: https://videomail.io/faq
License: CC0-1.0
Record videos in Ninja Forms!
== Description ==
With this add-on recording and sending videos in WordPress *finally* comes true. No further coding required. Just install + configure a bit (like duration, width or enable audio etc) and that’s all. Wicked.
* Record from webcam, simple
* Allow *video* and *audio* inputs in your forms, wow!
* World first solution
* Very easy to add with Ninja Forms
All you need is the Ninja Forms plugin so that this extension can be added there.
Latest version (zip file) also can be downloaded for free anytime from GitHub:
[https://github.com/binarykitchen/videomail-for-ninja-forms/blob/master/dist/videomail-for-ninja-forms.zip](https://github.com/binarykitchen/videomail-for-ninja-forms/blob/master/dist/videomail-for-ninja-forms.zip)
More documentation on setup and configuration see:
[https://github.com/binarykitchen/videomail-for-ninja-forms/tree/master/doc/faq/videomail-for-ninja-forms-faq.pdf](https://github.com/binarykitchen/videomail-for-ninja-forms/tree/master/doc/faq/videomail-for-ninja-forms-faq.pdf)
== Installation ==
This section describes how to install the plugin and get it working.
1. Upload the `videomail-for-ninja-forms` plugin folder to your `/wp-content/plugins/` directory
2. Activate the plugin through the ‘Plugins’ menu in WordPress
3. Visit the ‘Ninja Forms’ menu item in your admin sidebar
4. Build a form using videomail
Probably you also want to whitelist additional domains besides localhost. See whitelisting under FAQ.
== Frequently Asked Questions ==
= Donations? =
That would be awesome :) Scroll to bottom of https://videomail.io/faq
= Where is the documentation? =
Check out that pretty online PDF at [https://github.com/binarykitchen/videomail-for-ninja-forms/blob/master/doc/faq/videomail-for-ninja-forms-faq.pdf](https://github.com/binarykitchen/videomail-for-ninja-forms/blob/master/doc/faq/videomail-for-ninja-forms-faq.pdf)
= What options are there? =
That new recordable video field comes with many options you can configure yourself such as duration, width, audio on/off and much more.
Each option is explained well at bottom of this PDF file: [Videomail FAQ](https://github.com/binarykitchen/videomail-for-ninja-forms/tree/master/doc/faq/videomail-for-ninja-forms-faq.pdf)
= How does whitelisting work? =
For local development, everything will work right away because the localhost URL is already whitelisted on the videomail server.
But once you deploy your Wordpress site out in the wild, we will have to whitelist your production URL. For that, just submit a [Whitelist Request](https://videomail.io/whitelist). Very easy.
= Is there a live example? =
There is also the live site [videomail.io](https://videomail.io). Have a look and play.
You can see the videomail-client in action and use it right away for free, anytime, anywhere. Many people, especially Deafs and Sign Language users, already use it for their everyday communication.
= Can I use videomail outside of WordPress? =
Yes. There is a low level npm [videomail-client](https://github.com/binarykitchen/videomail-client) package. This WordPress plugin relies on it.
= Where is the support? =
To get help, just use any of these contacts at [https://binarykitchen.com](https://binarykitchen.com)
== Screenshots ==
1. There will be a new Ninja Form Fields in the common section called Videomail.
2. Once you have assembled a form and preview it, any browser will ask for webcam access first.
== Changelog ==
= 5.1.0 (24 Feb 2024) =
*Improvement:*
* New option: "load_user_media_on_record". When enabled, webcam permission are only being asked for when user hits record button
= 5.0.2 (21 Nov 2023) =
*Change:*
* Upgrade deployment tools
= 5.0.1 (21 Nov 2023) =
*Bugs:*
* Fix deployment issues
= 5.0.0 (19 Nov 2023) =
*Change:*
* Internal technical improvements for releasing new versions
* Internal technical change: Bump to NodeJS v20 and npm v9
= 4.0.16 (14 Jul 2023) =
*Bugs:*
* Fix versioning
= 4.0.15 (14 Jul 2023) =
*Bugs:*
* Fix versioning
= 4.0.14 (14 Jul 2023) =
*Bugs:*
* Fix versioning
= 4.0.13 (14 Jul 2023) =
*Bugs:*
* Fix boolean check for media library addition
= 4.0.12 (12 Jul 2023) =
*Bugs:*
* Fix a releasing issue
= 4.0.11 (12 Jul 2023) =
*Bugs:*
* Do not save to media library when disabled
*Change:*
* Deliver unminified JS for easier debugging
= 4.0.10 (29 June 2023) =
*Bugs:*
* Repair broken bash comment
= 4.0.9 (29 June 2023) =
*Bugs:*
* Repair broken repo syncing
= 4.0.8 (29 June 2023) =
*Bugs:*
* Repair broken versioning
= 4.0.6 (29 June 2023) =
*Bugs:*
* Bump videomail-client which resolves a bug when webcam permissions are missing.
= 4.0.5 (29 May 2023) =
*Change:*
* Rebuild lockfile
= 4.0.4 (29 May 2023) =
*Change:*
* Include target folder
= 4.0.3 (29 May 2023) =
*Change:*
* Internal technical improvements for versioning
= 4.0.2 (29 May 2023) =
*Change:*
* Internal technical improvements for development
= 4.0.1 (29 May 2023) =
*Change:*
* Upgrade Videomail-Client
*Improvement:*
* Prefer serving MP4 over WebM movies (better coverage, especially on mobiles)
= 4.0.0 (31 Dec 2022) =
*Change:*
* Bump all dependencies and rebuild with NodeJS v18
= 3.13.1 (23 Sep 2022) =
*Improvement:*
* Better detection of supported video types
= 3.13.0 (22 Sep 2022) =
*Bugs:*
* Fixes broken video type detection
= 3.12.0 (3 Sep 2022) =
*Improvements:*
* Audio and Video 99.9% in sync now
*Tasks:*
* Upgrade all inside dependencies without breaking changes.
= 3.11.2 (11 Jun 2022) =
*Tasks:*
* Tested everything on latest WordPress v6.0.0 and works well
*Change:*
* Upgraded all internal libraries, especially Videomail-Client on npm (they come with lots of stability fixes)
= 3.11.1 (28 Aug 2021) =
*Change:*
* Just a maintenance bump using latest Videomail-Client
* Better treatment of undefined form inputs
= 3.11.0 (19 Jul 2021) =
*Change:*
* Switch to node.js v16 and npm v7.18
* Runs security audit toward all dependencies
= 3.10.4 (12 Jul 2021) =
*Change:*
* Countdown and pause texts are bolder now
= 3.10.3 (29 Jan 2021) =
*Bugs:*
* Another workaround for more global pollution situations
= 3.10.2 (29 Jan 2021) =
*Bugs:*
* Works for older Backbone versions too or when other plugins pollute its global scope.
= 3.10.1 (5 Dec 2020) =
*Change:*
* Bump min required and tested versions
= 3.10.0 (5 Dec 2020) =
*Bugs:*
* Make it work along with the Conditional Logic add-on
* Required attribute works again with latest WP and Ninja Form versions
*Change:*
* Upgrades Videomail dependency
= 3.9.8 (20 Oct 2020) =
*Bugs:*
* Fixed wrong FPS calculation. Now overall quality of encoded videos won’t be impacted when connectivity deteriorates toward the end.
*Change:*
* Upgrades Videomail dependency
= 3.9.7 (9 Sept 2020) =
*Improvements:*
* Better release procedure
* Consistent source code
= 3.9.6 (16 Jun 2020) =
*Change:*
* Upgrades Videomail dependency
= 3.9.5 (16 Jun 2020) =
*Bugs:*
* Flip video feed horizontally to match with reality (all webcams are inverted by default)
= 3.9.4 (13 Mar 2020) =
*Bugs:*
* Ping more often to keep connection alive
* Also submit disabled form inputs
= 3.9.3 (7 Nov 2019) =
*Bugs:*
* Do not enable audio when already false
= 3.9.2 (7 Nov 2019) =
*Bugs:*
* Repaired merging fields into strings
= 3.8.1 (7 Nov 2019) =
*Bugs:*
* Repair readme.txt
= 3.8.0 (6 Nov 2019) =
*Change:*
Lots improved under the hood, updated many libraries for speed and security.
*Bugs:*
* Works again on IE11
= 3.7.4 (3 Sep 2019) =
*Bugs:*
* Fix invalid URLs for Windows machines
= 3.7.3 (27 Aug 2019) =
*Bugs:*
* Correct error message when on insecure HTTP with recommendation to switch to HTTPS
* Works again on older iPhones
*Change:*
* Replaced lots of old code with modern code.
= 3.7.2 (8 May 2019) =
*Change:*
* Better readystate handling for faster page loads
* Improved error messages for iOS on Chrome
* Faster websocket streams
= 3.7.1 (14 Jan 2019) =
*Change:*
* Audio now enabled by default
* Improved documentation
*Bugs:*
* More robust with exotic browsers
* Correct bad spelling
= 3.6.0 (17 March 2018) =
*Change:*
* Moved to a new, public repository and free now
= 3.5.0 (17 February 2018) =
*Features:*
* New option: save to media library - so that you can reuse the video for posts or pages yay!
* New option: image quality - with this you can improve video in cost of bandwidth
*Bugs:*
* Much better error handling
= 3.4.3 (21 December 2017) =
*Bugs:*
* Now it does not mess with other rich content text editors anymore.
= 3.4.2 (12 December 2017) =
*Bugs:*
* Added missing licensing field under settings
= 3.4.0 (12 October 2017) =
*Features:*
* Now works on iPhones running on iOS11 and on Safari v11, yay.
*Bugs:*
* Now works as an optional input (= not as a required field)
= 3.3.3 (9 September 2017) =
*Bugs:*
* Make it work again on all Edge browsers
= 3.3.2 (27 July 2017) =
*Bugs:*
* Do not zip extension in another zip.
*Changes:*
* Bump videomail-client using ES6 code
* Improved error messages
= 3.3.1 (12 July 2017) =
*Initial Release*