Skip to content

Provides some basic templates for things in Registrasion, so that you get basic behaviour automatically.

License

Notifications You must be signed in to change notification settings

chrisjrn/symposion-bootstrap-templates

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

38 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

symposion-bootstrap-templates

Provides some customisable bootstrap templates for things in Symposion, so that you get basic behaviour automatically.

What is the point of this?

symposion provides a bunch of django views that make the app tick, however, it does not include any templates, which means that as new features are added, things do not work automagically

How does it work

For each template required by symposion, symposion_templates provides two templates. Say the template used by the view is called view.html. We provide:

  • view.html, which is the template that is loaded directly -- this will be very modular, and will let you easily override things that you need to override in your own installations
  • view_.html, which is the thing that lays everything out.

So you can either override view_.html if you're happy with the text and markup that view.html provides, or you can override view.html if you want to change the entire thing. Your choice!

Installation

Ensure that APP_DIRS is switched on in your settings, like so:

TEMPLATES = [{
    'BACKEND': 'django.template.backends.django.DjangoTemplates',
    'APP_DIRS': True,
}]

Then add symposion_templates to your INSTALLED_APPS:

INSTALLED_APPS = [
  ...
  "symposion_templates",
  ...
]

Overriding our defaults:

  • symposion/form.html is used by these templates whenever a form needs to be rendered. The default implementation of this just calls {form}.
  • symposion/base.html extends site_base.html. Each view_.html template that we provide extends symposion/base.html

Using the templates

  • Our default templates place their content in a block called content. Your symposion/base.html MUST include a block called content where you want the content to appear.
  • Each template will document the purpose of the templates

About

Provides some basic templates for things in Registrasion, so that you get basic behaviour automatically.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published