defmodule PhoenixKitWeb.BlogHTML do @moduledoc """ HTML rendering functions for BlogController. """ use PhoenixKitWeb, :html alias PhoenixKit.Blogging.Renderer alias PhoenixKit.Config alias PhoenixKit.Storage embed_templates("blog_html/*") @doc """ Builds the public URL for a blog listing page. Default language gets clean URLs without locale prefix. """ def blog_listing_path(language, blog_slug, params \\ []) do segments = if default_language?(language), do: [blog_slug], else: [language, blog_slug] base_path = build_public_path(segments) case params do [] -> base_path _ -> base_path <> "?" <> URI.encode_query(params) end end @doc """ Builds a post URL based on mode. Default language gets clean URLs without locale prefix. """ def build_post_url(blog_slug, post, language) do case post.mode do :slug -> segments = if default_language?(language), do: [blog_slug, post.slug], else: [language, blog_slug, post.slug] build_public_path(segments) :timestamp -> date = format_date_for_url(post.metadata.published_at) time = format_time_for_url(post.metadata.published_at) segments = if default_language?(language), do: [blog_slug, date, time], else: [language, blog_slug, date, time] build_public_path(segments) _ -> segments = if default_language?(language), do: [blog_slug, post.slug], else: [language, blog_slug, post.slug] build_public_path(segments) end end @doc """ Formats a date for display. """ def format_date(datetime) when is_struct(datetime, DateTime) do datetime |> DateTime.to_date() |> Calendar.strftime("%B %d, %Y") end def format_date(datetime_string) when is_binary(datetime_string) do case DateTime.from_iso8601(datetime_string) do {:ok, datetime, _} -> datetime |> DateTime.to_date() |> Calendar.strftime("%B %d, %Y") _ -> datetime_string end end def format_date(_), do: "" @doc """ Formats a date for URL. """ def format_date_for_url(datetime) when is_struct(datetime, DateTime) do datetime |> DateTime.to_date() |> Date.to_iso8601() end def format_date_for_url(_), do: "2025-01-01" @doc """ Formats time for URL (HH:MM). """ def format_time_for_url(datetime) when is_struct(datetime, DateTime) do datetime |> DateTime.to_time() |> Time.truncate(:second) |> Time.to_string() |> String.slice(0..4) end def format_time_for_url(_), do: "00:00" @doc """ Pluralizes a word based on count. """ def pluralize(1, singular, _plural), do: "1 #{singular}" def pluralize(count, _singular, plural), do: "#{count} #{plural}" @doc """ Extracts and renders an excerpt from post content. Returns content before tag, or first paragraph if no tag. Renders markdown and strips HTML tags for plain text display. """ def extract_excerpt(content) when is_binary(content) do excerpt_markdown = if String.contains?(content, "") do # Extract content before tag content |> String.split("") |> List.first() |> String.trim() else # Get first paragraph (content before first double newline) content |> String.split(~r/\n\s*\n/, parts: 2) |> List.first() |> String.trim() end # Render markdown to HTML html = Renderer.render_markdown(excerpt_markdown) # Strip HTML tags to get plain text html |> Phoenix.HTML.raw() |> Phoenix.HTML.safe_to_string() |> strip_html_tags() |> String.trim() end def extract_excerpt(_), do: "" defp strip_html_tags(html) when is_binary(html) do html |> String.replace(~r/<[^>]*>/, " ") |> String.replace(~r/\s+/, " ") |> String.trim() end defp build_public_path(segments) do parts = url_prefix_segments() ++ (segments |> Enum.reject(&(&1 in [nil, ""])) |> Enum.map(&to_string/1)) case parts do [] -> "/" _ -> "/" <> Enum.join(parts, "/") end end defp url_prefix_segments do Config.get_url_prefix() |> case do "/" -> [] prefix -> prefix |> String.trim("/") |> String.split("/", trim: true) end end # Check if the given language is the default language (first admin language) # Default language gets clean URLs without locale prefix defp default_language?(language) do default = get_default_admin_language() language == default end # Get the default admin language base code (first in admin_languages list, or "en") # Extracts base code from full dialect (e.g., "en-US" -> "en") defp get_default_admin_language do alias PhoenixKit.Modules.Languages.DialectMapper case PhoenixKit.Settings.get_setting("admin_languages") do nil -> # No setting exists, default is "en" "en" json when is_binary(json) -> case Jason.decode(json) do # Extract base code from full dialect (e.g., "en-US" -> "en") {:ok, [first | _]} -> DialectMapper.extract_base(first) _ -> "en" end end end @doc """ Resolves a featured image URL for a post, falling back to the original variant. """ def featured_image_url(post, variant \\ "medium") do post.metadata |> Map.get(:featured_image_id) |> resolve_featured_image_url(variant) end defp resolve_featured_image_url(nil, _variant), do: nil defp resolve_featured_image_url("", _variant), do: nil defp resolve_featured_image_url(file_id, variant) when is_binary(file_id) do Storage.get_public_url_by_id(file_id, variant) || Storage.get_public_url_by_id(file_id) rescue _ -> nil end end