Newcomen

Description A static content generator.
Newcomen > Perl Modules > Newcomen::Plugin::Blog::Index::Defaults
Source

Index


NAME ^

Newcomen::Plugin::Blog::Index::Defaults - Sets some defaults for index pages.

DESCRIPTION ^

This plugin will add default formatters for all content on index pages, and set renderer and writer for these index pages (unless a renderer/writer is already set).

The default formatter(s) will always be added to all Newcomen::Content instances on a page with a creator ID starting with 'Blog::Index::', early during the hook_formatters() hook (see HOOKS). However, formatters will not be added twice, if a formatter of the same name already exists in the content's formatter list, it will not be added again.

The default renderer and writer will be set for all Newcomen::Page instances with a creator ID starting with 'Blog::Index::', unless a renderer or writer is already set for the page. This will be done late during the hook_renderer()/hook_writer() hook, respectively. See HOOKS.

OPTIONS ^

{
   'blog'                => {
      'index'            => {
         'defaults'      => {
            'ascending'  => undef,
            'per_page'   => undef,
            'page_info'  => {},
            'formatters' => undef,
            'renderer'   => undef,
            'writer'     => undef,
         },
      },
   },
}

These are the default options set by this plugin. They may be overridden by user configuration.

The options blog/index/defaults/formatters, blog/index/defaults/renderer and blog/index/defaults/writer work like described in Newcomen::Plugin::Blog::Defaults, please see there for details.

blog/index/defaults/per_page is a default setting for the number of articles per index page.

blog/index/defaults/ascending is a default setting for the order of articles on the index pages.

blog/index/defaults/page_info may contain defaults for additional information to be stored in the pages' meta data. This has to be a hashref (may be empty).

It is up to the individual index plugins to respect these last three settings, see the plugins' documentation for details.

HOOKS ^

This plugin implements the following hooks: hook_formatters() (priority 300), hook_renderer() (priority 700) and hook_writer() (priority 700).

SEE ALSO ^

Newcomen::Content, Newcomen::Page, Newcomen::Plugin::Blog::Defaults

VERSION ^

This is version 2014052501.

AUTHOR ^

Stefan Goebel - newcomen {at} subtype {dot} de

COPYRIGHT AND LICENSE ^

Copyright 2013-2014 Stefan Goebel.

This file is part of Newcomen.

Newcomen is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the license, or (at your option) any later version.

Newcomen is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with Newcomen. If not, see <http://www.gnu.org/licenses/>.