PhoenixKit.ResourceLinks (phoenix_kit v1.7.178)

Resolves (resource_type, resource_uuid) pairs into navigable deep-links to the underlying resource — the record an action happened on or a comment is attached to.

Two-tier resolution, tried in order per resource_type:

Handler modules — a module registered for the type that exports resolve_comment_resources/1, returning %{uuid => %{title, path, thumb_url?}} with a raw phoenix_kit path (Routes.path/1 is applied once at render time — pre-applying it would double-prefix under a non-root url_prefix). Auto-registered when the module is loaded: "post" => PhoenixKitPosts, "file" => PhoenixKit.Annotations, "user" => PhoenixKit.Users.CommentResources. Hosts add more via config :phoenix_kit, :comment_resource_handlers.
String path templates — the comment_resource_paths setting, a no-code JSON map (%{"shoes" => "/order/shoes/:uuid"}) with :uuid / :prefix / :metadata.<key> placeholders.

Shared by the Comments moderation admin (PhoenixKitComments delegates here) and the Activity feed. The handler contract and setting name keep the historical comment_* naming, but the mechanism is resource-generic — a resource that deep-links in comments deep-links in Activity with no extra config.

Items

resolve/1 accepts any list of maps/structs exposing :resource_type, :resource_uuid, and (optionally) :metadata — both PhoenixKit.Activity.Entry and comment structs qualify. Items missing a type or uuid are skipped.

Returns a map keyed by {resource_type, resource_uuid}, each value a map:

%{title: String.t(), full_title: String.t(), path: String.t(),
  prefixed: boolean(), thumb_url: String.t() (optional)}

prefixed: true means path is a raw phoenix_kit route — pass it through url/1 (→ Routes.path/1) and SPA-navigate. prefixed: false comes from a host template and should render as a plain href.

Summary

Functions

get_resource_path_templates()

Gets configured resource path templates (path + optional display title).

handlers()

The registered resource_type => handler_module map.

info_for(context, resource_type, resource_uuid)

Looks up a resolved info map for a single (resource_type, resource_uuid) pair.

resolve(items)

Resolves resource context (title + path) for a list of items.

update_resource_path_templates(templates)

Updates resource path templates for resource types.

url(info)

Final navigable path for a resolved info map.

Functions

get_resource_path_templates()

Gets configured resource path templates (path + optional display title).

Returns a map of resource_type => config, where config is either a plain string (legacy path-only format) or a map with "path" and optional "title" keys.

%{"shoes" => "/order/shoes/:uuid"}
%{"shoes" => %{"path" => "/order/shoes/:uuid", "title" => ":metadata.name"}}

handlers()

The registered resource_type => handler_module map.

Merges, in increasing precedence: the auto-registered core defaults (loaded post/file/user/integration modules), the module-declared handlers (the resource_links/0 PhoenixKit.Module callback entries whose value is a resolver module), and the host's config :phoenix_kit, :comment_resource_handlers overrides. Exposed so other consumers (e.g. the comments notification-callback dispatch) resolve a resource type against the same registry the deep-links use.

info_for(context, resource_type, resource_uuid)

Looks up a resolved info map for a single (resource_type, resource_uuid) pair.

Returns nil when the pair was not resolvable.

resolve(items)

Resolves resource context (title + path) for a list of items.

See the module doc for the item and return shapes.

update_resource_path_templates(templates)

Updates resource path templates for resource types.

Accepts both legacy string values and new map values with "path" and "title" keys.

url(info)

Final navigable path for a resolved info map.

Applies Routes.path/1 (URL prefix + locale) to raw phoenix_kit paths (prefixed: true); returns host-template paths (prefixed: false) verbatim.