CoreFiles by mySites.guru
LayoutHelper.php74 lines, 2,652 bytes, from Joomla_4.2.0-beta3-Beta-Full_Package.zip
Raw History Compare with 4.2.0-beta2
md5
57f10edc1cbf35f3c094e24365c943ea
sha1
1361ffa50042c2d45d832471a8352e01751b285b
sha256
d059d4ab019c1bea016263d19642d3f8967c6a34e7f6de926efee311bd0599f9
<?php

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

namespace Joomla\CMS\Layout;

/**
 * Helper to render a Layout object, storing a base path
 *
 * @link   https://docs.joomla.org/Special:MyLanguage/Sharing_layouts_across_views_or_extensions_with_JLayout
 * @since  3.1
 */
class LayoutHelper
{
    /**
     * A default base path that will be used if none is provided when calling the render method.
     * Note that FileLayout itself will defaults to JPATH_ROOT . '/layouts' if no basePath is supplied at all
     *
     * @var    string
     * @since  3.1
     */
    public static $defaultBasePath = '';

    /**
     * Method to render a layout with debug info
     *
     * @param   string  $layoutFile   Dot separated path to the layout file, relative to base path
     * @param   mixed   $displayData  Object which properties are used inside the layout file to build displayed output
     * @param   string  $basePath     Base path to use when loading layout files
     * @param   mixed   $options      Optional custom options to load. Registry or array format
     *
     * @return  string
     *
     * @since   3.5
     */
    public static function debug($layoutFile, $displayData = null, $basePath = '', $options = null)
    {
        $basePath = empty($basePath) ? self::$defaultBasePath : $basePath;

        // Make sure we send null to FileLayout if no path set
        $basePath = empty($basePath) ? null : $basePath;
        $layout = new FileLayout($layoutFile, $basePath, $options);

        return $layout->debug($displayData);
    }

    /**
     * Method to render the layout.
     *
     * @param   string  $layoutFile   Dot separated path to the layout file, relative to base path
     * @param   mixed   $displayData  Object which properties are used inside the layout file to build displayed output
     * @param   string  $basePath     Base path to use when loading layout files
     * @param   mixed   $options      Optional custom options to load. Registry or array format
     *
     * @return  string
     *
     * @since   3.1
     */
    public static function render($layoutFile, $displayData = null, $basePath = '', $options = null)
    {
        $basePath = empty($basePath) ? self::$defaultBasePath : $basePath;

        // Make sure we send null to FileLayout if no path set
        $basePath = empty($basePath) ? null : $basePath;
        $layout = new FileLayout($layoutFile, $basePath, $options);

        return $layout->render($displayData);
    }
}

The same content is in 5 releases, Joomla 4.2.0-beta3 to 4.2.1-rc2. See them all, or every version of this file.