Frontend Item View

Edit on GitHub

Time to create the Recipe item view for the frontend. This starts almost exactly the same. In fact, copy the admin config... then paste. In Layouts, we know that the app key means the "admin" section. And, it turns out, default is used to mean the frontend:

            
            29 lines
            
            config/packages/netgen_layouts.yaml
        
            netgen_layouts:
        
                                                    ... lines 2 - 12
                            
                view:
        
                    item_view:
        
                                                    ... lines 15 - 21
                            
                        # default = frontend
        
                        default:
        
                            # this key is not important
        
                            recipes_default:
        
                                                    ... lines 26 - 29

Frontend (default) item_view & Template

Once again, this internal name isn't important, for the template, use the same path but frontend... and keep match exactly the same:

            
            29 lines
            
            config/packages/netgen_layouts.yaml
        
            netgen_layouts:
        
                                                    ... lines 2 - 12
                            
                view:
        
                    item_view:
        
                                                    ... lines 15 - 21
                            
                        # default = frontend
        
                        default:
        
                            # this key is not important
        
                            recipes_default:
        
                                template: 'nglayouts/frontend/recipe_item.html.twig'
        
                                match:
        
                                    item\value_type: 'doctrine_recipe'

I love when things are boring and easy! Let's go create that template. In nglayouts/, make the frontend/ directory... and inside, recipe_item.html.twig.

Layouts will pass this the same variables as the admin item template. This means we can, once again, use {{ item.object }} to access our Recipe object. Let's print the name key to see if things are working:

2 lines templates/nglayouts/frontend/recipe_item.html.twig

And... they are working. It's alive!

Checking Templates in the Twig Profiler

One of my favorite things to do when I start working with templates inside Layouts is to click the Twig item on the web debug toolbar. Here, we can actually see how Layouts is rendering. Yup, it renders layout_2.html.twig... then starts rendering each zone. It renders our navigation block, the hero block, then, eventually down here, the grid. You can see it's using grid/3_columns.html.twig. This is something we can control in the admin area. Click the grid. On the right, we're looking at the "Content" tab. But there's also a "Design" tab. Change this to "4 columns"... and I'll hit "Publish and continue editing".

If we refreshed now and reloaded the Twig profiler, we would see it rendering 4_columns.html.twig. Then, hey! Inside of each column, it renders our recipe_item.html.twig. This is just really cool to see, and we're going to look at this again later when we talk about overriding core templates.

Bootstrap 4 CSS

One thing I do need to mention is that our app is using Bootstrap version 4, not Bootstrap 5. The reason is because, right now, the grid template renders Bootstrap version 4 markup. If you wanted to use Bootstrap 5, that's totally possible, but you would need to override these columns templates - like 4_columns.html.twig - to tweak the classes. Overriding core templates is actually super easy, and we'll talk about how to do it soon.

Customizing our Frontend Template

Ok, let's bring this frontend view to life! Open up the homepage template: main/homepage.html.twig... and scroll up to where we loop over the latest recipes. Perfect. What I basically want to do is steal the markup for one of these recipe tiles... then paste that into the frontend template:

            
            8 lines
            
            templates/nglayouts/frontend/recipe_item.html.twig
        
            <a href="{{ path('app_recipes_show', { slug: recipe.slug }) }}" class="text-center recipe-container p-3">
        
                <div class="p-3 entity-img">
        
                    <img src="{{ asset(recipe.imageUrl) }}" width="auto" height="115" alt="{{ recipe.name }} image">
        
                </div>
        
                <h3 class="mt-3">{{ recipe.name }}</h3>
        
                <small>{{ recipe.timeAsWords }} (prep & cook)</small>
        
            </a>

Now we just need to tweak some variables: instead of recipe.slug, it needs to be item.object.slug. I'll do a find and replace: replace recipe. with item.object.:

            
            8 lines
            
            templates/nglayouts/frontend/recipe_item.html.twig
        
            <a href="{{ path('app_recipes_show', { slug: item.object.slug }) }}" class="text-center recipe-container p-3">
        
                <div class="p-3 entity-img">
        
                    <img src="{{ asset(item.object.imageUrl) }}" width="auto" height="115" alt="{{ item.object.name }} image">
        
                </div>
        
                <h3 class="mt-3">{{ item.object.name }}</h3>
        
                <small>{{ item.object.timeAsWords }} (prep & cook)</small>
        
            </a>

Wrapping Blocks in a Container

Nice! Let's see if that worked. Move over, refresh... and it did! That looks like the frontend. We're awesome! Except, it's missing the "gutter" that we have in the original. Inspect element. Ah, the difference is that the original columns were inside of a container div, which adds the margin. In the new code, we are inside of a row... but not a container.

To fix this in Layouts, let's add our favorite utility block: a column! Move the grid into that column. Then, we could add a CSS class like we did before in the hero area. But instead, take a shortcut and check "Wrap in container".

Hit "Publish and continue editing" and refresh. Whoops - wrong page. Head back to the homepage and... it looks great! It's now inside of an element with a container class!

This "Wrap in container" is super handy: it literally adds an extra div around your block with class="container" and every block supports this. Heck, we didn't even need a column: we could have just checked the "Wrap in container" on the grid itself.

The only reason I put this inside of a column is so we can also add the "Latest Recipes" header there too. Drag a new "Title" block into the column. Get outta here Apple! Inside, type "Latest Recipes" and change to an h2.

Hit our favorite "Publish and continue editing", refresh and... even closer! We just need to center this... and maybe give it a little top margin. Add two classes to the title: text-center and my-5 for some vertical margin: both classes come from Bootstrap. I'm just repeating the classes that my designer was already using in the template.

Publish that... and when we try it... it matches exactly. Woo! But now, we have full control over the recipes inside! We could change to a different query, change the number of items or, in a little while, we could choose to manually select the exact recipes to show. We can also now embed lists and grids of recipes anywhere we want on the site.

Cleanup!

To celebrate, remove the entire latest_recipes Twig block:

            
            70 lines
            
            templates/main/homepage.html.twig
        
                                                    ... lines 1 - 14
                            
            {% block latest_recipes %}
        
                <div class="container">
        
                    <h2 class="text-center my-5">Latest Recipes</h2>
        
                    <div class="row">
        
                        {% for recipe in latestRecipes %}
        
                            <div class="col-3">
        
                                <a href="{{ path('app_recipes_show', { slug: recipe.slug }) }}" class="text-center recipe-container p-3">
        
                                    <div class="p-3 entity-img">
        
                                        <img src="{{ asset(recipe.imageUrl) }}" width="auto" height="115" alt="{{ recipe.name }} image">
        
                                    </div>
        
                                    <h3 class="mt-3">{{ recipe.name }}</h3>
        
                                    <small>{{ recipe.timeAsWords }} (prep & cook)</small>
        
                                </a>
        
                            </div>
        
                        {% endfor %}
        
                    </div>
        
                    <div class="text-center mt-5 text-underline"><u><a href="#">Show More</a></u></div>
        
                </div>
        
            {% endblock %}
        
                                                    ... lines 34 - 70

And, up in MainController, delete the query, the variable, the repository argument and the use statement:

            
            18 lines
            
            src/Controller/MainController.php
        
                                                    ... lines 1 - 2
                            
            namespace App\Controller;
        
            use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
        
            use Symfony\Component\HttpFoundation\Response;
        
            use Symfony\Component\Routing\Annotation\Route;
        
            class MainController extends AbstractController
        
            {
        
                #[Route('/', name: 'app_homepage')]
        
                public function homepage(): Response
        
                {
        
                    return $this->render('main/homepage.html.twig', [
        
                    ]);
        
                }
        
            }

When we refresh, we have just one "Latest Recipes" section coming from our dynamic block. Oh, but notice in the layouts admin, we're still rendering the latest_recipes block... even though it doesn't exist anymore! Layouts is pretty forgiving to admin users: instead of throwing an error, it simply renders nothing.

But let's delete that... then publish... and take one last look. I love it!

Next: now that we have this grid inside of layouts, we can do some cool stuff with it, like enabling Ajax-powered pagination.

What PHP libraries does this tutorial use?

// composer.json
{
    "require": {
        "php": ">=8.1.0",
        "ext-ctype": "*",
        "ext-iconv": "*",
        "babdev/pagerfanta-bundle": "^3.7", // v3.7.0
        "doctrine/doctrine-bundle": "^2.7", // 2.7.0
        "doctrine/doctrine-migrations-bundle": "^3.2", // 3.2.2
        "doctrine/orm": "^2.13", // 2.13.3
        "easycorp/easyadmin-bundle": "^4.4", // v4.4.1
        "netgen/layouts-contentful": "^1.3", // 1.3.2
        "netgen/layouts-standard": "^1.3", // 1.3.1
        "pagerfanta/doctrine-orm-adapter": "^3.6",
        "sensio/framework-extra-bundle": "^6.2", // v6.2.8
        "stof/doctrine-extensions-bundle": "^1.7", // v1.7.0
        "symfony/console": "5.4.*", // v5.4.14
        "symfony/dotenv": "5.4.*", // v5.4.5
        "symfony/flex": "^1.17|^2", // v2.2.3
        "symfony/framework-bundle": "5.4.*", // v5.4.14
        "symfony/monolog-bundle": "^3.0", // v3.8.0
        "symfony/proxy-manager-bridge": "5.4.*", // v5.4.6
        "symfony/runtime": "5.4.*", // v5.4.11
        "symfony/security-bundle": "5.4.*", // v5.4.11
        "symfony/twig-bundle": "5.4.*", // v5.4.8
        "symfony/ux-live-component": "^2.x-dev", // 2.x-dev
        "symfony/ux-twig-component": "^2.x-dev", // 2.x-dev
        "symfony/validator": "5.4.*", // v5.4.14
        "symfony/webpack-encore-bundle": "^1.15", // v1.16.0
        "symfony/yaml": "5.4.*", // v5.4.14
        "twig/extra-bundle": "^2.12|^3.0", // v3.4.0
        "twig/twig": "^2.12|^3.0" // v3.4.3
    },
    "require-dev": {
        "doctrine/doctrine-fixtures-bundle": "^3.4", // 3.4.2
        "symfony/debug-bundle": "5.4.*", // v5.4.11
        "symfony/maker-bundle": "^1.47", // v1.47.0
        "symfony/stopwatch": "5.4.*", // v5.4.13
        "symfony/web-profiler-bundle": "5.4.*", // v5.4.14
        "zenstruck/foundry": "^1.22" // v1.22.1
    }
}

Edit on GitHub

TRACK

Symfony 5 >

COURSE

Netgen Layouts: Building Pages with Symfony