Updated Twig template to take into account asset() function changes

Author: javiereguiluz

book/templating.rst

@@ -1027,46 +1027,12 @@ assets won't be cached when deployed. For example, ``/images/logo.png`` might
 look like ``/images/logo.png?v2``. For more information, see the :ref:`ref-framework-assets-version`
 configuration option.
 
-.. _`book-templating-version-by-asset`:
+If you need absolute URLs for assets, use the ``absolute_url()`` Twig function
+as follows:
 
-If you need to set a version for a specific asset, you can set the fourth
-argument (or the ``version`` argument) to the desired version:
-
-.. configuration-block::
-
-    .. code-block:: html+jinja
-
-        <img src="{{ asset('images/logo.png', version='3.0') }}" alt="Symfony!" />
-
-    .. code-block:: html+php
-
-        <img src="<?php echo $view['assets']->getUrl(
-            'images/logo.png',
-            null,
-            false,
-            '3.0'
-        ) ?>" alt="Symfony!" />
-
-If you don't give a version or pass ``null``, the default package version
-(from :ref:`ref-framework-assets-version`) will be used. If you pass ``false``,
-versioned URL will be deactivated for this asset.
-
-If you need absolute URLs for assets, you can set the third argument (or the
-``absolute`` argument) to ``true``:
-
-.. configuration-block::
-
-    .. code-block:: html+jinja
-
-        <img src="{{ asset('images/logo.png', absolute=true) }}" alt="Symfony!" />
-
-    .. code-block:: html+php
+.. code-block:: html+jinja
 
-        <img src="<?php echo $view['assets']->getUrl(
-            'images/logo.png',
-            null,
-            true
-        ) ?>" alt="Symfony!" />
+    <img src="{{ absolute_url(asset('images/logo.png')) }}" alt="Symfony!" />
 
 .. index::
    single: Templating; Including stylesheets and JavaScripts
@@ -1224,7 +1190,7 @@ automatically:
 
 .. versionadded:: 2.6
     The global ``app.security`` variable (or the ``$app->getSecurity()``
-    method in PHP templates) is deprecated as of Symfony 2.6. Use ``app.user`` 
+    method in PHP templates) is deprecated as of Symfony 2.6. Use ``app.user``
     (``$app->getUser()``) and ``is_granted()`` (``$view['security']->isGranted()``)
     instead.
 

reference/configuration/framework.rst

@@ -923,10 +923,6 @@ Now, the same asset will be rendered as ``/images/logo.png?v2`` If you use
 this feature, you **must** manually increment the ``assets_version`` value
 before each deployment so that the query parameters change.
 
-It's also possible to set the version value on an asset-by-asset basis (instead
-of using the global version - e.g. ``v2`` - set here). See
-:ref:`Versioning by Asset <book-templating-version-by-asset>` for details.
-
 You can also control how the query string works via the `assets_version_format`_
 option.
 
@@ -1063,6 +1059,7 @@ Assume you have custom global form themes in
     See :ref:`book-forms-theming-global` for more information.
 
 .. _reference-templating-base-urls:
+.. _ref-framework-assets-base-urls:
 
 assets_base_urls
 ................

reference/twig_reference.rst

@@ -126,6 +126,29 @@ assets_version
 Returns the current version of the package, more information in
 :ref:`book-templating-assets`.
 
+absolute_url
+~~~~~~~~~~~~
+
+.. code-block:: jinja
+
+    {{ absolute_url(asset(path, packageName)) }}
+
+``path``
+    **type**: ``string``
+``packageName``
+    **type**: ``string`` | ``null`` **default**: ``null``
+
+Returns the absolute URL that corresponds to the given asset path and package.
+More information in :ref:`book-templating-assets`. For configuring the base URLs,
+:ref:`ref-framework-assets-base-urls`.
+
+The absolute URLs generated with this function ignore the asset versioning.
+Combine it with the ``assets_version()`` function to append the version number:
+
+.. code-block:: jinja
+
+    {{ absolute_url(asset('logo.png')) ~ '?' ~ assets_version('images') }}
+
 form
 ~~~~