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.
![tide_screen](https://private-user-images.githubusercontent.com/121483313/253292675-433bf991-6bc0-4c11-83ba-7a369f88ae1a.png?jwt=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3MjM4OTc5OTQsIm5iZiI6MTcyMzg5NzY5NCwicGF0aCI6Ii8xMjE0ODMzMTMvMjUzMjkyNjc1LTQzM2JmOTkxLTZiYzAtNGMxMS04M2JhLTdhMzY5Zjg4YWUxYS5wbmc_WC1BbXotQWxnb3JpdGhtPUFXUzQtSE1BQy1TSEEyNTYmWC1BbXotQ3JlZGVudGlhbD1BS0lBVkNPRFlMU0E1M1BRSzRaQSUyRjIwMjQwODE3JTJGdXMtZWFzdC0xJTJGczMlMkZhd3M0X3JlcXVlc3QmWC1BbXotRGF0ZT0yMDI0MDgxN1QxMjI4MTRaJlgtQW16LUV4cGlyZXM9MzAwJlgtQW16LVNpZ25hdHVyZT0wMmJkMWJkMDg3ZWNkZmZiN2VlZGZjM2M4OTFkZDIxMTM5YjZhZTk5MDA0NTc4MGU2YzE1MjIxYjRhMWJiNzNmJlgtQW16LVNpZ25lZEhlYWRlcnM9aG9zdCZhY3Rvcl9pZD0wJmtleV9pZD0wJnJlcG9faWQ9MCJ9.jTjbJR5K2_2WvN2rGxCnngBwb2xLw3QH-r1OpnD6PTI)
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!