Changeset 505 for trunk/lib/Utilities.inc.php

Timestamp:

Mar 23, 2015 10:06:42 PM (9 years ago)

Author:

anonymous

Message:

Added hyperlinkTxt(). Fixed setParam() to apply some settings during runtime.

File:

• trunk/lib/Utilities.inc.php (modified) (2 diffs)

trunk/lib/Utilities.inc.php

@@ -135 +135 @@
 
 /**
- * Returns text with appropriate html translations.
+ * Returns text with appropriate html translations (a smart wrapper for htmlspecialchars()).
  *
  * @param  string $text             Text to clean.
@@ -208 +208 @@
 
     return preg_replace($search, $replace, $text);
+}
+
+/*
+* Finds all URLs in text and hyperlinks them.
+*
+* @access   public
+* @param    string  $text   Text to search for URLs.
+* @param    mixed   $length Number of characters to truncate URL, or NULL to disable truncating.
+* @param    string  $delim  Delimiter to append, indicate truncation.
+* @return   string          Same input text, but URLs hyperlinked.
+* @author   Quinn Comendant <quinn@strangecode.com>
+* @version  1.0
+* @since    22 Mar 2015 23:29:04
+*/
+function hyperlinkTxt($text, $length=null, $delim='
')
+{
+    return preg_replace_callback(
+        // Inspired by @stephenhay's regex from https://mathiasbynens.be/demo/url-regex
+        // Here we capture the full URL into the first match and only the first X characters into the second match.
+        sprintf('@\b(?<!")(?<!\')(?<!=)(((?:https?|s?ftps?)://[^\s/$.?#].[^\s]{0,%s})[^\s]*)@iS', $length),
+        // Use an anonymous function to decide when to append the delim.
+        // Also encode special chars with oTxt().
+        function ($m) use ($length, $delim) {
+            if (is_null($length) || $m[1] == $m[2]) {
+                // If not truncating, or URL was not truncated.
+                return sprintf('<a href="%s">%s</a>', oTxt($m[1]), oTxt($m[1]));
+            } else {
+                // Truncated URL.
+                return sprintf('<a href="%s">%s%s</a>', oTxt($m[1]), oTxt(trim($m[2])), $delim);
+            }
+        },
+        $text
+    );
 }