{-# LANGUAGE QuasiQuotes #-}
{-# LANGUAGE OverloadedStrings #-}
{-# LANGUAGE FlexibleContexts #-}
{-# LANGUAGE TypeFamilies #-}
-------------------------------------------------------------------------------
-- |
--
-- Inspiration from a concept by ajdunlap:
-- <http://hackage.haskell.org/package/yesod-paginate>
--
-- But uses an entirely different approach.
--
-- There are two pagination functions. One for arbitrary items where you
-- provide the list of things to be paginated:
--
-- > getSomeRoute = do
-- > things' <- getAllThings
-- >
-- > (things, widget) <- paginate 10 things'
-- >
-- > defaultLayout $ do
-- > [whamlet|
-- > $forall thing <- things
-- > ^{showThing thing}
-- >
-- > <div .pagination>
-- > ^{widget}
-- > |]
--
-- And another for paginating directly out of the database, you provide
-- the same filters as you would to @selectList@.
--
-- > getSomeRoute something = do
-- > -- note: things is [Entity val] just like selectList returns
-- > (things, widget) <- runDB $ selectPaginated 10 [SomeThing ==. something] []
-- >
-- > defaultLayout $ do
-- > [whamlet|
-- > $forall thing <- things
-- > ^{showThing $ entityVal thing}
-- >
-- > <div .pagination>
-- > ^{widget}
-- > |]
--
-- Both functions return a tuple: the first element being the list of
-- items (or Entities) to display on this page and the second being a
-- widget showing the pagination navagation links.
--
-------------------------------------------------------------------------------
module Yesod.Paginator
( paginate
, paginateWith
, selectPaginated
, selectPaginatedWith
, module Yesod.Paginator.Widget
) where
import Yesod
import Yesod.Paginator.Widget
paginate :: Yesod m => Int -> [a] -> HandlerT m IO ([a], WidgetT m IO ())
paginate = paginateWith defaultWidget
paginateWith :: Yesod m
=> PageWidget m
-> Int
-> [a]
-> HandlerT m IO ([a], WidgetT m IO ())
paginateWith widget per items = do
p <- getCurrentPage
let tot = length items
let xs = take per $ drop ((p - 1) * per) items
return (xs, widget p per tot)
selectPaginated :: ( PersistEntity val
, (PersistQuery (YesodPersistBackend m (HandlerT m IO)))
, (PersistMonadBackend (YesodPersistBackend m (HandlerT m IO)) ~ PersistEntityBackend val)
, (MonadTrans (YesodPersistBackend m))
, Yesod m
)
=> Int
-> [Filter val]
-> [SelectOpt val]
-> YesodDB m ([Entity val], WidgetT m IO ())
selectPaginated = selectPaginatedWith defaultWidget
selectPaginatedWith :: ( PersistEntity val
, (PersistQuery (YesodPersistBackend m (HandlerT m IO)))
, (PersistMonadBackend (YesodPersistBackend m (HandlerT m IO)) ~ PersistEntityBackend val)
, (MonadTrans (YesodPersistBackend m))
, Yesod m
)
=> PageWidget m
-> Int
-> [Filter val]
-> [SelectOpt val]
-> YesodDB m ([Entity val], WidgetT m IO ())
selectPaginatedWith widget per filters selectOpts = do
p <- lift getCurrentPage
tot <- count filters
xs <- selectList filters (selectOpts ++ [OffsetBy ((p-1)*per), LimitTo per])
return (xs, widget p per tot)