A collection of records that documents can show: products, posts, events, team members… (dynamic content).

A source tells the editor which fields its records have, and gives the records to the blocks that need them: a Loop grid repeats its content for each record of a source, and any prop of a block can be bound to a field of the current record (see ElementorexCms.Dynamic).

From an Ecto schema

The quickest way: list your schema in the config. Its fields are read from the schema (see ElementorexCms.Source.Ecto), so a table made with mix phx.gen.live or by hand works as it is:

config :elementorex_cms, sources: [MyApp.Catalog.Product]

Or a module, to choose the fields, restrict the records and give each one a link (mix elementorex.gen.source Catalog.Product writes it):

defmodule MyAppWeb.Sources.Products do
  use ElementorexCms.Source.Ecto,
    schema: MyApp.Catalog.Product,
    repo: MyApp.Repo,
    path: "/products/:slug",
    fields: [price: [defaults: %{"before" => "$", "format" => "number"}]]

  @impl true
  def scope(query, _context), do: where(query, [p], p.published)
end

Any other data

Implement this behaviour: key/0, label/0, fields/0 and list/2 are required; get/2, value/2, url/1, id/1, title/1, count/2, values/2 and icon/0 are optional. list/2 gets the filters, search and order of the loop and of the visitors' filters in its query ("custom" filters are the source's own, see ElementorexCms.Source.Field).

defmodule MyAppWeb.Sources.Team do
  @behaviour ElementorexCms.Source

  alias ElementorexCms.Source.{Field, Query}

  @impl true
  def key, do: "team"
  @impl true
  def label, do: "Team"
  @impl true
  def fields, do: [Field.new(:name, role: :title), Field.new(:photo, type: :image)]
  @impl true
  def list(query, _context), do: Query.run(query, MyApp.Team.members(), &Map.get(&1, String.to_existing_atom(&2)))
end

context is %{mode: :public | :editor, data: map}: where the document is rendered and the data the host passed (the current user, a tenant…).

The functions of this module work on the %ElementorexCms.Source{} built by new/1 (see ElementorexCms.Sources for the configured ones).