-
Notifications
You must be signed in to change notification settings - Fork 1
/
readme.txt
205 lines (154 loc) · 7.39 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
=== External files in media library ===
Contributors: threadi
Tags: external files, media library, media
Requires at least: 6.2
Tested up to: 6.7
Requires PHP: 8.0
License: GPL-2.0-or-later
License URI: https://www.gnu.org/licenses/gpl-2.0.html
Stable tag: 2.0.2
Add external files to your media library to link or embed them in your website. They will be integrated as if they were locally available.
== Description ==
Add one or more files under Media > "Add new media file". You can use the files in all places where the media library is used.
== Mass-Import ==
You can import complete directories from any of the supported TCP protocols. Just enter the directory as path to import and the plugin will import any supported files from it.
== TCP Protocols ==
You can use the following TCP-protocols to import external files in your media library:
* `http://`
* `https://`
* `ftp://`
* `ftps://`
* `sftp://`
* `ssh://`
* `file://`
Some of them require credentials, for http it is optional.
== Checks ==
The plugin checks for you automatically on a regular basis whether the external files you have stored are still available.
== Settings ==
In the settings you can define whether image files are hosted locally in your hosting or externally.
== Repository and documentation ==
You find some documentations [here](https://github.com/threadi/external-files-in-media-library/docs/).
The development repository is on [GitHub](https://github.com/threadi/external-files-in-media-library/).
---
== Installation ==
1. Upload "external-files-in-media-library" to the "/wp-content/plugins/" directory.
2. Activate the plugin through the "Plugins" menu in WordPress.
== Frequently Asked Questions ==
= Can I prevent other WordPress-users from adding external files? =
Yes, you can select under Settings > External files in Media Library which roles gets the ability to add external files.
= Can I also embed password-protected external files? =
Yes, but these files will included locally and not from the external URL.
= Can I embed files from FTP? =
Yes, see [our documentation](https://github.com/threadi/external-files-in-media-library/blob/master/docs/import/ftp.md).
= Can I import complete directories? =
Yes, you can. Just enter the directory to import.
= Can I import from my local server? =
Yes, you can. Simply enter the absolute path with file-protocol, e.g.: `file:///var/www/path/to/file.png` - see also [our documentation](https://github.com/threadi/external-files-in-media-library/blob/master/docs/import/file.md).
= Can I import external product images for WooCommerce? =
Yes, simply enable the setting under Settings > External files in Media Library > WooCommerce. Add your external URLs
for images in the CSV you want to import as it is already possible with WooCommerce. They will be handled as
external files by this plugin. This also allows you to use all protocols supported by the plugin for importing these files.
= Is there a WP CLI command? =
Yes, there are many options on WP CLI, see [our documentation](https://github.com/threadi/external-files-in-media-library/blob/master/docs/cli.md).
== Screenshots ==
1. Field to add external files in Media > Add New Media File.
2. Dialog to add URLs of external files.
== Changelog ==
= 1.0.0 =
* Initial release
= 1.0.1 =
* Updated compatibility-flag for WordPress 6.4
* Compatible with WordPress Coding Standards 3.0
* Fixed error in settings-save-process
* Fixed typo in translations
= 1.0.2 =
* Added hook documentation
* Added hint for hook documentation in settings
* Optimized handling of upload-form if nothing has been added there
* Removed language files from release
= 1.1.0 =
* Added multiple hooks
* Prevent usage of plugin with older PHP than required minimum
* Optimized content type detection
* Optimized attachment title handling with special chars
* Updated compatibility-flag for WordPress 6.4.3
* Updated dependencies
= 1.1.1 =
* Proxy-slug will now also be changed with simple permalinks
* Updated compatibility-flag for WordPress 6.5
* Updated hook documentation
* Fixed support for spaces in URLs
* Fixed typo in examples in hook-documentation
* Fixed possible notice in transient-handler
* Fixed usage of proxy with simple permalinks
= 1.1.2 =
* Fixed possible error during check for current screen
* Fixed usage of URLs with ampersand on AJAX-request
= 1.2.0 =
* New import dialog with progress and extended info about the import
* Show proxy hint on file only if proxy is enabled
* Optimized style for box with infos about external files
* Updated compatibility-flag for WordPress 6.5.2
* Updated dependencies
= 1.2.1 =
* Added support for hook of plugin "Download List Block with Icons" for mark external files with rel-external
* Updated compatibility-flag for WordPress 6.5.3
* Updated dependencies
= 1.2.2 =
* Updated compatibility-flag for WordPress 6.6
* Updated dependencies
* Fixed potential error on attachment pages
= 1.2.3 =
* Updated dependencies
= 1.3.0 =
* Added possibility to switch the hosting of images during local and extern on media edit page
* Added new column for marker of external files in media table
* Compatibility with plugin Prevent Direct Access: hide options for external fields
* Fixed some typos
* Fixed wrong proxied URL after successful import of images
= 2.0.0 =
* Revamped plugin
* Added queue for importing large amount of URLs
* Added support for import of directories with multiple files
* Added support for different tcp-protocols
* Added support for FTP-URLs
* Added support for SSH/SFTP-URLs
* Added support for file-URL (to import from local server)
* Added support for credentials for each tcp-protocol
* Added wrapper to support third party plugins or platforms, e.g. Imgur or Google Drive
* Added support for Rank Math
* Added warning about old PHP-versions
* Added option to switch external files to local hosting during uninstallation of the plugin
* Added WP CLI option to switch hosting of all files to local or external
* Added documentation for each possible option in GitHub
* Added link to settings in plugin list
* Added migration tool to switch the external files from Exmage to this one
* Added thumbnail support for proxied images
* Added settings for videos which now can also be proxied
* Added import and export for plugin settings
* Added a handful help texts for WordPress-own help system
* Added multiple new hooks
* Added statistic about used files.
* Added warning regarding the GPRD of the EU (could be disabled)
* Compatible with WordPress 6.7
* External files which are not provided via SSL will be saved local if actual website is using SSL
* Extended WP CLI support with documentation, progressbar, states and arguments
* Replaced settings management with optimized objects
* Optimized proxy url handling
* Optimized build process for releases
* Optimized transients of this plugin
* Optimized log table with much more options
* Replaced dialog library with new one
* Renamed internal transient prefix for better compatibility with other plugins
* Move support for already supported plugins in new wrapper
* Fixed some typos
* Fixed error with import of multiple files via WP CLI
= 2.0.1 =
* Small optimizations on texts for better translations
* GPRD-hint is now also shown for old installations if it is not disabled
* Fixed update handler for WordPress 6.7
* Fixed setting of capabilities for Playground
* Fixed setting of capabilities on update
= 2.0.2 =
* Added option to use the external file date instead of the import date
* Fixed hook documentations