calloway introduction

It builds the boring stuff,

so you can build the cool stuff

Friday, June 25, 2010

Websites are mostly

“infrastructure”

The fun stuff

Caching

Taxonomies

Media Handling

Staff Management

User Management

Server Configuration

Unique

Features

The boring stuff


Web teams

have their own ways of

doing things


A builder of boring stuff for

opinionated developers

Calloway


Principles

• Integration without dependency

• User interface for content managers is

important

• Easy customization through overrides

and fallbacks

• So simple a designer could do it


Integration Without

Dependency


if 'staff' in global_settings.INSTALLED_APPS: from staff.models import StaffMember as AuthorModelelse: from django.contrib.auth.models import User as AuthorModel

from django.conf import settingsfrom django.db.models import get_modelAUTHOR_MODEL = getattr(settings, 'STORY_AUTHOR_MODEL', 'auth.user')AuthorModel = get_model(AUTHOR_MODEL.split('.'))

authors = models.ManyToManyField(AuthorModel, verbose_name=_('Authors'), blank=True, null=True)

Dynamic Relations

Integrate with

another app, if

available.

Or allow the

developer to

decide.

Either way,

implementation is

still simple.


if 'categories' in global_settings.INSTALLED_APPS: HAS_CATEGORIES = True from categories.fields import CategoryM2MField, CategoryFKFieldelse: HAS_CATEGORIES = False

if HAS_CATEGORIES: primary_category = CategoryFKField( related_name='primary_story_set') categories = CategoryM2MField(blank=True)

Optional Features


Other Add-ons

Rich Text Editing

Positioning of

content

Some applications can simply augment

others, without modification


User Interface for

Content Managers is

Important


You can make your own dashboard modules


Menus are easily

customized by project


We took the edit inline to a new level


Still a few CSS issues

The quick edit form is specified in admin.py


Icon sets are included!


A lightbox view of images only makes sense


Many-to-Many Generic Relations


Allows for different presentations...


...of related content


Easy customizations

through overrides and

fallbacks


Overriding Settings

Calloway settings.py

ADMIN_MEDIA_PREFIXAPPEND_SLASH

AUTHENTICATION_BACKENDSMEDIA_ROOT

MIDDLEWARE_CLASSESROOT_URLCONFSITE_ID

TEMPLATE_CONTEXT_PROCESSORS


Overriding Settings

Project settings.py

from calloway.settings import *


from local_settings import *


ADMIN_MEDIA_PREFIXAPPEND_SLASH





Overriding Settings

Project settings.py

from calloway.settings import *


from local_settings import *


ADMIN_MEDIA_PREFIX APPEND_SLASH




local_settings.py

MEDIA_ROOT


So simple a designer

could do it

talented


Calloway App

Pieces of Calloway

Internal snippets

Default Templates

Default Settings

External App

References

Project Creation

Template Project

start_project.py


Typical Workflow

• Execute start_project.py

• Answer questions

• Modify application bundles in INSTALLED_APPS

• Execute generate_reqs

• Execute pip install -r setup/requirements.txt


Details

• In production, but still a bit alpha

• Apache 2.0 license

• www.callowayproject.com

• github.com/callowayproject


More Details

• [email protected], @coordt

• opensource.washingtontimes.com

• github.com/coordt

• github.com/washingtontimes


calloway introduction

Technology