Wednesday, December 19, 2012

Symfony2 - Load different templates based on user agent

If you want to load different templates for different user agents while keeping the same backend code base, you can accomplish this simply in 2 ways.

  1.  Responsive Template
  2. Load different templates against user agents.
In this blog post I'm trying to demonstrate the option 2 (load different templates against user agents)

The trick is to use RequestFormat in symfony

1. Create a Request Listener

php app/console generate:bundle --namespace=Acme/RequestListenerBundle --format=yml


Note: You don't need Controller, Tests directories

Past the below code to AcmeRequestListnerBundle.php

getRequest();

        if(preg_match('/(alcatel|amoi|android|avantgo|blackberry|benq|cell|cricket|docomo|elaine|htc|iemobile|iphone|ipad|ipaq|ipod|j2me|java|midp|mini|mmp|mobi|motorola|nec-|nokia|palm|panasonic|philips|phone|playbook|sagem|sharp|sie-|silk|smartphone|sony|symbian|t-mobile|telus|up\.browser|up\.link|vodafone|wap|webos|wireless|xda|xoom|zte)/i', $request->headers->get('user-agent')))
        {
            $request->setRequestFormat('mobile', 'text/html');
        }else {
            $request->setRequestFormat('html', 'text/html');
        }
    }

    private function setFormat (\Symfony\Component\HttpFoundation\Request $request, $format='html') {
        $request->setRequestFormat($format, 'text/html');
    }
}

2. Create a test action in your controller

Action 

    /**
     * @Route("/test", name="_demo_test")
     * @Template()
     */
    public function testAction()
    {
        return array(
            'name' => 'Thilanga Pitigala',
        );
    }

Note: Run
php app/console router:debug | grep _demo_test
and verify the newly created action and the router

Template
Create the template for newly created action

Acme/DemoBundle/Resources/views/Demo/test.html.twig

{% extends "AcmeDemoBundle::layout.html.twig" %}

{% block title "Hello " %}

{% block content %}
    

Hello Desktop !

{% endblock %}

2. Create a Service using RequestListener

Add below code to config.yml

services:
    acme.listener.request:
        class: Acme\RequestListenerBundle\AcmeRequestListenerBundle
        tags:
            - { name: kernel.event_listener, event: kernel.request, method: onKernelRequest }

Note: run
php app/console container:debug | grep acme.listener.request
  and That will output the newly created service

2. Test RequestListener service

Try visiting the web applications from mobile device. It will throw an error complaining about missing test.mobile.twig file.

Create the test.mobile.twig file in Acme/DemoBundle/Resources/views/Demo/test.html.twig as we created the test.html.twig template.

Now you will be able to see the mobile template from mobile devices while desktop template load for desktop agents.

By that way we can load different templates for different agents without doing any responsive templates.

Happy Coding..

4 comments :

Anonymous said...

Hi, I guess it is going to be in a right direction. But I guess there is a problem or bug. Because when I copy and paste the code. test.html.twig or test.mobile.twig is not rendered at all. T

he Message is: The controller must return a response (Array(name => Thilanga Pitigala) given).

How can I render the templates?

Unknown said...

Which Symfony version you are using and the OS?, also make sure you have below lines in you controller

use Symfony\Component\HttpFoundation\Request;
use Symfony\Component\HttpFoundation\Response;
use Sensio\Bundle\FrameworkExtraBundle\Configuration\Route;
use Sensio\Bundle\FrameworkExtraBundle\Configuration\Template;

Thanks

Anonymous said...

I use symfony2.1 and iOS 6.1.

I mean the normal why you render a page is:
return $this->render('AcmeBundle:Default:test.html.php');

In your example I just return an array, but I don't return anything else like the path to the folder AcmeBundle/Ressources/views/Default/test.html.php.

I followed your post from yesterday, but it doesn't work. I put them on top of the Controller of the test-action.
But why I should use your four "use..."-classes? For example In your code you don't use: public function test(Request $request).

Unknown said...

Hi Gunnar,

I tested the code with Symfony2.1 and Yes it seems like I need to update the post. :) Thanks for trying out and letting me know.

To answer you question about newly loaded class (for use statements), with this request listener we don't force the template type, coz of that we need to use template annotation when loading templates.