# `PhoenixKitEcommerce.Web.Helpers`
[🔗](https://github.com/BeamLabEU/phoenix_kit_ecommerce/blob/v0.1.8/lib/phoenix_kit_ecommerce/web/helpers.ex#L1)

Shared helper functions for Shop public LiveViews.

Centralizes utility functions that were duplicated across shop_catalog,
catalog_category, catalog_product, cart_page, checkout_page, and checkout_complete.

# `best_redirect_language`

Find the best enabled language that has a slug for this entity.

Prefers the default language, then checks other enabled languages.
Returns nil if no valid language found.

# `build_lang_url`

Build a localized URL path, adding language prefix for non-default languages.
Delegates to Routes.path which handles default vs non-default consistently.

# `first_image`

Get the first image URL for a product.

Handles Storage-based images (new format with featured_image_uuid or image_uuids)
and legacy URL-based images (Shopify imports).
Returns nil if no image is available.

# `format_price`

Format a price value with currency. Returns "-" for nil price.

# `get_current_user`

Extract current user from socket assigns scope.

# `get_language_from_params_or_default`

Determine language from URL params.

Uses locale param if present, otherwise falls back to Translations.default_language/0.
Used by catalog and category pages (non-product pages).

# `get_storage_image_url`

Get signed URL for a Storage image file.

Returns nil if file or variant not found (unlike product detail page
which returns a placeholder). Falls back to original variant if
requested variant is not available.

# `humanize_key`

Convert a key string to human-readable format.

Example: "material_type" -> "Material Type"

# `parse_page`

Parse page param with validation. Returns 1 for invalid/missing values.

# `profile_address`

Format address for a billing profile.

# `profile_display_name`

Format display name for a billing profile.

---

*Consult [api-reference.md](api-reference.md) for complete listing*