Tide is a client area theme for FOSSBilling. It's designed to enhance your user interface with a clean, modern aesthetic. This guide provides steps on how to install, upgrade, secure, and customize the Tide theme.
Follow these steps to install the Tide theme:
- Clone this repository or download the latest version.
- Extract the files and move the
tide
directory into theFOSSBilling directory/themes
. - Change the directory owner to the user your web server runs under. For example:
chown -Rf www-data:www-data tide/
. - Set permissions to
750
using chmod:chmod -Rf 750 tide/
. - Navigate to
Settings -> Themes
in the FOSSBilling admin panel and selecttide
as the default theme.
To upgrade to a newer version of the Tide theme, perform the following:
- Clone this repository or download the latest version.
- Backup your
FOSSBilling directory/themes/tide/config/settings_data.json
and any custom assets located atFOSSBilling directory/themes/tide/assets
. Pay close attention if you have customized the CSS file atFOSSBilling directory/themes/tide/assets/css/custom.css
. - Extract the latest version and move the
tide
directory intoFOSSBilling directory/themes
, overwriting all files. - Restore your
settings_data.json
and any custom assets from the backup. - Change the directory owner to the web server user. For example:
chown -Rf www-data:www-data tide/
. - Set permissions to
750
using chmod:chmod -Rf 750 tide/
.
For versions of Tide installed prior to 0.9.5, implement these security measures:
- Change the directory owner to the web server user. For example:
chown -Rf www-data:www-data tide/
. - Set permissions to
750
using chmod:chmod -Rf 750 tide/
.
Tide now allows you to replace default colours with custom ones, enabling you to align the theme with your branding. To make these changes, edit the FOSSBilling directory/themes/tide/assets/css/custom.css
file as per the comments provided within it.
Please remember to regularly update your theme to receive the latest enhancements and security patches. Enjoy using Tide!