/
README.txt
executable file
·384 lines (275 loc) · 19 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
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
=== Instant Images - One Click Image Uploads from Unsplash, Openverse, Pixabay and Pexels ===
Contributors: dcooney, connekthq
Donate link: <https://connekthq.com/donate/>
Tags: Unsplash, Openverse, Pixabay, Pexels, Stock Photos, media library, prototyping, photos, stock photo, image upload, upload, free photos
Requires at least: 5.0
Tested up to: 6.5
Stable tag: 6.1.2
License: GPLv2 or later
License URI: <http://www.gnu.org/licenses/gpl-2.0.html>
One click image uploads from Unsplash, Openverse, Pixabay, & Pexels directly to your WordPress media library.
== Description ==
Instantly upload photos from Unsplash, Openverse, Pixabay or Pexels to your website all without ever leaving WordPress!
**Instant Images** is the fastest and easiest way to upload high quality **FREE** photos from your favorite stock photo communities directly to your WordPress media library.
= Supported Image Providers =
- [Unsplash](http://unsplash.com)
- [Openverse](https://wordpress.org/openverse/)
- [Pixabay](http://pixabay.com)
- [Pexels](http://pexels.com)
[youtube <https://www.youtube.com/watch?v=s6Q7Kfi2f1c>]
The perfect tool for users who want to save time and frustration by uploading images directly inside their WordPress installation and for developers who want to prototype and develop using real world imagery.
**[Visit Plugin Website](https://getinstantimages.com)**
= Features =
- **Image Search** - The Instant Images search let’s you quickly find and upload images for any subject in a matter of seconds!
- **Image Orientation** - Filter search results by landscape, portrait or square images.
- **Time Saver** - Quickly upload amazing stock photos without leaving the comfort of your WordPress admin.
- **Theme/Plugin Developers** - A great tool for developers who want to prototype and develop using real world imagery.
- **Gutenberg** - Instant Images directly integrates with Gutenberg as a plugin sidebar.
- **Media Modal** - Instant Images is available as a tab in the WordPress Media Modal.
- **Page Builders** - Instant Images integrates with page builders such as Elementor, Beaver Builder, Brizy and Divi.
- **Edit Image Metadata** - Easily edit image filename, alt text and caption prior to uploading to your media library.
- **Accessibility** - Automatically include a relevant alt description for screen readers, visually reduced users, and SEO.
- **Easy to Use** - It couldn't get much more simple, just click an image and it's automatically uploaded to your media library for use on your site.
- **No Accounts Needed** - An account on any service provider is not required for use of this plugin. Just activate and you're ready to go.
= Add-ons =
== Instant Images: Extended ==
Enhance the Instant Images experience with a suite of premium features and added functionality.
**What's Included:**
- Instant Images Gutenberg Block
- WordPress CLI Imports
- Batch Image Imports
- Images Filters (Instagram)
- Search History & Suggestions
- And more...
[Learn More](https://getinstantimages.com/add-ons/extended/)
= Proxy Server =
Instant Images routes all API requests to service providers (Unsplash, Pexels, Pixabay, Openverse etc.) through our custom proxy server at [proxy.getinstantimages.com](https://proxy.getinstantimages.com).
Maintaining a proxy server for Instant Images allows us to keep API keys hidden from public view and ensures image data returned from the providers is returned in a normalized format for display in WordPress.
Please take a moment and read our Terms of Use and Privacy Policy for when using our proxy service:
- [Terms of Use](https://getinstantimages.com/terms-of-use/)
- [Privacy Policy](https://getinstantimages.com/privacy-policy/)
---
= How Can You Contribute? =
Pull requests can be submitted via [GitHub](https://github.com/dcooney/instant-images).
---
= Website =
[https://getinstantimages.com](https://getinstantimages.com)
---
== Frequently Asked Questions ==
= Can I legally use these photos on my website? =
All photos published on Unsplash are licensed under Creative Commons Zero which means you can copy, modify, distribute and use the photos for free, including commercial purposes, without asking permission from or providing attribution to the photographer or Unsplash/Pixabay.
[Learn More](http://creativecommons.org/publicdomain/zero/1.0/)
[Continue Reading](https://getinstantimages.com/frequently-asked-questions/#can-i-legally-use-these-photos-on-my-website)
= Can I search for individual photos by ID? =
Yes! You can enter `id:{photo_id}` into the search box to return a single result.
e.g. `id:YiUi00uqKk8`
= I'm unable to download images, what is the cause of this? =
Unfortunately, there are a number of reasons why Instant Images may not work in your current hosting/server environment. Please read through the [FAQ on our website](https://getinstantimages.com/frequently-asked-questions/) to view some potential causes.
= Can I update the filename or metadata prior to upload? =
Yes, click the `options` (cog) icon in the bottom corner of the image to bring up an edit screen where you can modify the filename, title, alt and caption before the image is uploaded.
= Are the images upload to the Media Library? =
Yes, once clicked, the images are processed on the server then uploaded to the Media Library into the various sizes set in your theme.
= Are raw uploads stored on the server? =
No, once an image has be uploaded and resized the raw download will be removed from your server.
= Are there server requirements? =
Yes, this plugin is required to write temporary images into an `/instant-images` directory within your WordPress `uploads` directory for image processing prior to being uploaded to the media library.
Some hosts lock down their servers and you may be required to update your php.ini or .htaccess in order to use this plugin.
= Do I need an account at Unsplash? =
No, there is no need to sign up from an Unsplash account to access the photos server via Instant Images.
= Do I need an account at Pixabay? =
No, we provide an API for you to use, however you can get your own by signing up for a free account at [Pixabay](https://pixabay.com/).
= Do I need an account at Pexels? =
No, we provide an API for you to use, however you can get your own by signing up for a free account at [Pexels](https://pexels.com/).
= Do I need an account at Openverse? =
No, an Openverse account is not required.
== Installation ==
How to install Instant Images.
= Using The WordPress Dashboard =
1. Navigate to the 'Add New' in the plugins dashboard
2. Search for 'Instant Images'
3. Click 'Install Now'
4. Activate the plugin on the Plugin dashboard
= Uploading in WordPress Dashboard =
1. Navigate to the 'Add New' in the plugins dashboard
2. Navigate to the 'Upload' area
3. Select `instant-images.zip` from your computer
4. Click 'Install Now'
5. Activate the plugin in the Plugin dashboard
= Using FTP =
1. Download `instant-images.zip`
2. Extract the `instant-images` directory to your computer
3. Upload the `instant-images` directory to the `/wp-content/plugins/` directory
4. Activate the plugin in the Plugin dashboard
== Screenshots ==
1. Dashboard - Browse, search and upload images to your WordPress media library
2. Search - Find and upload images for any subject in a matter of seconds!
3. Image Metadata - Easily edit image filename, alt text and caption prior to uploading to your media library.
4. Gutenberg post edit screens. Add as featured image, insert into post or just upload photo.
5. Instant Images is available in the WordPress media modal as a custom tab. It is available in front end page builder like Elementor, Beaver Builder and Divi.
== Changelog ==
= 6.1.2 - April 15, 2024 =
* FIX: Fixed issue with Openverse search not working due to plugin error.
* UPDATE: WordPress 6.5 compatibility updates.
= 6.1.1 - January 25, 2024 =
* FIX: Various security patches.
* FIX: Fixed issue with permissions for accessing Instant Images settings.
= 6.1.0 - November 13, 2023 =
* NEW: Adding localization for all image provider filters.
* FIX: Fixed issue with CSS classname conflict with other plugins.
* FIX: Fixed issue with search results saying `0 Results found` when there were results.
* UPDATE: Various UI/UX updates throughout the app.
= 6.0.1 - November 8, 2023 =
* FIX: Fixed issue with `admin_footer_text` hook incorrectly echoing data in the WP admin.
* UPDATE: Various code, UX and UI updates throughout the app.
* UPDATE: Updates `Requires at least` version to 5.0 as plugin relies on Gutenberg editor scripts.
* NEW: Added hook for modifying the image attribution text.
```
add_filter( 'instant_images_attribution', function() {
return __( 'This <a href="{image_url}">photo</a> is by <a href="{user_url}">{username}</a> and available for free on <a href="{provider_url}">{provider}</a>', 'framework' );
} );
```
= 6.0.0 - June 19, 2023 =
* NEW: Added support and functionality requirements for [Instant Images: Extended add-on](https://getinstantimages.com/add-ons/extended/).
* UPDATE: Improved infinite scroll loading and animations.
* UPDATE: Improved error handling for API keys with session data.
* UPDATE: UX and UI updates throughout the app.
* UPDATE: Code cleanup and various refactoring.
* UPDATE: Various accessibility updates throughout the app.
* FIX: Fixed issue with Instant Images header CSS conflicting with GeneratePress.
= 5.3.1 - May 12, 2023 =
* UPDATE: Updated default user role to manage_options on the Instant Images settings page.
* NEW: Added new instant_images_settings_user_role hook to adjust the user role for the Instant Images settings page.
* FIX: Adding fix for error on Site Editor screen when using a FSE theme.
= 5.3.0 - May 8, 2023 =
* NEW: Added new standalone Instant Images settings page and added new settings fields.
* NEW: Added initial support for upcoming Instant Images Pro plugin.
* FIX: Fixed issue with missing `createRoot` function in WP < 6.2 that would cause Instant Images to fail to load.
* UPDATE: General styling and UI updates throughout app.
= 5.2.1 - April 20, 2023 =
* UPDATE: Adds sessionStorage for storing API results in browser session to reduce proxy usage and API requests. Session data is stored for 1 hour.
* UPDATE: Cleans up Openverse sources to include WordPress, Flickr, Nasa, SpaceX and Wikimedia only.
* UPDATE: Updates security check to match on expected URLs before an upload is processed.
* FIX: Removes StockSnap from Openverse as images are being blocked on upload to the media library.
* UPDATE: Various code cleanup and tweaks.
= 5.2.0.2 - March 28, 2023 =
* HOTFIX: Fix for fatal compatibility error with Elementor Pro.
= 5.2.0.1 - March 20, 2023 =
* HOTFIX: Quick fix for potential fatal error on the frontend for Beaver Builder users. Fixed by wrapping function check in `is_admin()`.
= 5.2.0 - March 20, 2023 =
* NEW: Added new setting to automatically add image attribution as captions.
* NEW: Adding mime type checking based on current allowed uploads.
* UPDATE: Updated `instant_images_after_upload` hook to pass additional image data.
* UPDATE: Added sizes filter to openverse search.
* UPDATE: Added Wikimedia filter to openverse sources.
* UPDATE: Code refactoring and build process updates.
= 5.1.0.2 - March 8, 2023 =
* HOTFIX: Security fix to prevent SSRF/misuse of download functionality.
= 5.1.0.1 - February 2, 2023 =
* HOTFIX: Fixed issue with mime type check not always working correctly. Reverted change for now.
* UPDATE: Pexels is using the Proxy server again after fixing the caching issues.
= 5.1.0 - February 2, 2023 =
* NEW: Added Openverse support.
* NEW: Added Description field to save data into the Post Content WP field.
* NEW: Added mime type checker to make sure the file type is allowed before uploading.
* UPDATE: Better attribution handling.
* UPDATE: Various admin UI/UX tweaks and updated.
= 5.0.1 - January 10, 2023 =
* HOTFIX: Adding a temporary hotfix to patch issues with the Pexels API and the Instant Images Proxy server.
Note: This fix is still not perfect but the integration is working again when a valid API is present.
= 5.0 - December 19, 2022 =
* NEW: All API requests to Unsplash, Pexels and Pixabay are now routed through our custom proxy server (proxy.getinstantimages.com). Read our terms of service and privacy policy for more information.
* UPDATE: Improved error handling and reporting.
* UPDATE: Removal of hard coded API Keys from plugin.
* UPDATE: Fixed issue where search filters wouldn't reset after a new search.
= 4.6.3 - November 04, 2022 =
* UPDATE: Improved load handling of default provider.
* FIX: Security fix for issue for authenticated users.
* FIX: Fixed issue default Pexels API key.
* FIX: Fixed issue with photo attribution text and localization.
= 4.6.2 - June 24, 2022 =
* UPDATE: Updated all packages for security updates.
* FIX: Fixed issue with Unsplash API variable declaration.
= 4.6.1 - January 14, 2022 =
* NEW: Added default API keys for all API providers 🎉 . Default API keys can still be overwritten in the plugin settings shouls you want to use your own key.
* NEW: Added rate-limit checker to determine the status of the API and display an alert warning if the limit has been exceeded.
= 4.6.0.1 - January 3, 2022 =
* HOTFIX: Hotfix for accidentaly `delete_options` function left in whilst testing. Sorry about that!
= 4.6.0 - January 2, 2022 =
* NEW: Added Pexels integration. This requires a valid API key.
* FIX: Fixed issue with filtering Unsplash search results by 'all'.
* FIX: Various admin UI/UX updates and tweaks to improve the look and feel.
= 4.5.1 - December 27, 2021 =
* NEW: Added Pixabay photo filters (Type, Category, Colors and Orientation).
* NEW: Added Unsplash search filters for Color, Orientation and Order.
* NEW: Added new `instant_images_pixabay_safesearch` & `instant_images_unsplash_content_filter` filters that allow for modifying the flags the indicate the types of suitable images that should be returned. Get more information in our [FAQ](https://getinstantimages.com/frequently-asked-questions/#can-i-ensure-only-photos-safe-for-work-are-returned-in-the-photo-listings).
* NEW: Added Pixabay API constant that allows for setting Pixabay API key via site constant. e.g. `define( 'INSTANT_IMAGES_PIXABAY_KEY', 'YOUR-KEY-HERE' );`
* UPDATE: Revamped filtering menus and orientation options.
* UPDATE: Other UI/UX updates to make the plugin more visually appealing.
* UPDATE: Improved plugin accessibility across various sections.
= 4.5.0 - October 28, 2021 =
* NEW: 🎉 Pixabay! We've added support for [Pixabay](https://pixabay.com) images. This requires a valid API key.
* NEW: Added button to auto-generate Photo attribution in image caption.
* NEW: Added uninstaller script to remove plugin settings.
* UPDATE: Updated styling and functionality of photo detail editor.
* UPDATE: Various UI/UX updates.
= 4.4.0.3 - July 30, 2021 =
- Fix: WP 5.8 issue resolved - added fix for Instant Images causing the Widget Block Editor to fail due to JS error.
- Update: Code clean up.
= 4.4.0.2 - June 7, 2021 =
- Fix: Added fix for CSS conflict causing issues in the WordPress menus section.
- Fix: Removed browser console error with regards `activeFrame.querySelector is not a function` that could appear when creating a gallery.
- Updated: Improved coding standard and overall code quality.
= 4.4.0.1 - May 3, 2021 =
- UPDATE - Updated Instant Images settings page to sanitize inputs before saving.
= 4.4.0 - March 26, 2021 =
- UPDATE - 🎉 Massive improvement to image download speeds by [dynamically resizing](https://unsplash.com/documentation#dynamically-resizable-images) the initial download before sending image to media library.
- Intitial testing revealed up to 4x faster download speeds than previous version of Instant Images 🤯.
- NEW - Added `instant_images_after_upload` hook that is dispatch after a successful upload allowing users to hook into the attachment and run custom functionality.
- UPDATE - Upgraded Axios JS libray to `0.21.1`.
= 4.3.5 - August 14, 2020 =
- FIX - Fixed issue with WP 5.5 and REST API warning messages when `WP_DEBUG` is `true`.
- FIX - Fixed issue with undefined `$suffix` variable when `WP_DEBUG` is `true`.
= 4.3.4 - August 11, 2020 =
- FIX - Fixed issue with Yoast SEO meta boxes not appearing in Classic Editor.
- UPDATE - Code cleanup and some refactoring of media enqueue scripts.
= 4.3.3 - August 10, 2020 =
- NEW - Adding Instant Images tab to Media Modal windows everywhere, including page builders and taxonomy terms pages.
- NEW - Added new plugin setting to hide the Instant Images tab in the Media Modals
= 4.3.2 - May 28, 2020 =
- UPDATE - Switched REST API methods to `POST` requests from `PUT`. This will hopefully reduce issues users are having with `PUT` being disabled on their servers.
- UPDATE - Added Instant Images media button back to Classic Editor post screen.
= 4.3.1 - April 13, 2020 =
- FIX - Fixed issue with Instant Images causing Yoast SEO metabox to not show correctly in the classic WordPress editor. Not really sure why, but the Instant Images JS dependencies seemed to interfere with Yoast.
- FIX - Added user privileges checks to the new Media Modal functionality.
= 4.3.0 - April 9, 2020 =
- NEW - Adding `Instant Images` tab to the WordPress Media Modal.
- NEW - When images are uploaded directly to a post the current Post ID is attached to the upload as the parent post.
- NEW - Adding default alt text directly from Unsplash API.
- UPDATE - Updated image uploader API to _hopefully_ improve stability of the upload and resize process. The new process uses core WordPress functions for the upload.
- UPDATE - Switching tab navigation from `<a/> to`<button/>` for better accessibility.
- FIX - Added a fix for JS error regarding `PluginSidebar` registration on non-gutenberg editor pages.
= 4.2.0 - December 14, 2019 =
- NEW - Added image orientation search filter
- FIX - Fixed issue with instant images being rendered in Gutenberg editor for users without permissions.
- UPDATE - Updated WordPress role requirement from `edit_theme_options` to [`upload_files`](https://wordpress.org/support/article/roles-and-capabilities/#upload_files).
= 4.1.0 - July 23, 2019 =
- NEW - Added support for updating image title prior to upload.
- NEW - Added link to edit image after upload process completes.
- UPDATE - Updated functionality to trigger photo upload immediately after triggering a `Save` when editing image metadata.
= 4.0.1 - April 18, 2019 =
- FIX - Fixed issue where Instant Images sidebar plugin would not appear in Gutenberg if removed as a pinned item.
= 4.0.0 - February 12, 2019 =
- 4.0 adds Gutenberg support. You can now access instant images directly from inside the block editor.
- NEW - Added Instant Images to Gutenberg as a Plugin Sidebar.
- NEW - Added Gutenberg featured image support.
- NEW - Added Gutenberg Create Image Block support.
- UPDATE - Improved a11y (accessibility) of photo listing items.
- UPDATE - Updated REST API methods to prefix function names.
- UPDATE - Various other UI/UX enhancements.
= 3.0 - September 21, 2017 =
** NEW - Instant Images has been completely re-built using React and the WordPress REST API.
= 2.0 - January 12, 2017 =
- Initial Commit
- Updating plugin from UnsplashWP to Instant Images
== Upgrade Notice ==
- This is an upgrade from UnsplashWP