File: /home/cafsindia/lead_cafsinfotech_in/public/legacy/include/SugarObjects/LanguageManager.php
<?php
/**
*
* SugarCRM Community Edition is a customer relationship management program developed by
* SugarCRM, Inc. Copyright (C) 2004-2013 SugarCRM Inc.
*
* SuiteCRM is an extension to SugarCRM Community Edition developed by SalesAgility Ltd.
* Copyright (C) 2011 - 2018 SalesAgility Ltd.
*
* This program is free software; you can redistribute it and/or modify it under
* the terms of the GNU Affero General Public License version 3 as published by the
* Free Software Foundation with the addition of the following permission added
* to Section 15 as permitted in Section 7(a): FOR ANY PART OF THE COVERED WORK
* IN WHICH THE COPYRIGHT IS OWNED BY SUGARCRM, SUGARCRM DISCLAIMS THE WARRANTY
* OF NON INFRINGEMENT OF THIRD PARTY RIGHTS.
*
* This program is distributed in the hope that it will be useful, but WITHOUT
* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
* FOR A PARTICULAR PURPOSE. See the GNU Affero General Public License for more
* details.
*
* You should have received a copy of the GNU Affero General Public License along with
* this program; if not, see http://www.gnu.org/licenses or write to the Free
* Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA
* 02110-1301 USA.
*
* You can contact SugarCRM, Inc. headquarters at 10050 North Wolfe Road,
* SW2-130, Cupertino, CA 95014, USA. or at email address contact@sugarcrm.com.
*
* The interactive user interfaces in modified source and object code versions
* of this program must display Appropriate Legal Notices, as required under
* Section 5 of the GNU Affero General Public License version 3.
*
* In accordance with Section 7(b) of the GNU Affero General Public License version 3,
* these Appropriate Legal Notices must retain the display of the "Powered by
* SugarCRM" logo and "Supercharged by SuiteCRM" logo. If the display of the logos is not
* reasonably feasible for technical reasons, the Appropriate Legal Notices must
* display the words "Powered by SugarCRM" and "Supercharged by SuiteCRM".
*/
if (!defined('sugarEntry') || !sugarEntry) {
die('Not A Valid Entry Point');
}
require_once __DIR__.'/translated_prefix.php';
/**
* Language files management
* @api
*/
class LanguageManager
{
/**
* Called from VardefManager to allow for caching a lang file for a module
* @param module - the name of the module we are working with
* @param templates - an array of templates this module uses
*/
public static function createLanguageFile($module, $templates=array('default'), $refresh = false)
{
global $mod_strings, $current_language;
if (inDeveloperMode() || !empty($_SESSION['developerMode'])) {
$refresh = true;
}
$temp_mod_strings = $mod_strings;
$lang = $current_language;
if (empty($lang)) {
$lang = $GLOBALS['sugar_config']['default_language'];
}
static $createdModules = array();
if (empty($createdModules[$module]) && ($refresh || !file_exists(sugar_cached('modules/').$module.'/language/'.$lang.'.lang.php'))) {
$loaded_mod_strings = array();
$loaded_mod_strings = LanguageManager::loadTemplateLanguage($module, $templates, $lang, $loaded_mod_strings);
$createdModules[$module] = true;
LanguageManager::refreshLanguage($module, $lang, $loaded_mod_strings);
}
}
/**
* Load the module tempalte lauguage files
* @param module - the name of the module we are working with
* @param templates - an array of templates this module uses
* @param lang - current language this module use
* @param loaded_mod_strings - the string that we will add the module template language into
*/
public static function loadTemplateLanguage($module, $templates, $lang, $loaded_mod_strings)
{
$templates = array_reverse($templates);
foreach ($templates as $template) {
$temp = LanguageManager::addTemplate($module, $lang, $template);
$loaded_mod_strings = sugarLangArrayMerge($loaded_mod_strings, $temp);
}
return $loaded_mod_strings;
}
public static function addTemplate($module, $lang, $template)
{
if ($template == 'default') {
$template = 'basic';
}
$templates = array();
$fields = array();
if (empty($templates[$template])) {
$path = 'include/SugarObjects/templates/' . $template . '/language/'.$lang.'.lang.php';
if (file_exists($path)) {
require($path);
$templates[$template] = $mod_strings;
} else {
$path = 'include/SugarObjects/implements/' . $template . '/language/'.$lang.'.lang.php';
if (file_exists($path)) {
require($path);
$templates[$template] = $mod_strings;
}
}
}
if (!empty($templates[$template])) {
return $templates[$template];
}
}
public static function saveCache($module, $lang, $loaded_mod_strings, $additonal_objects= array())
{
if (empty($lang)) {
$lang = $GLOBALS['sugar_config']['default_language'];
}
$file = create_cache_directory('modules/' . $module . '/language/'.$lang.'.lang.php');
write_array_to_file('mod_strings', $loaded_mod_strings, $file);
include($file);
// put the item in the sugar cache.
$key = self::getLanguageCacheKey($module, $lang);
sugar_cache_put($key, $loaded_mod_strings);
}
/**
* clear out the language cache.
* @param string module_dir the module_dir to clear, if not specified then clear
* clear language cache for all modules.
* @param string lang the name of the object we are clearing this is for sugar_cache
*/
public static function clearLanguageCache($module_dir = '', $lang = '')
{
if (empty($lang)) {
$languages = array_keys($GLOBALS['sugar_config']['languages']);
} else {
$languages = array($lang);
}
//if we have a module name specified then just remove that language file
//otherwise go through each module and clean up the language
if (!empty($module_dir)) {
foreach ($languages as $clean_lang) {
LanguageManager::_clearCache($module_dir, $clean_lang);
}
} else {
$cache_dir = sugar_cached('modules/');
if (file_exists($cache_dir) && $dir = @opendir($cache_dir)) {
while (($entry = readdir($dir)) !== false) {
if ($entry == "." || $entry == "..") {
continue;
}
foreach ($languages as $clean_lang) {
LanguageManager::_clearCache($entry, $clean_lang);
}
}
closedir($dir);
}
}
}
/**
* PRIVATE function used within clearLanguageCache so we do not repeat logic
* @param string module_dir the module_dir to clear
* @param string lang the name of the language file we are clearing this is for sugar_cache
*/
private static function _clearCache($module_dir, $lang = null)
{
if (!empty($module_dir) && !empty($lang)) {
$file = sugar_cached('modules/').$module_dir.'/language/'.$lang.'.lang.php';
if (file_exists($file)) {
unlink($file);
$key = self::getLanguageCacheKey($module_dir, $lang);
sugar_cache_clear($key);
}
}
}
/**
* Given a module, search all of the specified locations, and any others as specified
* in order to refresh the cache file
*
* @param string $module the given module we want to load the vardefs for
* @param string $lang the given language we wish to load
* @param array $additional_search_paths an array which allows a consumer to pass in additional vardef locations to search
*/
public static function refreshLanguage($module, $lang, $loaded_mod_strings = array(), $additional_search_paths = null)
{
// Some of the vardefs do not correctly define dictionary as global. Declare it first.
$lang_paths = array(
'modules/' . $module . '/language/' . $lang . '.lang.php',
'modules/' . $module . '/language/' . $lang . '.lang.override.php',
'custom/modules/' . $module . '/language/' . $lang . '.lang.php',
'custom/modules/' . $module . '/Ext/Language/' . $lang . '.lang.ext.php',
);
require_once 'ModuleInstall/ExtensionManager.php';
SuiteCRM\ModuleInstall\ExtensionManager::compileExtensionFiles('Language', '.lang.ext.php', $lang);
#27023, if this module template language file was not attached , get the template from this module vardef cache file if exsits and load the template language files.
static $createdModules;
if (empty($createdModules[$module]) && isset($GLOBALS['beanList'][$module])) {
$object = $GLOBALS['beanList'][$module];
if ($object == 'aCase') {
$object = 'Case';
}
if (!empty($GLOBALS["dictionary"][(string)$object]["templates"])) {
$templates = $GLOBALS["dictionary"][(string)$object]["templates"];
$loaded_mod_strings = LanguageManager::loadTemplateLanguage($module, $templates, $lang, $loaded_mod_strings);
$createdModules[$module] = true;
}
}
//end of fix #27023
// Add in additional search paths if they were provided.
if (!empty($additional_search_paths) && is_array($additional_search_paths)) {
$lang_paths = array_merge($lang_paths, $additional_search_paths);
}
//search a predefined set of locations for the vardef files
foreach ($lang_paths as $path) {
if (file_exists($path)) {
require($path);
if (!empty($mod_strings)) {
if (function_exists('sugarArrayMergeRecursive')) {
$loaded_mod_strings = sugarArrayMergeRecursive($loaded_mod_strings, $mod_strings);
} else {
$loaded_mod_strings = sugarLangArrayMerge($loaded_mod_strings, $mod_strings);
}
}
}
}
//great! now that we have loaded all of our vardefs.
//let's go save them to the cache file.
if (!empty($loaded_mod_strings)) {
LanguageManager::saveCache($module, $lang, $loaded_mod_strings);
}
}
public static function loadModuleLanguage($module, $lang, $refresh=false)
{
//here check if the cache file exists, if it does then load it, if it doesn't
//then call refreshVardef
//if either our session or the system is set to developerMode then refresh is set to true
// Retrieve the vardefs from cache.
$key = self::getLanguageCacheKey($module, $lang);
if (!$refresh) {
$return_result = sugar_cache_retrieve($key);
if (!empty($return_result) && is_array($return_result)) {
return $return_result;
}
}
// Some of the vardefs do not correctly define dictionary as global. Declare it first.
$cachedfile = sugar_cached('modules/').$module.'/language/'.$lang.'.lang.php';
if ($refresh || !file_exists($cachedfile)) {
LanguageManager::refreshLanguage($module, $lang);
}
//at this point we should have the cache/modules/... file
//which was created from the refreshVardefs so let's try to load it.
if (file_exists($cachedfile)) {
global $mod_strings;
require $cachedfile;
// now that we hae loaded the data from disk, put it in the cache.
if (!empty($mod_strings)) {
sugar_cache_put($key, $mod_strings);
}
if (!empty($_SESSION['translation_mode'])) {
$mod_strings = array_map('translated_prefix', $mod_strings);
}
return $mod_strings;
}
}
/**
* Return the cache key for the module language definition
*
* @static
* @param $module
* @param $lang
* @return string
*/
public static function getLanguageCacheKey($module, $lang)
{
return "LanguageManager.$module.$lang";
}
/**
* Remove any cached js language strings.
*
* @static
* @return void
*/
public static function removeJSLanguageFiles()
{
$jsFiles = array();
getFiles($jsFiles, sugar_cached('jsLanguage'));
foreach ($jsFiles as $file) {
unlink($file);
}
if (empty($GLOBALS['sugar_config']['js_lang_version'])) {
$GLOBALS['sugar_config']['js_lang_version'] = 1;
} else {
$GLOBALS['sugar_config']['js_lang_version'] += 1;
}
write_array_to_file("sugar_config", $GLOBALS['sugar_config'], "config.php");
}
}