Skip to content


Subversion checkout URL

You can clone with
Download ZIP
Base content wells for Armstrong
Python Other

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.



Provides the basic content well code necessary for scheduling and arranging models inside ArmstrongCMS. Conceptually, a well is an ordered grouping of content that can expire.


This is development level software. Please do not unless you are familiar with what that means and are comfortable using that type of software.


pip install -e git://$NAME.git#egg=$NAME


Wells utilize GenericForeignKeys to associate content with themselves, so any model can be placed in a well, regardless of if it inherits from armstrong.core.arm_content.models.ContentBase

Wells can also be backed by a queryset which will be used as a source of additional content after all items have been exhausted. Currently, this is not configurable via the admin, but is easily accomplished by using the QuerySetBackedWellView. In your

url(r'^$', QuerySetBackedWellView.as_view(well_title='front_page',
# get's the current 'front_page' well, backs it with Article.published.all()
# and renders the index.html page

To render a well we recommend using the armstrong.core.arm_layout module. This will allow simple templates to handle heterogenous content. For instance, to render ever item in a well using the 'standard' layout:

{% load layout_helpers %}
{% for content in well.items %}
    {% render_model content 'standard' %}
{% endfor %}


  • Create something awesome -- make the code better, add some functionality, whatever (this is the hardest part).
  • Fork it
  • 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. The first release is scheduled for June, 2011.

To follow development, be sure to join the Google Group.

armstrong.core.arm_wells is part of the Armstrong project. You're probably looking for that.


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.

Something went wrong with that request. Please try again.