Views¶

class ella.core.views.ListContentType¶

List objects’ listings according to the parameters. If no filtering is applied (including pagination), the category’s title page is rendered:

• page/category/<tree_path>/category.html
• page/category.html

Otherwise an archive template gets rendered:

• page/category/<tree_path>/content_type/<app>.<model>/listing.html
• page/category/<tree_path>/listing.html
• page/content_type/<app>.<model>/listing.html
• page/listing.html

The context contains:

• category
• listings: list of Listing objects ordered by date and priority
• page: django.core.paginator.Page instance
• is_paginated: True if there are more pages
• results_per_page: number of objects on one page
• content_type: ContentType of the objects, if filtered on content type
• content_type_name: name of the objects’ type, if filtered on content type

Parameters:	category – tree_path of the Category, root category is used if empty year, month, day – date matching the publish_from field of the Listing object. content_type – slugified verbose_name_plural of the target model, if omitted all content_types are listed page_no – which page to display paginate_by – number of records in one page

All parameters are optional, filtering is done on those supplied

Raises Http404:	if the specified category or content_type does not exist or if the given date is malformed.

class ella.core.views.ObjectDetail¶

Renders a page for placement. If url_remainder is specified, tries to locate custom view via DetailDispatcher.call_view(). If DetailDispatcher.has_custom_detail() returns True, calls DetailDispatcher.call_custom_detail(). Otherwise renders a template with context containing:

• placement: Placement instance representing the URL accessed
• object: Publishable instance bound to the placement
• category: Category of the placement
• content_type_name: slugified plural verbose name of the publishable’s content type
• content_type: ContentType of the publishable

The template is chosen based on the object in question (the first one that matches is used):

• page/category/<tree_path>/content_type/<app>.<model>/<slug>/object.html
• page/category/<tree_path>/content_type/<app>.<model>/object.html
• page/category/<tree_path>/object.html
• page/content_type/<app>.<model>/object.html
• page/object.html

Note

The category being used in selecting a template is taken from the object’s Placement, thus one object published in many categories (even sites) can have a different template every time.

Parameters:	request – HttpRequest from Django category – Category.tree_path (empty if home category) content_type – slugified verbose_name_plural of the target model year month day – date matching the publish_from field of the Placement object slug – slug of the Placement url_remainder – url after the object’s url, used to locate custom views in custom_urls.dispatcher
Raises Http404:	if the URL is not valid and/or doesn’t correspond to any valid Placement