/
readme.txt
264 lines (182 loc) · 9.83 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
=== WP Add Mime Types ===
Contributors: kimipooh
Tags: mime,file extention
Requires at least: 6.2
Requires PHP: 7.4
Tested up to: 6.5.2
Stable tag: 3.1.1
License: GPL v2
License URI: http://www.gnu.org/licenses/gpl-2.0.html
The plugin additionally allows the mime types and file extensions to WordPress.
== Description ==
The plugin additionally allows the mime types and file extensions to WordPress. In other words, your WordPress site can upload various file extensions.
== Installation ==
Please install this plugin and activate it.
If you use a language except English, please update the translation data in the updates of Dashboard.
If the multisite is enabled, please check the setting menu in the network administrator.
= Usage =
First of all, please check the "Media Type Settings" in the "Settings".
You can see the list of allowed mime types and file extensions by WordPress.
When you add the mime type or file extension, the data will be added to last item in this list at the red color.
About the mime type list, please see the list of mime types in the information of the Internet.
Ex. http://www.freeformatter.com/mime-types-list.html
The user who have the [manage_options](http://codex.wordpress.org/Roles_and_Capabilities#manage_options) permission can only add the setting.
If you would like to translate it to your language, please visit the GlotPress from https://wordpress.org/plugins/wp-add-mime-types/ .
If the multisite is enabled, the multisite network administrator can add/change/delete the mime type value in the multisite network setting menu. And the multisite network administrator or the site administrator can only see the past value (cannot change) before the site was migrated to the multisite.
== Frequently Asked Questions ==
= How to check the uploaded file type from Media. =
WordPress recognizes the file mime type by finfo_file function (wp-includes/functions.php). However, sometimes, the standard MIME type of a file and the MIME type of a WordPress-recognized file are different. By enabling both this option (in setting menu) and the "Enable the attempt to determine the real file type of a file by WordPress core.", the file type is displayed if it is from Media. PLEASE keep in mind that a file uploads are stopped while they are being processed if the both of two options are enabled. Therefore, be sure to disable this debugging option after debugging.
= Cannot work =
If the added mime type does not work, please deactivate other mime type plugins or the setting of other mime type plugins.
For example, if you install Media Library Assistant plugin, please turn off "Enable Upload MIME Type Support" in the Upload tag in this plugin setting.
= Can the plugin support the multi extensions? =
Yes. The function was supported by Version 2.4.0.
WordPress sanitizes the filename in case of 2 or more extensions.
ex. XXX.YYY.ZZZ --> XXX_.YYY.ZZZ.
The plugin fixes the sanitized extension when a file is uploaded in the media in case of allowed extensions.
ex. XXX.YYY.ZZZ -- sanitized --> XXX_.YYY.ZZZ -- fixed the plugin --> XXX.YYY.ZZZ
In detail, please see sanitize_file_name function in "wp-includes/formatting.php".
= Can I comment out in the setting value? =
Yes. You can comment out above version 2.3.0.
= Can the plugin avoid the security check for a file content by WordPress core? =
Yes. WordPress core has implemented the security check for a file content since version 4.7.1.
The plugin's default setting disables this security check .
= How do the plugin behave when it is installed and activated on the multisite network administration dashboard? =
The setting in the multisite network administration dashboard is taken precedence. The setting in each site administration dashboard is displayed, but the values aren't applied.
= How do the plugin behave when it is deactivated/uninstalled on the multisite network administration dashboard? =
The setting values in each site administration dashboard in case of activating the plugin in each site is applied.
= Don't the setting values in the multisite network administration dashboard and the setting values in each site administration dashboard influence each other? =
Yes, each setting values are saved as the other setting items.
= Is it possible to restrict the extensions? =
Yes, it is available on the version 3.0.0.
If the head in each line is set to '-', then the MIME type restricts.
ex. -bmp = image/bmp
The files which has "bmp" file extention becomes not to be able to upload.
== Screenshots ==
1. Setting Menu
2. Setting Menu in case of the multisite
3. Ignore to the right of '#' on a line
4. Security Options
== Changelog ==
= 3.1.1 =
- Fixes the type format mismatch issues since PHP 8.1 or later.
= 3.1.0 =
- Fixes type format mismatch issues in variable initialisation.
- Tested up WordPress 6.4.2 with PHP 8.2.0.
- Changed to require WordPress 6.2+ and PHP 7.4+.
- Tested up WordPress 6.5.2 with PHP 8.3.6.
= 3.0.3 =
- Fixed warning checking when retrieving serialized data.
= 3.0.2 =
- Enhanced error checking when retrieving serialized data.
= 3.0.1 =
- Fixed warning when the $settings data gets.
= 3.0.0 =
- Added the mime type restriction function by using '-' prefix. If the head in each line is set to '-', then the MIME type restricts. In case of "-bmp = image/bmp", the files which has "bmp" file extention becomes not to be able to upload.
- Fixed the warning on the multisite.
- Tested up WordPress 5.6.2 with PHP 8.0.0.
- Tested up WordPress 5.8
- Tested up WordPress 6.0
= 2.5.8 =
* Fixed the issue of the media uploads failing when activating this plugin for the first time, if the plugin settings are not saved whenever.
= 2.5.7 =
* Removed the folder (trunk) for this plugin in this plugin folder. The “trunk” folder was not needed. Due to this, activating the plugin in version 2.5.6, you might get an error message "Error: The plugin does not have a valid header".
= 2.5.6 =
* Added the "Enable to debug output for file types recognized by WordPress when a file is uploaded by the media." security option. In detail, please see "Frequently Asked Questions" section.
* Tested up to WordPress 5.6 and PHP 7.4.
= 2.5.5 =
* Fixed the error "the "Too few argument" for WordPress 5.0 or previous versions.
= 2.5.4 =
* Added the function for removing this plugin's settings in the database when this plugin is uninstall.
* Fixed the function names for not influencing the function name for other plugins.
= 2.5.3 =
* Fixed the issue of "Undefined variable: f_exp_more2_flag" warning.
= 2.5.2 =
* Improved the response of CSRF (Cross-Site Request Forgery) vulnerability for this plugin's settings.
= 2.5.1 =
* Added the response of CSRF (Cross-Site Request Forgery) vulnerability for this plugin's settings.
= 2.5.0 =
* Added the security option item in the admin menu for enabling the security check for a file content and for sanitizing the multiple file extensions within the filename by WordPress core.
* Supported the new language setting regarding load_plugin_textdomain function.
= 2.4.1 =
* Changed remove_underscore function name to wpaddmimetypes_remove_underscore because of the avoidance of the name conflict.
* Tested up to WordPress 5.2.2 and PHP 7.4.
= 2.4.0 =
* Support of the multi extension. Even if the file extension is "XXX.ZZZ", "XXX.YYY.ZZZ", "AAA.XXX.YYY.ZZZ" or more, it always picks up the tail of the extensions.
= 2.3.1 =
* Tested up to WordPress 5.2.2 and PHP 7.3.
= 2.3.0 =
* Tested up to WordPress 5.0 and PHP 7.2.
= 2.2.1 =
* Tested up to WordPress 4.9.
= 2.2.0 =
* Fixed foreach function warning if a setting value is empty.
* Added to escape HTML tags in a setting value using wp_strip_all_tags function.
* Added to ignore to the right of '#' on a line.
= 2.1.3 =
* Tested up to WordPress 4.8 and PHP 7.1
= 2.1.2 =
* Fixed the warning issue regarding explode function.
* Tested up to WordPress 4.7.2
= 2.1.1 =
* Fixed the issue that the safe files in WordPress, such as jpg, png, pdf cannot be uploaded.
= 2.1.0 =
* Tested up to WordPress 4.7.1
* Fixed finfo_file issue. See FAQ section.
= 2.0.6 =
* Tested up to WordPress 4.7
= 2.0.5 =
* Tested up to WordPress 4.6
= 2.0.4 =
* Fixed the help message in the administration menu.
= 2.0.3 =
* Fixed the help message in the administration menu.
* If the added mime type does not work, please turn off the mime type setting or deactivate other mime type plugins.
= 2.0.2 =
* Fixed the compatibility with Media Library Assistant plugin.
= 2.0.1 =
* Fixed the message in the setting menu
= 2.0.0 =
* Supported Multisite.
* Tested up to WordPress 4.5.1
= 1.3.13 =
* Tested up to WordPress 4.5.
= 1.3.12 =
* Migrated the translation function to GlotPress. If you translate it to your language, please visit the GlotPress from https://wordpress.org/plugins/wp-add-mime-types/ .
= 1.3.11 =
* Preparation of migrating the translation function to GlotPress.
= 1.3.10 =
* Tested up to WordPress 4.4.2
= 1.3.9 =
* Tested up to WordPress 4.4.1
= 1.3.8 =
* Tested up to WordPress 4.4
* Fixed language translation setting.
= 1.3.7 =
* Tested up to WordPress 4.3
= 1.3.6 =
* Fixed load_plugin_textdomain setting.
= 1.3.5 =
* Fixed load_plugin_textdomain setting.
= 1.3.4 =
* Tested up to WordPress 4.2.2
= 1.3.3 =
* Tested up to WordPress 4.1.1
= 1.3.2 =
* Tested up to WordPress 4.0
= 1.3.1 =
* Tested up to WordPress 3.9.1
= 1.3.0 =
* Tested up to WordPress 3.9
= 1.2.1 =
* Fixed Language support
= 1.2.0 =
* Tested up to WordPress 3.8
= 1.1.0 =
* Tested up to WordPress 3.7.1
= 1.0.1 =
* Fixed the display error if the setting value is empty for the first time.
= 1.0.0 =
* First Released.
* Language: English, Japanese
== Upgrade Notice ==