jbouzekri/sculpin-date-navigation-bundle

Generate date navigation block (with pages) in Sculpin

1.0.0 2014-07-13 23:27 UTC

This package is auto-updated.

Last update: 2024-10-12 19:28:12 UTC


README

Generate date navigation block (with pages) in Sculpin :

  • It generates pages listing posts for each year and couple year/month
  • And a block to navigate between this pages

You can see a working demo on the right column of my personal french blog.

Installation

Using composer, add the dependancy to your composer.json :

require: {
    "jbouzekri/sculpin-date-navigation-bundle": "1.*"
}

And run the composer update command

Enable the bundle. If you have already have an app/SculpinKernel.php, add this bundle to it otherwise create the file with the following content :

<?php

class SculpinKernel extends \Sculpin\Bundle\SculpinBundle\HttpKernel\AbstractKernel
{
    protected function getAdditionalSculpinBundles()
    {
        return array(
            'Jb\Bundle\DateNavigationBundle\JbDateNavigationBundle'
        );
    }
}

Then you need to add the date page html and the date navigation block html to your project :

  • Copy the Resources/html/include/date_navigation.html file in the _includes folder of your source
  • Copy the Resources/html/page/date.html file in the blog folder of your source (or any other html folder you use). For information, a date_paginated.html template is available for paginated date page.

Usage

In a template, you can now call the following twig function :

{{ date_navigation(page) }}

It will generate the date navigation html.

You can specify a custom template :

{{ tag_cloud(page, 'my_template.html') }}

Configuration

jb_date_navigation:
    permalink_year: /:year/index.html
    permalink_month: /:year/:month/index.html
  • jb_date_navigation.permalink_year : the url mask for the date year page
  • jb_date_navigation.permalink_month : the url mask for the date month page

License

MIT