Added more information to index

This commit is contained in:
Brandon Taylor
2014-08-20 23:34:31 -04:00
parent 279ce2e71f
commit e43d7d67c2
14 changed files with 345 additions and 6 deletions
+26
View File
@@ -102,6 +102,32 @@
</div>
<p>Add <code class="docutils literal"><span class="pre">adminsortable</span></code> to your project&#8217;s <code class="docutils literal"><span class="pre">INSTALLED_APPS</span></code> setting.</p>
<p>Ensure <code class="docutils literal"><span class="pre">django.core.context_processors.static</span></code> is in your <code class="docutils literal"><span class="pre">TEMPLATE_CONTEXT_PROCESSORS</span></code> setting.</p>
<p>Define your model, inheriting from <code class="docutils literal"><span class="pre">adminsortable.Sortable</span></code>:</p>
<div class="highlight-python"><div class="highlight"><pre><span class="c"># models.py</span>
<span class="kn">from</span> <span class="nn">adminsortable.models</span> <span class="kn">import</span> <span class="n">Sortable</span>
<span class="k">class</span> <span class="nc">MySortableClass</span><span class="p">(</span><span class="n">Sortable</span><span class="p">):</span>
<span class="k">class</span> <span class="nc">Meta</span><span class="p">(</span><span class="n">Sortable</span><span class="o">.</span><span class="n">Meta</span><span class="p">):</span>
<span class="k">pass</span>
<span class="n">title</span> <span class="o">=</span> <span class="n">models</span><span class="o">.</span><span class="n">CharField</span><span class="p">(</span><span class="n">max_length</span><span class="o">=</span><span class="mi">50</span><span class="p">)</span>
<span class="k">def</span> <span class="nf">__unicode__</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
<span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">title</span>
</pre></div>
</div>
<p>Wire up your sortable model to Django admin:</p>
<div class="highlight-python"><div class="highlight"><pre><span class="c"># admin.py</span>
<span class="kn">from</span> <span class="nn">adminsortable.admin</span> <span class="kn">import</span> <span class="n">SortableAdmin</span>
<span class="kn">from</span> <span class="nn">.models</span> <span class="kn">import</span> <span class="n">MySortableClass</span>
<span class="k">class</span> <span class="nc">MySortableAdminClass</span><span class="p">(</span><span class="n">SortableAdmin</span><span class="p">):</span>
<span class="sd">&quot;&quot;&quot;Any admin options you need go here&quot;&quot;&quot;</span>
<span class="n">admin</span><span class="o">.</span><span class="n">site</span><span class="o">.</span><span class="n">register</span><span class="p">(</span><span class="n">MySortableClass</span><span class="p">,</span> <span class="n">MySortableAdminClass</span><span class="p">)</span>
</pre></div>
</div>
<p>Your model&#8217;s ChangeList view should now have an extra tool link when there are 2 or more objects present that will take you to a view where you can drag-and-drop the objects into your desired order.</p>
</div>