improved readability for crossword input field numbers

app/Utils.inc

@@ -0,0 +1,83 @@
+<?php
+
+	/**
+	 * The Legend of Z
+	 *
+	 * @author	Oliver Hanraths <oliver.hanraths@uni-duesseldorf.de>
+	 * @copyright	2014 Heinrich-Heine-Universität Düsseldorf
+	 * @license	http://www.gnu.org/licenses/gpl.html
+	 * @link	https://bitbucket.org/coderkun/the-legend-of-z
+	 */
+	
+	namespace hhu\z;
+	
+	
+	/**
+	 * Class for implementing utility methods.
+	 * 
+	 * @author	Oliver Hanraths <oliver.hanraths@uni-duesseldorf.de>
+	 */
+	class Utils
+	{
+		
+		
+		/**
+		 * Mask HTML-chars for save output.
+		 * 
+		 * @static
+		 * @param	string	$string	String to be masked
+		 * @return	string		Masked string
+		 */
+		static function t($string)
+		{
+			return nl2br(htmlspecialchars($string));
+		}
+		
+		
+		/**
+		 * ‚htmlspecialchars‘ with support for UTF-8.
+		 * 
+		 * @static
+		 * @param	string	$string	String to be masked
+		 * @return	string		Masked string
+		 */
+		public static function htmlspecialchars_utf8($string)
+		{
+			return htmlspecialchars($string, ENT_COMPAT, 'UTF-8');
+		}
+		
+		
+		/**
+		 * Cut a string to the given length but only word boundaries.
+		 * 
+		 * @static
+		 * @param	string	$string	String to cut
+		 * @param	int	$length	Length to cut string
+		 * @param	int	$scope	Maximum length to cut string regardless word boundaries
+		 * @return	string		Cutted string
+		 */
+		public static function shortenString($string, $length, $scope)
+		{
+			// Determine length
+			$length = min($length, strlen($string));
+			
+			// Look for word boundary
+			if(($pos = strpos($string, ' ', $length)) !== false)
+			{
+				// Check if boundary is outside of scope
+				if($pos > $length + $scope) {
+					$pos = strrpos(substr($string, 0, $pos), ' ');
+				}
+			}
+			else {
+				$pos = strlen($string);
+			}
+			
+			
+			// Cut string and return it
+			return substr($string, 0, $pos);
+		}
+		
+	}
+
+?>