One address of a site answered by a rule — a page or a file that moved, and the visitors, search engines and shared links that still ask for its old address.
A rule is a site's own (global? false): from_path is the address asked for, and kind what it
answers — see MishkaCmsCore.Runtime.Redirects:
:redirect(the default) sends the visitor toto— a path on the same site or a fullhttp(s)address — withstatus301, 302, 307 or 308;:rewriteservesto, a page or a media file of the same site, at the address asked for, which stays in the browser;:goneand:not_foundanswer the site's error page with 410 or 404, and keep noto.
status is a redirect's alone. An inactive rule is kept and answers nothing.
Addresses
from_path is stored as MishkaCmsCore.Runtime.Redirects.normalize_path/1 writes it: one leading
/, no scheme or host, no query or fragment, no trailing / but the root's, and its
percent-escapes decoded, so a rule matches the address however a browser spelled it. A redirect's
to is stored as written, a rewrite's as normalize_path/1 writes it. A rule is refused when its
target is its own source, a redirect when following the site's active redirects from its target
comes back to an address already on the way, and a rewrite whose target is on another host, one of
the CMS's own addresses, or a file outside its site's media folder.
from_query narrows a rule to a query string, as MishkaCmsCore.Runtime.Redirects.normalize_query/1
writes it: p=123 on / answers WordPress's /?p=123, and page_id=7 or cat=3 the same. Such a
rule answers only a request that carries that query, alone or among other parameters, and sends
the visitor on without it. p=* answers p with any value, at its own path, when no rule on the
exact query does. A rule with none answers its path whatever the query.
Served from ETS
Every rule that is active is held by MishkaCmsCore.Runtime.States.RedirectsState, loaded at boot
and kept current off this resource's broadcasts. MishkaCmsCore.Runtime.Plugs.SiteLookupPlug asks
it once the request's site is known, before any page is resolved — see
MishkaCmsCore.Runtime.Redirects.redirect/2.
Who writes them
Anyone under the request's surface reads a site's rules; writing them takes the redirect section,
admin:dashboard:runtime:redirect or admin:api:runtime:redirect. A master reaches every site, a
site user its own.
Summary
Functions
Apply the full GuardedStruct pipeline (sanitize → validate → derive →
main_validator) to attrs and return either {:ok, transformed_attrs}
or {:error, errors}. Wire this into an Ash.Resource.Change to plug
guardedstruct rules into Ash's changeset pipeline.
O(1) lookup of a field's compile-time metadata by name. Returns
nil for unknown fields.
Compile-time-baked MapSet of every field name owned by the
guardedstruct block. Used by GuardedStruct.AshResource.Change
to decide, in O(1), whether a key in changeset.atomics
belongs to the pipeline.
Validates that the keys in the provided input are valid for at least one action on the resource.
Same as input/1, except restricts the keys to values accepted by the action provided.
Types
@type t() :: %MishkaCmsCore.Runtime.Redirect{ __lateral_join_source__: term(), __meta__: term(), __metadata__: term(), __order__: term(), active: term(), aggregates: term(), archived_at: term(), calculations: term(), description: term(), from_path: term(), from_query: term(), id: term(), inserted_at: term(), kind: term(), paper_trail_versions: term(), site: term(), site_id: term(), sorted_versions: term(), status: term(), to: term(), updated_at: term() }
Functions
Apply the full GuardedStruct pipeline (sanitize → validate → derive →
main_validator) to attrs and return either {:ok, transformed_attrs}
or {:error, errors}. Wire this into an Ash.Resource.Change to plug
guardedstruct rules into Ash's changeset pipeline.
The function is named __guarded_change__ because it does more than
validate — it can also transform values (trim, downcase, slugify,
auto-fill, etc.) before they reach the data layer.
O(1) lookup of a field's compile-time metadata by name. Returns
nil for unknown fields.
Compile-time-baked MapSet of every field name owned by the
guardedstruct block. Used by GuardedStruct.AshResource.Change
to decide, in O(1), whether a key in changeset.atomics
belongs to the pipeline.
Validates that the keys in the provided input are valid for at least one action on the resource.
Raises a KeyError error at compile time if not. This exists because generally a struct should only ever
be created by Ash as a result of a successful action. You should not be creating records manually in code,
e.g %MyResource{value: 1, value: 2}. Generally that is fine, but often with embedded resources it is nice
to be able to validate the keys that are being provided, e.g
Resource
|> Ash.Changeset.for_create(:create, %{embedded: EmbeddedResource.input(foo: 1, bar: 2)})
|> Ash.create()
Same as input/1, except restricts the keys to values accepted by the action provided.