Pull Request resolves # .

• I read the Generative AI policy and my contribution is either not created with the help of AI or is compatible with the policy and GNU/GPL 2 or later.

Summary of Changes

This pull request introduces a safeguard to the file installation process in the FileAdapter installer, preventing accidental copying of all files from a package root to the site root.
It also fixes an error if no fileset is available in manifest file (for example, if everything is handled separately via an installer script).

Testing Instructions

Case 1 - no fileset in manifest file - only installer script

fileadaptertest2.zip

Case 2 - various configurations within the fileset using the folder and target attributes

fileadaptertest.zip

Actual result BEFORE applying this Pull Request

Case 1

Unfortunately, this error message occurs only sporadically and cannot always be reproduced.
However, the PHP error can be traced at this point.FileAdapter.php#L505

Case 2

These files can be found in the root of the site:

fileadaptertest.php
fileadaptertest.xml
i_should_not_be_in_root.txt
LICENSE
README.md

Expected result AFTER applying this Pull Request

Case 1

No 'JSON.parse: unexpected character at line 1 column 1 of the JSON data' - error message.

If you visit the frontend using the standard Cassiopeia template, you should see this message

Or alternatively, this comment in the index.php in the cassiopeia template code - line 13.

defined('_JEXEC') or die;

// I should be here to ensure fileadaptertest script is working correctly.

Case 2

You should see the same for the template index.php override in Cassiopeia template like in case 1.

1. All files from a specific file package folder can be copied into any folder in Joomla.

<files folder="test" target="fatest1"></files>

• New folder fatest1with the following file
  • i_should_be_here.txt

2. All files from a specific file package folder can be deliberately copied into Joomla root.

<files folder="test"></files>

New file under root on the site i_should_be_here.txt

3. All root files from the file package can still be deliberately copied into any folder (except the root) in Joomla.

<files target="fatest2"></files>

• New folder fatest2 with the following files
  • fileadaptertest.php
  • fileadaptertest.xml
  • i_should_not_be_in_root.txt
  • LICENSE
  • README.md

4. A specific file can still be copied to the root of the Joomla site.

 <files>test/i_should_be_here.txt</files>

New file under root on the site i_should_be_here.txt

5. Preventing accidental copying of all files from a package root to the site root.

<files></files>

You should see this warning message

These files should not be copied to the root of the site:

• fileadaptertest.php
• fileadaptertest.xml
• i_should_not_be_in_root.txt
• LICENSE
• README.md

Link to documentations

Please select:

• Documentation link for guide.joomla.org:

• No documentation changes for guide.joomla.org needed

• Pull Request link for manual.joomla.org:

• No documentation changes for manual.joomla.org needed