Theme: Structure¶
Here is an overview of the folder structure for themes, along with some details of specific files within the theme. All themes should be added to the themes
folder in the main root of the site.
Theme Folder Organization¶
theme-name
theme.info
screenshot.png
settings.json
media
css
js
img
templates
homepage.html
default.html
Theme File Descriptions¶
- theme.info
This file contains a set of attributes associated with a theme. See the example below for some common attributes.
name = Salonify description = Salonify theme for Tendenci CMS. tags = homepage rotator, spaces screenshot = screenshot.png author = Schipul author uri = http://schipul.com version = 1.0 create_dt = 2013-01-01 01:00:00
- screenshot.png
This file is a full page screenshot of the theme after it has been loaded with the fixtures using the
load_npo_defaults
management command.- settings.json
This file contains settings for the Tendenci site settings. These settings are written in json and are installed whenever the
update_settings
,set_theme
, orinstall_theme
command is run.- templates/homepage.html
This file defines the HTML that is used when the homepage of the site is loaded. You can learn more about the homepage at Theme: Homepage Template
- templates/default.html
This file defines the HTML that is used when a page other than the homepage is loaded.
Theme Media Usage¶
Template media in the media
folder can be referenced in the template using {% static 'path/to/file' %}
.