Support Center

About Koken

This Help Center provides support for Koken, a free content management system designed for photographers, artists and designers.

Lens templates

Lens templates

Last Updated: Feb 24, 2015 10:06AM EST

Koken's Lens system uses a defined list of templates to display managed content. The following is a list of every Koken template and the relative URLs each are accessed through.

Template Description URL
album.lens Displays a single public or unlisted album. /albums/title/
albums.lens Displays all top public albums and sets. /albums/
archive.albums.lens Displays a list of all public albums and sets filtered by category, tag or creation date. /albums/year/month/day/
/albums/year/month/
/albums/year/
/albums/categories/category/
/albums/tags/tag/
/tags/tag/albums/
/categories/category/albums/
archive.contents.lens Displays a list of all public images and videos filtered by category, tag or creation date. /content/year/month/day/
/content/year/month/
/content/year/
/content/categories/category/
/content/tags/tag/
/tags/tag/content/
/categories/category/content/
archive.essays.lens Displays a list of all published essays filtered by category, tag or creation date. /essays/year/month/day/
/essays/year/month/
/essays/year/
/essays/categories/category/
/essays/tags/tag/
/tags/tag/essays/
/categories/category/essays/
categories.lens Displays a list of all categories. /categories/
category.lens Displays a unified list of all albums, content and essays assigned a particular category. /categories/category/
content.lens Displays a single public or unlisted image or video. /content/title/
/tags/tag/content/title/
/categories/category/content/title/
contents.lens Displays a list of all public images and videos. /content/
date.lens Displays events from a timeline day, month or year. /timeline/year/
/timeline/year/month/
/timeline/year/month/day/
error.lens Displays an error if a link isn't valid. /error/404/
essay.lens Displays a single essay. /essays/year/month/title/
essays.lens Displays a list of all published essays. /essays/
favorites.lens Displays a list of a favorite images and videos. /favorites/
index.lens Displays featured content. /
login.lens Login screen for password protected content. Password Protect plugin required. /login/
page.lens Displays a custom page. /pages/title/
set.lens Displays a single public or unlisted set. /sets/title/
sets.lens Displays all top public sets. /sets/
tag.lens Displays a unified list of all albums, content and essays assigned a particular tag. /tags/tag/
tags.lens Displays a list of all tags. /tags/
timeline.lens Displays a unified list of all albums, content and essays in chronological order by publication date. /timeline/

Note: Default link labels and URLs may be modified if you'd prefer a different scheme.

Which templates to include

Theme designers may decide which templates to include in their themes. Koken will display error.lens if a link isn't able to find a matching template. Our introduction to theme building article explains how to construct a basic site theme using the recommended set of baseline templates, then adds additional archive templates for more presentation options.

Loading template data

Every template uses the same basic structure:

<html>
  <body>
    <koken:load>
      <!-- Insert template tags/variables -->
    </koken:load>
  </body>
</html>

As its name implies, the <koken:load> template tag loads data. It is used to load a template's native data as well as specific data sources to publish more than one type of content on a single page.

Rendering template data

Data is rendered using Lens variables and tags. Some are global and may be used anywhere, while others may only be used within the scope of a particular type of loaded data.

Koken has four major types of data:

  • Content — An individual image or video.
  • Essay — An individual essay.
  • Album — An individual album or set.
  • Event — A timeline event.

Content Content

Below is example markup from each template that loads content. Lens variables and tags would be added to the commented areas.

content.lens

<html>
  <body>
    <koken:load>
      <!-- Content tags/variables -->
    </koken:load>
  </body>
</html>

album.lens / contents.lens / favorites.lens / index.lens / archive.contents.lens

<html>
  <body>
    <koken:load>
      <koken:loop>
        <!-- Content tags/variables -->
      </koken:loop>
    </koken:load>
  </body>
</html>

category.lens / date.lens / tag.lens / timeline.lens

<html>
  <body>
    <koken:load>
      <koken:event>
        <koken:event_content>
          <!-- Content tags/variables -->
        <koken:event_content>
      <koken:event>
    </koken:load>
  </body>
</html>

*.lens (any template)

<html>
  <body>
    <koken:load source="contents">
      <koken:loop>
        <!-- Content tags/variables -->
      </koken:loop>
    </koken:load>
  </body>
</html>

Essay Essay

Below is example markup from each template that loads essays. Lens variables and tags would be added to the commented areas.

essay.lens

<html>
  <body>
    <koken:load>
      <!-- Essay tags/variables -->
    </koken:load>
  </body>
</html>

essays.lens / archive.essays.lens

<html>
  <body>
    <koken:load>
      <koken:loop>
        <!-- Essay tags/variables -->
      </koken:loop>
    </koken:load>
  </body>
</html>

category.lens / date.lens / tag.lens / timeline.lens

<html>
  <body>
    <koken:load>
      <koken:loop>
        <koken:event>
          <koken:event_essay>
            <!-- Essay tags/variables -->
          <koken:event_essay>
        <koken:event>
      </koken:loop>
    </koken:load>
  </body>
</html>

*.lens (any template)

<html>
  <body>
    <koken:load source="essays">
      <koken:loop>
        <!-- Essay tags/variables -->
      </koken:loop>
    </koken:load>
  </body>
</html>

Album Album

Below is example markup from each template that loads albums. Lens variables and tags would be added to the commented areas.

album.lens

<html>
  <body>
    <koken:load>
      <!-- Album tags/variables -->
    </koken:load>
  </body>
</html>

albums.lens / sets.lens / set.lens / archive.albums.lens

<html>
  <body>
    <koken:load>
      <koken:loop>
        <!-- Album tags/variables -->
      </koken:loop>
    </koken:load>
  </body>
</html>

category.lens / date.lens / tag.lens / timeline.lens

<html>
  <body>
    <koken:load>
      <koken:loop>
        <koken:event>
          <koken:event_album>
            <!-- Album tags/variables -->
          </koken:event_album>
          <koken:event_album_update>
            <!-- Album tags/variables -->
          </koken:event_album_update>
        </koken:event>
      </koken:loop>
    </koken:load>
  </body>
</html>

*.lens (any template)

<html>
  <body>
    <koken:load source="albums">
      <koken:loop>
        <!-- Album tags/variables -->
      </koken:loop>
    </koken:load>
  </body>
</html>

Event Event

Below is example markup from each template that loads events. Lens variables and tags would be added to the commented areas.

category.lens / date.lens / tag.lens / timeline.lens

<html>
  <body>
    <koken:load>
      <koken:loop>
        <!-- Event tags/variables -->
      <koken:loop>
    </koken:load>
  </body>
</html>

*.lens (any template)

<html>
  <body>
    <koken:load source="timeline">
      <koken:loop>
        <!-- Event tags/variables -->
      </koken:loop>
    </koken:load>
  </body>
</html>

Where to from here

By now you should have a basic understanding of which Lens templates are available and how data is loaded and rendered. Ready to start building a theme? Head over to our introduction to theme building for the first in a four part series of articles that begins with step-by-step instructions to build a basic portfolio style theme, then continues by demonstrating how to add a variety of archival templates.

support@koken.me
http://assets1.desk.com/
false
koken
Loading
seconds ago
a minute ago
minutes ago
an hour ago
hours ago
a day ago
days ago
about
false
Invalid characters found
/customer/en/portal/articles/autocomplete