Image.Plug.Provider.Cloudinary (image_plug v0.1.0)

Copy Markdown View Source

Cloudinary URL provider.

Wires Image.Plug.Provider.Cloudinary.URL (URL recognition), Image.Plug.Provider.Cloudinary.Signing (optional HMAC verification), and Image.Plug.Provider.Cloudinary.Options (option parsing) into the Image.Plug.Provider behaviour.

Mount under any path. The expected URL shape is:

<mount>/<account>/image/<delivery>/[s--<sig>--/]<transforms>/<source>

where <transforms> may be a single comma-separated stage or multiple stages joined with / (v0.1 flattens multiple stages into one).

Options

  • :mount — string path prefix the plug is mounted under. Stripped before treating the rest as the cloudinary path. Defaults to "".

  • :account — when set, asserts the URL's account segment matches this value. When nil (default), any account is accepted.

  • :strict? — true (default) rejects unknown cloudinary option keys with :unknown_option. false logs and ignores them.

  • :signing — nil (default; no signing) or %{keys: [...], required?: bool}. When set, every request URL must carry a valid s--<sig>-- segment. Wire format matches Cloudinary's hosted signed URLs (SHA-256, 32 url-safe-base64 characters). See Image.Plug.Provider.Cloudinary.Signing.

Conformance

See guides/cloudinary_conformance.md for the per-option support matrix and the documented gaps.