forked from Interfacelab/ilab-media-tools
-
Notifications
You must be signed in to change notification settings - Fork 0
/
readme.txt
295 lines (229 loc) · 15.2 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
=== Media Cloud ===
Contributors: interfacelab
Tags: uploads, amazon, s3, imgix, minio, google cloud storage, digital ocean spaces, backblaze, wasabi, media, cdn, rekognition, cloudfront, images, crop, image editing, image editor, media library, offload, offload s3
Requires at least: 4.4
Tested up to: 4.8.2
License: GPLv3 or later
Donate link: http://www2.jdrf.org/site/TR?fr_id=6912&pg=personal&px=11429802
License URI: http://www.gnu.org/licenses/gpl-3.0.html
Stable tag: 2.1.0
Requires PHP: 5.6
Automatically upload media to Amazon S3 and integrate with Imgix, a real-time image processing CDN. Boosts site performance and simplifies workflows.
== Description ==
Media Cloud by ILAB is a suite of tools designed to enhance media handling in WordPress in a number of ways.
**NOTE**: This plugin requires PHP 5.6x or higher (PHP 7.x preferred)
= Upload to S3, Minio, Google Cloud Storage, Wasabi and Digital Ocean Spaces =
Automatically copy media uploads to the cloud and serve them directly from your cloud storage provider, CloudFront or any other CDN. Additionally, easily import your existing media library with the push of a button.
= Integrate with Imgix =
[Imgix](https://imgix.com) will radically change the way that you build your WordPress sites and themes. This plugin is the best integration available for WordPress. Upload your images to S3 with our S3 tool and then host the media with Imgix, providing you with real-time image processing and automatic format delivery. Forget ImageMagick, Imgix is light years ahead in quality and speed.
= Native support for Google Cloud Storage =
Now supports using Google Cloud Storage for uploads without having to use Google's S3 compatible interop mode. Supports direct uploads too.
= Native Support For Backblaze B2 Cloud Storage =
Now supports using Backblaze's new B2 Cloud Storage for uploads.
= Upload Directly To S3, Minio, Wasabi and Google Cloud Storage =
Directly upload your media and documents to the cloud, bypassing your WordPress server completely. This feature requires Imgix.
= Automatically Tag and Categorize with Amazon Rekognition =
Use Amazon's latest AI tools to tag and categorize your images when uploading to Amazon S3. With Rekognition, you can automatically detect objects, scenes, and faces in images.
= Advanced Image Editing =
When integrating with [Imgix](https://imgix.com), Media Cloud by ILAB provides the most advanced WordPress image editor. Alter contrast, saturation, vibrancy and over 30 other image editing operations - in real time right inside the WordPress admin interface! Completely non-destructive!
= Image Cropping =
Media Cloud by ILAB ships with the most advanced image cropping tool available for WordPress, based on Chen Fengyuan's amazing Cropper plugin for jQuery.
= WP-CLI Support =
Import your media library to the cloud, regenerate thumbnails and process your library with Amazon Rekognition using WP-CLI commands.
**Best of all you get this functionality for free.**
* Upload to any of a variety of cloud storage providers (Amazon S3, Google Cloud Storage, Minio, Wasabi, Backblaze, DigitalOcean Spaces or any other S3 compatible service)
* Host your media directly from your cloud storage provider or specify a CDN
* Integrate with Imgix media hosting
* Direct uploads to the cloud, bypassing WordPress completely (Requires Imgix)
* Use Amazon Rekognition to automatically tag and categorize images
* Use third party cloud file providers that use S3 compatible APIs
* Advanced image cropping tool
* Advanced image editing with saturation, contrast, auto-correct,
sharpen, blur and more (only when integrated with Imgix)
For more info (grab popcorn, it's kind of long!):
https://www.youtube.com/watch?v=rOmziu30nPI
== Installation ==
1. Upload the plugin files to the `/wp-content/plugins/ilab-media-tools` directory, or install the plugin through the WordPress plugins screen directly.
2. Activate the plugin through the 'Plugins' screen in WordPress
3. For Cloud Storage, enter your credentials in the *Media Cloud -> Storage Settings* page.
4. For Imgix, enter your Imgix settings in the *Media Cloud -> Imgix Settings* page.
5. Enable the tools you want through the *Media Cloud -> Tools* settings page.
6. Once your settings are complete, use the *Media Cloud -> Storage Importer* to import your current media library to
Amazon S3 or whatever storage service you are using.
== Frequently Asked Questions ==
= How does this compare to WP Offload S3? =
This essentially does everything that WP Offload S3 does but is free. It includes an import function for importing your current library to S3 that only the pro version of WP Offload S3 has. Otherwise, they work almost exactly the same.
= Why should I use Imgix? =
One of the headaches of managing a WordPress site is dealing with server disk space. If you just use the S3 functionality of this plugin, you are already one step ahead. Using S3, all of your media is centrally located in one place that you can then distribute through a high performing content delivery network to improve page load speeds for your site. You also don't have to worry about disk space on your servers anymore.
Imgix is a content delivery network with a twist. In addition to distributing your media, it also allows you to edit them, in real-time. and deliver the edited version through their CDN without altering the original. Want to add a new image size to your theme? You can do this with Imgix without having to use a plugin to recut all of your existing media to this new size. Imgix optimizes format delivery and a bunch of other things. It's seriously the greatest thing to happen to WordPress and web development in the history of ever.
= Are you a paid shill for Imgix? =
No, I'm just one very enthusiastic customer.
== Screenshots ==
1. Easy image cropping for all croppable image sizes defined in your theme.
2. Make adjustments to your images like saturation, vibrancy, contrast when using Imgix.
3. Stylize your images easily when using Imgix.
3. Watermarking is easy and non-destructive, change the watermark at any time and all watermarked images will automatically update.
4. Amazon S3 settings.
6. Imgix settings.
== Changelog ==
= 2.1.0 =
* Added support for Wasabi (https://wasabi.com) storage service
* Direct uploads via Wasabi (requires Imgix)
* Fix for direct uploads failing
* Fix for CSS issues on settings pages
= 2.0.9 =
* Added support for detecting faces using Imgix's API. You can enable this setting in the Imgix settings. With the detected faces, you can use those in the `Focus Crop` settings of the image editor. **Note** that Rekognition does a vastly superior job in detecting faces (sorry Imgix) and I would urge you to use that instead. But if you aren't using Amazon S3 for storage, you'll have to use the Imgix face detection if you want to use the Focus Crop feature.
* Added support for Imgix's Entropy and Edges cropping modes (https://docs.imgix.com/apis/url/size/crop). You can access these in the image editor.
= 2.0.8 =
* Added support for Imgix's Focal Point Cropping (read about it here: https://docs.imgix.com/apis/url/size/crop). Right now it only supports focal cropping to a point, however it can use faces that have been detected with the Amazon Rekognition feature of the plugin. Yes, I know, Imgix has this feature using their face detection and I will add it in the future!
* To use the new Focal Point Cropping, click on `Edit Image` in attachment details to open up the Imgix Image Editor. Click on the "Focus Crop" tab and go to town.
= 2.0.7 =
* Added WP-CLI support
* Added WP-CLI command `wp mediacloud import` to import the media library to cloud storage from the command line.
* Added WP-CLI command `wp mediacloud regenerate` to rebuild thumbnails for cloud storage from the command line.
* Added WP-CLI command `wp rekognition process` to run the media library through Amazon Rekognition from the command line.
= 2.0.6 =
* Fix for PHP 5.6. Was using a couple of PHP 7.x features.
* Slimmed down the size of the plugin.
= 2.0.5 =
* Fix for uploading non-image files. This bug was introduced in 2.0.3. If you've uploaded non-image files since then, you'll need to re-upload them. Sorry!
* Hovering over the cloud icon when in the media library grid will display storage info about that file
= 2.0.4 =
* Greatly enhanced the Storage Info panel on the attachment details edit page. This now shows you all of the different sizes that have been generated, as well as any that might be missing.
* Added the ability to rebuild thumbnails. If you are using Imgix, this is unnecessary. If you aren't using Imgix, you should be using Imgix. You're never going to do better than Imgix. Relying on WordPress to resize your images and then serve those images from a CDN tied to your cloud storage is a better choice than just serving everything from WordPress, but you are still inserting management tasks into your workflow that Imgix alleviates entirely. Seriously, check it out. If you still want to persist with this madness, then this new thumbnail regeneration feature is built just for you. Enjoy.
* Added "Regenerate Thumbnails" bulk action to WordPress's media library list view. Use Imgix and you'll never have to worry about this stuff ever again.
= 2.0.3 =
* Fix for bug when deleting from remote storage
* Fix for CDN URL not being applied
* Documentation fix
* Settings clean up
= 2.0.2 =
* Fix for srcset not being generated on WordPress generated image tags. Note that this will only fix future uploads, not existing uploads.
= 2.0.1 =
* Major refactoring of the code base
* Storage services are now "pluggable", meaning new ones can be added that aren't S3 compatible
* Added native Google Cloud Storage support
* Direct uploads to Google Cloud Storage
* Added native Backblaze B2 support
* Improved support for other S3 compatible services
* Other misc. fixes
= 2.0.0 =
* Major refactoring of the code base
* Storage services are now "pluggable", meaning new ones can be added that aren't S3 compatible
* Added native Google Cloud Storage support
* Direct uploads to Google Cloud Storage
* Added native Backblaze B2 support
* Improved support for other S3 compatible services
* Other misc. fixes
= 1.5.3 =
* Enabled Amazon S3 Transfer Acceleration for even faster uploads. You should enable this ASAP.
* Direct uploads to Minio storage servers now work (still requires Imgix).
* Fix for missing mime_content_type() errors on misconfigured PHP installs
* Added path style endpoint option for S3 compatible endpoints
* Misc. fixes
= 1.5.2 =
* Added Rekognition importer utility for running existing media on S3 through Rekognition
* Added bulk actions for S3 importing and Rekognition processing to the WordPress media library
* Added S3 icon overlay in the media library (grid mode)
* Added S3 column to the media library (list mode)
* Misc. fixes
= 1.5.1 =
* Added support for Amazon Rekognition for auto tagging and categorizing uploaded images
* Added debug for support tickets
* Misc. fixes
= 1.5.0 =
* Upload media directly to S3, bypassing WordPress. This feature requires Imgix.
* Ability to cancel S3 Importer
* Fixes to S3 importing
* Misc. fixes
= 1.4.9 =
* Compatibility with S3-compatible services like Minio, Google Cloud Storage (when in interoperability mode) and Digital Ocean Spaces. (thanks to Vladimir Pouzanov)
* Fix for S3 Importer on Windows (seriously stop hosting WordPress on Windows)
* Misc. fixes
= 1.4.7 =
* Fixed collision with Types plugin
* Added donation link. If you find this plugin useful, PLEASE donate to my JDRF fund raiser for finding a cure for type 1 diabetes.
= 1.4.6 =
* Added flag to skip bucket checks to avoid rate limiting errors from Amazon on media heavy sites
* Fixed the log spam for the isset offset error
= 1.4.5 =
* Updated AWS SDK to 3.26.5
* Fix for PDF upload bug
* Misc. bug fixes
= 1.4.4 =
* Fix incompatibility with WP Rocket
* Fix for env() bug
= 1.4.3 =
* Improve new user on-boarding
= 1.4.2 =
* Changed plugin name
* Ability to import non-standard image types such as TIFF, Adobe Photoshop, and Adobe Illustrator (requires Imgix)
* Ability to render PDF as images (requires Imgix)
* Turn off auto-upload for non-image types
* Specify specific MIME types to NOT upload to S3
* Improved compatibility with Offload S3
* Added ilab_s3_upload_params filter for the ability to specify custom S3 metadata for each upload
* Ability to define custom ACL for uploads
* S3 info displayed in Attachment Details pop up modal
* S3 metabox added to Attachment edit pages, allowing you to edit the Cache-Control, Expires and ACL for the S3 upload
* Fix for cropping images on S3
* Other bug fixes.
= 1.4.1 =
* Changed plugin name
* Ability to import non-standard image types such as TIFF, Adobe Photoshop, and Adobe Illustrator (requires Imgix)
* Ability to render PDF as images (requires Imgix)
* Turn off auto-upload for non-image types
* Specify specific MIME types to NOT upload to S3
* Improved compatibility with Offload S3
* Added ilab_s3_upload_params filter for the ability to specify custom S3 metadata for each upload
* Ability to define custom ACL for uploads
* S3 info displayed in Attachment Details pop up modal
* S3 metabox added to Attachment edit pages, allowing you to edit the Cache-Control, Expires and ACL for the S3 upload
* Fix for cropping images on S3
* Other bug fixes.
= 1.4 =
* Changed plugin name
* Ability to import non-standard image types such as TIFF, Adobe Photoshop, and Adobe Illustrator (requires Imgix)
* Ability to render PDF as images (requires Imgix)
* Turn off auto-upload for non-image types
* Specify specific MIME types to NOT upload to S3
* Improved compatibility with Offload S3
* Added ilab_s3_upload_params filter for the ability to specify custom S3 metadata for each upload
* Ability to define custom ACL for uploads
* S3 info displayed in Attachment Details pop up modal
* S3 metabox added to Attachment edit pages, allowing you to edit the Cache-Control, Expires and ACL for the S3 upload
* Fix for cropping images on S3
* Other bug fixes.
= 1.2.3 =
* Fix for importing non-image files to S3 with the importer tool
= 1.2.2 =
* Ability to specify Cache-Control and Expires metadata for S3 uploads (thanks to metadan)
* Fix for @{versioning} bucket prefix token
= 1.2.1 =
* Fix for admin notice dismissal when used with Bedrock
= 1.2 =
* Fix for imgix admin notice
* Added filter for defining default imgix parameters (thanks to eightam)
* Fix for deleting files from S3 (thanks to Lotykun)
* Support for auto compress (thanks to JulienMelissas)
= 1.1.1 =
* Fix for image sizes disappearing in the insert media dialog.
= 1.1.0 =
* Fixed a bug where SEO Framework and some other plugins were resizing images on the fly, causing an image to be
downloaded to be resized.
* You can now specify a prefix to be prepended to file names when uploaded to S3.
= 1.0.5 =
* Improved compatibility with other plugins that are using the AWS SDK. There should be zero compatibility issues.
* Forward compatibility with Offload S3. Any media uploaded with Offload S3 will continue to work normally when
switching to Media Cloud by ILAB.
* Check to make sure WordPress is being run on 5.5 or better.
= 1.0.4 =
* Updated readme.txt to indicate PHP version
= 1.0.3 =
* Fix for generating Imgix URLs for dynamically sized images.
= 1.0.2 =
* Correct versioning
= 1.0.1 =
* Update readme.txt
= 1.0.0 =
* First release