<h1>Django Categories v 1.0<aclass="headerlink"href="#django-categories-v-version"title="Permalink to this headline">¶</a></h1>
<p>Django Categories grew out of our need to provide a basic hierarchical taxonomy management system that multiple applications could use independently or in concert.</p>
<p>As a news site, our stories, photos, and other content get divided into “sections” and we wanted all the apps to use the same set of sections. As our needs grew, the Django Categories grew in the functionality it gave to category handling within web pages.</p>
<divclass="section"id="new-in-1-0">
<h2>New in 1.0<aclass="headerlink"href="#new-in-1-0"title="Permalink to this headline">¶</a></h2>
<dlclass="docutils">
<dt><strong>Abstract Base Class for generic hierarchical category models</strong></dt>
<dd><pclass="first">When you want a multiple types of categories and don’t want them all part of the same model, you can now easily create new models by subclassing <ttclass="docutils literal"><spanclass="pre">CategoryBase</span></tt>. You can also add additional metadata as necessary.</p>
<p>Your model’s can subclass <ttclass="docutils literal"><spanclass="pre">CategoryBaseAdminForm</span></tt> and <ttclass="docutils literal"><spanclass="pre">CategoryBaseAdmin</span></tt> to get the hierarchical management in the admin.</p>
<pclass="last">See the docs for more information.</p>
</dd>
<dt><strong>Increased the default caching time on views</strong></dt>
<dd>The default setting for <ttclass="docutils literal"><spanclass="pre">CACHE_VIEW_LENGTH</span></tt> was <ttclass="docutils literal"><spanclass="pre">0</span></tt>, which means it would tell the browser to <em>never</em> cache the page. It is now <ttclass="docutils literal"><spanclass="pre">600</span></tt>, which is the default for <aclass="reference external"href="https://docs.djangoproject.com/en/1.3/ref/settings/#cache-middleware-seconds">CACHE_MIDDLEWARE_SECONDS</a></dd>
<dt><strong>Updated for use with Django-MPTT 0.5</strong></dt>
<dd>Just a few tweaks.</dd>
<dt><strong>Initial compatibility with Django 1.4</strong></dt>
<dd>More is coming, but at least it works.</dd>
<dt><strong>Slug transliteration for non-ASCII characters</strong></dt>
<dd>A new setting, <ttclass="docutils literal"><spanclass="pre">SLUG_TRANSLITERATOR</span></tt>, allows you to specify a function for converting the non-ASCII characters to ASCII characters before the slugification. Works great with <aclass="reference external"href="http://pypi.python.org/pypi/Unidecode">Unidecode</a>.</dd>
</dl>
</div>
<divclass="section"id="contents">
<h2>Contents<aclass="headerlink"href="#contents"title="Permalink to this headline">¶</a></h2>
<liclass="toctree-l2"><aclass="reference internal"href="getting_started.html#connecting-your-model-with-django-categories">Connecting your model with Django-Categories</a></li>
</ul>
</li>
<liclass="toctree-l1"><aclass="reference internal"href="usage.html">Using categories in templates</a><ul>
<liclass="toctree-l2"><aclass="reference internal"href="registering_models.html#registering-models-in-settings-py">Registering models in settings.py</a></li>
<liclass="toctree-l2"><aclass="reference internal"href="registering_models.html#registering-a-many-to-one-relationship">Registering a many-to-one relationship</a></li>
<liclass="toctree-l2"><aclass="reference internal"href="registering_models.html#registering-a-many-to-many-relationship">Registering a many-to-many relationship</a></li>
