In this blog post I will explain how you can get the name of the months in your calendar view pager instead of the default "prev" and "next" links.


In this blog post I will explain how you can get the name of the months in your calendar view pager instead of the default "prev" and "next" links. The view that is used in this example is a really basic view that can be build with the calendar module for Drupal 7. If you need help setting one up, check the links on the module page, or try the video's at

The goal

This is the default output of a monthly view with a "page by date" pager:

default calendar pager output

And this is what we're trying to achieve: month names as pager

If you're in a rush, and don't want to know what's going on, skip to the code directly!

The steps

There are three steps to achieve this:

  1. override pager theme function in template.php
  2. create a tpl.php file for the pager
  3. add some css for proper alignment

Step 1: Override pager theme function in template.php

In your theme's template.php add a function named MYTHEME_preprocess_date_views_pager(&$vars). This function should contain the following code:

All code upto line 130 is copy & paste from of the date_views module. The magic happens after that.

  // Get the date information from the view.
  $date_info = $view->date_info;

  // Choose the dislpay format of the month name.
  $format = 'F';

  // Get the previous month.
  $dateString = $date_info->min_date;
  $prev_month = new DateTime($dateString);
  $prev_month->modify('-1 month');
  $prev_pager_title = format_date($prev_month->getTimestamp(), 'custom', $format);
  $vars['prev_title'] = $prev_pager_title;

  // Get the next month.
  $next_month = new DateTime($dateString);
  $next_month->modify('+1 month');
  $next_pager_title = format_date($next_month->getTimestamp(), 'custom', $format);
  $vars['next_title'] = $next_pager_title;

This snippet of code adds two new variables to the $vars array: prev_title and next_title. Now we're going to use those two variables in the template file.

Step 2: Create a tpl.php file for the pager

Create a file called date-views-pager.tpl.php in your theme's temlpates directory (e.g. sites/all/themes/MYTHEME/templates/date-views-pager.tpl.php). The code in this template file is based on date_views date-views-pager.tpl.php. This uses the $prev_title and $next_title to create links with the month names for the pager.

Step 3: Add some css for proper alignment

The final step in the process is to add some css. By default, the pager is aligned to the right and the prev link is positioned absolutely to appear left of the next link.

.view .date-nav-wrapper .date-prev {
  -moz-border-radius: 5px 0 0 5px;
  border-radius: 5px 0 0 5px;
  background: none repeat scroll 0 0 #dfdfdf;
  float: none;
  padding: 5px 0;
  position: absolute;
  right: 60px;
  left: auto;
  text-align: right;
  top: 0px;
  width: auto;
  z-index: 1;
  font-size: 12px;

This will not work in our new pager setup, as the titles for the link don't have a fixed width (e.g. may is shorter then november).
To fix this, add the following snippet to your MYTHEME.css file: This piece of css resets the default alignment css & positions the .pager container to the right.

The code

If you followed along in the previous steps, you're done!
But if you don't like typing, or skipped straight ahead to this part, you can get all the code you need from the GitHub snippet page

That's it, hope you find it useful! Used it or modified it? Let me know in the comments :)

comments powered by Disqus