v0.3.0

OgEx 0.3.0

This release introduces the controller card DSL and dedicated image dispatch.

• og_card :show, PostOgCard associates a card with one controller action.
• Card.load/2 loads image data without running the normal controller action.
• A controller function passed with load: can replace the card loader.
• image_route: :path generates /opengraph-image/TOKEN and
  /twitter-image/TOKEN URLs.
• image_route: :query generates ?__og_ex=TOKEN URLs.
• Path requests can be handled by og_ex_routes() in the router or by
  plug OgEx, router: MyAppWeb.Router in the endpoint.
• Duplicate declarations and simultaneous router/endpoint integrations are
  detected instead of being silently accepted.
• Loader failures return non-cacheable 404 or 503 responses.
• The 0.2 render(..., og: ...) API remains available during migration.

Install:

{:og_ex, "~> 0.3.0"}

View the changes from 0.2.0

v0.2.0

OgEx 0.2.0

This release introduces local and remote image sources.

• Generated HEEx cards can contain <img> elements.
• Root-relative paths load images from the Phoenix priv/static directory.
• OgEx.private_asset/1 loads a private local file without exposing a public
  URL.
• HTTPS images can be downloaded from an explicit host allowlist.
• Remote loading includes byte, dimension, pixel, redirect, and timeout limits.
• Direct-image declarations can point og:image at an existing local or
  external file instead of generating a new image.
• Local image content is inspected to determine its actual format and
  dimensions.

Install:

{:og_ex, "~> 0.2.0"}

View the changes from 0.1.0

v0.1.0

OgEx 0.1.0

This release introduces generated social cards for Phoenix controllers.

• use OgEx.Card defines card dimensions and output format.
• metadata/1 defines Open Graph and Twitter/X metadata.
• render/1 defines the image with HEEx and CSS.
• render(conn, template, og: CardModule) adds metadata to the HTML response.
• A signed query URL on the same controller route returns the generated image.
• Takumi renders PNG, JPEG, WebP, and SVG output.
• Generated images use an in-memory ETS cache and immutable response headers.
• Precompiled native libraries are available for supported Linux, macOS, and
  Windows targets.

Install:

{:og_ex, "~> 0.1.0"}

View the changes