Managing themes
Themes are managed in the Management Console, on the Themes page.
Themes overview
The following properties are present.
Property | Description |
---|---|
Name |
This is the metadata name contained in the QEXT file, which is different from the QEXT filename. |
Description |
Short description of the theme. |
Tags |
Tags for filtering. |
Author |
Creator of the theme. |
QEXT filename |
Identifier that must be unique. Filename of the theme definition file. Different from the name of the theme. |
QEXT version |
Metadata version contained in the QEXT file. |
Published |
Date of publishing. |
Updated | Date of last update. |
In the table, sort by using the arrows in the properties header. Filter by using the Tags drop-down menu, or by selecting the tags in the table.
Themes with external resources
Themes that contain links to external resources must have its origins allow listed in the Content Security Policy.
See also: Managing Content Security Policy
Supported file formats and size
Themes only support HTML files, CSS, JSON, and images (PNG, JPEG, GIF, and SVG), along with QEXT metadata files and font files.
Maximum size of a file within a theme folder is 250 MB.
Uploading of themes that contain files with the following disallowed MIME types will fail:
- 'application/octet-stream'
- 'application/x-coredump'
- 'application/x-dosexec'
- 'application/x-executable'
- 'application/x-java-applet'
- 'application/x-object'
- 'application/x-sharedlib'
- 'application/zip'
- 'text/x-shellscript'
- 'text/x-awk'
- 'text/x-gawk'
- 'text/x-msdos-batch'
- 'text/x-nawk'
- 'text/x-php'
Adding a new theme
Do the following:
- In the Management Console, go to the Themes section and Click Add in upper the right-hand corner.
-
In the pop-up, click Browse to select a theme file, or drop a file in the designated area.
Information noteYou cannot upload a theme with the same QEXT filename as an existing one. -
Optionally, add tags.
-
Click Publish.
-
If the theme you just uploaded contain external resources, you need to allow list the origins in the Content Security Policy. See Managing Content Security Policy.
Editing a theme
You can edit one theme at a time.
Do the following:
- In the Management Console, go to the Themes section and select the check box for the theme you want to edit.
-
In the upper right-hand corner, click Edit.
The editing panel is displayed with options for replacing the existing theme and adding or removing tags.
-
Make your edits and save.
Deleting an theme
Do the following:
- In the Management Console, go to the Themes section and select the check boxes for the themes you want to delete.
- In the upper the right-hand corner, click Delete.