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.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3MjE0ODM0MTMsIm5iZiI6MTcyMTQ4MzExMywicGF0aCI6Ii8xMjE0ODMzMTMvMjUzMjkyNjc1LTQzM2JmOTkxLTZiYzAtNGMxMS04M2JhLTdhMzY5Zjg4YWUxYS5wbmc_WC1BbXotQWxnb3JpdGhtPUFXUzQtSE1BQy1TSEEyNTYmWC1BbXotQ3JlZGVudGlhbD1BS0lBVkNPRFlMU0E1M1BRSzRaQSUyRjIwMjQwNzIwJTJGdXMtZWFzdC0xJTJGczMlMkZhd3M0X3JlcXVlc3QmWC1BbXotRGF0ZT0yMDI0MDcyMFQxMzQ1MTNaJlgtQW16LUV4cGlyZXM9MzAwJlgtQW16LVNpZ25hdHVyZT1jYzM2Mzk3MGNmMDg3OTJkM2ZkMDlkZjQ5OWNhODcxY2E1ZGQwYzk2ZWJlMWU1NmQ4ODRhNWZjNTg5ZDg2MWQ0JlgtQW16LVNpZ25lZEhlYWRlcnM9aG9zdCZhY3Rvcl9pZD0wJmtleV9pZD0wJnJlcG9faWQ9MCJ9.qiWz0mygu6240X4UPmPmd8rx0eoaQ8s3apK2TS5HPPM)
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!