Weave Code
Head Bundle Laravel Package
lifeinthecloud/head-bundle
A Symfony bundle for managing HTML head elements such as titles, meta tags, canonical links, stylesheets, and scripts. It provides services and Twig helpers to collect, organize, and render head content cleanly from controllers and templates.
At a glance
Frequently asked questions about Head Bundle
- How do I install lifeinthecloud/head-bundle in a Symfony app?
- Install it with Composer using composer require lifeinthecloud/head-bundle. Register the bundle in config/bundles.php for standard Symfony applications, or let Symfony Flex handle it if a recipe is available. Then configure any default title and meta values in your bundle configuration.
- Which Symfony versions does HeadBundle support?
- The provided overview does not list exact Symfony version constraints, so check the package composer.json and Packagist metadata before installing. Because it is a Symfony bundle, it should be registered in config/bundles.php and tested against your project's Symfony version. Run the test suite in a branch when upgrading major Symfony releases.
- How do I set a page title from a Symfony controller or Twig template?
- The bundle provides services and Twig helpers for collecting head content, so you can set the title from a controller service or override it in a template. Defaults configured at the bundle level apply when a page does not provide its own title. Check the README for exact service IDs and Twig function names for your installed version.
- Can I override default meta tags for individual pages?
- Yes. HeadBundle is designed around configurable defaults plus per-page overrides, so a template or controller can replace meta values for a specific page. Keep shared defaults in bundle configuration and set only the page-specific meta tags in that page's template or controller.
- How do I add canonical links and custom head elements?
- Canonical links and custom head elements are part of the bundle's head content model. Use the provided services or Twig helpers to add a canonical URL and any custom elements, then render the collected head output in your base layout. Confirm the exact API in the README because helper names can vary by version.
- Does HeadBundle handle stylesheets and scripts in the head?
- Yes. The package description lists stylesheets and scripts alongside titles, meta tags, and canonical links. You can collect and organize these head elements through the bundle services and Twig helpers, then render them cleanly from your layout.
- Do I need to edit every Twig template to render the head?
- No. Put the head render call once in your base layout, such as in the HTML head section. Individual templates or controllers then add or override titles and meta tags as needed. This keeps output consistent without repeating markup across every page.
- Is HeadBundle compatible with Symfony Flex?
- It is a Symfony bundle, so normal bundle registration in config/bundles.php applies. If a Symfony Flex recipe exists, Flex can enable and configure it automatically; otherwise register it manually. Test the install in a development branch to confirm the recipe and configuration behavior.
- How should I test head output in a Symfony application?
- Use Symfony's test client to request pages and assert that the rendered head contains the expected title, meta tags, canonical link, stylesheets, and scripts. Also test default values and per-page overrides separately. Unit tests around the bundle services can cover collection and ordering logic without full HTTP requests.
- Is lifeinthecloud/head-bundle for Laravel or Symfony?
- It is a Symfony bundle, not a Laravel package. Laravel developers evaluating it should look for a Laravel-specific head or SEO package instead. In Symfony, install it with Composer, register the bundle, and use its services and Twig helpers to render head content.
Weaver
How can I help you explore Laravel packages today?