Admin Apps Names Translation

Author:: Nad
Posted:: January 22, 2010
Language:: Python
Version:: 1.1
Score:: 3 (after 3 ratings)

Download
Raw

This Snippet allows for your project's apps names to be displayed as you want in the Admin, including translations.

The lists of apps and languages are created from your settings.py file.

How to use

1st part:

Create a application called 'apps_verbose' in you project with the models.py and admin.py showed here
Create a folder inside it with named 'templatetags' with the verbose_tags.py file inside it.
Add this app to installed apps in your settings.py
If you change this app name, dont forget to correct the imports.

2nd part:

Create a folder named 'admin' in your templates folder and copy the following files form your /django/contrib/admin/templates/admin/ folder.
/app_index.html
/base.html
/change_form.html
/change_list.html
/delete_confirmation.html
/delete_selected_confirmation.html
/index.html
/object_history.html
Make the necessary changes in each file, like shown here.

3rd part:

Create translations in the Admin and enjoy.

### apps_verbose/templatetags/verbose_tags.py  ###

#!/usr/bin/env python
# -*- coding: UTF-8 -*-

from django import template
from django.template.defaultfilters import *

from my_project.apps_verbose.models import * ### define import for your project (my_project) ###

register = template.Library()

@register.simple_tag
def verbose_name(app_name, language_code):

    try:
        app = Verbose_Name.objects.get(app = app_name.lower())
        app_name_translated = app.verbose_name_tranlations_set.get(language = language_code)
        return app_name_translated.name
    except:
        return app_name

@register.simple_tag
def verbose_name_title(title, language_code):
    
    title = title.split(' ')
    title_translated = []
    for word in title:
        title_translated.append(verbose_name(word, language_code))
    
    return ' '.join(title_translated)



### apps_verbose/models.py  ###

#!/usr/bin/env python
# -*- coding: UTF-8 -*-

from django.db import models
from django.conf import settings 
from django.db.models import get_app, get_apps

def get_app_name (path):
    path = path.split('.')
    i=len(path)-1
    return path[i]

app_list = ((get_app_name(app),get_app_name(app))for app in settings.INSTALLED_APPS if get_app_name(app))

class Verbose_Name(models.Model):
    """
    Apps
    """
    class Meta:
        verbose_name = u'Verbose_Name'
        verbose_name_plural = u'Verbose_Name'        

    app          = models.CharField(max_length=200,unique=False,choices=app_list)
    
    def __unicode__(self):
        return u'%s' % (self.app)

class Verbose_Name_Tranlations(models.Model):
    """
    Translations
    """
    class Meta:
        verbose_name = u'Verbose_Name Tranlations'
        verbose_name_plural = u'Verbose_Name Tranlations'
        unique_together = ('name','language')
        
    verbose_name = models.ForeignKey(Verbose_Name)
    language     = models.CharField(max_length=20,unique=True,choices = settings.LANGUAGES)
    name         = models.CharField(verbose_name = u'Name', max_length = 200, null = False, blank = False,)



### apps_verbose/admin.py  ###

#!/usr/bin/env python
# -*- coding: UTF-8 -*-

from django.contrib import admin
from django.contrib.admin.options import ModelAdmin

from my_project.apps_verbose.models import * ### define import for your project (my_project) ###

class Child_Verbose_Name_Tranlations(admin.TabularInline):
    model = Verbose_Name_Tranlations
    extra = 3

class Admin_Verbose_Name(ModelAdmin):  
    fieldsets = (
        (u'Verbose Name',
            {'fields':('app',)}),
    )

    inlines = [Child_Verbose_Name_Tranlations,]

    list_display = ('__unicode__',)
    list_display_links = ('__unicode__',)

admin.site.register(Verbose_Name,Admin_Verbose_Name)


<!-- templates/admin/object_history.html -->

{% extends "admin/base_site.html" %}
{% load i18n %}
{% load verbose_tags %} <!-- Add Tag Library here -->

{% block breadcrumbs %}
<div class="breadcrumbs">
    <a href="../../../../">{% trans 'Home' %}</a> &rsaquo; 
<!-- Changes made here -->
    <a href="../../../">{% get_current_language as LANGUAGE_CODE %}{% verbose_name app_label LANGUAGE_CODE %}</a> &rsaquo; 
    <a href="../../">{{ module_name }}</a> &rsaquo; 
    <a href="../">{{ object|truncatewords:"18" }}</a> &rsaquo; 
    {% trans 'History' %}
</div>
{% endblock %}



<!-- templates/admin/delete_selected_confirmation.html -->

{% extends "admin/base_site.html" %}
{% load i18n %}
{% load verbose_tags %} <!-- Add Tag Library here -->

{% block breadcrumbs %}
<div class="breadcrumbs">
     <a href="../../">{% trans "Home" %}</a> &rsaquo;
<!-- Changes made here -->
     <a href="../">{% get_current_language as LANGUAGE_CODE %}{% verbose_name app_label LANGUAGE_CODE %}</a> &rsaquo; 
     <a href="./">{{ opts.verbose_name_plural|capfirst }}</a> &rsaquo;
     {% trans 'Delete multiple objects' %}
</div>
{% endblock %}



<!-- templates/admin/delete_confirmation.html -->

{% extends "admin/base_site.html" %}
{% load i18n %}
{% load verbose_tags %} <!-- Add Tag Library here -->

{% block breadcrumbs %}
<div class="breadcrumbs">
     <a href="../../../../">{% trans "Home" %}</a> &rsaquo;
<!-- Changes made here -->
     <a href="../">{% get_current_language as LANGUAGE_CODE %}{% verbose_name app_label LANGUAGE_CODE %}</a> &rsaquo; 
     <a href="../../">{{ opts.verbose_name_plural|capfirst }}</a> &rsaquo;
     <a href="../">{{ object|truncatewords:"18" }}</a> &rsaquo;
     {% trans 'Delete' %}
</div>
{% endblock %}



<!-- templates/admin/app_index.html -->

{% extends "admin/index.html" %} 
{% load i18n %} 
{% load verbose_tags %} <!-- Add Tag Library here -->

{% if not is_popup %}

{% block breadcrumbs %}
<div class="breadcrumbs"><a href="../">
{% trans "Home" %}</a> &rsaquo; 
{% for app in app_list %}
<!-- Changes made here -->
 {% get_current_language as LANGUAGE_CODE %}{% verbose_name app.name LANGUAGE_CODE %} 
{% endfor %}</div>{% endblock %}

{% endif %} 

{% block sidebar %}{% endblock %}



<!-- templates/admin/change_form.html -->

{% extends "admin/base_site.html" %}
{% load i18n admin_modify adminmedia %}
{% load verbose_tags %} <!-- Add Tag Library here -->

{% block extrahead %}{{ block.super }}
<script type="text/javascript" src="../../../jsi18n/"></script>
{{ media }}
{% endblock %}

{% block extrastyle %}{{ block.super }}<link rel="stylesheet" type="text/css" href="{% admin_media_prefix %}css/forms.css" />{% endblock %}

{% block coltype %}{% if ordered_objects %}colMS{% else %}colM{% endif %}{% endblock %}

{% block bodyclass %}{{ opts.app_label }}-{{ opts.object_name.lower }} change-form{% endblock %}

{% block breadcrumbs %}{% if not is_popup %}
<div class="breadcrumbs">
     <a href="../../../">{% trans "Home" %}</a> &rsaquo;
<!-- Changes made here -->
     <a href="../../">{% get_current_language as LANGUAGE_CODE %}{% verbose_name app_label LANGUAGE_CODE %}</a> &rsaquo; 
     {% if has_change_permission %}<a href="../">{{ opts.verbose_name_plural|capfirst }}</a>{% else %}{{ opts.verbose_name_plural|capfirst }}{% endif %} &rsaquo; 
     {% if add %}{% trans "Add" %} {{ opts.verbose_name }}{% else %}{{ original|truncatewords:"18" }}{% endif %}
</div>
{% endif %}{% endblock %}



<!-- templates/admin/index.html -->

{% extends "admin/base_site.html" %}
{% load i18n %}
{% load verbose_tags %} <!-- Add Tag Library here -->

{% block extrastyle %}{{ block.super }}<link rel="stylesheet" type="text/css" href="{% load adminmedia %}{% admin_media_prefix %}css/dashboard.css" />{% endblock %}

{% block coltype %}colMS{% endblock %}

{% block bodyclass %}dashboard{% endblock %}

{% block breadcrumbs %}{% endblock %}

{% block content %}
<div id="content-main">

{% if app_list %}
    {% for app in app_list %}
        <div class="module">
        <table summary="{% blocktrans with app.name as name %}Models available in the {{ name }} application.{% endblocktrans %}">
<!-- Changes made here -->
        <caption><a href="{{ app.app_url }}" class="section">{% get_current_language as LANGUAGE_CODE %}{% verbose_name app.name LANGUAGE_CODE %}</a></caption> 
        {% for model in app.models %}
            <tr>
            {% if model.perms.change %}
                <th scope="row"><a href="{{ model.admin_url }}">{{ model.name }}</a></th>
            {% else %}
                <th scope="row">{{ model.name }}</th>
            {% endif %}

            {% if model.perms.add %}
                <td><a href="{{ model.admin_url }}add/" class="addlink">{% trans 'Add' %}</a></td>
            {% else %}
                <td>&nbsp;</td>
            {% endif %}

(...)


<!-- templates/admin/change_list.html -->

{% extends "admin/base_site.html" %}
{% load adminmedia admin_list i18n %}
{% load verbose_tags %} <!-- Add Tag Library here -->

{% block extrastyle %}
  {{ block.super }}
  <link rel="stylesheet" type="text/css" href="{% admin_media_prefix %}css/changelists.css" />
  {% if cl.formset %}
    <link rel="stylesheet" type="text/css" href="{% admin_media_prefix %}css/forms.css" />
    <script type="text/javascript" src="../../jsi18n/"></script>
  {% endif %}
  {{ media }}
  {% if not actions_on_top and not actions_on_bottom %}
    <style>
      #changelist table thead th:first-child {width: inherit}
    </style>
  {% endif %}
{% endblock %}

{% block bodyclass %}change-list{% endblock %}

{% if not is_popup %}
  {% block breadcrumbs %}
    <div class="breadcrumbs">
      <a href="../../">
        {% trans "Home" %}
      </a>
       &rsaquo; 
       <a href="../">
<!-- Changes made here -->
         {% get_current_language as LANGUAGE_CODE %}{% verbose_name app_label LANGUAGE_CODE %} 
      </a>
      &rsaquo; 
      {{ cl.opts.verbose_name_plural|capfirst }}
    </div>
  {% endblock %}
{% endif %}

(...)



<!-- templates/admin/base.html -->

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" lang="{{ LANGUAGE_CODE }}" xml:lang="{{ LANGUAGE_CODE }}" {% if LANGUAGE_BIDI %}dir="rtl"{% endif %}>
<head>
<title>{% block title %}{% endblock %}</title>
<link rel="stylesheet" type="text/css" href="{% block stylesheet %}{% load adminmedia %}{% admin_media_prefix %}css/base.css{% endblock %}" />
{% block extrastyle %}{% endblock %}
<!--[if lte IE 7]><link rel="stylesheet" type="text/css" href="{% block stylesheet_ie %}{% load adminmedia %}{% admin_media_prefix %}css/ie.css{% endblock %}" /><![endif]-->
{% if LANGUAGE_BIDI %}<link rel="stylesheet" type="text/css" href="{% block stylesheet_rtl %}{% admin_media_prefix %}css/rtl.css{% endblock %}" />{% endif %}
{% block extrahead %}{% endblock %}
{% block blockbots %}<meta name="robots" content="NONE,NOARCHIVE" />{% endblock %}
</head>
{% load i18n %}
{% load verbose_tags %} <!-- Add Tag Library here -->

<body class="{% if is_popup %}popup {% endif %}{% block bodyclass %}{% endblock %}">

<!-- Container -->

(...)

    <!-- Content -->
    <div id="content" class="{% block coltype %}colM{% endblock %}">
        {% block pretitle %}{% endblock %}
<!-- Changes made here -->
        {% block content_title %}{% if title %}<h1>{% get_current_language as LANGUAGE_CODE %}{% verbose_name_title title LANGUAGE_CODE %}</h1>{% endif %}{% endblock %} 
        {% block content %}
        {% block object-tools %}{% endblock %}
        {{ content }}
        {% endblock %}
        {% block sidebar %}{% endblock %}
        <br class="clear" />
    </div>
    <!-- END Content -->

(...)

Comments

ha22109 (on April 1, 2010):

this is not working for me.I am not able to change the app name "apps_verbose" .It is still showing in english

Nad (on August 2, 2010):

There is an erros in models.py. Language shoud have unique=False.

Corrected in code.

There have been some changes to the get_app_name function for better results.

valerio.maggio (on February 15, 2014):

@ha22109: You have to change the LANGUAGE_CODE in your settings to make it work. Moreover, if you want to enable on-demand language switching, you have to enable i18n URLS too.

@Nad/: There's a Typo in the names of the models (Tranlation instead of TranSlation) Btw, thanks for sharing this snippet!-)

Please login first before commenting.

Admin Apps Names Translation

More like this

Comments