grogy / linkify-bundle
Converts URLs and email addresses in text into HTML links
Installs: 13 482
Dependents: 0
Suggesters: 0
Security: 0
Stars: 0
Watchers: 1
Forks: 7
Type:symfony-bundle
Requires
- php: ^5.3.3 || ^7.0
- misd/linkify: ^1.0
- symfony/framework-bundle: ^2.1 || ^3.0
Requires (Dev)
- phpunit/phpunit: ^4.0 || ^5.0
- symfony/twig-bundle: ^2.1 || ^3.0
Suggests
- symfony/twig-bundle: to use the Twig linkify filter
Conflicts
- phpunit/phpunit-mock-objects: <2.2
- twig/twig: <1.23
README
Adds Linkify to your Symfony application, which converts URLs and email addresses in HTML (or plain text) to HTML links.
Installation
-
Add the LinkifyBundle to your dependencies:
$ composer require grogy/linkify-bundle
-
Register the bundle in your application:
// app/AppKernel.php class AppKernel extends Kernel { // ... public function registerBundles() { $bundles = array( // ... new Misd\LinkifyBundle\MisdLinkifyBundle(), // ... ); } // ... }
Usage
Use the service:
$text = $this->container->get('misd.linkify')->process('This is my text containing a link to www.example.com.');
In a Twig template:
{{ "This is my text containing a link to www.example.com."|linkify }}
In a PHP template:
<?php echo $view['linkify']->process('This is my text containing a link to www.example.com.') ?>
Options
Requires Linkify v1.1.1 or newer.
An array of options can be passed (see the Linkify docs for futher details). So to add the link
class to created links:
Using the service:
$text = $this->container->get('misd.linkify')->process('This is my text containing a link to www.example.com.', array('attr' => array('class' => 'link')));
In a Twig template:
{{ "This is my text containing a link to www.example.com."|linkify({'attr': {'class': 'link'}}) }}
In a PHP template:
<?php echo $view['linkify']->process('This is my text containing a link to www.example.com.', array('attr' => array('class' => 'link'))) ?>