OgEx (og_ex v0.3.1)

Open Graph and Twitter/X image support for Phoenix controllers.

Add OgEx.Controller to a controller and declare a card for an action:

og_card :show, MyAppWeb.PostOgCard

Card-local load/2 retrieves image-specific assigns without running the normal controller action. Applications can choose signed path or query image URLs.

Path mode supports either OgEx.Router.og_ex_routes/1 or plug OgEx, router: MyAppWeb.Router. Choose one, not both. Query mode can be intercepted by the controller integration without either path integration.

Legacy generated-card and direct-image render(..., og: declaration) calls remain supported.

See the project README for complete setup, source types, remote-image policy, caching, and current failure behavior.

Summary

Functions

action(conn)

Returns the action that declared the current card.

call(conn, options)

Dispatches endpoint image requests or preserves legacy query fetching.

controller(conn)

Returns the controller that declared the current card.

font(path)

Builds a lazy font entry for a file below the configured :otp_app.

image_role(conn)

Returns :open_graph or :twitter for the current image request.

init(options)

Initializes endpoint image dispatch.

private_asset(path)

Builds an opaque HEEx source for a private image.

route_params(conn)

Returns normalized route parameters for the current image request.

Functions

action(conn)

Returns the action that declared the current card.

call(conn, options)

Dispatches endpoint image requests or preserves legacy query fetching.

With a configured router, candidate path and query image requests are resolved before Phoenix routing. Without one, this retains the 0.2.x compatibility behavior.

controller(conn)

Returns the controller that declared the current card.

This is available during declaration-based image loading. It returns nil for ordinary requests and legacy render-time cards.

font(path)

Builds a lazy font entry for a file below the configured :otp_app.

The marker is resolved when fonts load during a render, so this helper never touches the filesystem:

config :og_ex,
  otp_app: :my_app,
  fonts: [OgEx.font("priv/fonts/Inter-Regular.ttf")]

Relative paths resolve with Application.app_dir/2 at load time; absolute paths pass through unchanged.

The return value is the plain {:ogex_font, path} tuple. Configuration evaluated before OgEx is compiled, such as config.exs during dependency compilation, cannot call this function; use the equivalent literal tuple there instead.