Overhauled

In the meantime a new version of the gallery has been submitted by Steffen Kamper, including fixes and a pagebrowser. So this version is overhauled, but can still be used of an example of customization

A simple pagebrowser for sk-simplegallery

Opens external link in new window Steffen Kamper has written an editor - friendly picture gallery called Initiates file download sk-simplegallery. But without a pagebrowser. So if you have many images in your picture gallery the user has to load every image. This takes time and needs space. Because of a client request I have programmed a very simple pagebrowser for this extension. You can download the customized version here (sk-simplegallery including the pagebrowser).

: Setting up the SingleView

Setting up the extension

The pagebrowser is set up by TypoScript in templates, only the entries per page - option is customizable by the backend forms. All options but four set up by TypoScript are located under pagebrowser. Those two, which are not located under pagebrowser, are located under singleView. So lets see a TypoScript example setting up the gallery sk-simplegallery:

TypoScript Setup

plugin.tx_sksimplegallery_pi1 {
    templateFile = path-to-your-template

    popupBodyTag = <body leftmargin="0" topmargin="0" marginwidth="0" marginheight="0">
    captionWrap = <p style="font: 0.9em 'palatino', arial, helvetica, sans-serif;padding:10px;">|</p>

    singleView {
        entriesPP = 9
        entriesPerLine = 3
        line_start = <tr>
        line_end = </tr>
    }

    pageBrowser {
        activePageWrap = <span class="activePage">|</span>
        pageWrap = <span class="page">|</span>

        nextLinkWrap = <span class="nextLink">|</span>
        previousLinkWrap = <span class="previousLink">|</span>
        inactiveNextLinkWrap = <span class="inactiveNextLink">|</span>
        inactivePreviousLinkWrap = <span class="inactivePreviousLink">|</span>

        jumpFirstPageWrap = <span class="jumpToFirst">|</span>
        jumpLastPageWrap = <span class="jumpToLast">|</span>
        inactiveJumpFirstPageWrap = <span class="inactiveJumpToFirst">|</span>
        inactiveJumpLastPageWrap = <span class="inactiveJumpToLast">|</span>

        showInactiveLinks = 1
    }
    captionHeight = 100
    general_stdWrap >
}

The only lines added by me are:

TypoScript Setup

plugin.tx_sksimplegallery_pi1 {
    singleView {
        entriesPP = 9
        entriesPerLine = 3
        line_start = <tr>
        line_end = </tr>
    }

    pageBrowser {
        activePageWrap = <span class="activePage">|</span>
        pageWrap = <span class="page">|</span>

        nextLinkWrap = <span class="nextLink">|</span>
        previousLinkWrap = <span class="previousLink">|</span>
        inactiveNextLinkWrap = <span class="inactiveNextLink">|</span>
        inactivePreviousLinkWrap = <span class="inactivePreviousLink">|</span>

        jumpFirstPageWrap = <span class="jumpToFirst">|</span>
        jumpLastPageWrap = <span class="jumpToLast">|</span>
        inactiveJumpFirstPageWrap = <span class="inactiveJumpToFirst">|</span>
        inactiveJumpLastPageWrap = <span class="inactiveJumpToLast">|</span>

        showInactiveLinks = 1
    }
}

What...?!

In the section singleView you can find entriesPP, entriesPerLine, line_start and line_end. Now what are they for?

entriesPP: entries per page. This allows you to configure how many items are shown per page. If the number of images is smaller than the allowed entries per page, the pagebrowser won't be shown.
entriesPerLine: how many images per line are shown. In combination with line_start and line_end this allows you to use a table based layout.
line_start: the string shown at the beginning of each line (if you are using a table layout, use <tr>)
line_end: the string shown at the end of each line (if you are using a table layout, use </tr>)

The section pagebrowser mainly consits of wraps. The syntax of the wraps is the same as it is for the standard wrap element in TS:

textbeforewrap | textafterwrap : the "|" is replaced with the content

So let's look at the items in pagebrowser:

activePageWrap: the wrap of the number of the current page
pageWrap: the standard wrap of pagenumbers
nextLinkWrap: the wrap of the text of the link to the next page
previousLinkWrap: the wrap of the text of the link to the previous page
jumpFirstPageWrap: the wrap for the text of the link to the first page (<<)
jumpLastPageWrap: the wrap for the text of the link to the last page (>>)
showInactiveLinks (boolean): if true, the links "next page", "previous page", "first page" and "last page" are always visible (but as text). if false, "last page" is hidden if you are at the last page and so on...
inactiveNextLinkWrap, inactivePreviousLinkWrap, inactiveJumpFirstPageWrap, inactiveJumpLastPageWrap: if showInactiveLinks is true, these are the wraps for the links explained before if they are no links (if you are at the last page, "last page" won't be a link anymore).

Example

You can find an Opens internal link in current window example of the customized extension sk-simplegallery on this page.

Download

download the customized sk-simplegallery as extension file