defmodule PhoenixKitWeb.BlogHTML do @moduledoc """ HTML rendering functions for BlogController. """ use PhoenixKitWeb, :html alias PhoenixKit.Blogging.Renderer alias PhoenixKit.Config alias PhoenixKit.Modules.Languages alias PhoenixKit.Modules.Languages.DialectMapper 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 # Default language gets clean URLs without locale prefix defp default_language?(language) do default = get_default_language() language == default end # Get the default frontend language base code # Uses the Languages module's default language for public URL consistency defp get_default_language do case Languages.get_default_language() do %{"code" => code} when is_binary(code) -> # Extract base code from full dialect (e.g., "en-US" -> "en") DialectMapper.extract_base(code) _ -> # Fallback to "en" if Languages module not configured "en" 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