Scopes a read to one site plus the shared rows, deciding whose site from WHO IS ASKING.

For the multitenancy :bypass reads that answer "this site's rows and the global ones" — :for_tenant_with_globals and its single-row twin, the builder's :for_editor reads, a stylesheet's :for_compiler. A missing tenant is never a master:

• a master (MishkaCmsCore.Accounts.Helper.master_user?/1, site_id nil) reads the tenant's site when one is passed, else the site named in the :site_id argument, else every site;
• a site user, whatever it holds, reads its own site. Passing another site's tenant or naming another site in :site_id reads nothing;
• a call made as the system — no actor, authorize?: false — reads as a master does;
• a call with no actor made as a user reads the tenant's site when one is passed, else nothing. A query built without authorize? is such a call: Ash hands the preparation the domain's default, true;
• any other actor reads nothing.

The actor is the one the query was built with. What holds the actor that runs the read is the policy on the same actions — see MishkaCmsCore.Runtime.Layout — and a test holds every action that uses this preparation to that policy.

Options

• :shape — :with_globals (the default) adds the shared rows to the site's own; :exact reads the site's rows alone, and the shared rows alone when the reach is every site.
• :fallback — what a master or the system reads with neither a tenant nor a :site_id: :everything (the default) or :globals.

Usage

read :for_tenant_with_globals do
  multitenancy :bypass
  argument :site_id, :uuid, allow_nil?: true

  prepare MishkaCmsCore.Runtime.Resources.Preparations.SiteWithGlobals
end