MultisiteLanguageSwitcher.php

<?php
/**
 * Multisite Language Switcher Plugin
 *
 * @copyright Copyright (C) 2011-2022, Dennis Ploetner, re@lloc.de
 * @license http://www.gnu.org/licenses/gpl-2.0.html GNU General Public License, version 2 or later
 * @wordpress-plugin
 *
 * Plugin Name: Multisite Language Switcher
 * Version: 2.9.4
 * Plugin URI: http://msls.co/
 * Description: A simple but powerful plugin that will help you to manage the relations of your contents in a multilingual multisite-installation.
 * Author: Dennis Ploetner
 * Author URI: http://lloc.de/
 * Text Domain: multisite-language-switcher
 * Domain Path: /languages/
 * License: GPLv2 or later
 *
 * This program is free software; you can redistribute it and/or modify
 * it under the terms of the GNU General Public License, version 2, as
 * published by the Free Software Foundation.
 *
 * 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 General Public License for more details.
 *
 * You should have received a copy of the GNU General Public License
 * along with this program; if not, write to the Free Software
 * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA
 */

if ( file_exists( __DIR__ . '/vendor/autoload.php' ) ) {
	require __DIR__ . '/vendor/autoload.php';
}

/**
 * MultisiteLanguageSwitcher
 *
 * @author Dennis Ploetner <re@lloc.de>
 */
if ( ! defined( 'MSLS_PLUGIN_VERSION' ) ) {
	define( 'MSLS_PLUGIN_VERSION', '2.9.4' );
	define( 'MSLS_PLUGIN_PATH', plugin_basename( __FILE__ ) );
	define( 'MSLS_PLUGIN__FILE__', __FILE__ );

	/**
	 * Get the output for using the links to the translations in your code
	 *
	 * @package Msls
	 *
	 * @param mixed $attr
	 *
	 * @return string
	 */
	function get_the_msls( $attr ): string {
		$arr = is_array( $attr ) ? $attr : array();
		$obj = apply_filters( 'msls_get_output', null );

		return ! is_null( $obj ) ? strval( $obj->set_tags( $arr ) ) : '';
	}

	/**
	 * Output the links to the translations in your template
	 *
	 * You can call this function directly like that
	 *
	 *     if ( function_exists ( 'the_msls' ) )
	 *         the_msls();
	 *
	 * or just use it as shortcode [sc_msls]
	 *
	 * @package Msls
	 * @uses get_the_msls
	 *
	 * @param string[] $arr
	 */
	function the_msls( array $arr = array() ): void {
        // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped
		echo get_the_msls( $arr );
	}

	/**
	 * Gets the URL of the country flag-icon for a specific locale
	 *
	 * @param string $locale
	 *
	 * @return string
	 */
	function get_msls_flag_url( string $locale ): string {
		return ( new \lloc\Msls\MslsOptions() )->get_flag_url( $locale );
	}

	/**
	 * Gets the description for a blog for a specific locale
	 *
	 * @param string $locale
	 *
	 * @return string
	 */
	function get_msls_blog_description( string $locale, string $default = '' ): string {
		$blog = msls_blog( $locale );

		return $blog ? $blog->get_description() : $default;
	}

	/**
	 * Gets the permalink for a translation of the current post in a given language
	 *
	 * @param string $locale
	 * @param string $default
	 *
	 * @return string
	 */
	function get_msls_permalink( string $locale, string $default = '' ): string {
		$url  = null;
		$blog = msls_blog( $locale );

		if ( $blog ) {
			$options = \lloc\Msls\MslsOptions::create();
			$url     = $blog->get_url( $options );
		}

		return $url ?? $default;
	}

	/**
	 * Looks for the MslsBlog instance for a specific locale
	 *
	 * @param string $locale
	 *
	 * @return \lloc\Msls\MslsBlog|null
	 */
	function msls_blog( string $locale ): ?\lloc\Msls\MslsBlog {
		return msls_blog_collection()->get_blog( $locale );
	}

	/**
	 * Gets the MslsBlogCollection instance
	 *
	 * @return \lloc\Msls\MslsBlogCollection
	 */
	function msls_blog_collection(): \lloc\Msls\MslsBlogCollection {
		return \lloc\Msls\MslsBlogCollection::instance();
	}

	/**
	 * Gets the MslsOptions instance
	 *
	 * @return \lloc\Msls\MslsOptions
	 */
	function msls_options(): \lloc\Msls\MslsOptions {
		return \lloc\Msls\MslsOptions::instance();
	}

	/**
	 * Gets the MslsContentTypes instance
	 *
	 * @return \lloc\Msls\MslsContentTypes
	 */
	function msls_content_types(): \lloc\Msls\MslsContentTypes {
		return \lloc\Msls\MslsContentTypes::create();
	}

	/**
	 * Gets the MslsPostType instance
	 *
	 * @return \lloc\Msls\MslsPostType
	 */
	function msls_post_type(): \lloc\Msls\MslsPostType {
		return \lloc\Msls\MslsPostType::instance();
	}

	/**
	 * Gets the MslsTaxonomy instance
	 *
	 * @return \lloc\Msls\MslsTaxonomy
	 */
	function msls_taxonomy(): \lloc\Msls\MslsTaxonomy {
		return \lloc\Msls\MslsTaxonomy::instance();
	}

	/**
	 * Gets the MslsOutput instance
	 *
	 * @return \lloc\Msls\MslsOutput
	 */
	function msls_output(): \lloc\Msls\MslsOutput {
		return \lloc\Msls\MslsOutput::create();
	}

	/**
	 * Retrieves the MslsOptionsPost instance.
	 *
	 * @param int $id
	 * @return \lloc\Msls\MslsOptionsPost
	 */
	function msls_get_post( int $id ): \lloc\Msls\MslsOptionsPost {
		return new \lloc\Msls\MslsOptionsPost( $id );
	}

	/**
	 * Retrieves the MslsOptionsTax instance.
	 *
	 * Determines the current query based on conditional tags:
	 * - is_category
	 * - is_tag
	 * - is_tax
	 *
	 * @param int $id
	 * @return \lloc\Msls\MslsOptionsTax
	 */
	function msls_get_tax( int $id ): \lloc\Msls\MslsOptionsTax {
		return \lloc\Msls\MslsOptionsTax::create( $id );
	}

	/**
	 * Retrieves the MslsOptionsQuery instance.
	 *
	 * Determines the current query based on conditional tags:
	 * - is_day
	 * - is_month
	 * - is_year
	 * - is_author
	 * - is_post_type_archive
	 *
	 * @return ?\lloc\Msls\MslsOptionsQuery
	 */
	function msls_get_query(): ?\lloc\Msls\MslsOptionsQuery {
		return \lloc\Msls\MslsOptionsQuery::create();
	}

	lloc\Msls\MslsPlugin::init();
}