Add link builder

Author: asika32764

README.md

@@ -1 +1,5 @@
-# php-autolink
+# PHP Autolink Library
+
+A library to auto convert URLs to links in text.
+
+## Installation via 

src/Autolink.php

@@ -40,6 +40,13 @@ class Autolink
 		'ftps'
 	);
 
+	/**
+	 * Property linkBuilder.
+	 *
+	 * @var  callable
+	 */
+	protected $linkBuilder;
+
 	/**
 	 * Class init.
 	 *
@@ -75,7 +82,7 @@ function($matches) use ($self, $attribs)
 
 				if (!$inElements)
 				{
-					return $self->convert($matches[0]);
+					return $self->convert($matches[0], $attribs);
 				}
 
 				return $matches[0];
@@ -106,7 +113,7 @@ function($matches) use ($attribs)
 				{
 					$attribs['href'] = 'mailto:' . htmlspecialchars($matches[0]);
 
-					return (string) new HtmlElement('a', htmlspecialchars($matches[0]), $attribs);
+					return $this->buildLink($matches[0], $attribs);
 				}
 
 				return $matches[0];
@@ -154,7 +161,25 @@ public function convert($url, $attribs = array())
 			$attribs['title'] = htmlspecialchars($url);
 		}
 
-		return (string) new HtmlElement('a', htmlspecialchars($content), $attribs);
+		return $this->buildLink($content, $attribs);
+	}
+
+	/**
+	 * buildLink
+	 *
+	 * @param string $url
+	 * @param array  $attribs
+	 *
+	 * @return  string
+	 */
+	protected function buildLink($url = null, $attribs = array())
+	{
+		if (is_callable($this->linkBuilder))
+		{
+			return call_user_func($this->linkBuilder, $url, $attribs);
+		}
+
+		return (string) new HtmlElement('a', htmlspecialchars($url), $attribs);
 	}
 
 	/**
@@ -330,4 +355,33 @@ public function setSchemes($schemes)
 
 		return $this;
 	}
+
+	/**
+	 * Method to get property LinkBuilder
+	 *
+	 * @return  callable
+	 */
+	public function getLinkBuilder()
+	{
+		return $this->linkBuilder;
+	}
+
+	/**
+	 * Method to set property linkBuilder
+	 *
+	 * @param   callable $linkBuilder
+	 *
+	 * @return  static  Return self to support chaining.
+	 */
+	public function setLinkBuilder($linkBuilder)
+	{
+		if (!is_callable($linkBuilder))
+		{
+			throw new \InvalidArgumentException('Please use a callable or Closure.');
+		}
+
+		$this->linkBuilder = $linkBuilder;
+
+		return $this;
+	}
 }

test/AutolinkTest.php

@@ -276,4 +276,21 @@ public function testRenderEmail()
 
 		$this->assertStringSafeEquals($html, $this->instance->renderEmail($text));
 	}
+
+	/**
+	 * testSetLinkBuilder
+	 *
+	 * @return  void
+	 */
+	public function testGetAndSetLinkBuilder()
+	{
+		$this->instance->setLinkBuilder(function($url, $attribs)
+		{
+			return $url . json_encode($attribs);
+		});
+
+		$this->assertEquals('http://google.com{"foo":"bar","href":"http:\/\/google.com"}', $this->instance->convert('http://google.com', array('foo' => 'bar')));
+
+		$this->assertInstanceOf('Closure', $this->instance->getLinkBuilder());
+	}
 }