Skip to main content

News Item content type for Kotti

Project description

build status production

News Item content type for Kotti.

This package provides:

  • a NewsItem content type that is just a Document with a different default view,

  • a news_listing view that provides an alternative default view for Document, for listing most recent published NewsItems on a full-page style display,

  • a RecentNews widget for showing most recent published NewsItems in a slot, and

  • an all_news view that shows ALL News Items in your site, chronologically ordered.

Find out more about Kotti

Setup

To activate the kotti_newsitem add-on in your Kotti site, you need to add an entry to the kotti.configurators setting in your Paste Deploy config. If you don’t have a kotti.configurators option, add one. The line in your [app:main] (or [app:kotti], depending on how you setup Fanstatic) section could then look like this:

kotti.configurators = kotti_newsitem.kotti_configure

Configuration

A good approach for managing news items on your site is to make a private container document for holding the actual news items. It is a good idea to organize them somehow, as by year:

news-items
    2013
        news-item-foo
        news-item-bar
        ...
    2014
        ...

This is primarily to help the content creator organize content, but it could also be used as a “manual” way of presenting news items if published. Display of most recent news items can be done either by selecting News Listing for the default view of a Document, or by using the recent news widget in a slot.

News Listing

For a full-page listing of most recent news items, add a Document, usually at the top-level of your site and titled “News”, and set its default view to News Listing. Control the number of recent items shown with:

kotti_newsitem.num_news = 10

At the bottom of the list of news items, regardless of the number of recent news items listed, is a link to a page for All News, where all news items are shown.

Recent News Widget

If you want the RecentNews widget to show up in your site in a slot, either in place of a dedicated full-page news listing or to augment it, you have to add a line like this to enable the recent news widget:

kotti_newsitem.widget.slot = right

The for a list of available slots in a default Kotti site see the kotti.view.slots API docs

To change the default number of recent news items shown in the widget (5), add a line like this:

kotti_newsitem.widget.num_news = 10

Development

build status master

Contributions to kotti_newsitem are highly welcome. Just clone its Github repository and submit your contributions as pull requests.

Changelog

0.2

  • Added a full-page style news listing. [geojeff]

0.1

  • Initial release. [disko]

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

kotti_newsitem-0.2.tar.gz (9.8 kB view hashes)

Uploaded Source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page