Adds new utilities abstract classes as helper methods. Moves the helper class autoloader above the class. Adds option to override the settings.json file.

libraries/jcb_powers/VDM.Joomla/src/Utilities/String/FieldHelper.php

@@ -0,0 +1,97 @@
+<?php
+/**
+ * @package    Joomla.Component.Builder
+ *
+ * @created    30th April, 2015
+ * @author     Llewellyn van der Merwe <http://www.joomlacomponentbuilder.com>
+ * @gitea      Joomla Component Builder <https://git.vdm.dev/joomla/Component-Builder>
+ * @github     Joomla Component Builder <https://github.com/vdm-io/Joomla-Component-Builder>
+ * @copyright  Copyright (C) 2015 Vast Development Method. All rights reserved.
+ * @license    GNU General Public License version 2 or later; see LICENSE.txt
+ */
+
+namespace VDM\Joomla\Utilities\String;
+
+
+use Joomla\CMS\Component\ComponentHelper;
+use VDM\Joomla\Utilities\StringHelper;
+
+
+/**
+ * Control the naming of a field
+ */
+abstract class FieldHelper
+{
+	/**
+	* The field builder switch
+	**/
+	protected static $builder = false;
+
+	/**
+	* Making field names safe
+	*
+	* @input	string       The string you would like to make safe
+	* @input	boolean      The switch to return an ALL UPPER CASE string
+	* @input	string       The string to use in white space
+	*
+	* @returns string on success
+	**/
+	public static function safe($string, $allcap = false, $spacer = '_')
+	{
+		// get global value
+		if (self::$builder === false)
+		{
+			self::$builder = ComponentHelper::getParams('com_componentbuilder')->get('field_name_builder', 1);
+		}
+
+		// use the new convention
+		if (2 == self::$builder)
+		{
+			// 0nly continue if we have a string
+			if (StringHelper::check($string))
+			{
+				// check that the first character is not a number
+				if (is_numeric(substr($string, 0, 1)))
+				{
+					$string = StringHelper::numbers($string);
+				}
+
+				// remove all other strange characters
+				$string = trim($string);
+				$string = preg_replace('/'.$spacer.'+/', ' ', $string);
+				$string = preg_replace('/\s+/', ' ', $string);
+
+				// Transliterate string
+				$string = StringHelper::transliterate($string);
+
+				// remove all and keep only characters and numbers
+				$string = preg_replace("/[^A-Za-z0-9 ]/", '', $string);
+
+				// replace white space with underscore (SAFEST OPTION)
+				$string = preg_replace('/\s+/', $spacer, $string);
+
+				// return all caps
+				if ($allcap)
+				{
+					return strtoupper($string);
+				}
+
+				// default is to return lower
+				return strtolower($string);
+			}
+			// not a string
+			return '';
+		}
+
+		// return all caps
+		if ($allcap)
+		{
+			return StringHelper::safe($string, 'U');
+		}
+
+		// use the default (original behavior/convention)
+		return StringHelper::safe($string);
+	}
+
+}
+