Packages
ash_admin
0.11.0
1.1.0
1.0.0-rc.0
0.14.0
0.13.26
0.13.25
0.13.24
0.13.23
0.13.22
0.13.21
0.13.20
0.13.19
0.13.18
0.13.17
0.13.16
0.13.15
0.13.14
0.13.13
0.13.12
0.13.11
0.13.10
0.13.9
0.13.8
0.13.7
0.13.6
0.13.5
0.13.4
0.13.3
0.13.2
0.13.1
0.13.0
0.12.6
0.12.5
0.12.4
0.12.3
0.12.2
0.12.1
0.12.0
0.11.11
0.11.10
0.11.9
0.11.8
0.11.7
0.11.6
0.11.5
0.11.4
0.11.3
0.11.2
0.11.1
0.11.0
0.10.12
0.10.11
0.10.10
retired
0.10.10-rc.1
0.10.10-rc.0
0.10.9
0.10.8
0.10.7
0.10.6
0.10.5
0.10.4
0.10.3
0.10.2
0.10.1
0.10.0
0.9.8
0.9.7
0.9.6
0.9.5
0.9.4
0.9.3
0.9.2
0.9.1
0.9.0
0.8.1
0.8.0
0.7.1
0.7.0
0.6.2
0.6.1
0.6.0-rc.2
0.6.0-rc.1
0.6.0-rc.0
0.5.2
0.5.1-rc.0
0.5.0
0.4.5-rc.0
0.4.4
0.4.2
0.4.0
0.3.0-rc.0
0.2.22
0.2.21
0.2.20
0.2.19
0.2.18
0.2.17
0.2.16-rc.1
0.2.16-rc.0
0.2.15
0.2.14
0.2.13
0.2.12
0.2.11
0.2.10
0.2.9
0.2.8
0.2.7
0.2.6
0.2.5
0.2.4
0.2.3
0.2.1
0.1.6
0.1.5
0.1.3
0.1.2
0.1.0
A super-admin UI for Ash Framework, built with Phoenix LiveView.
Current section
Files
Jump to
Current section
Files
lib/ash_admin/router.ex
defmodule AshAdmin.Router do
@moduledoc """
Provides LiveView routing for AshAdmin.
"""
@doc """
Can be used to create a `:browser` pipeline easily if you don't have one.
By default it is called `:browser`, but you can rename it by supplying an argument,
for example:
```elixir
defmodule MyAppWeb.Router do
use Phoenix.Router
import AshAdmin.Router
admin_browser_pipeline :something
scope "/" do
pipe_through [:something]
ash_admin "/admin"
end
end
```
"""
defmacro admin_browser_pipeline(name \\ :browser) do
quote do
import Phoenix.LiveView.Router
pipeline unquote(name) do
plug(:accepts, ["html"])
plug(:fetch_session)
plug(:fetch_live_flash)
plug(:put_root_layout, html: {AshAdmin.Layouts, :root})
plug(:protect_from_forgery)
plug(:put_secure_browser_headers)
end
end
end
@doc """
Defines an AshAdmin route.
It expects the `path` the admin dashboard will be mounted at
and a set of options.
## Options
* `:live_socket_path` - Optional override for the socket path. it must match
the `socket "/live", Phoenix.LiveView.Socket` in your endpoint. Defaults to `/live`.
* `:on_mount` - Optional list of hooks to attach to the mount lifecycle.
* `:session` - Optional extra session map or MFA tuple to be merged with the session.
* `:csp_nonce_assign_key` - Optional assign key to find the CSP nonce value used for assets
Supports either `atom()` or
`%{optional(:img) => atom(), optional(:script) => atom(), optional(:style) => atom()}`
Defaults to `ash_admin-Ed55GFnX` for backwards compatibility.
* `:live_session_name` - Optional atom to name the `live_session`. Defaults to `:ash_admin`.
## Examples
defmodule MyAppWeb.Router do
use Phoenix.Router
scope "/" do
import AshAdmin.Router
# Make sure you are piping through the browser pipeline
# If you don't have one, see `admin_browser_pipeline/1`
pipe_through [:browser]
ash_admin "/admin"
ash_admin "/csp/admin", live_session_name: :ash_admin_csp, csp_nonce_assign_key: :csp_nonce_value
end
end
"""
defmacro ash_admin(path, opts \\ []) do
quote bind_quoted: [path: path, opts: opts] do
import Phoenix.LiveView.Router
live_socket_path = Keyword.get(opts, :live_socket_path, "/live")
csp_nonce_assign_key =
case opts[:csp_nonce_assign_key] do
nil ->
%{
img: "ash_admin-Ed55GFnX",
style: "ash_admin-Ed55GFnX",
script: "ash_admin-Ed55GFnX"
}
key when is_atom(key) ->
%{img: key, style: key, script: key}
%{} = keys ->
Map.take(keys, [:img, :style, :script])
end
live_session opts[:live_session_name] || :ash_admin,
on_mount: List.wrap(opts[:on_mount]),
session:
{AshAdmin.Router, :__session__, [%{"prefix" => path}, List.wrap(opts[:session])]},
root_layout: {AshAdmin.Layouts, :root} do
live(
"#{path}/*route",
AshAdmin.PageLive,
:page,
private: %{
live_socket_path: live_socket_path,
ash_admin_csp_nonce: csp_nonce_assign_key
}
)
end
end
end
@cookies_to_replicate [
"tenant",
"actor_resource",
"actor_primary_key",
"actor_action",
"actor_domain",
"actor_authorizing",
"actor_paused"
]
@doc false
def __session__(conn, [session, additional_hooks]),
do: __session__(conn, session, additional_hooks)
def __session__(conn, session, additional_hooks \\ []) do
session =
Enum.reduce(additional_hooks, session, fn {m, f, a}, acc ->
Map.merge(acc, apply(m, f, [conn | a]) || %{})
end)
session = Map.put(session, "request_path", conn.request_path)
Enum.reduce(@cookies_to_replicate, session, fn cookie, session ->
case conn.req_cookies[cookie] do
value when value in [nil, "", "null"] ->
Map.put(session, cookie, nil)
value ->
Map.put(session, cookie, value)
end
end)
end
end