fkr/cssurlrewrite-bundle

A small assetic filter for symfony to fix all url paths at css documents to correct urls

FkrCssURLRewriteBundle

A small assetic filter for Symfony2 to fix all url paths in css documents to correct urls. It also provides easy resource linking across platforms., _(*1)

Installation

Bring in the vendor libraries

This can be done in three different ways:, _(*2)

Method #1) Use composer, _(*3)

~~~~~ json "require": { "fkr/cssurlrewrite-bundle": "*" }, _(*4)

**Method #2**) Use git submodules

    git submodule add git://github.com/fkrauthan/FkrCssURLRewriteBundle.git vendor/bundles/Fkr/CssURLRewriteBundle


**Method #3**) Use deps file

    [FkrCssURLRewriteBundle]
        git=git://github.com/fkrauthan/FkrCssURLRewriteBundle.git
        target=bundles/Fkr/CssURLRewriteBundle


Register the Fkr namespaces
-----------------------------------------

If not using composer, register the `Fkr` namespace with Symfony's
autoloader:

~~~~~ php
// app/autoload.php
$loader->registerNamespaces(array(
    'Fkr' => __DIR__.'/../vendor/bundles',
    // your other namespaces
));

Add CssURLRewriteBundle to your application kernel

~~~~~ php // app/AppKernel.php public function registerBundles() { return array( // ... new Fkr\CssURLRewriteBundle\FkrCssURLRewriteBundle(), // ... ); }, _(*5)

Configuration
=============

~~~~~ yml
# app/config.yml
fkr_css_url_rewrite:
    rewrite_only_if_file_exists: true
    clear_urls: true

• rewrite_only_if_file_exists: If true (default) only rewrites url if the resource exists in the .../BundleFolder/Resources/public/ folder.
• clear_urls: If true (default) the generated url gets normalized. For example if the url normaly is .../less/../img this option makes .../img.

Usage

Standard usage, _(*6)

If you place your css file for example in, _(*7)

.../BundleFolder/Resources/public/css 

and you have your images in, _(*8)

../BundleFolder/Resources/public/img

then you have in yours css file somthing like this, _(*9)

~~~~~ css background-image: url(../img/MyImageName.png) ~~~~~, _(*10)

Now you have to call, _(*11)

app/console assets:install

Now if you have somthing like this in your template, _(*12)

{% stylesheets filter='css_url_rewrite,?yui_css' 
    '@BundleName/Resources/public/css/mycssfile.css'
%}
    <link rel="stylesheet" href="{{ asset_url }}" type="text/css" />
{% endstylesheets %}

Now the filter rewrites your url in your css file, _(*13)

background-image: url(../img/MyImageName.png) => background-image: url(../bundles/bundlename/css/../img/MyImageName.png)

And everything works fine., _(*14)

Extended usage, _(*15)

You can link images from other bundles by using the @ annotation. For example if you write this in you css file, _(*16)

background-image: url(@BundleNameBundle/img/MyImageName.png)

Now the filter rewrite this url in your css file, _(*17)

background-image: url(@BundleNameBundle/img/MyImageName.png) => background-image: url(../bundles/bundlename/img/MyImageName.png)

License

Resources/meta/LICENSE, _(*18)