Theme and Login Customization Guide
/src/includes/theme/tema-name_*siteid* directory is used to manage theme and login customizations specific to each site. Customizations made in this directory are not affected by Git commits and system upgrades. You can create site-specific designs by editing your files such as CSS, JS and login.cfm here. Instead of editing standard files, you can prevent files from being crushed during pull operations by making your customizations in this special directory. This guide helps you manage your customizations in a safe and sustainable way.
File Location and Customization Details
/src/includes/theme/theme-name_*siteid* directory is reserved to host theme and login customizations specific to each site. This directory is ignore by Git. Therefore, changes made here are not committed and remain specific to the relevant site only.
Theme Customizations
- Theme files (CSS, JS, etc.) should be located in this directory and edits should be made here.
- Changes made in this directory are not affected by system upgrades . Thus, site-specific styles and functions are preserved.
- Attention:Do not interfere with standard theme files under
/AddOns/Yazilimsa/Protein/reactor/themes. These files are crushed in pull operations performed in the Git environment. Be sure to make your customizations in the theme directory above.
/src/includes/theme/theme-name_*siteid*/custom.css/src/includes/theme/theme-name_*siteid*/custom.js
Login Customizations
- If a site-specific login screen is to be used, the
login.cfmfile should be added to this directory: - /src/includes/theme/theme-name_*siteid*/login.cfm
- If login.cfm exists in this directory, the system will automatically run this file. If not, the standard
login.cfmin the home directory is used. - Caution: Changes made to the
login.cfmfile in the home directory are squashed during pull operations in the Git environment. If you need customization, copy the standard file and edit it here.
Updating Status of Original Files
Interventions made to standard theme or login files in the main directory During Git pull operations crushed. Therefore,avoid making changes to the original files. Use the directory mentioned above for your site-specific customizations.
Tips
- For Theme Customizations: Create a modular structure by keeping your CSS and JS files in a separate file. This makes future edits easier.
/src/includes/theme/theme-name_*siteid*/site-specific-styles.css/src/includes/theme/theme-name_*siteid*/site-specific-scripts.js
- In Login Customizations: Editing the
login.cfmfile in the main directory Instead, customize this file by copying it to the directory above. Making changes to the standard file will cause it to be lost during pull operations. - Backup: Be sure to back up your files before making edits. Especially after system upgrades, check your customized files and adapt them to the new system when necessary.