Skip to content

Latest commit

 

History

History
65 lines (46 loc) · 1.93 KB

readme.md

File metadata and controls

65 lines (46 loc) · 1.93 KB
Raw

Radiant Paginate Extension

About

An extension by Aissac that provides pagination support to Radiant CMS.

Tested on Radiant 0.7.1, 0.8 and 0.9 RC1

Features

Uses will_paginate plugin to iterate over children of a Page with pagination options:

  • Specify number children per page
  • Ordering by a specific page attribute and order direction
  • Conditionally render content for first page
  • Render pagination links customizable from the Radius tag (specify next/prev label, DOM class, inner and outer window etc.)

Installation

The Radiant Paginate Extension has one dependency: the 'will_paginate' gem/plugin

git clone git://github.com/mislav/will_paginate.git vendor/plugins/will_paginate

or

sudo gem install mislav-will_paginate --source http://gems.github.com

Then install the Radiant Paginate Extension:

git clone git://github.com/Aissac/radiant-paginate-extension.git vendor/extensions/paginate

Configuration

Because the archived pages urls may not be processed properly, it is recommended to set Radiant::Config['paginate.url_route'] to something like page-

Radiant['paginate.url_route'] = 'page-'

Usage

###Available Tags

  • See the "available tags" documentation built into the Radiant page admin for more details.
  • Use the <r:paginate:each> / to render the content for each child of the current page.
  • Use the <r:paginate:each:if_first /> to expand when this is the first child
  • Use the <r:paginate:each:unless_first /> to expand when this is not the first child
  • Use the <r:paginate:pages /> to render the pagination links with will_paginate.

Contributors

  • Istvan Hoka (@ihoka)
  • Benny Degezelle
  • Jim Gay
  • Andrew Neil
  • Michael Kessler
  • Cristi Duma (@cristi_duma)