Description:

When uploading a customized portal via the Omada Controller, users often encounter the "template format error" due to ZIP structure issues. This is a common pain point, especially for users on Windows, where the default compression tools include the parent folder by default (e.g., demo_test/), rather than just zipping the internal contents.

Even when users follow correct steps, the built-in Windows compression tool tends to cause failures unless third-party tools like WinRAR are used with specific settings.

Proposed Feature:

Enhance the portal upload functionality by:

• Automatically checking if the uploaded ZIP contains a single folder at the root.

• If so, extract from within that folder (i.e., one level deeper) and validate the contents as if they were at the root.

• Optionally show a warning or notification about this adjustment for transparency.

Benefit:

This will:

• Save time and frustration for users who unknowingly compress their portal folder instead of its contents.

• Improve compatibility with commonly used compression tools (especially on Windows/macOS).

• Reduce support tickets and community confusion about the upload format.

Please find a reference to one of the discussions on the topic here.

Thanks for considering this improvement!