lepton_basics.php

Go to the documentation of this file.

<?php
 
declare(strict_types=1);
 
class LEPTON_basics
{
    const SYSTEM_DEFAULT_STR = 'System Default';
    public static $instance;
 
    public static function getInstance(): object
    {
        if (null === static::$instance)
        {
            static::$instance = new static();
        }
 
        return static::$instance;
    }
 
    // @DEPRECATED_TEMP 20250117: will be replaced by LEPTON_date in L* > 7.3.0
    static function get_dateformats(): array
    {
        global $user_time;
        global $TEXT;
        
        // Get the current time (in the users timezone if required)
        $actual_time = time();
 
        // Get "System Default"
        $sSystemDefault = "";
        if ( isset( $user_time ) && $user_time === true )
        {
            $sSystemDefault = date(DEFAULT_DATE_FORMAT, $actual_time).' (';
            $sSystemDefault .= ($TEXT['SYSTEM_DEFAULT'] ?? self::SYSTEM_DEFAULT_STR).')';
        }
 
        // Add values to list
        $DATE_FORMATS = array(
            'system_default' => $sSystemDefault,
            'j.n.Y' => date('j.n.Y', $actual_time).' (j.n.Y)',
            'm/d/Y' => date('m/d/Y', $actual_time).' (M/D/Y)',
            'd/m/Y' => date('d/m/Y', $actual_time).' (D/M/Y)',
            'm.d.Y' => date('m.d.Y', $actual_time).' (M.D.Y)',
            'd.m.Y' => date('d.m.Y', $actual_time).' (D.M.Y)',
            'm-d-Y' => date('m-d-Y', $actual_time).' (M-D-Y)',
            'd-m-Y' => date('d-m-Y', $actual_time).' (D-M-Y)',
            'D M d, Y' => date( 'D M d, Y', $actual_time ),
            'M d Y' => date( 'M d Y', $actual_time ),
            'd M Y' => date( 'd M Y', $actual_time ),
            'jS F, Y' => date( 'jS F, Y', $actual_time ),
            'l, jS F, Y' => date( 'l, jS F, Y', $actual_time )
        );
 
        $oDateTool = lib_lepton::getToolInstance("datetools", true);
        $oDateTool->set_core_language( DEFAULT_LANGUAGE );
 
        $aFormatList = array(
            'D M d, Y',
            'M d Y',
            'd M Y',
            'jS F, Y',
            'l, jS F, Y'
        );
 
        foreach ($aFormatList as &$format)
        {
            $DATE_FORMATS[ $format ] =  $oDateTool->formatWithMySQL($format, $actual_time);
        }
 
        return $DATE_FORMATS;
    }
 
     // @DEPRECATED_TEMP 20250117: will be replaced by LEPTON_date in L* > 7.3.0
    static function get_timeformats(): array
    {
        global $user_time;
        global $TEXT;
        
        // Get the current time (in the users timezone if required)
        $actual_time = time();
 
        // Get "System Default"
        $sSystemDefault = "";
 
        if ((isset($user_time)) && ($user_time === true))
        {
            $sSystemDefault = date( DEFAULT_TIME_FORMAT, $actual_time ) . ' (';
            $sSystemDefault .= ($TEXT['SYSTEM_DEFAULT'] ?? self::SYSTEM_DEFAULT_STR) . ')';
        }
 
        return [
            'system_default'    => $sSystemDefault,
            'H:i'   => date('H:i', $actual_time),
            'H:i:s' => date( 'H:i:s', $actual_time ),
            'g:i a' => date( 'g:i a', $actual_time ), // Lowercase Ante meridiem and Post meridiem
            'g:i A' => date( 'g:i A', $actual_time )  // Uppercase Ante meridiem and Post meridiem
        ];
    }
 
     // @DEPRECATED_TEMP 20250117: will be replaced by LEPTON_date in L* > 7.3.0
    static function get_days(string $lang= "en_EN", bool $abbr= false): array
    {
        $oDATETOOLS = lib_lepton::getToolInstance("datetools");
        return $oDATETOOLS->getWeekdayNames($lang, $abbr);  // Wochentagsnamen ausgeschrieben
    }
    
     // @DEPRECATED_TEMP 20250117: will be replaced by LEPTON_date in L* > 7.3.0
    static function get_months(string $lang= "en_EN", bool $abbr= false): array
    {
        $oDATETOOLS = lib_lepton::getToolInstance("datetools");
        return $oDATETOOLS->getMonthNames($lang, $abbr); // Monatsnamen ausgeschrieben
    }
    
     // @DEPRECATED_TEMP 20250117: will be replaced by LEPTON_date in L* > 7.3.0
    static function get_timezones(): array
    {
        return [
            "Pacific/Kwajalein",
            "Pacific/Samoa",
            "Pacific/Honolulu",
            "America/Anchorage",
            "America/Los_Angeles",
            "America/Phoenix",
            "America/Mexico_City",
            "America/Lima",
            "America/Caracas",
            "America/Halifax",
            "America/Buenos_Aires",
            "Atlantic/Reykjavik",
            "Atlantic/Azores",
            "Europe/London",
            "Europe/Berlin",
            "Europe/Kaliningrad",
            "Europe/Moscow",
            "Asia/Tehran",
            "Asia/Baku",
            "Asia/Kabul",
            "Asia/Tashkent",
            "Asia/Calcutta",
            "Asia/Colombo",
            "Asia/Bangkok",
            "Asia/Hong_Kong",
            "Asia/Tokyo",
            "Australia/Adelaide",
            "Pacific/Guam",
            "Etc/GMT+10",
            "Pacific/Fiji" 
        ];
    }
 
    static function get_errorlevels(): array
    {
        global $TEXT;
        // Create array
        $ER_LEVELS = [];
 
        // Add values to list
        if (isset($TEXT['SYSTEM_DEFAULT']))
        {
            $ER_LEVELS[''] = $TEXT['SYSTEM_DEFAULT'];
        }
        else
        {
            $ER_LEVELS[''] = self::SYSTEM_DEFAULT_STR;
        }
        
        $ER_LEVELS['0'] = 'E_NONE'; // standard for productive use      
        $ER_LEVELS[E_NOTICE] = 'E_NOTICE';
        $ER_LEVELS[E_WARNING] = 'E_WARNING';
        $ER_LEVELS['-1'] = 'E_EVERYTHING'; // highest level
 
        return $ER_LEVELS;
    }
 
    static function get_backend_translation(string $sKey = ""): string
    {
        global $TEXT, $THEME;
 
        $sLanguagePath_user     = THEME_PATH."/languages/".LANGUAGE.".php";
        $sLanguagePath_default  = THEME_PATH."/languages/EN.php";
 
        if (!isset($THEME))
        {
            if (file_exists($sLanguagePath_user))
            {
                require_once $sLanguagePath_user;
            }
            elseif( file_exists( $sLanguagePath_default ) )
            {
                require_once $sLanguagePath_default;
            }
            else
            {
                // avoid errors and conflicts for non existing $THEME 
                $THEME = [];
            }
        }
 
        if (isset($THEME[$sKey]))
        {
            return $THEME[$sKey];
        }
        elseif (isset($TEXT[$sKey]))
        {
            return $TEXT[$sKey];
        }
        else
        {
            return "** ".$sKey." (Key not found in Languages!)";
        }
    }
 
    static function getLanguagePath(string $sRootDir = ""): string
    {
        $lang = $sRootDir."/languages/".LANGUAGE.".php";
        return (file_exists($lang))
            ? $lang
            : $sRootDir."/languages/EN.php"
            ;
    }
}