PhoenixKit.Modules.Publishing.Web.Editor.Helpers (PhoenixKitPublishing v0.2.0)

Copy Markdown View Source

Shared helper functions for the publishing editor.

Contains utilities for URL building, language handling, virtual post creation, and other common operations.

Summary

Functions

assign_current_language(socket, language_code)

Assigns current language with enabled/known status.

build_edit_url(group_slug, post, opts \\ [])

Builds the URL for the post editor.

build_editor_languages(post, enabled_languages, current_language)

Builds language data for the publishing_language_switcher component.

build_new_post_url(group_slug)

Builds the URL for creating a new post.

build_post_url(group_slug, post)

Builds the URL for a post overview page.

build_preview_url(group_slug, post)

Builds the URL for the post preview.

build_public_url(post, language)

Builds the public URL for a post.

build_virtual_post(group_slug, arg2, primary_language, now)

Builds a virtual post for new post creation.

build_virtual_translation(post, group_slug, new_language, socket)

Builds a virtual translation for a new language.

editor_language(assigns)

Gets the editor language from assigns.

featured_image_preview_url(value)

Gets the preview URL for a featured image.

format_language_list(language_codes)

Formats a list of language codes for display.

get_language_name(language_code)

Gets the language name for a language code.

image_component_markup(file_uuid)

Builds the inline <Image> PHK component markup for a storage file.

sanitize_featured_image_uuid(value)

Sanitizes a featured image ID value.

Functions

assign_current_language(socket, language_code)

Assigns current language with enabled/known status.

build_edit_url(group_slug, post, opts \\ [])

Builds the URL for the post editor.

Options: :version, :lang

build_editor_languages(post, enabled_languages, current_language)

Builds language data for the publishing_language_switcher component.

build_new_post_url(group_slug)

Builds the URL for creating a new post.

build_post_url(group_slug, post)

Builds the URL for a post overview page.

build_preview_url(group_slug, post)

Builds the URL for the post preview.

build_public_url(post, language)

Builds the public URL for a post.

build_virtual_post(group_slug, arg2, primary_language, now)

Builds a virtual post for new post creation.

build_virtual_translation(post, group_slug, new_language, socket)

Builds a virtual translation for a new language.

editor_language(assigns)

Gets the editor language from assigns.

format_language_list(language_codes)

Formats a list of language codes for display.

get_language_name(language_code)

Gets the language name for a language code.

image_component_markup(file_uuid)

Builds the inline <Image> PHK component markup for a storage file.

The component carries the file UUID, not a resolved URL — the renderer (PhoenixKit.Modules.Shared.Components.Image) resolves it to a URL at render time via Storage.get_public_url_by_uuid/2. Storing the UUID instead of a signed URL keeps the reference stable across url_prefix changes, secret_key_base rotation, and content moved between environments — the same late-resolution the featured image already uses.

Alt text is derived from the file's original name (falling back to "Image"), sanitised so it can't break out of the XML attribute.