avo 4.4.1 → 4.4.3
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- checksums.yaml +4 -4
- data/Gemfile.lock +1 -1
- data/app/assets/builds/avo/application.css +46 -53
- data/app/assets/stylesheets/css/sidebar.css +37 -33
- data/app/components/avo/debug/status_component.html.erb +27 -23
- data/app/components/avo/debug/status_component.rb +4 -0
- data/app/components/avo/sidebar_profile_component.html.erb +45 -57
- data/lib/avo/skills/avo-actions/SKILL.md +3 -2
- data/lib/avo/skills/avo-authentication/SKILL.md +2 -2
- data/lib/avo/skills/avo-custom-ui/SKILL.md +3 -1
- data/lib/avo/skills/avo-index-views/SKILL.md +2 -2
- data/lib/avo/skills/avo-setup/SKILL.md +1 -1
- data/lib/avo/skills/avo-update/SKILL.md +2 -2
- data/lib/avo/skills/docs-index.json +2 -2
- data/lib/avo/version.rb +1 -1
- metadata +1 -1
checksums.yaml
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
---
|
|
2
2
|
SHA256:
|
|
3
|
-
metadata.gz:
|
|
4
|
-
data.tar.gz:
|
|
3
|
+
metadata.gz: 4db5afb9a352fe2f25dd355093e0fb16f466c205d4ab10f4c59a30951021c6aa
|
|
4
|
+
data.tar.gz: aad220bc34950f2d5c53d9e7af37b6d98d4b4e26168e33df781bdae46d6e95e2
|
|
5
5
|
SHA512:
|
|
6
|
-
metadata.gz:
|
|
7
|
-
data.tar.gz:
|
|
6
|
+
metadata.gz: 803ebc0900b8ce4ea49f94d0ef3f058075494894576c06975354d22024deba6485d4d3ff516711471af1231c28336085c80d88cb267fa0a77a20f6e41fcdaeaf
|
|
7
|
+
data.tar.gz: 351edeedeb2ead0adf9c2b653d1c80f60b54367c11a06334df2f64f352d3edf86397b62a4a8c119b6b6f8c79f049efa7d8719c75ac72d52678badbf2faa5c2c2
|
data/Gemfile.lock
CHANGED
|
@@ -12605,23 +12605,44 @@ tag.tagify__tag {
|
|
|
12605
12605
|
border-block-end: 2px solid var(--sidebar-link-active-background);
|
|
12606
12606
|
}
|
|
12607
12607
|
.sidebar-profile {
|
|
12608
|
-
|
|
12609
|
-
|
|
12610
|
-
|
|
12611
|
-
padding-inline: calc(var(--spacing) * 4);
|
|
12612
|
-
padding-block: calc(var(--spacing) * 2);
|
|
12613
|
-
&:where(:dir(rtl), [dir="rtl"], [dir="rtl"] *) {
|
|
12614
|
-
flex-direction: row-reverse;
|
|
12615
|
-
}
|
|
12608
|
+
position: relative;
|
|
12609
|
+
padding-inline: calc(var(--spacing) * 2);
|
|
12610
|
+
padding-block: var(--spacing);
|
|
12616
12611
|
color: var(--sidebar-content);
|
|
12617
12612
|
}
|
|
12618
|
-
.sidebar-
|
|
12613
|
+
.sidebar-profile .popover-menu {
|
|
12614
|
+
display: flex;
|
|
12615
|
+
width: 100%;
|
|
12616
|
+
}
|
|
12617
|
+
.sidebar-profile__trigger {
|
|
12619
12618
|
display: flex;
|
|
12620
12619
|
width: 100%;
|
|
12621
12620
|
min-width: 0px;
|
|
12622
|
-
|
|
12621
|
+
cursor: pointer;
|
|
12623
12622
|
align-items: center;
|
|
12624
12623
|
gap: calc(var(--spacing) * 2);
|
|
12624
|
+
border-radius: var(--radius-lg);
|
|
12625
|
+
padding-inline: calc(var(--spacing) * 2);
|
|
12626
|
+
padding-block: var(--spacing);
|
|
12627
|
+
text-align: start;
|
|
12628
|
+
}
|
|
12629
|
+
.sidebar-profile__trigger:hover, .sidebar-profile__trigger:has(+ :popover-open) {
|
|
12630
|
+
background-color: var(--sidebar-link-hover-background);
|
|
12631
|
+
}
|
|
12632
|
+
.sidebar-profile__trigger:focus-visible {
|
|
12633
|
+
background-color: var(--sidebar-focus-background);
|
|
12634
|
+
}
|
|
12635
|
+
.sidebar-profile__chevron {
|
|
12636
|
+
position: relative;
|
|
12637
|
+
display: inline-flex;
|
|
12638
|
+
width: calc(var(--spacing) * 4);
|
|
12639
|
+
height: calc(var(--spacing) * 4);
|
|
12640
|
+
flex-shrink: 0;
|
|
12641
|
+
}
|
|
12642
|
+
.sidebar-profile__chevron svg {
|
|
12643
|
+
width: calc(var(--spacing) * 4);
|
|
12644
|
+
height: calc(var(--spacing) * 4);
|
|
12645
|
+
opacity: 60%;
|
|
12625
12646
|
}
|
|
12626
12647
|
.sidebar-profile__avatar-wrapper {
|
|
12627
12648
|
display: flex;
|
|
@@ -12667,38 +12688,31 @@ tag.tagify__tag {
|
|
|
12667
12688
|
.sidebar-profile__info {
|
|
12668
12689
|
display: flex;
|
|
12669
12690
|
min-width: 0px;
|
|
12691
|
+
flex: 1;
|
|
12670
12692
|
flex-direction: column;
|
|
12671
|
-
&:where(:dir(rtl), [dir="rtl"], [dir="rtl"] *) {
|
|
12672
|
-
text-align: end;
|
|
12673
|
-
}
|
|
12674
12693
|
}
|
|
12675
12694
|
.sidebar-profile__title {
|
|
12676
12695
|
overflow: hidden;
|
|
12696
|
+
text-overflow: ellipsis;
|
|
12697
|
+
white-space: nowrap;
|
|
12677
12698
|
font-size: var(--text-sm);
|
|
12678
12699
|
line-height: var(--tw-leading, var(--text-sm--line-height));
|
|
12679
12700
|
--tw-leading: calc(var(--spacing) * 5);
|
|
12680
12701
|
line-height: calc(var(--spacing) * 5);
|
|
12681
12702
|
--tw-font-weight: var(--font-weight-medium);
|
|
12682
12703
|
font-weight: var(--font-weight-medium);
|
|
12683
|
-
text-overflow: ellipsis;
|
|
12684
12704
|
color: var(--sidebar-content);
|
|
12685
12705
|
}
|
|
12686
12706
|
.sidebar-profile__subtitle {
|
|
12687
12707
|
overflow: hidden;
|
|
12708
|
+
text-overflow: ellipsis;
|
|
12709
|
+
white-space: nowrap;
|
|
12688
12710
|
font-size: var(--text-xs);
|
|
12689
12711
|
line-height: var(--tw-leading, var(--text-xs--line-height));
|
|
12690
12712
|
--tw-leading: calc(var(--spacing) * 4);
|
|
12691
12713
|
line-height: calc(var(--spacing) * 4);
|
|
12692
|
-
text-overflow: ellipsis;
|
|
12693
12714
|
color: var(--sidebar-content-secondary);
|
|
12694
12715
|
}
|
|
12695
|
-
.sidebar-profile__actions {
|
|
12696
|
-
display: flex;
|
|
12697
|
-
flex-shrink: 0;
|
|
12698
|
-
align-items: center;
|
|
12699
|
-
justify-content: center;
|
|
12700
|
-
gap: var(--spacing);
|
|
12701
|
-
}
|
|
12702
12716
|
.sidebar-profile__form {
|
|
12703
12717
|
display: flex;
|
|
12704
12718
|
width: 100%;
|
|
@@ -12708,7 +12722,8 @@ tag.tagify__tag {
|
|
|
12708
12722
|
@media (width >= 40rem) {
|
|
12709
12723
|
max-width: var(--container-sm);
|
|
12710
12724
|
}
|
|
12711
|
-
position-area:
|
|
12725
|
+
position-area: block-start span-inline-end;
|
|
12726
|
+
min-width: anchor-size(width);
|
|
12712
12727
|
transform: translateY(0.25rem);
|
|
12713
12728
|
}
|
|
12714
12729
|
@starting-style {
|
|
@@ -12743,44 +12758,22 @@ tag.tagify__tag {
|
|
|
12743
12758
|
}
|
|
12744
12759
|
}
|
|
12745
12760
|
.sidebar-status {
|
|
12746
|
-
|
|
12747
|
-
|
|
12748
|
-
|
|
12749
|
-
|
|
12750
|
-
|
|
12751
|
-
justify-content: center;
|
|
12752
|
-
border-radius: calc(infinity * 1px);
|
|
12753
|
-
}
|
|
12754
|
-
.sidebar-status:focus-visible {
|
|
12755
|
-
outline: 2px solid var(--color-accent-content);
|
|
12756
|
-
}
|
|
12757
|
-
.sidebar-status__indicator {
|
|
12758
|
-
width: calc(var(--spacing) * 2.5);
|
|
12759
|
-
height: calc(var(--spacing) * 2.5);
|
|
12761
|
+
position: absolute;
|
|
12762
|
+
inset-inline-end: calc(var(--spacing) * -0.5);
|
|
12763
|
+
top: calc(var(--spacing) * 0.5);
|
|
12764
|
+
width: calc(var(--spacing) * 1.5);
|
|
12765
|
+
height: calc(var(--spacing) * 1.5);
|
|
12760
12766
|
border-radius: calc(infinity * 1px);
|
|
12761
12767
|
}
|
|
12762
|
-
.sidebar-
|
|
12768
|
+
.sidebar-status--ok {
|
|
12763
12769
|
background-color: var(--color-green-400);
|
|
12764
12770
|
}
|
|
12765
|
-
.sidebar-
|
|
12771
|
+
.sidebar-status--error {
|
|
12766
12772
|
background-color: var(--color-orange-400);
|
|
12767
12773
|
}
|
|
12768
|
-
.sidebar-
|
|
12774
|
+
.sidebar-status--warning {
|
|
12769
12775
|
background-color: var(--color-amber-400);
|
|
12770
12776
|
}
|
|
12771
|
-
.sidebar-status__hint {
|
|
12772
|
-
position: absolute;
|
|
12773
|
-
margin-inline-start: calc(var(--spacing) * -4);
|
|
12774
|
-
display: none;
|
|
12775
|
-
width: 100%;
|
|
12776
|
-
text-align: center;
|
|
12777
|
-
font-size: var(--text-xs);
|
|
12778
|
-
line-height: var(--tw-leading, var(--text-xs--line-height));
|
|
12779
|
-
color: var(--sidebar-content-secondary);
|
|
12780
|
-
}
|
|
12781
|
-
.sidebar-status:hover .sidebar-status__hint {
|
|
12782
|
-
display: block;
|
|
12783
|
-
}
|
|
12784
12777
|
.sidebar-flyout {
|
|
12785
12778
|
width: 100%;
|
|
12786
12779
|
}
|
|
@@ -381,13 +381,36 @@
|
|
|
381
381
|
/* BEM: .sidebar-profile (block) */
|
|
382
382
|
/* ================================================ */
|
|
383
383
|
|
|
384
|
+
/* px-2 + the trigger's px-2 keep the row's old inset while the trigger's hover background fills it. */
|
|
384
385
|
.sidebar-profile {
|
|
385
|
-
@apply
|
|
386
|
+
@apply relative px-2 py-1;
|
|
386
387
|
color: var(--sidebar-content);
|
|
387
388
|
}
|
|
388
389
|
|
|
389
|
-
.sidebar-
|
|
390
|
-
@apply flex
|
|
390
|
+
.sidebar-profile .popover-menu {
|
|
391
|
+
@apply flex w-full;
|
|
392
|
+
}
|
|
393
|
+
|
|
394
|
+
.sidebar-profile__trigger {
|
|
395
|
+
@apply flex items-center gap-2 w-full min-w-0 px-2 py-1 rounded-lg text-start cursor-pointer;
|
|
396
|
+
}
|
|
397
|
+
|
|
398
|
+
.sidebar-profile__trigger:hover,
|
|
399
|
+
.sidebar-profile__trigger:has(+ :popover-open) {
|
|
400
|
+
background-color: var(--sidebar-link-hover-background);
|
|
401
|
+
}
|
|
402
|
+
|
|
403
|
+
.sidebar-profile__trigger:focus-visible {
|
|
404
|
+
background-color: var(--sidebar-focus-background);
|
|
405
|
+
}
|
|
406
|
+
|
|
407
|
+
.sidebar-profile__chevron {
|
|
408
|
+
@apply relative inline-flex shrink-0 size-4;
|
|
409
|
+
}
|
|
410
|
+
|
|
411
|
+
/* Dims the icon only, so the status badge keeps its full color. */
|
|
412
|
+
.sidebar-profile__chevron svg {
|
|
413
|
+
@apply size-4 opacity-60;
|
|
391
414
|
}
|
|
392
415
|
|
|
393
416
|
.sidebar-profile__avatar-wrapper {
|
|
@@ -410,30 +433,28 @@
|
|
|
410
433
|
}
|
|
411
434
|
|
|
412
435
|
.sidebar-profile__info {
|
|
413
|
-
@apply flex flex-col min-w-0
|
|
436
|
+
@apply flex flex-col flex-1 min-w-0;
|
|
414
437
|
}
|
|
415
438
|
|
|
416
439
|
.sidebar-profile__title {
|
|
417
|
-
@apply font-medium
|
|
440
|
+
@apply font-medium truncate text-sm leading-5;
|
|
418
441
|
color: var(--sidebar-content);
|
|
419
442
|
}
|
|
420
443
|
|
|
421
444
|
.sidebar-profile__subtitle {
|
|
422
|
-
@apply text-xs
|
|
445
|
+
@apply text-xs truncate leading-4;
|
|
423
446
|
color: var(--sidebar-content-secondary);
|
|
424
447
|
}
|
|
425
448
|
|
|
426
|
-
.sidebar-profile__actions {
|
|
427
|
-
@apply flex items-center justify-center gap-1 shrink-0;
|
|
428
|
-
}
|
|
429
|
-
|
|
430
449
|
.sidebar-profile__form {
|
|
431
450
|
@apply flex w-full;
|
|
432
451
|
}
|
|
433
452
|
|
|
434
453
|
.sidebar-profile__dropdown {
|
|
435
454
|
@apply sm:max-w-sm mb-0.5;
|
|
436
|
-
|
|
455
|
+
/* Starts at the row's start edge and is at least as wide as the row (the trigger is the anchor). */
|
|
456
|
+
position-area: block-start span-inline-end;
|
|
457
|
+
min-width: anchor-size(width);
|
|
437
458
|
|
|
438
459
|
/* The profile menu opens upward, so it should rise from below and drop back
|
|
439
460
|
down — the inverse of the shared `.popover-menu__panel` slide, which starts
|
|
@@ -484,40 +505,23 @@
|
|
|
484
505
|
/* BEM: .sidebar-status (block) */
|
|
485
506
|
/* ================================================ */
|
|
486
507
|
|
|
487
|
-
/*
|
|
508
|
+
/* Hangs past the chevron's end edge, beside the upper arrow rather than on it, so the icon stays whole. */
|
|
488
509
|
.sidebar-status {
|
|
489
|
-
@apply
|
|
490
|
-
}
|
|
491
|
-
|
|
492
|
-
.sidebar-status:focus-visible {
|
|
493
|
-
outline: 2px solid var(--color-accent-content);
|
|
494
|
-
}
|
|
495
|
-
|
|
496
|
-
.sidebar-status__indicator {
|
|
497
|
-
@apply rounded-full size-2.5;
|
|
510
|
+
@apply absolute top-0.5 -end-0.5 size-1.5 rounded-full;
|
|
498
511
|
}
|
|
499
512
|
|
|
500
|
-
.sidebar-
|
|
513
|
+
.sidebar-status--ok {
|
|
501
514
|
@apply bg-green-400;
|
|
502
515
|
}
|
|
503
516
|
|
|
504
|
-
.sidebar-
|
|
517
|
+
.sidebar-status--error {
|
|
505
518
|
@apply bg-orange-400;
|
|
506
519
|
}
|
|
507
520
|
|
|
508
|
-
.sidebar-
|
|
521
|
+
.sidebar-status--warning {
|
|
509
522
|
@apply bg-amber-400;
|
|
510
523
|
}
|
|
511
524
|
|
|
512
|
-
.sidebar-status__hint {
|
|
513
|
-
@apply absolute text-xs hidden text-center w-full -ms-4;
|
|
514
|
-
color: var(--sidebar-content-secondary);
|
|
515
|
-
}
|
|
516
|
-
|
|
517
|
-
.sidebar-status:hover .sidebar-status__hint {
|
|
518
|
-
@apply block;
|
|
519
|
-
}
|
|
520
|
-
|
|
521
525
|
/* ================================================ */
|
|
522
526
|
/* Sidebar Flyout — ItemSwitcherComponent */
|
|
523
527
|
/* BEM: .sidebar-flyout (block) */
|
|
@@ -1,33 +1,37 @@
|
|
|
1
1
|
<%= render ui.panel(title: "Avo Status", description: "Use this page to debug your Avo instance.") do |panel| %>
|
|
2
2
|
<% panel.with_body do %>
|
|
3
3
|
<div class="status-page">
|
|
4
|
-
|
|
5
|
-
|
|
6
|
-
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
|
|
4
|
+
<% if license_card? %>
|
|
5
|
+
<%= license_card %>
|
|
6
|
+
<% else %>
|
|
7
|
+
<%= render ui.card(title: "License", padded: true) do |card| %>
|
|
8
|
+
<% card.with_body do %>
|
|
9
|
+
<div class="status-page__license">
|
|
10
|
+
<%= render ui.badge(label: "Community", color: :success, icon: "tabler/outline/rosette-discount-check") %>
|
|
11
|
+
<dl class="status-page__details">
|
|
12
|
+
<% information_items.each do |key, value| %>
|
|
13
|
+
<div class="status-page__detail">
|
|
14
|
+
<dt class="status-page__detail-label"><%= key.humanize %></dt>
|
|
15
|
+
<dd class="status-page__detail-value"><%= value.presence || tag.span("Not set", class: "status-page__detail-empty") %></dd>
|
|
16
|
+
</div>
|
|
17
|
+
<% end %>
|
|
18
|
+
</dl>
|
|
19
|
+
</div>
|
|
20
|
+
<% end %>
|
|
21
|
+
<% card.with_footer do %>
|
|
22
|
+
<div class="status-page__upgrade">
|
|
23
|
+
<p class="status-page__upgrade-text">
|
|
24
|
+
Need more? Pick your license, then open its <strong>Upgrade</strong> section.
|
|
25
|
+
</p>
|
|
26
|
+
<%= a_link "https://avohq.io/licenses", style: :primary, color: :blue, size: :sm, target: "_blank", icon: "tabler/outline/external-link" do %>
|
|
27
|
+
View licenses
|
|
14
28
|
<% end %>
|
|
15
|
-
</
|
|
16
|
-
|
|
17
|
-
<% end %>
|
|
18
|
-
<% card.with_footer do %>
|
|
19
|
-
<div class="status-page__upgrade">
|
|
20
|
-
<p class="status-page__upgrade-text">
|
|
21
|
-
Need more? Pick your license, then open its <strong>Upgrade</strong> section.
|
|
22
|
-
</p>
|
|
23
|
-
<%= a_link "https://avohq.io/licenses", style: :primary, color: :blue, size: :sm, target: "_blank", icon: "tabler/outline/external-link" do %>
|
|
24
|
-
View licenses
|
|
25
|
-
<% end %>
|
|
26
|
-
</div>
|
|
29
|
+
</div>
|
|
30
|
+
<% end %>
|
|
27
31
|
<% end %>
|
|
28
32
|
<% end %>
|
|
29
33
|
|
|
30
|
-
<%= render Avo::Debug::PluginsComponent.new %>
|
|
34
|
+
<%= render Avo::Debug::PluginsComponent.new(row_extra: @plugin_row_extra) %>
|
|
31
35
|
|
|
32
36
|
<% if Avo::IN_DEVELOPMENT %>
|
|
33
37
|
<%= render ui.card(title: "Telemetry", description: "The payload sent to HQ. Shown only when AVO_IN_DEVELOPMENT=1.", class: "status-page__wide") do |card| %>
|
|
@@ -3,6 +3,10 @@
|
|
|
3
3
|
class Avo::Debug::StatusComponent < Avo::BaseComponent
|
|
4
4
|
include Avo::ApplicationHelper
|
|
5
5
|
|
|
6
|
+
# A host page that knows more about the license fills these, so it reuses this layout instead of drawing its own.
|
|
7
|
+
renders_one :license_card
|
|
8
|
+
prop :plugin_row_extra
|
|
9
|
+
|
|
6
10
|
def information_items
|
|
7
11
|
@information_items ||= {
|
|
8
12
|
license_key: Avo.configuration.license_key,
|
|
@@ -1,66 +1,54 @@
|
|
|
1
1
|
<div class="sidebar-profile">
|
|
2
|
-
|
|
3
|
-
|
|
4
|
-
|
|
5
|
-
|
|
6
|
-
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
|
|
2
|
+
<%= render Avo::UI::DropdownComponent.new(popover_mode: true, classes: "sidebar-profile__dropdown") do |component| %>
|
|
3
|
+
<% component.with_trigger do %>
|
|
4
|
+
<%# The whole row opens the menu, so the menu anchors to the row and takes its width. %>
|
|
5
|
+
<button type="button" class="sidebar-profile__trigger" popovertarget="<%= component.popover_id %>">
|
|
6
|
+
<span class="sidebar-profile__avatar-wrapper">
|
|
7
|
+
<span class="sidebar-profile__avatar">
|
|
8
|
+
<% if avatar.present? %>
|
|
9
|
+
<%= image_tag helpers.main_app.url_for(avatar), class: "sidebar-profile__avatar-img", alt: "" %>
|
|
10
|
+
<% else %>
|
|
11
|
+
<span class="sidebar-profile__avatar-initials"><%= initials %></span>
|
|
12
|
+
<% end %>
|
|
10
13
|
</span>
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
<%= link_to helpers.avo.status_path,
|
|
27
|
-
class: "sidebar-status",
|
|
28
|
-
title: "Avo Status",
|
|
29
|
-
aria: {label: "Avo Status: #{Avo.app_status}"},
|
|
30
|
-
data: {tippy: "tooltip"} do %>
|
|
31
|
-
<span class="sidebar-status__indicator sidebar-status__indicator--<%= Avo.app_status %>"></span>
|
|
14
|
+
</span>
|
|
15
|
+
<span class="sidebar-profile__info">
|
|
16
|
+
<span class="sidebar-profile__title"><%= name %></span>
|
|
17
|
+
<% if title.present? %>
|
|
18
|
+
<span class="sidebar-profile__subtitle"><%= title %></span>
|
|
19
|
+
<% end %>
|
|
20
|
+
</span>
|
|
21
|
+
<span class="sidebar-profile__chevron">
|
|
22
|
+
<%= helpers.svg "tabler/outline/selector" %>
|
|
23
|
+
<% if @show_status %>
|
|
24
|
+
<span class="sidebar-status sidebar-status--<%= Avo.app_status %>"></span>
|
|
25
|
+
<span class="sr-only">Avo Status: <%= Avo.app_status %></span>
|
|
26
|
+
<% end %>
|
|
27
|
+
</span>
|
|
28
|
+
</button>
|
|
32
29
|
<% end %>
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
<% component.with_trigger do %>
|
|
37
|
-
<%= render Avo::ButtonComponent.new(
|
|
38
|
-
icon: "tabler/outline/dots",
|
|
39
|
-
size: :md,
|
|
40
|
-
style: :text,
|
|
41
|
-
popovertarget: component.popover_id
|
|
42
|
-
) %>
|
|
30
|
+
<% component.with_items do %>
|
|
31
|
+
<% if render_custom_profile_menu? %>
|
|
32
|
+
<%= render custom_profile_component %>
|
|
43
33
|
<% end %>
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
|
|
51
|
-
|
|
52
|
-
|
|
53
|
-
|
|
54
|
-
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
|
|
58
|
-
<%=
|
|
59
|
-
<%= helpers.svg "tabler/outline/logout", class: 'sidebar-icon' %> <span class="truncate min-w-0"><%= t('avo.sign_out') %></span>
|
|
60
|
-
<% end %>
|
|
34
|
+
<%= render "avo/partials/profile_menu_extra" %>
|
|
35
|
+
<% if @show_status %>
|
|
36
|
+
<%= render Avo::ProfileItemComponent.new label: "Avo Status", path: helpers.avo.status_path, icon: "tabler/outline/activity-heartbeat" %>
|
|
37
|
+
<% end %>
|
|
38
|
+
<% if can_sign_out_user? %>
|
|
39
|
+
<%= form_with url: helpers.main_app.send(sign_out_path),
|
|
40
|
+
method: sign_out_method,
|
|
41
|
+
data: {
|
|
42
|
+
controller: :"sign-out",
|
|
43
|
+
sign_out_confirm_value: t("avo.are_you_sure"),
|
|
44
|
+
action: "submit->sign-out#handle"
|
|
45
|
+
},
|
|
46
|
+
class: "sidebar-profile__form" do |form| %>
|
|
47
|
+
<%= form.button turbo_confirm: t("avo.are_you_sure"), class: "sidebar-profile__sign-out" do %>
|
|
48
|
+
<%= helpers.svg "tabler/outline/logout", class: "sidebar-icon" %> <span class="truncate min-w-0"><%= t("avo.sign_out") %></span>
|
|
61
49
|
<% end %>
|
|
62
50
|
<% end %>
|
|
63
51
|
<% end %>
|
|
64
52
|
<% end %>
|
|
65
|
-
|
|
53
|
+
<% end %>
|
|
66
54
|
</div>
|
|
@@ -171,7 +171,7 @@ def handle(query:, fields:, **args)
|
|
|
171
171
|
end
|
|
172
172
|
```
|
|
173
173
|
|
|
174
|
-
**Picking an associated record.** A `belongs_to` field
|
|
174
|
+
**Picking an associated record.** A `belongs_to` field renders in the action modal wherever the action starts: **Show**, one or several rows on **Index**, or a standalone action with no record. On a single record it opens with that record's association preselected. Before `avo` 4.2.9 it rendered only with exactly one record, so older apps guard it with `visible: -> { resource.record.present? }` (drop the guard on 4.2.9+). For a value that isn't an association, use a plain input:
|
|
175
175
|
|
|
176
176
|
```ruby
|
|
177
177
|
# Short list — a select with the options loaded when the form renders.
|
|
@@ -270,7 +270,8 @@ When an index spans multiple pages, checking "Select all" offers to select **eve
|
|
|
270
270
|
URI.parse(request.referer).query.to_s.include?("hey=ya") ? :yes : :no
|
|
271
271
|
}
|
|
272
272
|
```
|
|
273
|
-
-
|
|
273
|
+
- **A `belongs_to` field arrives in `handle` under its foreign key.** `field :user, as: :belongs_to` is `fields[:user_id]`; a polymorphic one arrives as `fields[:reviewable_type]` and `fields[:reviewable_id]` (4.2.7+). Both are the submitted strings, and an action does not check the type against the field's `types`, so validate it before constantizing. On `avo` older than 4.2.9 the field doesn't render in a bulk or standalone action: use `as: :select` or `as: :tags, mode: :select, fetch_values_from: "..."` and assign the ID yourself.
|
|
274
|
+
- **Actions also run from association panels (4.3.3+).** A `has_many` or `has_and_belongs_to_many` panel offers the actions declared on the *associated* resource, on the rows checked in the panel. `record` is `nil` while the dropdown renders (as on Index), so `name` and `arguments` blocks must handle that; the panel's parent record reaches `visible` as `parent_resource.record` (`parent_resource` is `nil` outside a panel).
|
|
274
275
|
- **`reload_records` is Index-only.** It doesn't work on association tables — use `reload` there.
|
|
275
276
|
- **Notification bodies truncate at ~320 characters.** Keep `succeed`/`error` messages short; put long output in a `download` or a redirect.
|
|
276
277
|
- **File downloads need `self.turbo = false`.** Otherwise Turbo intercepts the response and the download won't fire.
|
|
@@ -106,7 +106,7 @@ If the user mentions the Rails 8 scaffold (or you see `Current.user` + an `Authe
|
|
|
106
106
|
|
|
107
107
|
Avo ships two deliberately minimal roles, resolved by calling a method on the `current_user`:
|
|
108
108
|
|
|
109
|
-
- `is_admin?` → the user can reach the private **Avo Status** page (`/status`, under your mount path) and sees its sidebar
|
|
109
|
+
- `is_admin?` → the user can reach the private **Avo Status** page (`/status`, under your mount path) and sees its item in the sidebar profile menu in production.
|
|
110
110
|
- `is_developer?` → same Status-page access, **plus** full backtraces on non-validation errors (e.g. an API call that blows up during save) instead of a generic "Something went wrong".
|
|
111
111
|
|
|
112
112
|
Check them yourself anywhere with `Avo::Current.user_is_admin?` / `Avo::Current.user_is_developer?`. Point Avo at differently-named predicate methods via the initializer:
|
|
@@ -141,7 +141,7 @@ end
|
|
|
141
141
|
|
|
142
142
|
### 6. The sign-out link
|
|
143
143
|
|
|
144
|
-
The sign-out item lives in the
|
|
144
|
+
The sign-out item lives in the profile menu, opened by clicking the user's row in the sidebar footer. Avo shows it automatically if your app responds to `destroy_user_session_path` (the Devise default). Otherwise it's hidden until you name the path. Two knobs:
|
|
145
145
|
|
|
146
146
|
```ruby
|
|
147
147
|
# config/initializers/avo.rb
|
|
@@ -482,7 +482,7 @@ end
|
|
|
482
482
|
`Avo.plugin_manager` API:
|
|
483
483
|
|
|
484
484
|
- `register(name, priority: 10)` — add to the plugin list (lower priority runs earlier).
|
|
485
|
-
- `register_view_type(name, component:, icon:, active_icon:)` — a new index view type. **Pass `component:` as a string** (`"MyPlugin::ViewTypes::TimelineViewTypeComponent"`) to dodge boot load-order issues; the component inherits `Avo::ViewTypes::BaseViewTypeComponent` and must render `paginator_component
|
|
485
|
+
- `register_view_type(name, component:, icon:, active_icon:)` — a new index view type. **Pass `component:` as a string** (`"MyPlugin::ViewTypes::TimelineViewTypeComponent"`) to dodge boot load-order issues; the component inherits `Avo::ViewTypes::BaseViewTypeComponent` and must render `paginator_component` and keep its list inside `<turbo-frame id="<%= list_frame_id %>">`. Name the list's frame with `list_frame_id` (not the `turbo_frame` prop, which is the surrounding frame passed on to the paginator) and the selection data attributes (`data-resource-name`, `data-selected-resources-name`) with `resource_name_for(@resource)`, never `@resource.model_key` (4.3.4+): inside an association panel both use the association field's id, so two panels on one page don't collide. It only gets `collection`, `records` and `pagination` slots where its template calls `render_index_slot`, passing the default markup as the block for replacements. Enabling it on a resource is **avo-index-views** (`self.view_types` / `self.default_view_type`).
|
|
486
486
|
- `register_field(method_name, klass)` — ship a field *type* from a gem (the plugin-author side of **avo-custom-fields**).
|
|
487
487
|
- `register_menu_item(name, &block)` — a custom menu DSL method for `config.main_menu`. Delegates to `avo-menu`; **no-op when avo-menu isn't installed**, so register unconditionally.
|
|
488
488
|
- `register_configuration(name, klass)` — add a `config.<name>` namespace to `Avo::Configuration` backed by an instance of `klass`, so host apps configure the plugin from the same `config/initializers/avo.rb` they already use. **The one call that must not go in `avo_boot`** — see below.
|
|
@@ -520,6 +520,7 @@ Assets from library code go through `Avo.asset_manager` (not the app pipeline);
|
|
|
520
520
|
- **Custom tool vs. resource tool vs. new field.** Standalone page → custom tool. Widget on a record's Show/Edit → resource tool. A new *input type* used across resources → **avo-custom-fields** (not this).
|
|
521
521
|
- **Ejected files are frozen copies — you own them forever.** They stop receiving upstream updates; Avo bug/security fixes won't reach your copy. Prefer [view slots](#view-slots), CSS-variable / Tailwind-layer overrides and `--scope` (so you don't replace a component everywhere) before ejecting whole components.
|
|
522
522
|
- **A slot replacement that skips its default skips the nested hooks too.** Replacing `:header` without `default_content.call` also drops the title and controls and their hooks. Replacing `:collection` the same way drops `records` and `pagination`.
|
|
523
|
+
- **Live search refreshes `collection`, `records` and `pagination` slots, not `toolbar` ones.** Put a summary that must follow the search and page in a collection or records slot. On an empty index core renders the shared empty state with `collection` and `records` hooks only, no `pagination`. Map view's collection hooks wrap only its optional embedded table.
|
|
523
524
|
- **Index slots of a resource also fire on its has-many panels** on a parent's page. Return `nil` when `parent_record` is present if the content only belongs on the main index.
|
|
524
525
|
- **`controls` hooks run twice when `buttons_on_form_footers` is on**, once in the header and once in the footer, so a fixed HTML id can be duplicated.
|
|
525
526
|
- **The toolbar doesn't refresh on live search.** Put a summary that follows the search in a `collection`, `records` or `pagination` hook.
|
|
@@ -536,6 +537,7 @@ Assets from library code go through `Avo.asset_manager` (not the app pipeline);
|
|
|
536
537
|
- **`avo-overrides.css` is served as-is — NOT compiled by Tailwind.** `@apply` and utility classes won't be generated there; it's for raw CSS and CSS-variable overrides. Put Tailwind-using CSS under `app/assets/stylesheets/avo/`.
|
|
537
538
|
- **Tailwind integration silently stays off** unless `tailwindcss-ruby` is present, and — if you pull Tailwind via `tailwindcss-rails` — that gem is **>= 4.0** (on 3.x the integration is disabled even though `tailwindcss-ruby` is there). Symptom: your utility classes don't exist in the admin.
|
|
538
539
|
- **New JS/CSS not loading?** You skipped the asset-pipeline entrypoint. Run `avo:js:install` (or wire `avo.custom.js` manually) — `self.stimulus_controllers` alone loads nothing.
|
|
540
|
+
- **`avo_boot` must not load app classes.** It runs while the app initializes, and naming a controller, component or model there loads Action Controller, Action View or Active Record early (Rails 8.2 flags it). Extend Avo's `lib/` classes (resources, fields, managers) in the hook; extend controllers, components and helpers from `Rails.autoloaders.main.on_load("Avo::BaseController") { |klass, _| klass.prepend ... }`; extend models from `ActiveSupport.on_load(:active_record)`. It also re-runs on each code reload in development.
|
|
539
541
|
- **Plugin registration must be inside `ActiveSupport.on_load(:avo_boot)`** — with one exception: `register_configuration` runs **too late** there and must go in an engine initializer ordered `before: :load_config_initializers`. `register_view_type`'s `component:` should be a **string**, and `register_menu_item` is a no-op without `avo-menu`.
|
|
540
542
|
|
|
541
543
|
## Report
|
|
@@ -233,7 +233,7 @@ Make it the default with `self.default_view_type = :map`.
|
|
|
233
233
|
|
|
234
234
|
Not a view type — a table affordance. Checking the header "Select all" checkbox and confirming "select all matching" lets an action run on **every record the current query matches**, across all pages, not just the visible page. Avo serializes (and encrypts) the whole query — filters, sorting, scopes — and reconstructs it inside the action.
|
|
235
235
|
|
|
236
|
-
It works out of the box on the table view; nothing to enable on the resource. The action itself is where the selection is consumed — cross-link the **avo-actions** skill for writing/handling the action. If serialization fails, Avo silently disables select-all rather than crashing (see the `normalizes` gotcha below).
|
|
236
|
+
It works out of the box on the table view and, from `avo` 4.3.10, on the grid view (a bar above the cards with the page checkbox, "Select all matching" and Undo); nothing to enable on the resource. A resource that sets `self.record_selector` to hide checkboxes renders no bar. The action itself is where the selection is consumed — cross-link the **avo-actions** skill for writing/handling the action. If serialization fails, Avo silently disables select-all rather than crashing (see the `normalizes` gotcha below).
|
|
237
237
|
|
|
238
238
|
**Coming back to the index (4.3.1+):** going Back (browser Back or the record page's **Go back** link) re-checks the rows that were selected and restores scroll. The selection is kept per browser tab and per URL (filters, sort, page), is forgotten after running an action or on reload, and a "Select all matching" choice is not kept. With `config.persistence = { driver: :session }` (4.3.11+) the selection is kept per page rather than per URL and comes back however you reach the index; turn it off with `selection: false`. System specs that expect nothing selected after **Go back** will now find rows checked.
|
|
239
239
|
|
|
@@ -254,7 +254,7 @@ class Avo::Resources::Project < Avo::BaseResource
|
|
|
254
254
|
end
|
|
255
255
|
```
|
|
256
256
|
|
|
257
|
-
`cards` means the resource's dashboard cards, not grid items. Blocks run once per region, not per row: use `row_options` to change rows.
|
|
257
|
+
`cards` means the resource's dashboard cards, not grid items. Collection, records and pagination slots refresh with live search; toolbar, cards and header ones don't. Blocks run once per region, not per row: use `row_options` to change rows.
|
|
258
258
|
|
|
259
259
|
The **avo-custom-ui** skill's **View slots** section has the full reference, Show/Edit/New, block context and gotchas.
|
|
260
260
|
|
|
@@ -221,7 +221,7 @@ A license authorizes **one app, one production URL** (`Rails.env.production?`).
|
|
|
221
221
|
|
|
222
222
|
Verify at the **status page**: `https://yourapp.com/<mount-path>/status` (e.g. `.../avo/status` or `.../admin/status`). It shows whether the license authenticated and what the checking server returned; the key is masked unless you set `config.exclude_from_status = []`. The viewing user must be an Avo admin. Deep failure diagnosis (unlicensed after deploy, timeouts, test-suite blocking the check host) is the **avo-troubleshoot** skill.
|
|
223
223
|
|
|
224
|
-
**Trials are full licenses.** Every add-on a trial covers behaves exactly as it does on a paid license while the trial runs — nothing is gated or degraded. The **Avo Status**
|
|
224
|
+
**Trials are full licenses.** Every add-on a trial covers behaves exactly as it does on a paid license while the trial runs — nothing is gated or degraded. The **Avo Status** badge on the profile menu button in the sidebar footer is green when all is well, **amber** when a trial needs attention, and orange when the license is invalid. Amber is not a failure: the status page names why, and the fix is on https://avohq.io/licenses. The **avo-troubleshoot** skill lists each case and its fix. Avo caches the license response between checks, so press **Refresh license** on the status page afterwards or the app keeps showing the older billing state. Trial state needs `avo-licensing` **4.0.10+**; the amber indicator needs Avo **4.0.20+** (an older Avo renders an uncolored dot rather than breaking).
|
|
225
225
|
|
|
226
226
|
### 7. (Optional) Append your own routes inside the engine
|
|
227
227
|
|
|
@@ -66,7 +66,7 @@ grep -n "avo" Gemfile
|
|
|
66
66
|
bin/rails avo:update # or: bundle exec rails avo:update
|
|
67
67
|
```
|
|
68
68
|
|
|
69
|
-
The task resolves Avo core plus every registered Avo plugin to its real gem name and runs `bundle update --conservative <those gems>` — `--conservative` so it doesn't drag unrelated shared dependencies along. Read its output: it echoes the exact `bundle update` command it ran.
|
|
69
|
+
The task resolves Avo core plus every registered Avo plugin to its real gem name and runs `bundle update --conservative <those gems>` — `--conservative` so it doesn't drag unrelated shared dependencies along. Read its output: it echoes the exact `bundle update` command it ran. From `avo` 4.3.10, `AVO_UPDATE_PUSH=1 bin/rails avo:update` also commits `Gemfile.lock` (message `Update Avo gems`) and pushes to the branch's upstream, for scheduled jobs and agents. It refuses to start outside a Git repo, with uncommitted changes to tracked files, or on a branch with no upstream; run it on a branch you're happy to push to, not the deploy branch.
|
|
70
70
|
|
|
71
71
|
If the task isn't available (older Avo, or the app won't boot), fall back to naming the gems yourself:
|
|
72
72
|
|
|
@@ -147,7 +147,7 @@ Check the project's own instructions for how — in this order: `AGENTS.md`, `CL
|
|
|
147
147
|
| Command | Does |
|
|
148
148
|
| --- | --- |
|
|
149
149
|
| `grep -E "^ {4}avo(-[a-z_]+)? \(" Gemfile.lock` | Current version of every Avo gem — run **before** updating |
|
|
150
|
-
| `bin/rails avo:update` | `bundle update --conservative` across Avo core + every registered plugin |
|
|
150
|
+
| `bin/rails avo:update` | `bundle update --conservative` across Avo core + every registered plugin (`AVO_UPDATE_PUSH=1` also commits and pushes the lockfile) |
|
|
151
151
|
| `git diff Gemfile.lock \| grep -E "^[-+] {4}avo"` | The actual before → after jump per gem |
|
|
152
152
|
| `bundle update --conservative avo …` | Manual fallback when the rake task isn't available |
|
|
153
153
|
| `bundle outdated \| grep avo` | What's available above the current Gemfile constraints |
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"repo": "avo-hq/docs.avohq.io",
|
|
3
3
|
"docs_path": "docs/4.0",
|
|
4
|
-
"commit": "
|
|
5
|
-
"date": "2026-11-
|
|
4
|
+
"commit": "c54913692157757c342802a3b9e1d5f167798624",
|
|
5
|
+
"date": "2026-11-09",
|
|
6
6
|
"note": "The docs commit these skills were last indexed from. Run ruby lib/avo/skills/bin/docs_drift.rb to see what changed since, and --update after a refresh."
|
|
7
7
|
}
|
data/lib/avo/version.rb
CHANGED