FAQ & Troubleshooting

You can follow the installation steps provided in the Getting Started page. If you’re using phpBB for the first time, we recommend reviewing phpBB’s official installation guide.

Check if the Panel Head Color feature is has a custom color, it might override the default theme color.

Make sure Theme Mode is set correctly in the control panel. You can enable Auto Mode to sync with the system preferences.

If you're using the Image mode for forum icons, double-check:

• The path: styles/zeina/theme/images/icons/.
• The selected image extension (GIF, PNG, or SVG) matches the file.

Renaming the theme folder causes path conflicts with images and icons. Please keep the folder name as zeina to avoid these issues.

Zeina is a standalone theme and does not support inheritance from other themes. Please disable inheritance to ensure proper functioning.

You should only add the JavaScript code itself, without wrapping it inside <script> tags.

After deleting the header image, set the header height to zero.

At the moment, upgrading the theme from TailwindCSS v3 to v4 is not planned. The reason is that TailwindCSS v4 has dropped support for older browsers, which may cause the theme to not work properly on some older devices or mobile phones.

It's very important to us that the theme is usable and accessible in a wide range of browsers, even if they're slightly older. Please note that TailwindCSS v3 itself does not support any version of Internet Explorer, and we only began using it once Microsoft officially ended support and usage of that browser.

We’ll certainly keep an eye on future developments, but for now, ensuring broad compatibility remains a top priority.

After careful consideration, we chose to use the Iconify library because it offers access to an extremely large collection of free icons from multiple sets — far more than any single icon font library provides. This allows users greater flexibility when customizing their forum icons.

While icon fonts may load slightly faster in some cases, they are limited in variety and style. Iconify enables us to offer a wider range of choices without forcing users to manually import or manage multiple icon sets.

We always prioritize performance and continuously monitor ways to optimize loading times without sacrificing flexibility.

This is often caused by your hosting server’s file permission settings. We recommend adjusting the images folder permissions on this path styles/zeina/theme using chmod.

• Try setting permissions to 755.
• If the problem persists, try 777 but use this cautiously as it reduces security.

If you are using Linux or Mac, you may need to add -R to chmod or chown for this step to work.

Example (Linux OS):

chmod -R 755 /var/www/public_html/styles/zeina/theme/images

Sometimes, after uploading a large image or video for the header, it may not appear immediately in the preview window. This usually happens because the browser attempts to preview the media as a Base64 encoded string, which can be too large for the browser to handle.

Solution

• Option 1: Save the settings even if the image/video is not visible in the preview side, then refresh the page. After saving, the media will be loaded as a file from the server, not as a Base64 preview, and should display properly.
• Option 2: Upload an image or video that is less than 2MB in size. This not only avoids the Base64 issue but also improves page loading speed and reduces data usage, especially for mobile users.