Provides the basic section objects
Project description
Provides the basic concept of sections within an Armstrong site.
You can use Section models to organize your content into a group. Sections can have a parent section to allow you to create a hierarchy. For example, the Texas Tribune has an Immigration section which in turns has Sanctuary Cities and Dream Act as children sections.
You are not limited to a hierarchical structure—you can create a flat structure as well.
Usage
You need to add a section field to any model that you would like to show up in a given section. For example:
# your models.py
from django.db import models
from armstrong.core.arm_sections.models import Section
class MyArticle(models.Model):
title = models.CharField(max_length=100)
body = models.TextField()
section = models.ForeignKey(Section)
You can also relate to multiple sections as well through a ManyToManyField:
class MyArticle(models.Model):
# other fields
sections = models.ManyToManyField(Section)
Displaying Sections
You can display a section through the SimpleSectionView class-based-view (CBV). The standard project template in Armstrong provides an example of how to configure this view.
url(r'^section/(?P<full_slug>[-\w/]+)',
SimpleSectionView.as_view(template_name='section.html'),
name='section_view'),
You can use the {% section menu %} template tag to display list of all sections inside your template. You must load the section_helpers template tags to use this. You must provide it with a section_view kwarg that is associated with the section view you configure inside your URL routes. For example, to display a list of sections that link to the section view created above, you would put this in your template.
{% load section_helpers %}
{% section_menu section_view='section_view' %}
With the following sections in your database:
Politics
Sports
Football
Basketball
Fashion
Using all of the example we have so far, the output from your template would look like this:
<ul class="root">
<li>
<a href='/section/politics/'>Politics</a>
</li>
<li>
<a href='/section/sports/'>Sports</a>
<ul class="children">
<li>
<a href='/section/sports/football/'>Football</a>
</li>
<li>
<a href='/section/sports/basketball/'>Basketball</a>
</li>
</ul>
</li>
<li>
<a href='/section/fashion/'>Fashion</a>
</li>
</ul>
Installation & Configuration
We recommend installing this through the Cheese Shop.
pip install armstrong.core.arm_sections
This gets you the latest released version of armstrong.core.arm_sections.
Configuration
There are two setting that you can use to change the behavior of this component.
- ARMSTRONG_SECTION_ITEM_BACKEND
This is used to configure which backend is used to find the items associated with a given Section. (default: armstrong.core.arm_sections.backend.ItemFilter)
- ARMSTRONG_SECTION_ITEM_MODEL
This is used by the default find_related_models backend to determine which model has a section associated with it. (default: armstrong.apps.content.models.Content)
Contributing
Create something awesome – make the code better, add some functionality, whatever (this is the hardest part).
Create a topic branch to house your changes
Get all of your commits in the new topic branch
Submit a pull request
State of Project
Armstrong is an open-source news platform that is freely available to any organization. It is the result of a collaboration between the Texas Tribune and Bay Citizen, and a grant from the John S. and James L. Knight Foundation.
To follow development, be sure to join the Google Group.
armstrong.core.arm_section is part of the Armstrong project. You’re probably looking for that.
License
Copyright 2011 Bay Citizen and Texas Tribune
Licensed under the Apache License, Version 2.0 (the “License”); you may not use this file except in compliance with the License. You may obtain a copy of the License at
Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an “AS IS” BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
File details
Details for the file armstrong.core.arm_sections-1.5.4.tar.gz.
File metadata
- Download URL: armstrong.core.arm_sections-1.5.4.tar.gz
- Upload date:
- Size: 21.2 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 36b8752c8e0e0ddbcae64d3987ef8d03dc16337ec535a541b2379ad2cdad2333 |
|
| MD5 | 68742cc532c9c6c0a64d354b041e8846 |
|
| BLAKE2b-256 | 780f717281fa2bb23892ca4a409b48a6ebdc5988408a3e4a8398ee686946e44f |
