Add configurable :logo_path option for dashboard

Allow users to customize where the Oban logo links to by passing a
`:logo_path` option to the `oban_dashboard/1` router helper. When
provided, the logo will link to the specified path instead of the
default jobs page.

Closes #149

Author: sorentwo

lib/oban/web/components/layouts.ex

@@ -17,9 +17,11 @@ defmodule Oban.Web.Layouts do
     )
   end
 
+  attr :path, :string, default: nil
+
   def logo(assigns) do
     ~H"""
-    <a href={oban_path(:jobs)} title="Oban Web">
+    <a href={@path || oban_path(:jobs)} title="Oban Web">
       <svg class="h-10 overflow-visible" viewBox="0 0 227 64">
         <path
           class="text-violet-950 dark:text-violet-50"

lib/oban/web/components/layouts/live.html.heex

@@ -8,7 +8,7 @@
 
   <header class="flex items-center">
     <div class="md:w-84 mr-3">
-      <.logo />
+      <.logo path={@logo_path} />
     </div>
 
     <.nav socket={@socket} page={@page.name} />

lib/oban/web/dashboard_live.ex

@@ -8,7 +8,7 @@ defmodule Oban.Web.DashboardLive do
     %{"prefix" => prefix, "resolver" => resolver} = session
     %{"live_path" => live_path, "live_transport" => live_transport} = session
     %{"user" => user, "access" => access, "csp_nonces" => csp_nonces} = session
-    %{"refresh" => refresh} = session
+    %{"refresh" => refresh, "logo_path" => logo_path} = session
 
     refresh = restore_state(socket, "refresh", refresh)
     theme = restore_state(socket, "theme", "system")
@@ -24,7 +24,7 @@ defmodule Oban.Web.DashboardLive do
     socket =
       socket
       |> assign(conf: conf, params: params, page: page, init_state: init_state(socket))
-      |> assign(live_path: live_path, live_transport: live_transport)
+      |> assign(live_path: live_path, live_transport: live_transport, logo_path: logo_path)
       |> assign(access: access, csp_nonces: csp_nonces, resolver: resolver, user: user)
       |> assign(original_refresh: nil, refresh: refresh, timer: nil, theme: theme)
       |> assign(sidebar_width: sidebar_width)

lib/oban/web/router.ex

@@ -144,6 +144,13 @@ defmodule Oban.Web.Router do
 
   * `:as` — override the route name; otherwise defaults to `:oban_dashboard`
 
+  * `:csp_nonce_assign_key` — CSP (Content Security Policy) keys used to authenticate image,
+    style, and script assets by pulling a generated nonce out of the connection's `assigns` map. May
+    be `nil`, a single atom, or a map of atoms. Defaults to `nil`.
+
+  * `:logo_path` — a custom path for the logo link in the header, allowing the logo to link to
+    another page in your application instead of the Oban dashboard root. Defaults to the jobs page.
+
   * `:on_mount` — declares additional module callbacks to be invoked when the dashboard mounts
 
   * `:oban_name` — name of the Oban instance the dashboard will use for configuration and
@@ -157,10 +164,6 @@ defmodule Oban.Web.Router do
   * `:transport` — a phoenix socket transport, either `"websocket"` or `"longpoll"`, defaults to
     `"websocket"`.
 
-  * `:csp_nonce_assign_key` — CSP (Content Security Policy) keys used to authenticate image,
-    style, and script assets by pulling a generated nonce out of the connection's `assigns` map. May
-    be `nil`, a single atom, or a map of atoms. Defaults to `nil`.
-
   ## Examples
 
   Mount an `oban` dashboard at the path "/oban":
@@ -225,7 +228,8 @@ defmodule Oban.Web.Router do
       opts[:resolver],
       opts[:socket_path],
       opts[:transport],
-      opts[:csp_nonce_assign_key]
+      opts[:csp_nonce_assign_key],
+      opts[:logo_path]
     ]
 
     session_opts = [
@@ -240,7 +244,7 @@ defmodule Oban.Web.Router do
   end
 
   @doc false
-  def __session__(conn, prefix, oban, resolver, live_path, live_transport, csp_key) do
+  def __session__(conn, prefix, oban, resolver, live_path, live_transport, csp_key, logo_path) do
     user = Resolver.call_with_fallback(resolver, :resolve_user, [conn])
 
     csp_keys = expand_csp_nonce_keys(csp_key)
@@ -254,6 +258,7 @@ defmodule Oban.Web.Router do
       "refresh" => Resolver.call_with_fallback(resolver, :resolve_refresh, [user]),
       "live_path" => live_path,
       "live_transport" => live_transport,
+      "logo_path" => logo_path,
       "csp_nonces" => %{
         img: conn.assigns[csp_keys[:img]],
         style: conn.assigns[csp_keys[:style]],
@@ -275,6 +280,15 @@ defmodule Oban.Web.Router do
     end
   end
 
+  defp validate_opt!({:logo_path, path}) do
+    unless is_nil(path) or (is_binary(path) and byte_size(path) > 0) do
+      raise ArgumentError, """
+      invalid :logo_path, expected nil or a non-empty binary path,
+      got: #{inspect(path)}
+      """
+    end
+  end
+
   defp validate_opt!({:oban_name, name}) do
     unless is_atom(name) do
       raise ArgumentError, """