[], 'css'=>[], 'rss'=>[]];
/**
* @var string Specifies a path to the asset directory.
*/
public $assetPath;
/**
* Outputs and ' . PHP_EOL;
}
}
return $result;
}
/**
* Adds JavaScript asset to the asset list. Call $this->makeAssets() in a view
* to output corresponding markup.
* @param string $name Specifies a path (URL) to the script.
* @param array $attributes Adds extra HTML attributes to the asset link.
* @return void
*/
public function addJs($name, $attributes = [])
{
$jsPath = $this->getAssetPath($name);
if (isset($this->controller))
$this->controller->addJs($jsPath, $attributes);
if (is_string($attributes))
$attributes = ['build' => $attributes];
$jsPath = $this->getAssetScheme($jsPath);
if (!in_array($jsPath, $this->assets['js']))
$this->assets['js'][] = ['path' => $jsPath, 'attributes' => $attributes];
}
/**
* Adds StyleSheet asset to the asset list. Call $this->makeAssets() in a view
* to output corresponding markup.
* @param string $name Specifies a path (URL) to the script.
* @param array $attributes Adds extra HTML attributes to the asset link.
* @return void
*/
public function addCss($name, $attributes = [])
{
$cssPath = $this->getAssetPath($name);
if (isset($this->controller))
$this->controller->addCss($cssPath, $attributes);
if (is_string($attributes))
$attributes = ['build' => $attributes];
$cssPath = $this->getAssetScheme($cssPath);
if (!in_array($cssPath, $this->assets['css']))
$this->assets['css'][] = ['path' => $cssPath, 'attributes' => $attributes];
}
/**
* Adds an RSS link asset to the asset list. Call $this->makeAssets() in a view
* to output corresponding markup.
* @param string $name Specifies a path (URL) to the RSS channel
* @param array $attributes Adds extra HTML attributes to the asset link.
* @return void
*/
public function addRss($name, $attributes = [])
{
$rssPath = $this->getAssetPath($name);
if (isset($this->controller))
$this->controller->addRss($rssPath, $attributes);
if (is_string($attributes))
$attributes = ['build' => $attributes];
$rssPath = $this->getAssetScheme($rssPath);
if (!in_array($rssPath, $this->assets['rss']))
$this->assets['rss'][] = ['path' => $rssPath, 'attributes' => $attributes];
}
/**
* Returns an array of all registered asset paths.
* @return array
*/
public function getAssetPaths()
{
$assets = [];
foreach ($this->assets as $type => $collection) {
$assets[$type] = [];
foreach ($collection as $asset) {
$assets[$type][] = $this->getAssetEntryBuildPath($asset);
}
}
return $assets;
}
/**
* Locates a file based on it's definition. If the file starts with
* a forward slash, it will be returned in context of the application public path,
* otherwise it will be returned in context of the asset path.
* @param string $fileName File to load.
* @param mixed $assetPath Explicitly define an asset path.
* @return string Relative path to the asset file.
*/
public function getAssetPath($fileName, $assetPath = null)
{
if (!$assetPath)
$assetPath = $this->assetPath;
if (substr($fileName, 0, 1) == '/' || $assetPath === null)
return $fileName;
if (!is_array($assetPath))
$assetPath = [$assetPath];
foreach ($assetPath as $path) {
$_fileName = $path . '/' . $fileName;
if (File::isFile(PATH_BASE . '/' . $_fileName))
break;
}
return $_fileName;
}
/**
* Returns true if assets any have been added.
* @return bool
*/
public function hasAssetsDefined()
{
return count($this->assets, COUNT_RECURSIVE) > 3;
}
/**
* Internal helper, attaches a build code to an asset path
* @param array $asset Stored asset array
* @return string
*/
protected function getAssetEntryBuildPath($asset)
{
$path = $asset['path'];
if (isset($asset['attributes']['build'])) {
$build = $asset['attributes']['build'];
if ($build == 'core')
$build = 'v' . Parameters::get('system::core.build', 1);
elseif ($pluginVersion = PluginVersion::getVersion($build))
$build = 'v' . $pluginVersion;
$path .= '?' . $build;
}
return $path;
}
/**
* Internal helper, get asset scheme
* @param string $asset Specifies a path (URL) to the asset.
* @return string
*/
protected function getAssetScheme($asset)
{
if (preg_match("/(\/\/|http|https)/", $asset))
return $asset;
if (substr($asset, 0, 1) == '/')
$asset = Request::getBasePath() . $asset;
return $asset;
}
}