Skip to content

Latest commit

 

History

History
53 lines (33 loc) · 1.51 KB

README.rst

File metadata and controls

53 lines (33 loc) · 1.51 KB

django-hvad

This project is yet another attempt at making model translations suck less in Django.

Documentation for django-hvad can be found at http://django-hvad.readthedocs.org/.

This project provides the same functionality as django-nani, but it as opposed to django-nani, this project does not affect the default queries, which means that everything will continue to work as it was before.

You have to activate the translated fields, by calling a specific method on the manager.

Warning

django-hvad is still in beta, please use it with caution and report any bug(s) you might encounter.

Feel free to join us at #django-hvad on irc.freenode.net for a chat

https://secure.travis-ci.org/KristianOellegaard/django-hvad.png?branch=master

Example

Normal.objects.all()

Returns all objects, but without any translated fields attached - this query is just the default django queryset and can therefore be used as usual.

Normal.objects.language().all()

Returns all objects as translated instances, but only the ones that are translated into the currect language. You can also specify which language to get, using e.g.

Normal.objects.language("en").all()

Features

  • Simple API
  • Predictable
  • Reliable
  • Fast (few and simple queries)
  • High level (no custom SQL Compiler or other scary things)

Thanks to

Jonas Obrist (https://github.com/ojii) for making django-nani and for helping me with this project.