first version

kirby/src/Cms/Url.php

@@ -0,0 +1,45 @@
+<?php
+
+namespace Kirby\Cms;
+
+use Kirby\Http\Url as BaseUrl;
+use Kirby\Toolkit\Str;
+
+/**
+ * Extension of the Kirby\Http\Url class
+ * with a specific Url::home method that always
+ * creates the correct base Url and a template asset
+ * Url builder.
+ */
+class Url extends BaseUrl
+{
+    public static $home = null;
+
+    /**
+     * Returns the Url to the homepage
+     *
+     * @return string
+     */
+    public static function home(): string
+    {
+        return App::instance()->url();
+    }
+
+    /**
+     * Creates an absolute Url to a template asset if it exists. This is used in the `css()` and `js()` helpers
+     *
+     * @param string $assetPath
+     * @param string $extension
+     * @return string|null
+     */
+    public static function toTemplateAsset(string $assetPath, string $extension)
+    {
+        $kirby = App::instance();
+        $page  = $kirby->site()->page();
+        $path  = $assetPath . '/' . $page->template() . '.' . $extension;
+        $file  = $kirby->root('assets') . '/' . $path;
+        $url   = $kirby->url('assets') . '/' . $path;
+
+        return file_exists($file) === true ? $url : null;
+    }
+}