Language translation

[feuerkind99]

Language translation seams to be working fine (as far as I can say) but is there a way to add new strings for custom files? I just added some curtom filters and added them to models/forms/filter*.xml ... Is there a better way to add them to the JCB Database or should I just add them as custom code to the language files? Any help or idea would be appreciated due to me being still very new to JCB :-) regards Markus

[Llewellynvdm]

if you are adding custom files, you can in your custom file use the same methods as in the site and custom admin views, just where you link the custom file, check the Should file be updated.:

Then JCB will take the strings, auto add them to your project and update them in the file.

How will this look like?

Lets say your custom file has this code:

/**
* Move File to Server
*
* @param   string    $localPath     The local path to the file
* @param   string    $fileName      The the actual file name
* @param   int         $serverID       The server local id to use
* @param   int         $protocol        The server protocol to use
* @param   string    $permission    The permission validation area
*
* @return  bool      true on success
**/
public static function moveToServer($localPath, $fileName, $serverID, $protocol = null, $permission = 'core.export')
{
	// get the server
	if ($server = self::getServer( (int) $serverID, $protocol, $permission))
	{
		// use the FTP protocol
		if (1 == $server->jcb_protocol)
		{
			// now move the file
			if (!$server->store($localPath, $fileName))
			{
				JFactory::getApplication()->enqueueMessage(JText::sprintf('The <b>%s</b> file could not be moved to <b>%s</b> server.', $fileName, $server->jcb_remote_server_name[(int) $serverID]), 'Error');
				return false;
			}
			// close the connection
			$server->quit();
		}
		// use the SFTP protocol
		elseif (2 == $server->jcb_protocol)
		{
			// now move the file
			if (!$server->put($server->jcb_remote_server_path[(int) $serverID] . $fileName, self::getFileContents($localPath, null)))
			{
				JFactory::getApplication()->enqueueMessage(JText::sprintf('The <b>%s</b> file could not be moved to <b>%s</b> path on <b>%s</b> server.', $fileName, $server->jcb_remote_server_path[(int) $serverID], $server->jcb_remote_server_name[(int) $serverID]), 'Error');
				return false;
			}
		}
		return true;
	}
	return false;
}

Then it will be changed to:

/**
* Move File to Server
*
* @param   string    $localPath     The local path to the file
* @param   string    $fileName      The the actual file name
* @param   int         $serverID       The server local id to use
* @param   int         $protocol        The server protocol to use
* @param   string    $permission    The permission validation area
*
* @return  bool      true on success
**/
public static function moveToServer($localPath, $fileName, $serverID, $protocol = null, $permission = 'core.export')
{
	// get the server
	if ($server = self::getServer( (int) $serverID, $protocol, $permission))
	{
		// use the FTP protocol
		if (1 == $server->jcb_protocol)
		{
			// now move the file
			if (!$server->store($localPath, $fileName))
			{
				JFactory::getApplication()->enqueueMessage(JText::sprintf('COM_COMPONENTBUILDER_THE_BSB_FILE_COULD_NOT_BE_MOVED_TO_BSB_SERVER', $fileName, $server->jcb_remote_server_name[(int) $serverID]), 'Error');
				return false;
			}
			// close the connection
			$server->quit();
		}
		// use the SFTP protocol
		elseif (2 == $server->jcb_protocol)
		{
			// now move the file
			if (!$server->put($server->jcb_remote_server_path[(int) $serverID] . $fileName, self::getFileContents($localPath, null)))
			{
				JFactory::getApplication()->enqueueMessage(JText::sprintf('COM_COMPONENTBUILDER_THE_BSB_FILE_COULD_NOT_BE_MOVED_TO_BSB_PATH_ON_BSB_SERVER', $fileName, $server->jcb_remote_server_path[(int) $serverID], $server->jcb_remote_server_name[(int) $serverID]), 'Error');
				return false;
			}
		}
		return true;
	}
	return false;
}

And these language strings will be added to your project:

COM_COMPONENTBUILDER_THE_BSB_FILE_COULD_NOT_BE_MOVED_TO_BSB_SERVER="The <b>%s</b> file could not be moved to <b>%s</b> server."
COM_COMPONENTBUILDER_THE_BSB_FILE_COULD_NOT_BE_MOVED_TO_BSB_PATH_ON_BSB_SERVER="The <b>%s</b> file could not be moved to <b>%s</b> path on <b>%s</b> server."

That simple... enjoy!

[feuerkind99]

Thanks for pointing me to the right direction. works perfectly ... somehow I messed up with custome code files and had some allready translated texts in it and was wondering wy they did not get translated ... maybe I change it in the component and then copied it back to the custom folder with allready translated code ...