Merge pull request #11995 from nextcloud/filename-validation-changes

Add documentation for filename validation options

Author: come-nc

admin_manual/release_notes/upgrade_to_30.rst

@@ -7,4 +7,13 @@ System requirements
 
 * PHP 8.1 is now deprecated but still supported.
 * PHP 8.0 is no longer supported.
-* PostgreSQL 9.4 is no longer supported.
+* PostgreSQL 9.4 is no longer supported.
+
+Nextcloud configuration
+-----------------------
+
+Changes to the available options in ``config.php``.
+
+* The option ``blacklisted_files`` is now deprecated and replaced with ``forbidden_filenames``
+* The option ``forbidden_chars`` is now deprecated and replaced with ``forbidden_filename_characters``
+* The option ``forbidden_filename_extensions`` was added to allow blocking extensions from being used on filenames

developer_manual/app_publishing_maintenance/app_upgrade_guide/upgrade_to_30.rst

@@ -5,6 +5,16 @@ Upgrade to Nextcloud 30
 General
 -------
 
+Capabilities
+------------
+
+``files``
+^^^^^^^^^
+
+- ``blacklist_files_regex`` is deprecated now use ``forbidden_filenames`` instead
+- ``forbidden_filename_characters`` was added to provide a list of characters not allowed within filenames
+- ``forbidden_filename_extensions`` was added to provide a list of extensions (suffixes) not allwed for filenames
+
 Front-end changes
 -----------------
 
@@ -30,18 +40,20 @@ Removed globals
 Deprecated APIs
 ^^^^^^^^^^^^^^^
 
-* ``OC.dialogs.fileexists`` was already deprecated in Nextcloud 29, but is now also marked as such.
+- ``OC.config.blacklist_files_regex`` is deprecated now, use the ``files`` capabilities instead
+- ``OC.config.forbidden_filename_characters`` is deprecated now, use the ``files`` capabilities instead
+- ``OC.dialogs.fileexists`` was already deprecated in Nextcloud 29, but is now also marked as such.
   Use ``openConflictPicker`` from `@nextcloud/upload <https://nextcloud-libraries.github.io/nextcloud-upload/functions/openConflictPicker.html>`_ instead.
-* Most ``OC.dialogs`` API is now deprecated and will be removed in the future. For generic dialogs use the ``DialogBuilder`` from the :ref:`js-library_nextcloud-dialogs`.
+- Most ``OC.dialogs`` API is now deprecated and will be removed in the future. For generic dialogs use the ``DialogBuilder`` from the :ref:`js-library_nextcloud-dialogs`.
   A list of the now deprecated methods:
 
-  * ``OC.dialogs.alert``
-  * ``OC.dialogs.info``
-  * ``OC.dialogs.confirm``
-  * ``OC.dialogs.confirmDestructive``
-  * ``OC.dialogs.confirmHtml``
-  * ``OC.dialogs.prompt``
-  * ``OC.dialogs.message``
+  - ``OC.dialogs.alert``
+  - ``OC.dialogs.info``
+  - ``OC.dialogs.confirm``
+  - ``OC.dialogs.confirmDestructive``
+  - ``OC.dialogs.confirmHtml``
+  - ``OC.dialogs.prompt``
+  - ``OC.dialogs.message``
 
 Back-end changes
 ----------------