daun/statamic-latte

Use Latte templates on Statamic sites

1.2.0 2024-10-19 10:24 UTC

Requires

• php: ^8.1
• daun/laravel-latte: ^1.1.0
• laravel/framework: ^9.0 || ^10.0 || ^11.0
• statamic/cms: ^4.0 || ^5.0

Requires (Dev)

• larastan/larastan: ^2.9
• laravel/pint: ^1.14
• mockery/mockery: ^1.6
• orchestra/testbench: ^8.21
• pestphp/pest: ^2.34
• pestphp/pest-plugin-laravel: ^2.3
• spatie/ray: ^1.41

MIT

• Philipp Daun

• view
• nette
• latte
• statamic

README

Use the Latte templating language on Statamic sites.

✨ Features

• Render .latte views
• Use Statamic's built-in tags and modifiers
• Resolve the current layout from entry data
• Render Antlers inline where useful

🛠️ Installation

Run the following command from your project root:

composer require daun/statamic-latte

Alternatively, you can search for this addon in the Tools > Addons section of the Statamic control panel and install it from there.

🎨 Usage

Once installed, you're ready to use Latte views in your frontend. Just save or rename your views using the extension .latte and reference them as usual. Of course, you can use both side-by-side as long as you're making sure there's only ever one identically named view.

- /resources/views/project.antlers.html
+ /resources/views/project.latte

Antlers

<ul>
    {{ songs }}
        <li>{{ value }} (Next: {{ next:value }})</li>
    {{ /songs }}
</ul>

Latte

<ul n:inner-foreach="$songs as $song">
    <li>{$song} (Next: {$iterator->nextValue})</li>
</ul>

Tags

Statamic Tags can be used via the s helper function:

Antlers

{{ collection:pages take="8" }}
  {{ title }}
{{ /collection }}

Latte

{foreach s('collection:pages', take: 8) as $entry}
  {$entry->title}
{/foreach}

Modifiers

Statamic Modifiers can also be used as filters in Latte:

Antlers

<h1>{{ title | upper | truncate(50) }}</h1>

Latte

<h1>{$title|upper|truncate:50}</h1>

Mix & Match

If you ever need to combine Latte and Antlers code, you can use the antlers tag in your Latte views to render Antlers code inline. This can be useful for complex built-in tags or quick prototyping by copy-pasting examples from the docs.

Rendered in Latte: {$title}

{antlers}
    Rendered in Antlers: {{ title }}
{/antlers}

Layout

Just like in Antlers templates, the correct layout file will be used based on the data available in your entries and blueprints.

By default, it will look for /resources/views/layout.latte, but you can configure specific entries and collections to use different layouts instead by setting layout: other_layout on the entry or collection config file.

Caching

Cache

Use the cache tag to cache parts of a view.

{cache for: '10 minutes'}
    {foreach $stocks as $stock}
        {$stock->fetchPrice()}
    {/foreach}
{/cache}

Nocache

The nocache tag can be used to exempt part of a view from static caching.

{include 'partials.nav', handle: main}
 
{nocache} 
    {if $logged_in}
        Welcome back, {$current_user->name}
    {else}
        Hello, Guest!
    {/if}
{/nocache}
 
{block content}{/block}

Limitations

The nocache tag is only supported for application-level static caching. Full file-based caching requires JavaScript for nocache to work, which isn't yet implemented in this addon. See Caching Strategies for details.

Nesting cache and nocache is also not yet supported. The following will not work:

{cache}
    this will be cached
    {nocache}
        this will remain dynamic
    {/nocache}
    this will also be cached
{/cache}

License

MIT