aboutsummaryrefslogtreecommitdiffstats
path: root/phpBB/includes/style/style.php
diff options
context:
space:
mode:
authorVjacheslav Trushkin <arty@phpbb.com>2012-04-01 09:52:55 +0300
committerVjacheslav Trushkin <arty@phpbb.com>2012-04-01 09:52:55 +0300
commitf80512f1066ebfc09d2a4ffac412c56a3fb247de (patch)
treeb6e15ac28a9d5ac5f93f9bd7cfb3951cad44cf29 /phpBB/includes/style/style.php
parent2ce73baeab35adc3515a04c1db38af62c98d5c93 (diff)
downloadforums-f80512f1066ebfc09d2a4ffac412c56a3fb247de.tar
forums-f80512f1066ebfc09d2a4ffac412c56a3fb247de.tar.gz
forums-f80512f1066ebfc09d2a4ffac412c56a3fb247de.tar.bz2
forums-f80512f1066ebfc09d2a4ffac412c56a3fb247de.tar.xz
forums-f80512f1066ebfc09d2a4ffac412c56a3fb247de.zip
[ticket/10733] Adding functions to locate resources
Adding $style->locate() and $template->locate() functions PHPBB3-10733
Diffstat (limited to 'phpBB/includes/style/style.php')
-rw-r--r--phpBB/includes/style/style.php28
1 files changed, 28 insertions, 0 deletions
diff --git a/phpBB/includes/style/style.php b/phpBB/includes/style/style.php
index dc1e71dff6..5ac61c9f10 100644
--- a/phpBB/includes/style/style.php
+++ b/phpBB/includes/style/style.php
@@ -150,4 +150,32 @@ class phpbb_style
{
$this->provider->set_ext_dir_prefix($ext_dir_prefix);
}
+
+ /**
+ * Locates source file path, accounting for styles tree and verifying that
+ * the path exists.
+ *
+ * @param string or array $files List of files to locate. If there is only
+ * one file, $files can be a string to make code easier to read.
+ * @param bool $return_default Determines what to return if file does not
+ * exist. If true, function will return location where file is
+ * supposed to be. If false, function will return false.
+ * @param bool $return_full_path If true, function will return full path
+ * to file. If false, function will return file name. This
+ * parameter can be used to check which one of set of files
+ * is available.
+ * @return string or boolean Source file path if file exists or $return_default is
+ * true. False if file does not exist and $return_default is false
+ */
+ public function locate($files, $return_default = false, $return_full_path = true)
+ {
+ // convert string to array
+ if (is_string($files))
+ {
+ $files = array($files);
+ }
+
+ // use resource locator to find files
+ return $this->locator->get_first_file_location($files, $return_default, $return_full_path);
+ }
}