Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (pypi.python.org).
Help us improve Python packaging - Donate today!

A Django app to make minor changes to your templates on the fly.

Project Description

Templates Admin is a tiny, nifty application for your Django project to edit your templates, that are stored on your disk, via an admin interface.

Originally this app was inspired by dbtemplates.

Installation:

  1. Put templatesadmin into your INSTALLED_APPS setting.

  2. Add this line to your urlconf but before your admin include:

    (r'^admin/templatesadmin/', include('templatesadmin.urls')),
    
  3. Create a group TemplateAdmins and put all users in there, who should been able to edit templates. You don’t need to grant any permissions to that group. Just call it TemplateAdmins.

    Keep in mind that also Superusers (is_admin flag) must belong to this group, if they should been able to edit templates. The group name is case-sensitive!

  4. Point your webbrowser to http://localhost/admin/templatesadmin/ and start editing.

Optional Settings:

There are some settings that you can override in your settings.py:

  1. TEMPLATESADMIN_GROUP: The name of your group of your TemplatesAdmin Users.

    Default: TemplateAdmins

  2. TEMPLATESADMIN_VALID_FILE_EXTENSIONS: A tuple of file-extensions (without the leading dot) that are editable by TemplatesAdmin.

    Default:

    TEMPLATESADMIN_VALID_FILE_EXTENSIONS = (
        'html',
        'htm',
        'txt',
        'css',
        'backup'
    )
    
  3. TEMPLATESADMIN_TEMPLATE_DIRS: A tuple of directories you want your users to edit, instead of all templates.

    Default: All user-defined and application template-dirs.

  4. TEMPLATESADMIN_HIDE_READONLY: A boolean to wether enable or disable displaying of read-only templates.

    Default: False

  5. TEMPLATESADMIN_EDITHOOKS: A tuple of callables edithooks. Edithooks are a way to interact with changes made on a template. Think of a plugin system.

    There are two builtin edithooks:

    • dotbackupfiles.DotBackupFilesHook: Creates a copy of the original file before overwriting, naming it <oldname>.backup.
    • gitcommit.GitCommitHook: Commits your templates after saving via git version control.
    • hgcommit.HgCommitHook: Creates a mercurial commit after saving.

    You can define your own edithooks, see above hooks as example.

    Default:

    TEMPLATESADMIN_EDITHOOKS = (
        'templatesadmin.edithooks.dotbackupfiles.DotBackupFilesHook',
    )
    

LICENSE:

This application is licensed under the Beerware License. See LICENSE for details.

Changelog:

v0.7 (2012-11-20)

  • Added missing permission check for an Admin view.

v0.6 (2009-09-08)

  • Published under a proper BSD license.
  • The templates now inherits from the Django templates to provide a better look and feel.
  • A lot of overall improvements from typo fixing to better permission handling. Thanks to peritus and rlaager.

v0.5.5 (2009-02-13)

  • Documented that there is a edithook for mercurial repositories.
  • Bugfix in GitCommitHook: Allow non-ascii characters.

v0.5.4 (2009-02-13)

  • Fixed missing templatetags in pypi release.

v0.5.3 (2009-02-03)

  • Edit-Views now have an optional argument “base_form” to overwrite the default form.
  • Removed shorten-path functions. They didn’t work under some conditions.
  • List of templates in the admin overview are shorter.

v0.5.2 (2008-12-12)

  • Added a edithook for dealing with mercurial repositories. Thank you v.oostveen! (Issue3)
  • Fixed handling of newline characters at the end of the file, which causes to delete the last character. (Issue4)
Release History

Release History

This version
History Node

0.7

History Node

0.6

History Node

0.5.5

History Node

0.5.4

History Node

0.5.3

History Node

0.5.2

History Node

0.5.1

Download Files

Download Files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
django-templatesadmin-0.7.tar.gz (9.5 kB) Copy SHA256 Checksum SHA256 Source Nov 20, 2012

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting