Skip to main content

rustango_cms/
urls.rs

1//! Named URL patterns + Tera helper registration.
2//!
3//! Registered via [`rustango::register_url!`]:
4//! every admin route gets a stable name (`rcms-admin:pages:list`,
5//! `rcms-admin:pages:edit`, …) so templates resolve URLs through
6//! `{{ url(name="…") }}` instead of hard-coding `/cms-admin/...`
7//! strings. Mount-prefix changes only need one edit in this file.
8//!
9//! ## Wire-up
10//!
11//! Calling [`crate::admin::register_templates`] also calls
12//! [`register_tera_helpers`], which registers:
13//!
14//! - `{{ url(name=…, kwarg=…) }}` — named URL reversal
15//!   ([`rustango::urls`]).
16//! - `{{ "…" | querystring(…) }}` — URL query-string builder
17//!   for pagination + filter links.
18//! - `{{ ts | naturaltime }}`, `intcomma`, `naturalsize`,
19//!   `ordinal`, etc. — humanize filters
20//!   ([`rustango::humanize`]).
21//! - `{{ csrf_token | csrf_input | safe }}` — hidden-input shape
22//!   of the CSRF token ([`rustango::forms::csrf`]).
23//!
24//! No-op on the registry-name side: [`rustango::register_url!`]
25//! submits each pattern through `inventory`, so the names are live
26//! the moment this module is linked into the binary.
27
28use rustango::register_url;
29
30// -- pages tab --
31register_url!("rcms-admin:root", "/cms-admin");
32// #144 — editor dashboard / home screen.
33register_url!("rcms-admin:dashboard", "/cms-admin/dashboard");
34
35// -- auth chrome (logout + password-reset; reachable pre-auth, see admin/mod.rs) --
36register_url!("rcms-admin:logout", "/cms-admin/logout");
37register_url!("rcms-admin:password-reset", "/cms-admin/password-reset");
38register_url!(
39    "rcms-admin:password-reset:confirm",
40    "/cms-admin/password-reset/confirm"
41);
42
43register_url!("rcms-admin:pages:list", "/cms-admin/pages");
44register_url!("rcms-admin:pages:new", "/cms-admin/pages/new");
45register_url!("rcms-admin:pages:edit", "/cms-admin/pages/{id}/edit");
46register_url!(
47    "rcms-admin:pages:translate",
48    "/cms-admin/pages/{id}/translate"
49);
50register_url!("rcms-admin:pages:delete", "/cms-admin/pages/{id}/delete");
51register_url!("rcms-admin:pages:preview", "/cms-admin/pages/{id}/preview");
52register_url!(
53    "rcms-admin:pages:revert",
54    "/cms-admin/pages/{id}/revert/{rev_id}"
55);
56register_url!(
57    "rcms-admin:pages:history-diff",
58    "/cms-admin/pages/{id}/history/diff"
59);
60// #192 — per-page audit log CSV export.
61register_url!("rcms-admin:pages:log-csv", "/cms-admin/pages/{id}/log.csv");
62register_url!("rcms-admin:pages:move", "/cms-admin/pages/{id}/move");
63register_url!("rcms-admin:pages:clone", "/cms-admin/pages/{id}/clone");
64register_url!("rcms-admin:pages:alias", "/cms-admin/pages/{id}/alias");
65register_url!("rcms-admin:pages:privacy", "/cms-admin/pages/{id}/privacy");
66register_url!("rcms-admin:pages:bulk", "/cms-admin/pages/bulk");
67register_url!("rcms-admin:pages:unlock", "/cms-admin/pages/{id}/unlock");
68register_url!(
69    "rcms-admin:pages:lock-heartbeat",
70    "/cms-admin/pages/{id}/lock-heartbeat"
71);
72register_url!(
73    "rcms-admin:pages:lock-release",
74    "/cms-admin/pages/{id}/lock-release"
75);
76// #147 — draft autosave (silent revision capture).
77register_url!(
78    "rcms-admin:pages:autosave",
79    "/cms-admin/pages/{id}/autosave"
80);
81register_url!(
82    "rcms-admin:pages:sessions",
83    "/cms-admin/pages/{id}/sessions"
84);
85// #115 — page subscriptions (notify-on-publish opt-in).
86register_url!(
87    "rcms-admin:pages:subscribe",
88    "/cms-admin/pages/{id}/subscribe"
89);
90register_url!(
91    "rcms-admin:pages:unsubscribe",
92    "/cms-admin/pages/{id}/unsubscribe"
93);
94// #81 PR 1 — inline comments.
95register_url!(
96    "rcms-admin:pages:comments:new",
97    "/cms-admin/pages/{id}/comments/new"
98);
99register_url!(
100    "rcms-admin:pages:comments:reply",
101    "/cms-admin/pages/{id}/comments/{comment_id}/reply"
102);
103register_url!(
104    "rcms-admin:pages:comments:resolve",
105    "/cms-admin/pages/{id}/comments/{comment_id}/resolve"
106);
107register_url!(
108    "rcms-admin:pages:comments:reopen",
109    "/cms-admin/pages/{id}/comments/{comment_id}/reopen"
110);
111
112// #533 FB-04 — dedicated visual Form Builder editor route.
113register_url!("rcms-admin:forms:build", "/cms-admin/forms/{id}/build");
114register_url!("rcms-admin:forms:preview", "/cms-admin/forms/{id}/preview");
115// #548 FB-15 — publish the draft.
116register_url!("rcms-admin:forms:publish", "/cms-admin/forms/{id}/publish");
117// #525 — persist the admin UI language.
118register_url!("rcms-admin:set-language", "/cms-admin/set-language");
119// #545 FB-12 — per-form submission history.
120register_url!(
121    "rcms-admin:forms:submissions",
122    "/cms-admin/forms/{id}/submissions"
123);
124// #73 PR 2 — per-page workflow actions.
125register_url!(
126    "rcms-admin:pages:workflow-submit",
127    "/cms-admin/pages/{id}/workflow/submit"
128);
129register_url!(
130    "rcms-admin:pages:workflow-approve",
131    "/cms-admin/pages/{id}/workflow/approve"
132);
133register_url!(
134    "rcms-admin:pages:workflow-reject",
135    "/cms-admin/pages/{id}/workflow/reject"
136);
137register_url!(
138    "rcms-admin:pages:workflow-cancel",
139    "/cms-admin/pages/{id}/workflow/cancel"
140);
141
142// -- library (snippets) tab --
143register_url!("rcms-admin:library:list", "/cms-admin/library");
144register_url!("rcms-admin:library:new", "/cms-admin/library/new");
145register_url!("rcms-admin:library:edit", "/cms-admin/library/{id}/edit");
146register_url!(
147    "rcms-admin:library:delete",
148    "/cms-admin/library/{id}/delete"
149);
150register_url!(
151    "rcms-admin:library:bulk",
152    "/cms-admin/library/{type_name}/bulk"
153);
154// #123 — opt-in snippet revisions.
155register_url!(
156    "rcms-admin:library:revert",
157    "/cms-admin/library/{id}/revert/{seq}"
158);
159// #186 — bulk import snippets from CSV / TSV.
160register_url!(
161    "rcms-admin:library:import",
162    "/cms-admin/library/{type_name}/import"
163);
164
165// -- media / documents tab --
166register_url!("rcms-admin:media:list", "/cms-admin/media");
167register_url!("rcms-admin:media:upload", "/cms-admin/media/upload");
168// #142 — staged-upload scratch storage.
169register_url!(
170    "rcms-admin:media:upload-staged",
171    "/cms-admin/media/upload-staged"
172);
173register_url!(
174    "rcms-admin:media:upload-staged:cancel",
175    "/cms-admin/media/upload-staged/{id}/cancel"
176);
177// #188 — promote staged uploads to cms_media in bulk with per-file metadata.
178register_url!(
179    "rcms-admin:media:upload-staged:commit",
180    "/cms-admin/media/upload-staged/commit"
181);
182register_url!("rcms-admin:media:edit", "/cms-admin/media/{id}/edit");
183register_url!("rcms-admin:media:crop", "/cms-admin/media/{id}/crop");
184// #190 — re-upload bytes for an existing media id.
185register_url!("rcms-admin:media:replace", "/cms-admin/media/{id}/replace");
186register_url!("rcms-admin:media:delete", "/cms-admin/media/{id}/delete");
187register_url!(
188    "rcms-admin:media:collection-permissions",
189    "/cms-admin/media/collections/{id}/permissions"
190);
191// #195 — collection view restriction (login / groups / password).
192register_url!(
193    "rcms-admin:media:collection-privacy",
194    "/cms-admin/media/collections/{id}/privacy"
195);
196register_url!(
197    "rcms-admin:media:collections",
198    "/cms-admin/media/collections"
199);
200register_url!(
201    "rcms-admin:media:collections:new",
202    "/cms-admin/media/collections/new"
203);
204register_url!(
205    "rcms-admin:media:collections:edit",
206    "/cms-admin/media/collections/{id}/edit"
207);
208register_url!(
209    "rcms-admin:media:collections:delete",
210    "/cms-admin/media/collections/{id}/delete"
211);
212// #557 — categories / taxonomies.
213register_url!("rcms-admin:taxonomies:list", "/cms-admin/taxonomies");
214register_url!("rcms-admin:taxonomies:tree", "/cms-admin/taxonomies/{slug}");
215register_url!(
216    "rcms-admin:taxonomies:categories:new",
217    "/cms-admin/taxonomies/{slug}/categories/new"
218);
219register_url!(
220    "rcms-admin:taxonomies:categories:edit",
221    "/cms-admin/taxonomies/{slug}/categories/{id}/edit"
222);
223register_url!(
224    "rcms-admin:taxonomies:categories:delete",
225    "/cms-admin/taxonomies/{slug}/categories/{id}/delete"
226);
227register_url!(
228    "rcms-admin:taxonomies:categories:translate",
229    "/cms-admin/taxonomies/{slug}/categories/{id}/translate"
230);
231register_url!(
232    "rcms-admin:media:bulk-move-collection",
233    "/cms-admin/media/bulk-move-collection"
234);
235register_url!("rcms-admin:documents:list", "/cms-admin/documents");
236
237// -- locales tab --
238register_url!("rcms-admin:sso-providers:list", "/cms-admin/sso-providers");
239register_url!(
240    "rcms-admin:sso-providers:new",
241    "/cms-admin/sso-providers/new"
242);
243register_url!(
244    "rcms-admin:sso-providers:edit",
245    "/cms-admin/sso-providers/{id}/edit"
246);
247register_url!(
248    "rcms-admin:sso-providers:delete",
249    "/cms-admin/sso-providers/{id}/delete"
250);
251register_url!("rcms-admin:locales:list", "/cms-admin/locales");
252register_url!("rcms-admin:locales:new", "/cms-admin/locales/new");
253register_url!("rcms-admin:locales:edit", "/cms-admin/locales/{id}/edit");
254register_url!(
255    "rcms-admin:locales:delete",
256    "/cms-admin/locales/{id}/delete"
257);
258
259// -- redirects tab (editor-managed 301/302) --
260register_url!("rcms-admin:redirects:list", "/cms-admin/redirects");
261register_url!("rcms-admin:redirects:new", "/cms-admin/redirects/new");
262register_url!(
263    "rcms-admin:redirects:edit",
264    "/cms-admin/redirects/{id}/edit"
265);
266register_url!(
267    "rcms-admin:redirects:delete",
268    "/cms-admin/redirects/{id}/delete"
269);
270// #145 — bulk import from CSV / TSV.
271register_url!("rcms-admin:redirects:import", "/cms-admin/redirects/import");
272register_url!(
273    "rcms-admin:redirects:export",
274    "/cms-admin/redirects/export.csv"
275);
276
277// -- navigation menus (#22) --
278register_url!("rcms-admin:navigation:list", "/cms-admin/navigation");
279register_url!("rcms-admin:navigation:new", "/cms-admin/navigation/new");
280register_url!(
281    "rcms-admin:navigation:edit",
282    "/cms-admin/navigation/{id}/edit"
283);
284register_url!(
285    "rcms-admin:navigation:clone",
286    "/cms-admin/navigation/{id}/clone"
287);
288register_url!(
289    "rcms-admin:navigation:save-tree",
290    "/cms-admin/navigation/{id}/save-tree"
291);
292register_url!(
293    "rcms-admin:navigation:seed-from-pages",
294    "/cms-admin/navigation/{id}/seed-from-pages"
295);
296register_url!(
297    "rcms-admin:navigation:delete",
298    "/cms-admin/navigation/{id}/delete"
299);
300register_url!(
301    "rcms-admin:navigation:translate",
302    "/cms-admin/navigation/{id}/translate"
303);
304register_url!(
305    "rcms-admin:navigation:items",
306    "/cms-admin/navigation/{id}/items"
307);
308register_url!(
309    "rcms-admin:navigation:item-delete",
310    "/cms-admin/navigation/{menu_id}/items/{id}/delete"
311);
312
313// -- workflows (#73 PR 1 — multi-step approvals) --
314register_url!("rcms-admin:workflows:list", "/cms-admin/workflows");
315register_url!("rcms-admin:workflows:new", "/cms-admin/workflows/new");
316register_url!(
317    "rcms-admin:workflows:edit",
318    "/cms-admin/workflows/{id}/edit"
319);
320register_url!(
321    "rcms-admin:workflows:delete",
322    "/cms-admin/workflows/{id}/delete"
323);
324register_url!(
325    "rcms-admin:workflows:task-add",
326    "/cms-admin/workflows/{id}/tasks/add"
327);
328register_url!(
329    "rcms-admin:workflows:task-delete",
330    "/cms-admin/workflows/{id}/tasks/{task_id}/delete"
331);
332
333// -- history (tenant-wide revision audit) --
334register_url!("rcms-admin:history", "/cms-admin/history");
335
336// -- site settings (#108) --
337register_url!("rcms-admin:site-settings:list", "/cms-admin/site-settings");
338// Per-tenant template overrides — the admin editor.
339register_url!("rcms-admin:templates:list", "/cms-admin/templates");
340register_url!(
341    "rcms-admin:page-types:template",
342    "/cms-admin/page-types/{id}/template"
343);
344register_url!("rcms-admin:templates:edit", "/cms-admin/templates/edit");
345register_url!("rcms-admin:templates:new", "/cms-admin/templates/new");
346register_url!(
347    "rcms-admin:templates:validate",
348    "/cms-admin/templates/validate"
349);
350register_url!("rcms-admin:templates:delete", "/cms-admin/templates/delete");
351// Help → Documentation (the bundled guides).
352register_url!("rcms-admin:help", "/cms-admin/help");
353// Settings → Site theme (theme packages).
354register_url!("rcms-admin:site-theme", "/cms-admin/site-theme");
355register_url!("rcms-admin:site-theme:download", "/cms-admin/site-theme/download");
356register_url!("rcms-admin:site-theme:upload", "/cms-admin/site-theme/upload");
357register_url!("rcms-admin:site-theme:preview", "/cms-admin/site-theme/preview");
358register_url!("rcms-admin:site-theme:install", "/cms-admin/site-theme/install");
359register_url!("rcms-admin:site-theme:restore", "/cms-admin/site-theme/restore");
360register_url!(
361    "rcms-admin:site-settings:edit",
362    "/cms-admin/site-settings/{scope}/edit"
363);
364register_url!(
365    "rcms-admin:site-settings:delete",
366    "/cms-admin/site-settings/{scope}/delete"
367);
368register_url!(
369    "rcms-admin:site-settings:translate",
370    "/cms-admin/site-settings/{scope}/translate"
371);
372
373// -- aging-pages report (#101) --
374register_url!("rcms-admin:reports:aging", "/cms-admin/reports/aging");
375register_url!(
376    "rcms-admin:reports:aging-csv",
377    "/cms-admin/reports/aging.csv"
378);
379register_url!(
380    "rcms-admin:reports:locked-pages",
381    "/cms-admin/reports/locked-pages"
382);
383register_url!(
384    "rcms-admin:reports:locked-pages-csv",
385    "/cms-admin/reports/locked-pages.csv"
386);
387register_url!(
388    "rcms-admin:reports:workflows",
389    "/cms-admin/reports/workflows"
390);
391register_url!(
392    "rcms-admin:reports:workflows-csv",
393    "/cms-admin/reports/workflows.csv"
394);
395// #122 — revision storage + prune.
396register_url!(
397    "rcms-admin:reports:revisions",
398    "/cms-admin/reports/revisions"
399);
400register_url!(
401    "rcms-admin:reports:revisions:prune",
402    "/cms-admin/reports/revisions/prune"
403);
404// #141 — scheduled-publish report.
405register_url!(
406    "rcms-admin:reports:scheduled",
407    "/cms-admin/reports/scheduled"
408);
409register_url!(
410    "rcms-admin:reports:scheduled-csv",
411    "/cms-admin/reports/scheduled.csv"
412);
413// #143 — search promotions + query log.
414register_url!("rcms-admin:reports:search", "/cms-admin/reports/search");
415register_url!(
416    "rcms-admin:reports:search:edit",
417    "/cms-admin/reports/search/{id}/edit"
418);
419
420// -- global search (#77) --
421register_url!("rcms-admin:search", "/cms-admin/search");
422
423// -- page types (registry + usage stats) --
424register_url!("rcms-admin:page-types", "/cms-admin/page-types");
425register_url!("rcms-admin:page-types:new", "/cms-admin/page-types/new");
426// #843 — settings of an admin-made type (name, parent/child rules, workflow).
427register_url!("rcms-admin:page-types:edit", "/cms-admin/page-types/{id}/edit");
428register_url!(
429    "rcms-admin:page-types:delete",
430    "/cms-admin/page-types/{id}/delete"
431);
432register_url!(
433    "rcms-admin:page-types:build",
434    "/cms-admin/page-types/{id}/build"
435);
436register_url!(
437    "rcms-admin:page-types:publish",
438    "/cms-admin/page-types/{id}/build/publish"
439);
440
441// -- reusable components library (#563) --
442register_url!("rcms-admin:components:index", "/cms-admin/components");
443register_url!("rcms-admin:components:new", "/cms-admin/components/new");
444register_url!(
445    "rcms-admin:components:edit",
446    "/cms-admin/components/{id}/edit"
447);
448register_url!(
449    "rcms-admin:components:delete",
450    "/cms-admin/components/{id}/delete"
451);
452
453// -- unused media report (#8) --
454register_url!("rcms-admin:media:unused", "/cms-admin/media/unused");
455register_url!(
456    "rcms-admin:media:unused:delete",
457    "/cms-admin/media/unused/delete"
458);
459
460// -- settings tab --
461register_url!("rcms-admin:settings", "/cms-admin/settings");
462register_url!("rcms-admin:settings:theme", "/cms-admin/settings/theme");
463// #199 — per-tenant branding (logo + favicon).
464register_url!(
465    "rcms-admin:settings:branding",
466    "/cms-admin/settings/branding"
467);
468
469// -- no-access page (#35) — destination for the cms_admin.access gate --
470register_url!("rcms-admin:no-access", "/cms-admin/no-access");
471
472// -- per-user account preferences (#27) --
473register_url!("rcms-admin:account", "/cms-admin/me");
474register_url!(
475    "rcms-admin:account:mcp-key-create",
476    "/cms-admin/me/mcp-keys"
477);
478register_url!(
479    "rcms-admin:account:mcp-key-revoke",
480    "/cms-admin/me/mcp-keys/{id}/revoke"
481);
482// #197 — per-user notification preferences (workflow / comments / publishes).
483register_url!(
484    "rcms-admin:account:notifications",
485    "/cms-admin/me/notifications"
486);
487// JSON endpoint backing the PageChooser widget.
488register_url!("rcms-admin:page-chooser", "/cms-admin/__page-chooser");
489// JSON endpoints backing the Snippet + Document choosers.
490register_url!("rcms-admin:snippet-chooser", "/cms-admin/__snippet-chooser");
491register_url!(
492    "rcms-admin:document-chooser",
493    "/cms-admin/__document-chooser"
494);
495// #201 — avatar upload + display name change.
496register_url!("rcms-admin:account:profile", "/cms-admin/me/profile");
497// #526 — per-user admin UI language preference.
498register_url!("rcms-admin:account:language", "/cms-admin/me/language");
499register_url!("rcms-admin:account:show-templates", "/cms-admin/me/show-templates");
500// #202 — email change (with confirmation flow) + password change.
501register_url!("rcms-admin:account:email", "/cms-admin/me/email");
502register_url!(
503    "rcms-admin:account:email:confirm",
504    "/cms-admin/me/email/confirm"
505);
506register_url!("rcms-admin:account:password", "/cms-admin/me/password");
507// #129 — styleguide / component gallery.
508register_url!("rcms-admin:styleguide", "/cms-admin/styleguide");
509// #139 — banner dismissibles.
510register_url!("rcms-admin:dismissible", "/cms-admin/dismissibles/{key}");
511// `register_admin_page!`-registered custom admin pages (admin/mod.rs `/cms-admin/x/{slug}`).
512register_url!("rcms-admin:custom-page", "/cms-admin/x/{slug}");
513
514// -- users / roles (proxied to framework admin) --
515register_url!("rcms-admin:users", "/cms-admin/users");
516register_url!("rcms-admin:users:new", "/cms-admin/users/new");
517register_url!("rcms-admin:users:edit", "/cms-admin/users/{id}/edit");
518register_url!(
519    "rcms-admin:users:mcp-key-create",
520    "/cms-admin/users/{id}/mcp-keys"
521);
522register_url!(
523    "rcms-admin:users:deactivate",
524    "/cms-admin/users/{id}/deactivate"
525);
526register_url!("rcms-admin:roles", "/cms-admin/roles");
527register_url!("rcms-admin:security-log", "/cms-admin/security-log");
528register_url!("rcms-admin:roles:new", "/cms-admin/roles/new");
529register_url!("rcms-admin:roles:edit", "/cms-admin/roles/{id}/edit");
530register_url!("rcms-admin:roles:delete", "/cms-admin/roles/{id}/delete");
531
532// -- public-side --
533register_url!("rcms:sitemap", "/sitemap.xml");
534register_url!("rcms:feed:rss", "/feed/{kind}/rss.xml");
535register_url!("rcms:feed:atom", "/feed/{kind}/atom.xml");
536
537/// Register every Tera function / filter the bundled admin
538/// templates rely on. Called from
539/// [`crate::admin::register_templates`]; host apps don't need to
540/// call it themselves unless they're building Tera without the
541/// admin templates.
542pub fn register_tera_helpers(tera: &mut tera::Tera) {
543    rustango::urls::register_url_tag(tera);
544    rustango::urls::register_querystring_filter(tera);
545    rustango::humanize::register_filters(tera);
546    rustango::forms::csrf::register_csrf_filter(tera);
547    // #247 — `pageurl(id=…)` + `| pageurl`. The function reads from a
548    // thread-local map installed by [`crate::render::render_inner`]
549    // for the duration of `tera.render`, so registering it once on
550    // the shared Tera is safe.
551    crate::page_url::register_tera_function(tera);
552    // `| safe_href`: an editor's link only if it is a site path or a
553    // web, mail or phone address (layout blocks, theme buttons).
554    crate::block::layout::register_tera_filter(tera);
555    // #members — `can_view(page=…)` / `{{ p | can_view }}` (viewer-aware
556    // access predicate) + `{{ list | visible }}` (filter a page/menu list,
557    // nested-aware). Reads the render-scoped `AccessContext` thread-local
558    // installed by `render::render_inner`; used to guard hand-written page
559    // links and nested lists with the same protection the built-in menus
560    // apply.
561    crate::access::register_tera_function(tera);
562    // #249 — `children_filtered(status=…, order_by=…, limit=…)`. Same
563    // thread-local install pattern as `pageurl`; the rendered page's
564    // children get installed by `render::render_inner` and cleared
565    // when render returns.
566    crate::children_filtered::register_tera_function(tera);
567    // #248 — `| richtext`. Walks `<a linktype="page|media" id="N">`
568    // in editor-emitted HTML and rewrites `href` against the same
569    // `_pages_by_id` thread-local `pageurl` reads; the rest are resolved
570    // over the final page by `richtext::resolve_internal_links`. `is_safe = true` so
571    // the editor's already-escaped output passes through verbatim.
572    crate::richtext::register_tera_filter(tera);
573    // #244 — `auto_menu(parent_id=…, depth=…)`, the automatic menu.
574    // The render handler pre-fetches every `show_in_menus = true AND
575    // status = published` page into a thread-local pool; the function
576    // walks that pool at call time to build the nested item tree.
577    crate::auto_menu::register_tera_function(tera);
578    // #639 — `menu(slug=…)`, the editor-curated menus. Same pattern: the
579    // render resolves every menu and installs them in a thread-local.
580    crate::navigation::register_tera_function(tera);
581    // #845 — `cms_snippet(slug=…)`, a library element by slug. Same
582    // pattern again: the render installs the prefetched snippets.
583    crate::snippet::register_tera_function(tera);
584    // #255 — `| date_parse` + `| format_date`. Fail-soft string-to-
585    // date filters for extension fields backed by a `Date` widget
586    // (storage shape is `YYYY-MM-DD`); Tera's built-in `| date`
587    // errors on empty/null/unparseable inputs which 500s the page.
588    crate::date_filters::register_tera_filters(tera);
589    // #253 — `rcms_image_url(media_id, filter, v)`. Pure function;
590    // already accepts stringified ids (block-storage shape) + bare
591    // i64s (loaded-row shape). Wiring it here makes the bundled
592    // `blocks/image.html` AND admin templates (media_list, media_edit)
593    // actually resolve the call at render time.
594    crate::rendition::register_tera_function(tera);
595    // #250 — `snippet_html(type=…, id=N)`. Per-snippet template
596    // rendering. The render handler pre-renders every snippet whose
597    // handler declares a `render_template`; this function pulls the
598    // pre-rendered HTML keyed on `(type, id)`.
599    crate::snippet_render::register_tera_function(tera);
600    // #245 — `site_setting(scope=…)`. Looks up a pre-fetched
601    // `cms_site_setting` row's `value_json` by scope; templates
602    // access fields via `{{ site_setting(scope="footer").site_name }}`.
603    crate::site_setting::register_tera_function(tera);
604    // #445/#453 — the remaining public render helpers, wired here so a
605    // single `admin::register_templates` call gives a host EVERY public
606    // template function/filter (no separate meta_tags / t / markdown
607    // registration to hunt for): `rcms_meta_tags(page=…)`, the `| t`
608    // per-field translation filter, and the `| markdown` filter.
609    crate::meta_tags::register_tera_function(tera);
610    crate::translation::register_tera_filter(tera);
611    crate::markdown::register_tera_filter(tera);
612    // #401 — `language_switcher()` returns the active locales + the URL
613    // to the current page in each (data installed per-request by the
614    // public render handler).
615    crate::language_switcher::register_tera_function(tera);
616    // #i18n — `rcms_hreflang_tags(origin=…)` emits the `<head>` hreflang
617    // alternates cluster so SEO crawlers / audit tools that read the page
618    // head (not just the sitemap) discover the language versions.
619    crate::language_switcher::register_hreflang_function(tera);
620    // #442 — `routable_url()` reverses a routable page's sub-URL
621    // patterns.
622    crate::routable::register_tera_function(tera);
623}
624
625/// Surface duplicate URL-pattern names at boot. Returns a list of
626/// names registered more than once; empty list means clean.
627/// Re-exports [`rustango::urls::duplicates`] for callers that don't
628/// want to depend on the framework module directly.
629#[must_use]
630pub fn duplicate_url_names() -> Vec<&'static str> {
631    rustango::urls::duplicates()
632}