Skip to content

Commit 4993957

Browse files
committed
Collect upgrading info at one palce
1 parent d0a5497 commit 4993957

File tree

3 files changed

+21
-20
lines changed

3 files changed

+21
-20
lines changed

README.rst

Lines changed: 0 additions & 20 deletions
Original file line numberDiff line numberDiff line change
@@ -49,26 +49,6 @@ Documentation
4949
Please head over to the separate `documentation <https://django-filer.readthedocs.io/en/latest/index.html>`_
5050
for all the details on how to install, configure and use django-filer.
5151

52-
Upgrading
53-
=========
54-
55-
Version 3.3
56-
-----------
57-
58-
django-filer version 3 contains a change in security policy for file uploads.
59-
**By default, binary file or files of unknown type are not allowed to be uploaded.**
60-
To allow upload of binary files in your project, add
61-
62-
.. code-block:: python
63-
64-
FILER_REMOVE_FILE_VALIDATORS = [
65-
"application/octet-stream",
66-
]
67-
68-
to your project's settings. Be aware that binary files always are a security risk.
69-
See the documentation for more information on how to configure file upload validators,
70-
e.g., running files through a virus checker.
71-
7252

7353
.. |pypi| image:: https://badge.fury.io/py/django-filer.svg
7454
:target: http://badge.fury.io/py/django-filer

docs/upgrading.rst

Lines changed: 19 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -7,6 +7,25 @@ Usually upgrade procedure is straightforward: update the package and run migrati
77
require special attention from the developer and here we provide upgrade instructions for such cases.
88

99

10+
from 3.x to 3.3
11+
---------------
12+
13+
django-filer version 3.3 contains a change in security policy for file uploads.
14+
**By default, binary file or files of unknown type are not allowed to be uploaded.**
15+
To allow upload of binary files in your project, add
16+
17+
.. code-block:: python
18+
19+
FILER_REMOVE_FILE_VALIDATORS = [
20+
"application/octet-stream",
21+
]
22+
23+
to your project's settings. Be aware that binary files always are a security risk.
24+
See :ref:`check_virus` for more information on how to configure file upload validators,
25+
e.g., running files through a virus checker.
26+
27+
28+
1029
from 2.x to 3.0
1130
---------------
1231

docs/validation.rst

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -264,6 +264,8 @@ If you distinguish validation by the mime type, remember to register the
264264
validator function for all relevant mime types.
265265

266266

267+
.. _check_virus:
268+
267269
Checking uploads for viruses using ClamAV
268270
-----------------------------------------
269271

0 commit comments

Comments
 (0)