CoreFiles by mySites.guru
CMSApplicationInterface.php189 lines, 4,409 bytes, from Joomla_6.0.2-Stable-Full_Package.zip
Raw History Compare with 6.0.1
md5
9aba4e3fb92dce71249bf10ffa1d4a4e
sha1
03f175d98fa6fc39ae97a2518becd7813eb9b927
sha256
5eafa687bf15676efc43c9539ad3287fe36abc00847e1b136c1c5735793c5a8a
<?php

/**
 * Joomla! Content Management System
 *
 * @copyright  (C) 2017 Open Source Matters, Inc. <https://www.joomla.org>
 * @license    GNU General Public License version 2 or later; see LICENSE.txt
 */

namespace Joomla\CMS\Application;

use Joomla\Application\ConfigurationAwareApplicationInterface;
use Joomla\CMS\Extension\ExtensionManagerInterface;
use Joomla\CMS\Language\Language;
use Joomla\CMS\User\User;
use Joomla\Input\Input;

// phpcs:disable PSR1.Files.SideEffects
\defined('_JEXEC') or die;
// phpcs:enable PSR1.Files.SideEffects

/**
 * Interface defining a Joomla! CMS Application class
 *
 * @since  4.0.0
 * @note   In Joomla 6 this interface will no longer extend EventAwareInterface
 * @property-read   Input  $input  {@deprecated 4.0 will be removed in 7.0} The Joomla Input property. Deprecated in favour of getInput()
 */
interface CMSApplicationInterface extends ExtensionManagerInterface, ConfigurationAwareApplicationInterface, EventAwareInterface
{
    /**
     * Constant defining an enqueued emergency message
     *
     * @var    string
     * @since  4.0.0
     */
    public const MSG_EMERGENCY = 'emergency';

    /**
     * Constant defining an enqueued alert message
     *
     * @var    string
     * @since  4.0.0
     */
    public const MSG_ALERT = 'alert';

    /**
     * Constant defining an enqueued critical message
     *
     * @var    string
     * @since  4.0.0
     */
    public const MSG_CRITICAL = 'critical';

    /**
     * Constant defining an enqueued error message
     *
     * @var    string
     * @since  4.0.0
     */
    public const MSG_ERROR = 'error';

    /**
     * Constant defining an enqueued warning message
     *
     * @var    string
     * @since  4.0.0
     */
    public const MSG_WARNING = 'warning';

    /**
     * Constant defining an enqueued notice message
     *
     * @var    string
     * @since  4.0.0
     */
    public const MSG_NOTICE = 'notice';

    /**
     * Constant defining an enqueued info message
     *
     * @var    string
     * @since  4.0.0
     */
    public const MSG_INFO = 'info';

    /**
     * Constant defining an enqueued debug message
     *
     * @var    string
     * @since  4.0.0
     */
    public const MSG_DEBUG = 'debug';

    /**
     * Constant defining an enqueued message message
     *
     * @var    string
     * @since  6.0.2
     */
    public const MSG_MESSAGE = 'message';

    /**
     * Constant defining an enqueued success message
     *
     * @var    string
     * @since  6.0.2
     */
    public const MSG_SUCCESS = 'success';

    /**
     * Enqueue a system message.
     *
     * @param   string  $msg   The message to enqueue.
     * @param   string  $type  The message type.
     *
     * @return  void
     *
     * @since   4.0.0
     */
    public function enqueueMessage($msg, $type = self::MSG_INFO);

    /**
     * Get the system message queue.
     *
     * @return  array  The system message queue.
     *
     * @since   4.0.0
     */
    public function getMessageQueue();

    /**
     * Check the client interface by name.
     *
     * @param   string  $identifier  String identifier for the application interface
     *
     * @return  boolean  True if this application is of the given type client interface.
     *
     * @since   4.0.0
     */
    public function isClient($identifier);

    /**
     * Get the application identity.
     *
     * @return  User|null  A User object or null if not set.
     *
     * @since   4.0.0
     */
    public function getIdentity();

    /**
     * Method to get the application input object.
     *
     * @return  Input
     *
     * @since   4.0.0
     */
    public function getInput(): Input;

    /**
     * Method to get the application language object.
     *
     * @return  Language  The language object
     *
     * @since   4.0.0
     */
    public function getLanguage();

    /**
     * Gets the name of the current running application.
     *
     * @return  string  The name of the application.
     *
     * @since   4.0.0
     */
    public function getName();

    /**
     * Allows the application to load a custom or default identity.
     *
     * @param   ?User  $identity  An optional identity object. If omitted, the factory user is created.
     *
     * @return  $this
     *
     * @since   4.0.0
     */
    public function loadIdentity(?User $identity = null);
}

The same content is in 35 releases, Joomla 6.0.2-rc1 to 6.2.1-rc1. See them all, or every version of this file.