includes/lang.php
author Dan
Sat, 17 Nov 2007 22:12:31 -0500
changeset 265 7e0cdf71b1bb
parent 243 a7d0f2711df1
child 334 c72b545f1304
permissions -rw-r--r--
Some (not much) progress with localizing tooltips on the pagebar. Still aways to go and committing so as to merge changes from stable
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
205
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
     1
<?php
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
     2
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
     3
/*
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
     4
 * Enano - an open-source CMS capable of wiki functions, Drupal-like sidebar blocks, and everything in between
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
     5
 * Version 1.1.1
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
     6
 * Copyright (C) 2006-2007 Dan Fuhry
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
     7
 *
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
     8
 * This program is Free Software; you can redistribute and/or modify it under the terms of the GNU General Public License
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
     9
 * as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
    10
 *
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
    11
 * This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
    12
 * warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for details.
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
    13
 */
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
    14
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
    15
/**
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
    16
 * Language class - processes, stores, and retrieves language strings.
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
    17
 * @package Enano
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
    18
 * @subpackage Localization
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
    19
 * @copyright 2007 Dan Fuhry
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
    20
 * @license GNU General Public License
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
    21
 */
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
    22
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
    23
class Language
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
    24
{
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
    25
  
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
    26
  /**
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
    27
   * The numerical ID of the loaded language.
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
    28
   * @var int
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
    29
   */
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
    30
  
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
    31
  var $lang_id;
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
    32
  
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
    33
  /**
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
    34
   * The ISO-639-3 code for the loaded language. This should be grabbed directly from the database.
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
    35
   * @var string
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
    36
   */
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
    37
  
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
    38
  var $lang_code;
210
2b283402e4e4 Added language export to JSON page and localization for Javascript using $lang.get(). Localized AJAX login interface.
Dan
parents: 209
diff changeset
    39
2b283402e4e4 Added language export to JSON page and localization for Javascript using $lang.get(). Localized AJAX login interface.
Dan
parents: 209
diff changeset
    40
  /**
2b283402e4e4 Added language export to JSON page and localization for Javascript using $lang.get(). Localized AJAX login interface.
Dan
parents: 209
diff changeset
    41
   * Used to track when a language was last changed, to allow browsers to cache language data
2b283402e4e4 Added language export to JSON page and localization for Javascript using $lang.get(). Localized AJAX login interface.
Dan
parents: 209
diff changeset
    42
   * @var int
2b283402e4e4 Added language export to JSON page and localization for Javascript using $lang.get(). Localized AJAX login interface.
Dan
parents: 209
diff changeset
    43
   */
2b283402e4e4 Added language export to JSON page and localization for Javascript using $lang.get(). Localized AJAX login interface.
Dan
parents: 209
diff changeset
    44
  
2b283402e4e4 Added language export to JSON page and localization for Javascript using $lang.get(). Localized AJAX login interface.
Dan
parents: 209
diff changeset
    45
  var $lang_timestamp;
205
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
    46
  
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
    47
  /**
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
    48
   * Will be an object that holds an instance of the class configured with the site's default language. Only instanciated when needed.
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
    49
   * @var object
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
    50
   */
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
    51
  
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
    52
  var $default;
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
    53
  
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
    54
  /**
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
    55
   * The list of loaded strings.
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
    56
   * @var array
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
    57
   * @access private
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
    58
   */
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
    59
  
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
    60
  var $strings = array();
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
    61
  
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
    62
  /**
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
    63
   * Constructor.
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
    64
   * @param int|string Language ID or code to load.
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
    65
   */
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
    66
  
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
    67
  function __construct($lang)
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
    68
  {
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
    69
    global $db, $session, $paths, $template, $plugins; // Common objects
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
    70
    
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
    71
    if ( defined('IN_ENANO_INSTALL') )
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
    72
    {
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
    73
      // special case for the Enano installer: it will load its own strings from a JSON file and just use this API for fetching and templatizing them.
243
a7d0f2711df1 Installer localization started. Welcome, License, and SysReqs pages are fully localized.
Dan
parents: 241
diff changeset
    74
      $this->lang_id   = 1;
a7d0f2711df1 Installer localization started. Welcome, License, and SysReqs pages are fully localized.
Dan
parents: 241
diff changeset
    75
      $this->lang_code = $lang;
205
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
    76
      return true;
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
    77
    }
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
    78
    if ( is_string($lang) )
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
    79
    {
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
    80
      $sql_col = 'lang_code="' . $db->escape($lang) . '"';
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
    81
    }
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
    82
    else if ( is_int($lang) )
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
    83
    {
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
    84
      $sql_col = 'lang_id=' . $lang . '';
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
    85
    }
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
    86
    else
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
    87
    {
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
    88
      $db->_die('lang.php - attempting to pass invalid value to constructor');
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
    89
    }
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
    90
    
239
0f1b353570a7 Fix a comparison logic SQL error in lang.php; fix attempt to call mysql_real_escape_string() in install without a working DB connection
Dan
parents: 215
diff changeset
    91
    $lang_default = ( $x = getConfig('default_language') ) ? intval($x) : '\'def\'';
210
2b283402e4e4 Added language export to JSON page and localization for Javascript using $lang.get(). Localized AJAX login interface.
Dan
parents: 209
diff changeset
    92
    $q = $db->sql_query("SELECT lang_id, lang_code, last_changed, ( lang_id = $lang_default ) AS is_default FROM " . table_prefix . "language WHERE $sql_col OR lang_id = $lang_default ORDER BY is_default DESC LIMIT 1;");
205
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
    93
    
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
    94
    if ( !$q )
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
    95
      $db->_die('lang.php - main select query');
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
    96
    
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
    97
    if ( $db->numrows() < 1 )
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
    98
      $db->_die('lang.php - There are no languages installed');
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
    99
    
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   100
    $row = $db->fetchrow();
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   101
    
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   102
    $this->lang_id   = intval( $row['lang_id'] );
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   103
    $this->lang_code = $row['lang_code'];
210
2b283402e4e4 Added language export to JSON page and localization for Javascript using $lang.get(). Localized AJAX login interface.
Dan
parents: 209
diff changeset
   104
    $this->lang_timestamp = $row['last_changed'];
205
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   105
  }
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   106
  
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   107
  /**
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   108
   * PHP 4 constructor.
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   109
   * @param int|string Language ID or code to load.
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   110
   */
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   111
  
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   112
  function Language($lang)
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   113
  {
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   114
    $this->__construct($lang);
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   115
  }
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   116
  
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   117
  /**
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   118
   * Fetches language strings from the database, or a cache file if it's available.
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   119
   * @param bool If true (default), allows the cache to be used.
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   120
   */
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   121
  
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   122
  function fetch($allow_cache = true)
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   123
  {
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   124
    global $db, $session, $paths, $template, $plugins; // Common objects
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   125
    
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   126
    $lang_file = ENANO_ROOT . "/cache/lang_{$this->lang_id}.php";
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   127
    // Attempt to load the strings from a cache file
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   128
    if ( file_exists($lang_file) && $allow_cache )
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   129
    {
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   130
      // Yay! found it
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   131
      $this->load_cache_file($lang_file);
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   132
    }
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   133
    else
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   134
    {
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   135
      // No cache file - select and retrieve from the database
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   136
      $q = $db->sql_unbuffered_query("SELECT string_category, string_name, string_content FROM " . table_prefix . "language_strings WHERE lang_id = {$this->lang_id};");
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   137
      if ( !$q )
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   138
        $db->_die('lang.php - selecting language string data');
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   139
      if ( $row = $db->fetchrow() )
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   140
      {
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   141
        $strings = array();
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   142
        do
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   143
        {
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   144
          $cat =& $row['string_category'];
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   145
          if ( !is_array($strings[$cat]) )
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   146
          {
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   147
            $strings[$cat] = array();
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   148
          }
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   149
          $strings[$cat][ $row['string_name'] ] = $row['string_content'];
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   150
        }
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   151
        while ( $row = $db->fetchrow() );
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   152
        // all done fetching
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   153
        $this->merge($strings);
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   154
      }
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   155
      else
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   156
      {
241
c671f3bb8aed Trying to get lang import to work in the installer; it's not working ATM - cache file is generated with lang_id = 0. Syncing to Nighthawk.
Dan
parents: 239
diff changeset
   157
        if ( !defined('ENANO_ALLOW_LOAD_NOLANG') )
c671f3bb8aed Trying to get lang import to work in the installer; it's not working ATM - cache file is generated with lang_id = 0. Syncing to Nighthawk.
Dan
parents: 239
diff changeset
   158
          $db->_die('lang.php - No strings for language ' . $this->lang_code);
205
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   159
      }
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   160
    }
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   161
  }
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   162
  
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   163
  /**
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   164
   * Loads a file from the disk cache (treated as PHP) and merges it into RAM.
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   165
   * @param string File to load
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   166
   */
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   167
  
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   168
  function load_cache_file($file)
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   169
  {
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   170
    global $db, $session, $paths, $template, $plugins; // Common objects
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   171
    
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   172
    // We're using eval() here because it makes handling scope easier.
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   173
    
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   174
    if ( !file_exists($file) )
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   175
      $db->_die('lang.php - requested cache file doesn\'t exist');
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   176
    
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   177
    $contents = file_get_contents($file);
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   178
    $contents = preg_replace('/([\s]*)<\?php/', '', $contents);
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   179
    
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   180
    @eval($contents);
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   181
    
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   182
    if ( !isset($lang_cache) || ( isset($lang_cache) && !is_array($lang_cache) ) )
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   183
      $db->_die('lang.php - the cache file is invalid (didn\'t set $lang_cache as an array)');
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   184
    
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   185
    $this->merge($lang_cache);
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   186
  }
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   187
  
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   188
  /**
243
a7d0f2711df1 Installer localization started. Welcome, License, and SysReqs pages are fully localized.
Dan
parents: 241
diff changeset
   189
   * Loads a JSON language file and parses the strings into RAM. Will use the cache if possible, but stays far away from the database,
a7d0f2711df1 Installer localization started. Welcome, License, and SysReqs pages are fully localized.
Dan
parents: 241
diff changeset
   190
   * which we assume doesn't exist yet.
a7d0f2711df1 Installer localization started. Welcome, License, and SysReqs pages are fully localized.
Dan
parents: 241
diff changeset
   191
   */
a7d0f2711df1 Installer localization started. Welcome, License, and SysReqs pages are fully localized.
Dan
parents: 241
diff changeset
   192
  
a7d0f2711df1 Installer localization started. Welcome, License, and SysReqs pages are fully localized.
Dan
parents: 241
diff changeset
   193
  function load_file($file)
a7d0f2711df1 Installer localization started. Welcome, License, and SysReqs pages are fully localized.
Dan
parents: 241
diff changeset
   194
  {
a7d0f2711df1 Installer localization started. Welcome, License, and SysReqs pages are fully localized.
Dan
parents: 241
diff changeset
   195
    global $db, $session, $paths, $template, $plugins; // Common objects
a7d0f2711df1 Installer localization started. Welcome, License, and SysReqs pages are fully localized.
Dan
parents: 241
diff changeset
   196
    
a7d0f2711df1 Installer localization started. Welcome, License, and SysReqs pages are fully localized.
Dan
parents: 241
diff changeset
   197
    if ( !file_exists($file) )
a7d0f2711df1 Installer localization started. Welcome, License, and SysReqs pages are fully localized.
Dan
parents: 241
diff changeset
   198
      $db->_die('lang.php - requested JSON file doesn\'t exist');
a7d0f2711df1 Installer localization started. Welcome, License, and SysReqs pages are fully localized.
Dan
parents: 241
diff changeset
   199
    
a7d0f2711df1 Installer localization started. Welcome, License, and SysReqs pages are fully localized.
Dan
parents: 241
diff changeset
   200
    $contents = trim(@file_get_contents($file));
a7d0f2711df1 Installer localization started. Welcome, License, and SysReqs pages are fully localized.
Dan
parents: 241
diff changeset
   201
    if ( empty($contents) )
a7d0f2711df1 Installer localization started. Welcome, License, and SysReqs pages are fully localized.
Dan
parents: 241
diff changeset
   202
      $db->_die('lang.php - empty language file...');
a7d0f2711df1 Installer localization started. Welcome, License, and SysReqs pages are fully localized.
Dan
parents: 241
diff changeset
   203
    
a7d0f2711df1 Installer localization started. Welcome, License, and SysReqs pages are fully localized.
Dan
parents: 241
diff changeset
   204
    // Trim off all text before and after the starting and ending braces
a7d0f2711df1 Installer localization started. Welcome, License, and SysReqs pages are fully localized.
Dan
parents: 241
diff changeset
   205
    $contents = preg_replace('/^([^{]+)\{/', '{', $contents);
a7d0f2711df1 Installer localization started. Welcome, License, and SysReqs pages are fully localized.
Dan
parents: 241
diff changeset
   206
    $contents = preg_replace('/\}([^}]+)$/', '}', $contents);
a7d0f2711df1 Installer localization started. Welcome, License, and SysReqs pages are fully localized.
Dan
parents: 241
diff changeset
   207
    $contents = trim($contents);
a7d0f2711df1 Installer localization started. Welcome, License, and SysReqs pages are fully localized.
Dan
parents: 241
diff changeset
   208
    
a7d0f2711df1 Installer localization started. Welcome, License, and SysReqs pages are fully localized.
Dan
parents: 241
diff changeset
   209
    if ( empty($contents) )
a7d0f2711df1 Installer localization started. Welcome, License, and SysReqs pages are fully localized.
Dan
parents: 241
diff changeset
   210
      $db->_die('lang.php - no meat to the language file...');
a7d0f2711df1 Installer localization started. Welcome, License, and SysReqs pages are fully localized.
Dan
parents: 241
diff changeset
   211
    
a7d0f2711df1 Installer localization started. Welcome, License, and SysReqs pages are fully localized.
Dan
parents: 241
diff changeset
   212
    $checksum = md5($contents);
a7d0f2711df1 Installer localization started. Welcome, License, and SysReqs pages are fully localized.
Dan
parents: 241
diff changeset
   213
    if ( file_exists("./cache/lang_json_{$checksum}.php") )
a7d0f2711df1 Installer localization started. Welcome, License, and SysReqs pages are fully localized.
Dan
parents: 241
diff changeset
   214
    {
a7d0f2711df1 Installer localization started. Welcome, License, and SysReqs pages are fully localized.
Dan
parents: 241
diff changeset
   215
      $this->load_cache_file("./cache/lang_json_{$checksum}.php");
a7d0f2711df1 Installer localization started. Welcome, License, and SysReqs pages are fully localized.
Dan
parents: 241
diff changeset
   216
    }
a7d0f2711df1 Installer localization started. Welcome, License, and SysReqs pages are fully localized.
Dan
parents: 241
diff changeset
   217
    else
a7d0f2711df1 Installer localization started. Welcome, License, and SysReqs pages are fully localized.
Dan
parents: 241
diff changeset
   218
    {
a7d0f2711df1 Installer localization started. Welcome, License, and SysReqs pages are fully localized.
Dan
parents: 241
diff changeset
   219
      $json = new Services_JSON(SERVICES_JSON_LOOSE_TYPE);
a7d0f2711df1 Installer localization started. Welcome, License, and SysReqs pages are fully localized.
Dan
parents: 241
diff changeset
   220
      $langdata = $json->decode($contents);
a7d0f2711df1 Installer localization started. Welcome, License, and SysReqs pages are fully localized.
Dan
parents: 241
diff changeset
   221
    
a7d0f2711df1 Installer localization started. Welcome, License, and SysReqs pages are fully localized.
Dan
parents: 241
diff changeset
   222
      if ( !is_array($langdata) )
a7d0f2711df1 Installer localization started. Welcome, License, and SysReqs pages are fully localized.
Dan
parents: 241
diff changeset
   223
        $db->_die('lang.php - invalid language file');
a7d0f2711df1 Installer localization started. Welcome, License, and SysReqs pages are fully localized.
Dan
parents: 241
diff changeset
   224
      
a7d0f2711df1 Installer localization started. Welcome, License, and SysReqs pages are fully localized.
Dan
parents: 241
diff changeset
   225
      if ( !isset($langdata['categories']) || !isset($langdata['strings']) )
a7d0f2711df1 Installer localization started. Welcome, License, and SysReqs pages are fully localized.
Dan
parents: 241
diff changeset
   226
        $db->_die('lang.php - language file does not contain the proper items');
a7d0f2711df1 Installer localization started. Welcome, License, and SysReqs pages are fully localized.
Dan
parents: 241
diff changeset
   227
      
a7d0f2711df1 Installer localization started. Welcome, License, and SysReqs pages are fully localized.
Dan
parents: 241
diff changeset
   228
      $this->merge($langdata['strings']);
a7d0f2711df1 Installer localization started. Welcome, License, and SysReqs pages are fully localized.
Dan
parents: 241
diff changeset
   229
      
a7d0f2711df1 Installer localization started. Welcome, License, and SysReqs pages are fully localized.
Dan
parents: 241
diff changeset
   230
      $lang_file = "./cache/lang_json_{$checksum}.php";
a7d0f2711df1 Installer localization started. Welcome, License, and SysReqs pages are fully localized.
Dan
parents: 241
diff changeset
   231
      
a7d0f2711df1 Installer localization started. Welcome, License, and SysReqs pages are fully localized.
Dan
parents: 241
diff changeset
   232
      $handle = @fopen($lang_file, 'w');
a7d0f2711df1 Installer localization started. Welcome, License, and SysReqs pages are fully localized.
Dan
parents: 241
diff changeset
   233
      if ( !$handle )
a7d0f2711df1 Installer localization started. Welcome, License, and SysReqs pages are fully localized.
Dan
parents: 241
diff changeset
   234
        // Couldn't open the file. Silently fail and let the strings come from RAM.
a7d0f2711df1 Installer localization started. Welcome, License, and SysReqs pages are fully localized.
Dan
parents: 241
diff changeset
   235
        return false;
a7d0f2711df1 Installer localization started. Welcome, License, and SysReqs pages are fully localized.
Dan
parents: 241
diff changeset
   236
        
a7d0f2711df1 Installer localization started. Welcome, License, and SysReqs pages are fully localized.
Dan
parents: 241
diff changeset
   237
      // The file's open, that means we should be good.
a7d0f2711df1 Installer localization started. Welcome, License, and SysReqs pages are fully localized.
Dan
parents: 241
diff changeset
   238
      fwrite($handle, '<?php
a7d0f2711df1 Installer localization started. Welcome, License, and SysReqs pages are fully localized.
Dan
parents: 241
diff changeset
   239
// This file was generated automatically by Enano. You should not edit this file because any changes you make
a7d0f2711df1 Installer localization started. Welcome, License, and SysReqs pages are fully localized.
Dan
parents: 241
diff changeset
   240
// to it will not be visible in the ACP and all changes will be lost upon any changes to strings in the admin panel.
a7d0f2711df1 Installer localization started. Welcome, License, and SysReqs pages are fully localized.
Dan
parents: 241
diff changeset
   241
a7d0f2711df1 Installer localization started. Welcome, License, and SysReqs pages are fully localized.
Dan
parents: 241
diff changeset
   242
$lang_cache = ');
a7d0f2711df1 Installer localization started. Welcome, License, and SysReqs pages are fully localized.
Dan
parents: 241
diff changeset
   243
      
a7d0f2711df1 Installer localization started. Welcome, License, and SysReqs pages are fully localized.
Dan
parents: 241
diff changeset
   244
      $exported = $this->var_export_string($this->strings);
a7d0f2711df1 Installer localization started. Welcome, License, and SysReqs pages are fully localized.
Dan
parents: 241
diff changeset
   245
      if ( empty($exported) )
a7d0f2711df1 Installer localization started. Welcome, License, and SysReqs pages are fully localized.
Dan
parents: 241
diff changeset
   246
        // Ehh, that's not good
a7d0f2711df1 Installer localization started. Welcome, License, and SysReqs pages are fully localized.
Dan
parents: 241
diff changeset
   247
        $db->_die('lang.php - load_file(): var_export_string() failed');
a7d0f2711df1 Installer localization started. Welcome, License, and SysReqs pages are fully localized.
Dan
parents: 241
diff changeset
   248
      
a7d0f2711df1 Installer localization started. Welcome, License, and SysReqs pages are fully localized.
Dan
parents: 241
diff changeset
   249
      fwrite($handle, $exported . '; ?>');
a7d0f2711df1 Installer localization started. Welcome, License, and SysReqs pages are fully localized.
Dan
parents: 241
diff changeset
   250
      
a7d0f2711df1 Installer localization started. Welcome, License, and SysReqs pages are fully localized.
Dan
parents: 241
diff changeset
   251
      // Clean up
a7d0f2711df1 Installer localization started. Welcome, License, and SysReqs pages are fully localized.
Dan
parents: 241
diff changeset
   252
      unset($exported, $langdata);
a7d0f2711df1 Installer localization started. Welcome, License, and SysReqs pages are fully localized.
Dan
parents: 241
diff changeset
   253
      
a7d0f2711df1 Installer localization started. Welcome, License, and SysReqs pages are fully localized.
Dan
parents: 241
diff changeset
   254
      // Done =)
a7d0f2711df1 Installer localization started. Welcome, License, and SysReqs pages are fully localized.
Dan
parents: 241
diff changeset
   255
      fclose($handle);
a7d0f2711df1 Installer localization started. Welcome, License, and SysReqs pages are fully localized.
Dan
parents: 241
diff changeset
   256
    }
a7d0f2711df1 Installer localization started. Welcome, License, and SysReqs pages are fully localized.
Dan
parents: 241
diff changeset
   257
  }
a7d0f2711df1 Installer localization started. Welcome, License, and SysReqs pages are fully localized.
Dan
parents: 241
diff changeset
   258
  
a7d0f2711df1 Installer localization started. Welcome, License, and SysReqs pages are fully localized.
Dan
parents: 241
diff changeset
   259
  /**
205
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   260
   * Merges a standard language assoc array ($arr[cat][stringid]) with the master in RAM.
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   261
   * @param array
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   262
   */
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   263
  
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   264
  function merge($strings)
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   265
  {
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   266
    // This is stupidly simple.
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   267
    foreach ( $strings as $cat_id => $contents )
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   268
    {
243
a7d0f2711df1 Installer localization started. Welcome, License, and SysReqs pages are fully localized.
Dan
parents: 241
diff changeset
   269
      if ( !isset($this->strings[$cat_id]) || ( isset($this->strings[$cat_id]) && !is_array($this->strings[$cat_id]) ) )
205
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   270
        $this->strings[$cat_id] = array();
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   271
      foreach ( $contents as $string_id => $string )
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   272
      {
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   273
        $this->strings[$cat_id][$string_id] = $string;
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   274
      }
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   275
    }
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   276
  }
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   277
  
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   278
  /**
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   279
   * Imports a JSON-format language file into the database and merges with current strings.
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   280
   * @param string Path to the JSON file to load
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   281
   */
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   282
  
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   283
  function import($file)
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   284
  {
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   285
    global $db, $session, $paths, $template, $plugins; // Common objects
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   286
    
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   287
    if ( !file_exists($file) )
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   288
      $db->_die('lang.php - can\'t import language file: string file doesn\'t exist');
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   289
    
241
c671f3bb8aed Trying to get lang import to work in the installer; it's not working ATM - cache file is generated with lang_id = 0. Syncing to Nighthawk.
Dan
parents: 239
diff changeset
   290
    if ( $this->lang_id == 0 )
c671f3bb8aed Trying to get lang import to work in the installer; it's not working ATM - cache file is generated with lang_id = 0. Syncing to Nighthawk.
Dan
parents: 239
diff changeset
   291
      $db->_die('lang.php - BUG: trying to perform import when $lang->lang_id == 0');
c671f3bb8aed Trying to get lang import to work in the installer; it's not working ATM - cache file is generated with lang_id = 0. Syncing to Nighthawk.
Dan
parents: 239
diff changeset
   292
    
205
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   293
    $contents = trim(@file_get_contents($file));
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   294
    
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   295
    if ( empty($contents) )
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   296
      $db->_die('lang.php - can\'t load the contents of the language file');
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   297
    
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   298
    // Trim off all text before and after the starting and ending braces
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   299
    $contents = preg_replace('/^([^{]+)\{/', '{', $contents);
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   300
    $contents = preg_replace('/\}([^}]+)$/', '}', $contents);
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   301
    
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   302
    $json = new Services_JSON(SERVICES_JSON_LOOSE_TYPE);
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   303
    $langdata = $json->decode($contents);
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   304
    
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   305
    if ( !is_array($langdata) )
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   306
      $db->_die('lang.php - invalid language file');
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   307
    
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   308
    if ( !isset($langdata['categories']) || !isset($langdata['strings']) )
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   309
      $db->_die('lang.php - language file does not contain the proper items');
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   310
    
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   311
    $insert_list = array();
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   312
    $delete_list = array();
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   313
    
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   314
    foreach ( $langdata['categories'] as $category )
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   315
    {
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   316
      if ( isset($langdata['strings'][$category]) )
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   317
      {
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   318
        foreach ( $langdata['strings'][$category] as $string_name => $string_value )
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   319
        {
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   320
          $string_name = $db->escape($string_name);
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   321
          $string_value = $db->escape($string_value);
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   322
          $category_name = $db->escape($category);
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   323
          $insert_list[] = "({$this->lang_id}, '$category_name', '$string_name', '$string_value')";
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   324
          $delete_list[] = "( lang_id = {$this->lang_id} AND string_category = '$category_name' AND string_name = '$string_name' )";
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   325
        }
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   326
      }
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   327
    }
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   328
    
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   329
    $delete_list = implode(" OR\n  ", $delete_list);
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   330
    $sql = "DELETE FROM " . table_prefix . "language_strings WHERE $delete_list;";
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   331
    
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   332
    // Free some memory
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   333
    unset($delete_list);
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   334
    
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   335
    // Run the query
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   336
    $q = $db->sql_query($sql);
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   337
    if ( !$q )
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   338
      $db->_die('lang.php - couldn\'t kill off them old strings');
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   339
    
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   340
    $insert_list = implode(",\n  ", $insert_list);
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   341
    $sql = "INSERT INTO " . table_prefix . "language_strings(lang_id, string_category, string_name, string_content) VALUES\n  $insert_list;";
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   342
    
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   343
    // Free some memory
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   344
    unset($insert_list);
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   345
    
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   346
    // Run the query
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   347
    $q = $db->sql_query($sql);
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   348
    if ( !$q )
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   349
      $db->_die('lang.php - couldn\'t insert strings in import()');
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   350
    
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   351
    // YAY! done!
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   352
    // This will regenerate the cache file if possible.
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   353
    $this->regen_caches();
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   354
  }
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   355
  
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   356
  /**
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   357
   * Refetches the strings and writes out the cache file.
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   358
   */
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   359
  
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   360
  function regen_caches()
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   361
  {
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   362
    global $db, $session, $paths, $template, $plugins; // Common objects
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   363
    
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   364
    $lang_file = ENANO_ROOT . "/cache/lang_{$this->lang_id}.php";
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   365
    
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   366
    // Refresh the strings in RAM to the latest copies in the DB
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   367
    $this->fetch(false);
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   368
    
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   369
    $handle = @fopen($lang_file, 'w');
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   370
    if ( !$handle )
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   371
      // Couldn't open the file. Silently fail and let the strings come from the database.
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   372
      return false;
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   373
      
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   374
    // The file's open, that means we should be good.
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   375
    fwrite($handle, '<?php
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   376
// This file was generated automatically by Enano. You should not edit this file because any changes you make
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   377
// to it will not be visible in the ACP and all changes will be lost upon any changes to strings in the admin panel.
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   378
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   379
$lang_cache = ');
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   380
    
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   381
    $exported = $this->var_export_string($this->strings);
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   382
    if ( empty($exported) )
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   383
      // Ehh, that's not good
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   384
      $db->_die('lang.php - var_export_string() failed');
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   385
    
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   386
    fwrite($handle, $exported . '; ?>');
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   387
    
210
2b283402e4e4 Added language export to JSON page and localization for Javascript using $lang.get(). Localized AJAX login interface.
Dan
parents: 209
diff changeset
   388
    // Update timestamp in database
2b283402e4e4 Added language export to JSON page and localization for Javascript using $lang.get(). Localized AJAX login interface.
Dan
parents: 209
diff changeset
   389
    $q = $db->sql_query('UPDATE ' . table_prefix . 'language SET last_changed = ' . time() . ' WHERE lang_id = ' . $this->lang_id . ';');
2b283402e4e4 Added language export to JSON page and localization for Javascript using $lang.get(). Localized AJAX login interface.
Dan
parents: 209
diff changeset
   390
    if ( !$q )
2b283402e4e4 Added language export to JSON page and localization for Javascript using $lang.get(). Localized AJAX login interface.
Dan
parents: 209
diff changeset
   391
      $db->_die('lang.php - updating timestamp on language');
2b283402e4e4 Added language export to JSON page and localization for Javascript using $lang.get(). Localized AJAX login interface.
Dan
parents: 209
diff changeset
   392
    
205
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   393
    // Done =)
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   394
    fclose($handle);
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   395
  }
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   396
  
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   397
  /**
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   398
   * Calls var_export() on whatever, and returns the function's output.
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   399
   * @param mixed Whatever you want var_exported. Usually an array.
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   400
   * @return string
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   401
   */
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   402
  
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   403
  function var_export_string($val)
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   404
  {
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   405
    ob_start();
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   406
    var_export($val);
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   407
    $contents = ob_get_contents();
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   408
    ob_end_clean();
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   409
    return $contents;
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   410
  }
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   411
  
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   412
  /**
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   413
   * Fetches a language string from the cache in RAM. If it isn't there, it will call fetch() again and then try. If it still can't find it, it will ask for the string
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   414
   * in the default language. If even then the string can't be found, this function will return what was passed to it.
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   415
   *
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   416
   * This will also templatize strings. If a string contains variables in the format %foo%, you may specify the second parameter as an associative array in the format
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   417
   * of 'foo' => 'foo substitute'.
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   418
   *
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   419
   * @param string ID of the string to fetch. This will always be in the format of category_stringid.
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   420
   * @param array Optional. Associative array of substitutions.
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   421
   * @return string
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   422
   */
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   423
  
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   424
  function get($string_id, $substitutions = false)
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   425
  {
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   426
    // Extract the category and string ID
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   427
    $category = substr($string_id, 0, ( strpos($string_id, '_') ));
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   428
    $string_name = substr($string_id, ( strpos($string_id, '_') + 1 ));
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   429
    $found = false;
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   430
    if ( isset($this->strings[$category]) && isset($this->strings[$category][$string_name]) )
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   431
    {
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   432
      $found = true;
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   433
      $string = $this->strings[$category][$string_name];
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   434
    }
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   435
    if ( !$found )
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   436
    {
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   437
      // Ehh, the string wasn't found. Rerun fetch() and try again.
243
a7d0f2711df1 Installer localization started. Welcome, License, and SysReqs pages are fully localized.
Dan
parents: 241
diff changeset
   438
      if ( defined('IN_ENANO_INSTALL') )
a7d0f2711df1 Installer localization started. Welcome, License, and SysReqs pages are fully localized.
Dan
parents: 241
diff changeset
   439
      {
a7d0f2711df1 Installer localization started. Welcome, License, and SysReqs pages are fully localized.
Dan
parents: 241
diff changeset
   440
        return $string_id;
a7d0f2711df1 Installer localization started. Welcome, License, and SysReqs pages are fully localized.
Dan
parents: 241
diff changeset
   441
      }
205
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   442
      $this->fetch();
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   443
      if ( isset($this->strings[$category]) && isset($this->strings[$category][$string_name]) )
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   444
      {
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   445
        $found = true;
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   446
        $string = $this->strings[$category][$string_name];
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   447
      }
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   448
      if ( !$found )
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   449
      {
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   450
        // STILL not found. Check the default language.
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   451
        $lang_default = ( $x = getConfig('default_language') ) ? intval($x) : $this->lang_id;
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   452
        if ( $lang_default != $this->lang_id )
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   453
        {
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   454
          if ( !is_object($this->default) )
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   455
            $this->default = new Language($lang_default);
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   456
          return $this->default->get($string_id, $substitutions);
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   457
        }
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   458
      }
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   459
    }
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   460
    if ( !$found )
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   461
    {
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   462
      // Alright, it's nowhere. Return the input, grumble grumble...
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   463
      return $string_id;
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   464
    }
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   465
    // Found it!
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   466
    // Perform substitutions.
209
8a00247d1dee Login page mostly localized
Dan
parents: 205
diff changeset
   467
    // if ( is_array($substitutions) )
8a00247d1dee Login page mostly localized
Dan
parents: 205
diff changeset
   468
    //   die('<pre>' . print_r($substitutions, true) . '</pre>');
205
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   469
    if ( !is_array($substitutions) )
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   470
      $substitutions = array();
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   471
    return $this->substitute($string, $substitutions);
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   472
  }
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   473
  
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   474
  /**
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   475
   * Processes substitutions.
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   476
   * @param string
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   477
   * @param array
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   478
   * @return string
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   479
   */
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   480
  
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   481
  function substitute($string, $subs)
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   482
  {
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   483
    preg_match_all('/%this\.([a-z0-9_]+)%/', $string, $matches);
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   484
    if ( count($matches[0]) > 0 )
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   485
    {
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   486
      foreach ( $matches[1] as $i => $string_id )
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   487
      {
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   488
        $result = $this->get($string_id);
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   489
        $string = str_replace($matches[0][$i], $result, $string);
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   490
      }
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   491
    }
209
8a00247d1dee Login page mostly localized
Dan
parents: 205
diff changeset
   492
    preg_match_all('/%config\.([a-z0-9_]+)%/', $string, $matches);
8a00247d1dee Login page mostly localized
Dan
parents: 205
diff changeset
   493
    if ( count($matches[0]) > 0 )
8a00247d1dee Login page mostly localized
Dan
parents: 205
diff changeset
   494
    {
8a00247d1dee Login page mostly localized
Dan
parents: 205
diff changeset
   495
      foreach ( $matches[1] as $i => $string_id )
8a00247d1dee Login page mostly localized
Dan
parents: 205
diff changeset
   496
      {
8a00247d1dee Login page mostly localized
Dan
parents: 205
diff changeset
   497
        $result = getConfig($string_id);
8a00247d1dee Login page mostly localized
Dan
parents: 205
diff changeset
   498
        $string = str_replace($matches[0][$i], $result, $string);
8a00247d1dee Login page mostly localized
Dan
parents: 205
diff changeset
   499
      }
8a00247d1dee Login page mostly localized
Dan
parents: 205
diff changeset
   500
    }
205
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   501
    foreach ( $subs as $key => $value )
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   502
    {
209
8a00247d1dee Login page mostly localized
Dan
parents: 205
diff changeset
   503
      $subs[$key] = strval($value);
8a00247d1dee Login page mostly localized
Dan
parents: 205
diff changeset
   504
      $string = str_replace("%{$key}%", "{$subs[$key]}", $string);
205
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   505
    }
243
a7d0f2711df1 Installer localization started. Welcome, License, and SysReqs pages are fully localized.
Dan
parents: 241
diff changeset
   506
    return "{$string}*";
205
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   507
  }
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   508
  
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   509
} // class Language
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   510
c4542792db2b Localization low-level framework added
Dan
parents:
diff changeset
   511
?>