liip/url-auto-converter-bundle

This bundle adds a Twig Extension with a filter for automatically converting urls and emails in a string to html links

Installs: 26 867

Dependents: 2

Stars: 35

Watchers: 31

Forks: 10

Open Issues: 6

Language: PHP

1.1.0 2014-07-30 07:37 UTC

README

Latest Stable Version Latest Unstable Version Total Downloads Build Status

About

This bundle adds a Twig Extension with a filter for automatically converting urls and emails in a string to html links. In the Format: "liip.ch" for urls or "info@liip.ch" for emails.

Installation

  1. Add this bundle to your composer.json:

    $ php composer.phar require liip/url-auto-converter-bundle:dev-master
    
  2. Add this bundle to your application's kernel:

    // application/ApplicationKernel.php
    public function registerBundles()
    {
      return array(
          // ...
          new Liip\UrlAutoConverterBundle\LiipUrlAutoConverterBundle(),
          // ...
      );
    }
    

Configuration

The supported options for the LiipUrlAutoConverterBundle are: (put in /app/config/config.yml)

liip_url_auto_converter:
    linkclass:
    target: _blank
    debugmode: false
  • "linkClass": css class thath will be added automatically to converted links. default: "" (empty)
  • "target": browser link target. default: "_blank"
  • "debugMode": if true, links will be colored with a nasty green color - cool for testing. default: false

All settings are optional.

Usage

This library adds a filter for twig templates that can be used like:

{{ "sometexttofindaurl www.liip.ch inside" | converturls }}

License

See LICENSE.