first commit

2020-01-02 22:20:31 +07:00
commit 10eb3340ad
5753 changed files with 631345 additions and 0 deletions
--- a/libraries/cms/layout/file.php
+++ b/libraries/cms/layout/file.php
@ -0,0 +1,110 @@
+<?php
+/**
+ * @package     Joomla.Libraries
+ * @subpackage  Layout
+ *
+ * @copyright   Copyright (C) 2005 - 2013 Open Source Matters, Inc. All rights reserved.
+ * @license     GNU General Public License version 2 or later; see LICENSE.txt
+ */
+
+defined('JPATH_BASE') or die;
+
+/**
+ * Base class for rendering a display layout
+ * loaded from from a layout file
+ *
+ * @package     Joomla.Libraries
+ * @subpackage  Layout
+ * @see         http://docs.joomla.org/Sharing_layouts_across_views_or_extensions_with_JLayout
+ * @since       3.0
+ */
+class JLayoutFile extends JLayoutBase
+{
+	/**
+	 * @var    string  Dot separated path to the layout file, relative to base path
+	 * @since  3.0
+	 */
+	protected $layoutId = '';
+
+	/**
+	 * @var    string  Base path to use when loading layout files
+	 * @since  3.0
+	 */
+	protected $basePath = null;
+
+	/**
+	 * @var    string  Full path to actual layout files, after possible template override check
+	 * @since  3.0.3
+	 */
+	protected $fullPath = null;
+
+	/**
+	 * Method to instantiate the file-based layout.
+	 *
+	 * @param   string  $layoutId  Dot separated path to the layout file, relative to base path
+	 * @param   string  $basePath  Base path to use when loading layout files
+	 *
+	 * @since   3.0
+	 */
+	public function __construct($layoutId, $basePath = null)
+	{
+		$this->layoutId = $layoutId;
+		$this->basePath = is_null($basePath) ? JPATH_ROOT . '/layouts' : rtrim($basePath, DIRECTORY_SEPARATOR);
+	}
+
+	/**
+	 * Method to render the layout.
+	 *
+	 * @param   object  $displayData  Object which properties are used inside the layout file to build displayed output
+	 *
+	 * @return  string  The necessary HTML to display the layout
+	 *
+	 * @since   3.0
+	 */
+	public function render($displayData)
+	{
+		$layoutOutput = '';
+
+		// Check possible overrides, and build the full path to layout file
+		$path = $this->getPath();
+
+		// If there exists such a layout file, include it and collect its output
+		if (!empty($path))
+		{
+			ob_start();
+			include $path;
+			$layoutOutput = ob_get_contents();
+			ob_end_clean();
+		}
+
+		return $layoutOutput;
+	}
+
+	/**
+	 * Method to finds the full real file path, checking possible overrides
+	 *
+	 * @return  string  The full path to the layout file
+	 *
+	 * @since   3.0
+	 */
+	protected function getPath()
+	{
+		jimport('joomla.filesystem.path');
+
+		if (is_null($this->fullPath) && !empty($this->layoutId))
+		{
+			$rawPath = str_replace('.', '/', $this->layoutId) . '.php';
+			$fileName = basename($rawPath);
+			$filePath = dirname($rawPath);
+
+			$possiblePaths = array(
+				JPATH_THEMES . '/' . JFactory::getApplication()->getTemplate() . '/html/layouts/' . $filePath,
+				$this->basePath . '/' . $filePath
+			);
+
+			$this->fullPath = JPath::find($possiblePaths, $fileName);
+		}
+
+		return $this->fullPath;
+	}
+}