README

TangoMan Callback Twig Extension Bundle

TangoMan Callback Twig Extension Bundle provides simple callback function for twig which avoids unnecessary callbacks to stack up indefinitely in users query string.

🧩 Purpose of the Callback Class

This class defines a Twig extension that introduces a custom function called callback. Its main job is to generate clean URLs by removing callback parameters from query strings, which can help avoid issues where multiple callbacks get appended indefinitely and make sure users query parameters are not lost in the process.

🔧 callbackFunction()

public function callbackFunction($route = null, $parameters = [])

• Behavior:
  • If no route is provided -> use the current request URI.
  • If a route is specified -> generate a full URL using Symfony's router.
• Core logic:
  • Parses the URL.
  • Removes the callback parameter from the query string.
  • Reconstructs and returns the cleaned URL.

✨ Real-Life Use Case

Imagine you're building a redirect system where callbacks are passed through URLs. If multiple redirects occur (e.g., login flow, third-party auth, or form submissions), you might get URLs like this:

https://example.com/page?callback=https://another.com?callback=...

This class avoids that endless loop by stripping the callback query parameter from the final URL so it stays nice and tidy.

📦 Installation

Step 1: Download the Bundle

Open a command console, enter your project directory and execute the following command to download the latest stable version of this bundle:

composer require tangoman/callback-bundle

This command requires you to have Composer installed globally, as explained in the installation chapter of the Composer documentation.

Step 2: Enable the Bundle

Then, enable the bundle by adding it to the list of registered bundles in the app/AppKernel.php file of your project:

<?php
// app/AppKernel.php

// ...
class AppKernel extends Kernel
{
    // ...

    public function registerBundles()
    {
        $bundles = array(
            // ...
            new TangoMan\CallbackBundle\TangoManCallbackBundle(),
        );

        // ...
    }
}

You don't have to add TangoMan Callback Twig Extension Bundle to the service.yml of your project. twig.extension.callback service will load automatically.

🛠️ Usage

callback(route = null, parameters = [])

Returns current URI removing callback from query string. Optionally, returns the absolute URL (with scheme and host) for the given route with given parameters, callback will be ignored as well.

Inside your views:

By default callback will be defined on user's current page.

    <a href="{{ path('app_foo_bar', { 'callback': callback() }) }}">
        Your Foo Bar link here
    </a>

But you can optionally redirect user to any route.

    <a href="{{ path('app_delete_foo', { 'callback': callback('app_trash_bin', { 'slug': 'foo' } ) }) }}">
        Your Foo Bar link here
    </a>

Callback function accepts route name and parameters for desired route.

Inside your action method:

    public function foobarAction(Request $request)
    {
        ...
        // User is redirected to referrer page
        return $this->redirect($request->get('callback'));
        ...
    }

✅ Tests

TangoMan Callback Twig Extension Bundle provides Makefile script to perform unit tests, in order to fit in your continuous integration workflow.

Enter following command to install required dependencies and execute unit tests:

$ make tests

On windows machine you will need to install cygwin or GnuWin make first to execute make script.

If you have XDebug installed, you can generate code coverage report with:

$ make coverage

📝 Note

If you find any bug please report here : Issues

🤝 Contributing

Thank you for your interest in contributing to TangoMan Callback Twig Extension Bundle.

Please review the code of conduct and contribution guidelines before starting to work on any features.

If you want to open an issue, please check first if it was not reported already before creating a new one.

📜 License

Copyrights (c) 2025 "Matthias Morin" <mat@tangoman.io>

Distributed under the MIT license.

If you like TangoMan Callback Twig Extension Bundle please star, follow or tweet:

... And check my other cool projects.

👋 Let's Build Your Next Project Together !

Looking for an experienced Full-Stack Partner ?

Clean code. Clear communication.

From first sketch to final launch, I've got your back.