first commit

wp-content/plugins/loco-translate/loco.php

@@ -0,0 +1,193 @@
+<?php
+/*
+Plugin Name: Loco Translate
+Plugin URI: https://wordpress.org/plugins/loco-translate/
+Description: Translate themes and plugins directly in WordPress
+Author: Tim Whitlock
+Version: 2.8.0
+Requires at least: 6.6
+Requires PHP: 7.4
+Tested up to: 6.8.1
+Author URI: https://localise.biz/wordpress/plugin
+Text Domain: loco-translate
+Domain Path: /languages/
+*/
+
+// disallow execution out of context
+if( ! function_exists('is_admin') ){
+    return;
+}
+
+
+/**
+ * Get absolute path to Loco primary plugin file
+ */
+function loco_plugin_file(): string {
+    return __FILE__;
+}
+
+
+/**
+ * Get version of this plugin
+ */
+function loco_plugin_version(): string {
+    return '2.8.0';
+}
+
+
+/**
+ * Get Loco plugin handle, used by WordPress to identify plugin as a relative path
+ * @return string probably "loco-translate/loco.php"
+ */
+function loco_plugin_self(): string {
+    static $handle;
+    isset($handle) or $handle = plugin_basename(__FILE__);
+    return $handle;
+}
+
+
+/**
+ * Get absolute path to plugin root directory
+ */
+function loco_plugin_root(): string {
+    return __DIR__;
+}
+
+
+/**
+ * Check whether currently running in debug mode
+ */
+function loco_debugging(): bool {
+    return apply_filters('loco_debug', WP_DEBUG );
+}
+
+
+/**
+ * Whether currently processing an Ajax request
+ */
+function loco_doing_ajax(): bool {
+    return defined('DOING_AJAX') && DOING_AJAX;
+}
+
+
+if( ! function_exists('loco_constant') ) {
+    /**
+     * Evaluate a constant by name
+     * @return mixed
+     */
+    function loco_constant( string $name ) {
+        return defined($name) ? constant($name) : null;
+    }
+}
+
+
+/**
+ * Runtime inclusion of any file under plugin root
+ *
+ * @param string $relpath PHP file path relative to __DIR__
+ * @return mixed return value from included file
+ */
+function loco_include( string $relpath ){
+    $path = loco_plugin_root().'/'.$relpath;
+    if( ! file_exists($path) ){
+        $message = 'File not found: '.$path;
+        // debug specifics to error log in case full call stack not visible
+        if( 'cli' !== PHP_SAPI ) {
+            error_log( sprintf( '[Loco.debug] Failed on loco_include(%s). !file_exists(%s)', var_export($relpath,true), var_export($path,true) ) );
+        }
+        // handle circular file inclusion error if error class not found
+        if( loco_class_exists('Loco_error_Exception') ){
+            throw new Loco_error_Exception($message);
+        }
+        else {
+            throw new Exception($message.'; additionally src/error/Exception.php not loadable');
+        }
+    }
+    return include $path;
+}
+
+
+/**
+ * Require dependant library once only
+
+ * @param string $path PHP file path relative to ./lib
+ */
+function loco_require_lib( string $path ):void {
+    require_once loco_plugin_root().'/lib/'.$path;
+}
+
+
+/**
+ * Check PHP extension required by Loco and load polyfill if needed
+ */
+function loco_check_extension( string $name ): bool {
+    static $cache = [];
+    if( ! array_key_exists($name,$cache) ) {
+        if( extension_loaded($name) ){
+            $cache[$name] = true;
+        }
+        else {
+            // translators: %s refers to the name of a missing PHP extension, for example "mbstring".
+            Loco_error_AdminNotices::warn( sprintf( __('Loco Translate requires the "%s" PHP extension. Ask your hosting provider to install it','loco-translate'), $name ) );
+            class_exists( ucfirst($name).'Extension' ); // <- pings Loco_hooks_AdminHooks::autoload_compat
+            $cache[$name] = false;
+        }
+    }
+    return $cache[$name];
+}
+
+
+/**
+ * Class autoloader for Loco classes under src directory.
+ * e.g. class "Loco_foo_Bar" will be found in "src/foo/Bar.php"
+ * 
+ * @internal 
+ */
+function loco_autoload( string $name ):void {
+    if( 'Loco_' === substr($name,0,5) ){
+        loco_include( 'src/'.strtr( substr($name,5), '_', '/' ).'.php' );
+    }
+}
+
+
+/**
+ * class_exists wrapper that fails silently.
+ */
+function loco_class_exists( string $class ): bool {
+    try {
+        return class_exists($class);
+    }
+    catch( Throwable $e ){
+        return false;
+    }
+}
+
+
+// Startup errors will raise notices. Check your error logs if error reporting is quiet
+try {
+    spl_autoload_register('loco_autoload');
+
+    // provide safe directory for custom translations that won't be deleted during auto-updates
+    if ( ! defined( 'LOCO_LANG_DIR' ) ) {
+        define( 'LOCO_LANG_DIR', trailingslashit( loco_constant('WP_LANG_DIR') ) . 'loco' );
+    }
+
+    // text domain loading helper for custom file locations. Set constant empty to disable
+    if( LOCO_LANG_DIR ){
+        new Loco_hooks_LoadHelper;
+    }
+
+    // initialize hooks for admin screens
+    if ( is_admin() ) {
+        new Loco_hooks_AdminHooks;
+    }
+    
+    // enable wp cli commands
+    if( class_exists('WP_CLI',false) ) {
+        WP_CLI::add_command('loco','Loco_cli_Commands');
+    }
+
+}
+catch( Throwable $e ){
+    trigger_error(sprintf('[Loco.fatal] %s in %s:%u',$e->getMessage(), $e->getFile(), $e->getLine() ) );
+}