bigfork/silverstripe-template-yield

Adds yield functionality to Silverstripe templates

Installs: 546

Dependents: 0

Suggesters: 0

Security: 0

Stars: 1

Watchers: 4

Forks: 0

Open Issues: 0

Type:silverstripe-vendormodule

2.0.0 2022-07-01 15:18 UTC

This package is auto-updated.

Last update: 2024-02-29 04:20:11 UTC


README

Adds support for <% section %> and <% yield %> tags to Silverstripe.

⚠️ this is a proof of concept built by using HTTP middleware to perform string replacements in order to work around missing extension hooks. See the limitations section for more info.

Usage examples

You can "yield" content that’s provided by section tags that exist in any templates in the current render process.

<!-- Page.ss -->
<head>
    <% yield 'MetaTags' %>
</head>

<!-- Includes/Pagination.ss -->
<% section 'MetaTags' %>
    <meta rel="next" href="{$NextLink}" />
    <meta rel="prev" href="{$PrevLink}" />
<% end_section %>

<div class="pagination">
    <ul>
        ...

You can also offer fallback content:

<head>
    <!-- If nothing includes a <% section 'MetaTitle' %>, the following fallback will be rendered -->
    <% yield 'MetaTitle' %>
        <title>Some default meta title</title>
    <% end_yield %>
</head>

There are also inline (“open”) tags which are useful for yielding things like CSS classes:

<!-- Page.ss -->
<body class="<% yield 'BodyClass' %>">

</body>

<!-- Layout/MyPage.ss -->
<% section 'BodyClass', 'some-css-class' %>

<div class="typography">
    ... etc
</div>

As above, you can offer a fallback for inline tags too:

<!-- Will return fallback-class if no <% section 'BodyClass' %> is defined -->
<body class="<% yield 'BodyClass', 'fallback-class' %>">

</body>

Limitations

Due to there not yet being suitable hooks in place in Silverstripe core, this has the following limitations:

  • This only works for templates that are returned via an HTTP request, as it relies on HTTP middleware to inject the yielded content. If you need to use this for other content (e.g. emails or server-side rendering) you will need to call BlockProvider::yieldIntoString() yourself
  • While nested sections/yields appear to work, these haven’t been thoroughly tested