-
Notifications
You must be signed in to change notification settings - Fork 8
/
readme.txt
332 lines (238 loc) · 9.05 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
327
328
329
330
331
332
=== WP Photo Sphere ===
Contributors: Jeremy Heleine
Tags: Google, Android, Photo Sphere, photos, panoramas, 360-degree, equirectangular
Requires at least: 3.1
Tested up to: 4.8.1
Stable tag: 3.8
License: MIT
License URI: http://opensource.org/licenses/MIT
A filter that displays 360x180 degree panoramas.
== Description ==
WP Photo Sphere is a filter that allows you to display 360x180 degree panoramas. With WP Photo Sphere, your visitors will be able
to navigate through your panoramas without install any plugin.
WP Photo Sphere is based on the JavaScript library [Photo Sphere Viewer](http://jeremyheleine.me/photo-sphere-viewer).
This plugin allows you to display equirectangular panoramas, taken with a classic camera or with Photo Sphere on Android and iOS.
If you want to contact me for any reason, feel free to email me at [email protected] or contact me on:
* Twitter: http://twitter.com/JeremyHeleine
* GitHub: https://github.com/JeremyHeleine
* LinkedIn: https://fr.linkedin.com/pub/j%C3%A9r%C3%A9my-heleine/55/a14/64a
* Google+: https://plus.google.com/+JérémyHeleine
* Facebook: https://www.facebook.com/jeremy.heleine
WP Photo Sphere is available in:
* English,
* French,
* Spanish,
* Portuguese (thanks to [Pedro Mendonça](https://github.com/pedro-mendonca)),
* Turkish (thanks to [Alper Demir](https://www.cesakozmetik.com.tr/)),
* Dutch (thanks to [Gideon van Melle](https://github.com/gvmelle)).
== Installation ==
1. Upload the `wp-photo-sphere` folder to the `/wp-content/plugins/` directory
2. Activate the plugin through the 'Plugins' menu in WordPress
== Frequently Asked Questions ==
= How to add a panorama? =
Use the `Add a panorama` button to upload or choose a panorama to insert into your post.
= Is it possible to read a distant panorama? =
Since version 3.1, it is possible to read a distant panorama located on another website thanks to its URL. To do that, do not
indicate any ID number and use the `url` attribute. Note that this feature does not work with domains that did not enable CORS.
For example: `[sphere url="http://upload.wikimedia.org/wikipedia/commons/a/a4/Cascading_Milky_Way.jpg"]`.
= How to change the title? =
The default title displayed on each WP Photo Sphere link can be changed in the options page. You can also choose to display an
unique title for a specific panorama by using the `title` attribute. Note that the `%title%` tag is also available in this
attribute.
= How to change the dimensions? =
By default, the dimensions are 560 x 315 pixels but you can change that in the options page (in the Settings menu).
You can also choose different dimensions for each panorama using the width and height attributes.
For example: `[sphere 42 width="200" height="400"]` or `[sphere 42 width="50%" height="300"]`.
A maximum width can also be given with the attribute max_width. Its default value can be changed in the options page.
= How to display the navigation bar? =
The navigation bar allows users to zoom, animate the panorama or view it in fullscreen. To display it, just use the `navbar` attribute
with the value `yes`: `[sphere 42 navbar="yes"]`.
You can choose to display it (or not) on all of your panoramas in the options page. If you display it on all of your panoramas and
want to deactivate it on one particular panorama, use the `navbar` attribute with the value `no`.
= Can I change the automatic animation? =
By default, panoramas are automatically animated after 2000 milliseconds, but you can change this with the
anim_after attribute. You can also deactivate the animation with the value -1. For example:
`[sphere 42 anim_after="5000"]` or `[sphere 42 anim_after="-1"]`.
You can set the animation speed with the anim_speed attribute. It accepts six units: revolutions per minute/second
(rpm/rps), degrees per minute/second (dpm/dps) or radians per minute/second (rad per minute/second). The default
speed can be set in the options page.
Example: `[sphere 42 anim_speed="10rpm"]`.
= Is it possible to autoload the panorama? =
Since the version 1.1, you can specify, for each panorama, a special attribute: `autoload`. If you use this attribute,
the panorama will start automatically after the page has loaded. This attribute doesn't require any value, for
example: `[sphere 42 autoload]` or `[sphere 42 width="300" height="150" autoload]`.
= How to change the levels of zoom? =
Minimal and maximal levels of zoom can be personalized in the options page by changing the minimal and maximal fields of view. You can
also use the `min_fov` and `max_fov` attributes.
== Screenshots ==
1. Options page
2. WP Photo Sphere link
3. Panorama
== Changelog ==
= 3.8 =
* New option and attribute (zoom_speed) to control the zoom speed
* New option to control the animation delay
* New units allowed for width, max width and height
* New maximum height option and attribute
= 3.7.1 =
* Portuguese translation updated
= 3.7 =
* New option and attributes to control the sphere quality
* New option and attribute to control the "scroll to zoom" feature
= 3.6.2 =
* Dutch translation updated
= 3.6.1 =
* Portuguese translation updated
= 3.6 =
* New: smooth user movements
* New: FOVs for cropped panoramas
* New: overlay images
= 3.5.1 =
* Portuguese translation updated
= 3.5 =
* New: eyes offset in VR mode (option and attribute)
= 3.4.3 =
* Dutch translation added
= 3.4.2 =
* Portuguese translation added
= 3.4.1 =
* Fixed: XMP data read again
= 3.4 =
* New: Vertical animation control
* New: Longitude restriction possible
* New: Cropped panoramas
* Fixed: Fullscreen on Internet Explorer
= 3.3 =
* Gyroscope support
* Virtual reality support
= 3.2.2 =
* Fixed: multiple panoramas on a single page
= 3.2.1 =
* Portuguese translation updated
= 3.2 =
* New zoom_level, long, lat, tilt_up_max, tilt_down_max attributes
* New autoload, zoom level, longitude, latitude, maximal tilt up and down angles options
* Mobile zoom (pinch to zoom)
* Fullscreen works on Chrome
= 3.1 =
* New url attribute
* New title attribute
* New min_fov and max_fov attributes
* New minimal and maximal FOV options
* The container does not take its maximal height while loading
= 3.0.2 =
* Portuguese translation updated
= 3.0.1 =
* Turkish translation added
= 3.0 =
* Equirectangular panoramas compatibility (not only Photo Sphere)
* Navigation bar
* XMP data attribute (to read them or not)
* Portuguese language available
= 2.4 =
* You can set your own animation speed
= 2.3.1 =
* Bug fixed
= 2.3 =
* Panoramas are now mobile compatible
* Spanish language available
= 2.2 =
* "Add a panorama" button now compatible with the visual editor
= 2.1 =
* Maximum width can be given
* Autoload after 1 second
= 2.0 =
* New library
* New "Add a panorama" button
* New anim_after attribute
* Scipts loaded only if necessary
= 1.1.1 =
* Nothing new, just an error in the readme file
= 1.1 =
* Autoload attribute
= 1.0 =
* First official release
== Upgrade Notice ==
= 3.8 =
* New option and attribute (zoom_speed) to control the zoom speed
* New option to control the animation delay
* New units allowed for width, max width and height
* New maximum height option and attribute
= 3.7.1 =
* Portuguese translation updated
= 3.7 =
* New option and attributes to control the sphere quality
* New option and attribute to control the "scroll to zoom" feature
= 3.6.2 =
* Dutch translation updated
= 3.6.1 =
* Portuguese translation updated
= 3.6 =
* New: smooth user movements
* New: FOVs for cropped panoramas
* New: overlay images
= 3.5.1 =
* Portuguese translation updated
= 3.5 =
* New: eyes offset in VR mode (option and attribute)
= 3.4.3 =
* Dutch translation added
= 3.4.2 =
* Portuguese translation added
= 3.4.1 =
* Fixed: XMP data read again
= 3.4 =
* New: Vertical animation control
* New: Longitude restriction possible
* New: Cropped panoramas
* Fixed: Fullscreen on Internet Explorer
= 3.3 =
* Gyroscope support
* Virtual reality support
= 3.2.2 =
* Fixed: multiple panoramas on a single page
= 3.2.1 =
* Portuguese translation updated
= 3.2 =
* New zoom_level, long, lat, tilt_up_max, tilt_down_max attributes
* New autoload, zoom level, longitude, latitude, maximal tilt up and down angles options
* Mobile zoom (pinch to zoom)
* Fullscreen works on Chrome
= 3.1 =
* New url attribute
* New title attribute
* New min_fov and max_fov attributes
* New minimal and maximal FOV options
* The container does not take its maximal height while loading
= 3.0.2 =
* Portuguese translation updated
= 3.0.1 =
* Turkish translation added
= 3.0 =
* Equirectangular panoramas compatibility (not only Photo Sphere)
* Navigation bar
* XMP data attribute (to read them or not)
* Portuguese language available
= 2.4 =
* You can set your own animation speed
= 2.3.1 =
* Bug fixed
= 2.3 =
* Panoramas are now mobile compatible
* Spanish language available
= 2.2 =
* "Add a panorama" button now compatible with the visual editor
= 2.1 =
* Maximum width can be given
* Autoload after 1 second
= 2.0 =
* New library used: Photo Sphere Viewer
* New "Add a panorama" button
* New anim_after attribute
* Scripts are now loaded only if necessary
= 1.1.1 =
* There was an error in the readme file...
= 1.1 =
* Autoload attribute
= 1.0 =
* First version