testimonials 0.7.7 → 0.7.9

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 5c9b9d504e0560e2e38bec8dfe4ec41c3db57b1abb6c4df66f8781502494bb44
-  data.tar.gz: de8db179e088abaa205551cadd2610a539a3444e42bebc7e2265499db45a23e3
+  metadata.gz: 746c0b7bc1421a8aadfbbbd7e9d41cb4aabc81ff0c6afa60669e4d9c06e963b0
+  data.tar.gz: 3914ba53cef25fcb6f541e6b4176e1d6135205cb37cdcc05b289125d456f1bbb
 SHA512:
-  metadata.gz: cae8ec4cf6bcc3681b281ceea1fe29fd132f631a2473bceecc7ae4f0f1141bfb931612730cc509f10299bcecef0fd91f9eafe719f805b42e9a084304986a28d2
-  data.tar.gz: 3503ec49afd1137817eb4fd1d2b6b184cfee69de4e936a2e05807606230b4c615180dd8b903de21d146c6a229dd2d8d71a8aef1c1792266ad75baeaf877be545
+  metadata.gz: 55f8694212e3f1395481121efd0f67c8474e9422173ba63e9b05cf66f40320b340301a1be39537cfbeb8ce17292b289d4f73247b2a05742e52f79b1bad6d47ae
+  data.tar.gz: 1a57a1aa934adc3d3b92199d922effc5ec36d66dc9138f819b1b153f754431c5e5bd7bea4f21e65fe51bb725d732e648acf7f389f8168ac277f174e220130b19

data/CHANGELOG.md

@@ -1,5 +1,33 @@
 # Changelog
 
+## 0.7.9
+
+- NPS is now optional at install time. `bin/rails generate testimonials:install
+  --skip-nps` leaves out the `testimonials_nps_responses` table and writes
+  `config.nps = false`, so an app that only wants testimonials carries neither
+  the table nor the NPS tab. `bin/rails generate testimonials:nps` adds the
+  table later, mirroring the `testimonials:tenant` upgrade path.
+- The guard is `config.nps`, not table introspection — nothing checks the
+  schema at runtime and nothing touches the database at boot. Consequently
+  `/testimonials/nps_responses` now 404s when `config.nps` is false instead of
+  still serving history; flip the flag back to read old responses. The
+  dashboard nav already hid the tab, so only a typed URL reached it.
+- `testimonials:seed_demo` skips NPS rows when the flow is off, and the
+  `testimonials:tenant` migration skips the NPS table when it isn't there.
+
+## 0.7.8
+
+- The NPS dashboard now says what the score means. The card carries the band
+  the number falls into (needs work / good / great / excellent), a scale
+  showing where it sits between −100 and +100, and a note when fewer than 30
+  responses make the number too thin to read. A collapsed "How is this
+  calculated, and what is a good score?" panel spells out the formula, the four
+  bands, and the caveats — industry, trend, comments. Translated into all 26
+  locales.
+- The marker's position rides on a `data-nps-marker` attribute that
+  `dashboard.js` reads, so the page still ships no inline styles for a strict
+  `style-src` to refuse.
+
 ## 0.7.7
 
 - Shrank the gem from 1.0 MB back to ~90 KB by dropping the bundled 1.1 MB demo

data/README.md

@@ -33,6 +33,15 @@ bin/rails db:migrate
 The generator writes the initializer, the migration, and mounts the engine at
 `/testimonials`. Nothing renders until the widget is opened.
 
+Don't want NPS? Install without it — no table, no dashboard tab, no prompt:
+
+```bash
+bin/rails generate testimonials:install --skip-nps
+```
+
+Changed your mind later: `bin/rails generate testimonials:nps`, migrate, and
+set `config.nps = true`.
+
 Optional demo data:
 
 ```bash
@@ -242,10 +251,29 @@ throttle would allow it. Detractors (0–6) trigger `on_detractor`, which pairs
 well with [ideasbugs](https://github.com/yshmarov/ideasbugs). Your score and
 every response live at `/testimonials/nps_responses`.
 
+| 1. One question, eleven taps | 2. The reason, optional |
+| --- | --- |
+| ![The NPS prompt: how likely are you to recommend us, scored 0 to 10](https://raw.githubusercontent.com/yshmarov/testimonials/main/docs/screenshots/nps-01-score.jpg) | ![The follow-up asking for the main reason behind the score](https://raw.githubusercontent.com/yshmarov/testimonials/main/docs/screenshots/nps-02-comment.png) |
+| Ten seconds of work, and "Not now" is always there. | The comment is where the actionable half lives. Promoters go straight on to the testimonial form. |
+
+The score is `% promoters − % detractors`, from −100 to +100, and the dashboard
+reads it against the usual benchmarks so nobody has to go and google them:
+below 0 needs work, 0–29 is good, 30–69 is great, 70 and up is world-class. A
+scale under the number shows where you sit, and under 30 responses the card
+says the sample is too thin to read much into.
+
+<img src="https://raw.githubusercontent.com/yshmarov/testimonials/main/docs/screenshots/nps-dashboard.jpg" alt="The NPS dashboard: a score of 41 badged Great, a scale marking where it sits between −100 and +100, promoter/passive/detractor counts, and the collapsed panel explaining the formula and the benchmarks" width="820">
+
 `/testimonials/nps/new` is the same question on its own page — the link for an
 email campaign, where there is no app session to prompt inside of. A promoter
 who scores 9–10 gets the testimonial form right there on the page.
 
+NPS is optional. `config.nps = false` — what `--skip-nps` writes at install —
+turns off the prompt, the public page, the `/api/stats` score and the dashboard
+tab, and `/testimonials/nps_responses` then 404s. Turning it off on an install
+that has the table hides existing responses along with everything else; flip it
+back to read them.
+
 ## The public pages
 
 Two standalone, self-styled pages for people outside the app — drop either link

data/app/controllers/testimonials/nps_responses_controller.rb

@@ -8,11 +8,15 @@ module Testimonials
     layout :testimonials_admin_layout
 
     before_action :require_admin
+    # An install run with --skip-nps has no table behind these pages, and the
+    # nav already hides the tab whenever config.nps is off.
+    before_action :require_nps
     before_action :set_response, only: :show
 
     def index
       scope = NpsResponse.for_tenant(current_tenant)
       @score = NpsResponse.score(scope)
+      @band = NpsResponse.band(@score)
       @total = scope.count
       @promoters = scope.where(score: 9..10).count
       @passives = scope.where(score: 7..8).count
@@ -30,6 +34,10 @@ module Testimonials
 
     private
 
+    def require_nps
+      head :not_found unless Testimonials.config.nps
+    end
+
     def set_response
       @response = NpsResponse.for_tenant(current_tenant).find(params[:id])
     end

data/app/models/testimonials/nps_response.rb

@@ -21,5 +21,22 @@ module Testimonials
       detractors = scope.where(score: 0..6).count
       ((promoters - detractors) * 100.0 / total).round
     end
+
+    # The industry-standard reading of an NPS number, so the dashboard can say
+    # whether a score is good without anyone having to go and google it.
+    def self.band(nps)
+      return nil if nps.nil?
+
+      case nps
+      when ...0 then :needs_work
+      when 0...30 then :good
+      when 30...70 then :great
+      else :excellent
+      end
+    end
+
+    # Below this many responses a single answer swings the score by several
+    # points, so the dashboard says so instead of implying the number is solid.
+    THIN_SAMPLE = 30
   end
 end

data/app/views/testimonials/nps_responses/index.html.erb

@@ -2,10 +2,10 @@
 
 <div class="page-head">
   <h1><%= t('testimonials.dashboard.nps', default: 'NPS') %></h1>
-  <%# The shareable NPS page, same idea as the testimonial one. This dashboard
-      still reads history when config.nps is off, but that page 404s — so the
-      link needs both switches. %>
-  <% if Testimonials.config.public_collection && Testimonials.config.nps %>
+  <%# The shareable NPS page, same idea as the testimonial one. config.nps is
+      already true here — the controller 404s otherwise — so only the public
+      switch is left to check. %>
+  <% if Testimonials.config.public_collection %>
     <a class="button share-link" href="<%= nps_collection_url %>" target="_blank" rel="noopener"
        title="<%= nps_collection_url %>">
       🔗 <%= t('testimonials.dashboard.nps_page', default: 'Ask for NPS scores') %>
@@ -13,10 +13,59 @@
   <% end %>
 </div>
 
+<%# How the industry reads a score, so nobody has to go and google it. Range
+    labels are digits on purpose — no translation needed for "< 0". %>
+<% bands = [
+     { key: 'needs-work', range: '< 0',
+       name: t('testimonials.dashboard.nps_band_needs_work', default: 'Needs work'),
+       note: t('testimonials.dashboard.nps_guide_needs_work', default: 'More detractors than promoters.') },
+     { key: 'good', range: '0 – 29',
+       name: t('testimonials.dashboard.nps_band_good', default: 'Good'),
+       note: t('testimonials.dashboard.nps_guide_good', default: 'Where most companies land.') },
+     { key: 'great', range: '30 – 69',
+       name: t('testimonials.dashboard.nps_band_great', default: 'Great'),
+       note: t('testimonials.dashboard.nps_guide_great', default: 'Strong loyalty.') },
+     { key: 'excellent', range: '70 +',
+       name: t('testimonials.dashboard.nps_band_excellent', default: 'Excellent'),
+       note: t('testimonials.dashboard.nps_guide_excellent', default: 'World-class, and rare.') }
+   ] %>
+<% current = bands.find { |b| b[:key] == @band.to_s.tr('_', '-') } if @band %>
+<% if current
+     band_class = "badge nps-band-#{current[:key]}"
+     meter_label = "#{@score} — #{current[:name]} #{current[:note]}"
+   end %>
+
 <div class="stat-row">
-  <div class="stat">
-    <b><%= @score.nil? ? '—' : @score %></b>
+  <div class="stat stat-nps">
+    <div class="stat-headline">
+      <b><%= @score.nil? ? '—' : @score %></b>
+      <% if current %>
+        <span class="<%= band_class %>"><%= current[:name] %></span>
+      <% end %>
+    </div>
     <span><%= t('testimonials.dashboard.nps_score', default: 'NPS score') %></span>
+    <%# Where this score sits on the −100..100 scale, so the number reads as
+        good or bad at a glance. Kept LTR: it is a number line, not prose. %>
+    <% if current %>
+      <div class="nps-meter" role="img" aria-label="<%= meter_label %>">
+        <div class="nps-meter-track">
+          <i class="nps-seg nps-band-needs-work"></i><i class="nps-seg nps-band-good"></i>
+          <i class="nps-seg nps-band-great"></i><i class="nps-seg nps-band-excellent"></i>
+          <%# Position is data, not markup: dashboard.js places it, so a strict
+              style-src has no inline style to refuse. %>
+          <i class="nps-marker" data-nps-marker="<%= @score %>"></i>
+        </div>
+        <div class="nps-meter-ticks" aria-hidden="true">
+          <span class="tick-min">−100</span><span class="tick-zero">0</span>
+          <span class="tick-good">30</span><span class="tick-great">70</span>
+          <span class="tick-max">100</span>
+        </div>
+      </div>
+    <% end %>
+    <% if @total.positive? && @total < Testimonials::NpsResponse::THIN_SAMPLE %>
+      <p class="muted nps-sample"><%= t('testimonials.dashboard.nps_sample_note', count: @total,
+                                        default: 'Based on %{count} responses — too few to read much into.') %></p>
+    <% end %>
   </div>
   <div class="stat">
     <b><%= @promoters %></b>
@@ -32,6 +81,32 @@
   </div>
 </div>
 
+<%# The formula and the benchmarks, closed by default — there when someone
+    wonders whether their number is any good, out of the way the rest of the time. %>
+<details class="nps-guide">
+  <summary><%= t('testimonials.dashboard.nps_guide', default: 'How is this calculated, and what is a good score?') %></summary>
+  <div class="nps-guide-body">
+    <p><%= t('testimonials.dashboard.nps_guide_formula',
+             default: 'NPS = the % of promoters minus the % of detractors. Passives count in the total but on ' \
+                      'neither side, so they pull the score toward zero. The result runs from −100 to +100 — ' \
+                      'a score, not a percentage.') %></p>
+    <ul class="nps-bands">
+      <% bands.each do |band| %>
+        <% badge_class = "badge nps-band-#{band[:key]}" %>
+        <li>
+          <span class="<%= badge_class %>"><%= band[:name] %></span>
+          <b><%= band[:range] %></b>
+          <span class="muted"><%= band[:note] %></span>
+        </li>
+      <% end %>
+    </ul>
+    <p class="muted"><%= t('testimonials.dashboard.nps_guide_caveat',
+                           default: 'Benchmarks move with the industry — software often sits near 40, airlines ' \
+                                    'and internet providers near 0. The trend over time tells you more than any ' \
+                                    'single number, and the comments tell you more than the score.') %></p>
+  </div>
+</details>
+
 <div class="dashboard-shell <%= 'has-selected' if @selected_response %>">
   <aside class="dashboard-sidebar" aria-label="<%= t('testimonials.dashboard.nps_responses', default: 'NPS responses') %>">
     <div class="record-list">

data/config/locales/testimonials.ar.yml

@@ -102,5 +102,17 @@ ar:
       promoters: "المروّجون (9–10)"
       passives: "المحايدون (7–8)"
       detractors: "المنتقدون (0–6)"
+      nps_band_needs_work: "يحتاج إلى تحسين"
+      nps_band_good: "جيد"
+      nps_band_great: "جيد جدًا"
+      nps_band_excellent: "ممتاز"
+      nps_sample_note: "بناءً على %{count} ردًا — عدد قليل جدًا لبناء استنتاج عليه."
+      nps_guide: "كيف يُحتسب، وما هي النتيجة الجيدة؟"
+      nps_guide_formula: "NPS = نسبة المروّجين ناقص نسبة المنتقدين. المحايدون يُحتسبون ضمن الإجمالي لكن لا يُضافون إلى أي من الطرفين، لذلك يسحبون النتيجة نحو الصفر. تتراوح النتيجة بين −100 و+100، وهي مؤشر وليست نسبة مئوية."
+      nps_guide_needs_work: "عدد المنتقدين أكبر من عدد المروّجين."
+      nps_guide_good: "النطاق الذي تقع فيه معظم الشركات."
+      nps_guide_great: "ولاء قوي."
+      nps_guide_excellent: "مستوى عالمي، ونادر."
+      nps_guide_caveat: "تختلف المعايير حسب القطاع — البرمجيات غالبًا قرب 40، وشركات الطيران ومزوّدو الإنترنت قرب 0. الاتجاه عبر الوقت يقول أكثر من رقم واحد، والتعليقات تقول أكثر من النتيجة."
       score: "الدرجة"
       comment: "التعليق"

data/config/locales/testimonials.bg.yml

@@ -102,5 +102,17 @@ bg:
       promoters: "Промоутъри (9–10)"
       passives: "Неутрални (7–8)"
       detractors: "Критици (0–6)"
+      nps_band_needs_work: "Нужно е подобрение"
+      nps_band_good: "Добро"
+      nps_band_great: "Много добро"
+      nps_band_excellent: "Отлично"
+      nps_sample_note: "Въз основа на %{count} отговора — твърде малко за изводи."
+      nps_guide: "Как се изчислява и кой резултат е добър?"
+      nps_guide_formula: "NPS = % промотори минус % критици. Неутралните влизат в общия брой, но в нито една от двете страни, затова дърпат резултата към нулата. Стойността е от −100 до +100 — това е индекс, а не процент."
+      nps_guide_needs_work: "Критиците са повече от промоторите."
+      nps_guide_good: "Там, където са повечето компании."
+      nps_guide_great: "Силна лоялност."
+      nps_guide_excellent: "Световно ниво, среща се рядко."
+      nps_guide_caveat: "Ориентирите зависят от бранша — при софтуера често са около 40, при авиокомпаниите и интернет доставчиците — близо до 0. Тенденцията във времето казва повече от едно число, а коментарите — повече от резултата."
       score: "Резултат"
       comment: "Коментар"

data/config/locales/testimonials.bn.yml

@@ -102,5 +102,17 @@ bn:
       promoters: "প্রোমোটার (৯–১০)"
       passives: "নিরপেক্ষ (৭–৮)"
       detractors: "সমালোচক (০–৬)"
+      nps_band_needs_work: "উন্নতি দরকার"
+      nps_band_good: "ভালো"
+      nps_band_great: "খুব ভালো"
+      nps_band_excellent: "চমৎকার"
+      nps_sample_note: "%{count}টি উত্তরের ভিত্তিতে — সিদ্ধান্তে আসার জন্য যথেষ্ট নয়।"
+      nps_guide: "এটি কীভাবে হিসাব হয়, আর কত হলে ভালো?"
+      nps_guide_formula: "NPS = প্রোমোটারের শতাংশ বিয়োগ ডিট্র্যাক্টরের শতাংশ। নিরপেক্ষরা মোট সংখ্যায় ধরা হয় কিন্তু কোনো পক্ষেই যায় না, তাই স্কোরকে শূন্যের দিকে টানে। ফল −১০০ থেকে +১০০ পর্যন্ত — এটি স্কোর, শতাংশ নয়।"
+      nps_guide_needs_work: "প্রোমোটারের চেয়ে ডিট্র্যাক্টর বেশি।"
+      nps_guide_good: "বেশির ভাগ কোম্পানি এখানেই থাকে।"
+      nps_guide_great: "শক্ত আনুগত্য।"
+      nps_guide_excellent: "বিশ্বমানের, বিরল।"
+      nps_guide_caveat: "মানদণ্ড শিল্প অনুযায়ী বদলায় — সফটওয়্যারে প্রায়ই ৪০-এর কাছাকাছি, বিমান সংস্থা ও ইন্টারনেট সরবরাহকারীদের ০-এর কাছাকাছি। একক সংখ্যার চেয়ে সময়ের ধারা বেশি বলে, আর স্কোরের চেয়ে মন্তব্য বেশি বলে।"
       score: "স্কোর"
       comment: "মন্তব্য"

data/config/locales/testimonials.de.yml

@@ -102,5 +102,17 @@ de:
       promoters: "Promotoren (9–10)"
       passives: "Passive (7–8)"
       detractors: "Detraktoren (0–6)"
+      nps_band_needs_work: "Verbesserungsbedarf"
+      nps_band_good: "Gut"
+      nps_band_great: "Sehr gut"
+      nps_band_excellent: "Hervorragend"
+      nps_sample_note: "Basiert auf %{count} Antworten — zu wenige für belastbare Schlüsse."
+      nps_guide: "Wie wird das berechnet, und was ist ein guter Wert?"
+      nps_guide_formula: "NPS = % der Promotoren minus % der Kritiker. Indifferente zählen zur Gesamtzahl, aber zu keiner Seite, und ziehen den Wert damit Richtung null. Das Ergebnis reicht von −100 bis +100 — ein Indexwert, kein Prozentsatz."
+      nps_guide_needs_work: "Mehr Kritiker als Promotoren."
+      nps_guide_good: "Der Bereich, in dem die meisten Unternehmen liegen."
+      nps_guide_great: "Starke Loyalität."
+      nps_guide_excellent: "Weltklasse und selten."
+      nps_guide_caveat: "Die Richtwerte hängen von der Branche ab — Software liegt oft bei rund 40, Fluggesellschaften und Internetanbieter nahe 0. Der Verlauf über die Zeit sagt mehr als eine einzelne Zahl, und die Kommentare sagen mehr als der Wert."
       score: "Wert"
       comment: "Kommentar"

data/config/locales/testimonials.el.yml

@@ -102,5 +102,17 @@ el:
       promoters: "Υποστηρικτές (9–10)"
       passives: "Ουδέτεροι (7–8)"
       detractors: "Επικριτές (0–6)"
+      nps_band_needs_work: "Χρειάζεται βελτίωση"
+      nps_band_good: "Καλό"
+      nps_band_great: "Πολύ καλό"
+      nps_band_excellent: "Εξαιρετικό"
+      nps_sample_note: "Με βάση %{count} απαντήσεις — πολύ λίγες για ασφαλή συμπεράσματα."
+      nps_guide: "Πώς υπολογίζεται και ποια βαθμολογία θεωρείται καλή;"
+      nps_guide_formula: "NPS = ποσοστό υποστηρικτών μείον ποσοστό επικριτών. Οι ουδέτεροι μετρούν στο σύνολο αλλά σε καμία από τις δύο πλευρές, οπότε τραβούν τη βαθμολογία προς το μηδέν. Το αποτέλεσμα κυμαίνεται από −100 έως +100 — είναι δείκτης, όχι ποσοστό."
+      nps_guide_needs_work: "Περισσότεροι επικριτές από υποστηρικτές."
+      nps_guide_good: "Εκεί βρίσκονται οι περισσότερες εταιρείες."
+      nps_guide_great: "Ισχυρή πιστότητα."
+      nps_guide_excellent: "Παγκόσμιου επιπέδου, και σπάνιο."
+      nps_guide_caveat: "Τα σημεία αναφοράς αλλάζουν ανά κλάδο — το λογισμικό συχνά κοντά στο 40, οι αεροπορικές και οι πάροχοι ίντερνετ κοντά στο 0. Η τάση στον χρόνο λέει περισσότερα από έναν αριθμό, και τα σχόλια περισσότερα από τη βαθμολογία."
       score: "Βαθμός"
       comment: "Σχόλιο"

data/config/locales/testimonials.en.yml

@@ -102,5 +102,17 @@ en:
       promoters: "Promoters (9–10)"
       passives: "Passives (7–8)"
       detractors: "Detractors (0–6)"
+      nps_band_needs_work: "Needs work"
+      nps_band_good: "Good"
+      nps_band_great: "Great"
+      nps_band_excellent: "Excellent"
+      nps_sample_note: "Based on %{count} responses — too few to read much into."
+      nps_guide: "How is this calculated, and what is a good score?"
+      nps_guide_formula: "NPS = the % of promoters minus the % of detractors. Passives count in the total but on neither side, so they pull the score toward zero. The result runs from −100 to +100 — a score, not a percentage."
+      nps_guide_needs_work: "More detractors than promoters."
+      nps_guide_good: "Where most companies land."
+      nps_guide_great: "Strong loyalty."
+      nps_guide_excellent: "World-class, and rare."
+      nps_guide_caveat: "Benchmarks move with the industry — software often sits near 40, airlines and internet providers near 0. The trend over time tells you more than any single number, and the comments tell you more than the score."
       score: "Score"
       comment: "Comment"

data/config/locales/testimonials.es.yml

@@ -102,5 +102,17 @@ es:
       promoters: "Promotores (9–10)"
       passives: "Pasivos (7–8)"
       detractors: "Detractores (0–6)"
+      nps_band_needs_work: "Necesita mejorar"
+      nps_band_good: "Bueno"
+      nps_band_great: "Muy bueno"
+      nps_band_excellent: "Excelente"
+      nps_sample_note: "Basado en %{count} respuestas: demasiado pocas para sacar conclusiones."
+      nps_guide: "¿Cómo se calcula y qué puntuación es buena?"
+      nps_guide_formula: "NPS = % de promotores menos % de detractores. Los pasivos cuentan en el total pero en ninguno de los dos lados, así que empujan la puntuación hacia cero. El resultado va de −100 a +100: es un índice, no un porcentaje."
+      nps_guide_needs_work: "Más detractores que promotores."
+      nps_guide_good: "Donde se sitúa la mayoría de las empresas."
+      nps_guide_great: "Lealtad sólida."
+      nps_guide_excellent: "De primer nivel, y poco común."
+      nps_guide_caveat: "Las referencias cambian según el sector: el software suele rondar 40, y las aerolíneas y los proveedores de internet, cerca de 0. La tendencia en el tiempo dice más que una sola cifra, y los comentarios dicen más que la puntuación."
       score: "Puntuación"
       comment: "Comentario"

data/config/locales/testimonials.fr.yml

@@ -102,5 +102,17 @@ fr:
       promoters: "Promoteurs (9–10)"
       passives: "Passifs (7–8)"
       detractors: "Détracteurs (0–6)"
+      nps_band_needs_work: "À améliorer"
+      nps_band_good: "Bon"
+      nps_band_great: "Très bon"
+      nps_band_excellent: "Excellent"
+      nps_sample_note: "Basé sur %{count} réponses — trop peu pour en tirer des conclusions."
+      nps_guide: "Comment est-il calculé, et qu'est-ce qu'un bon score ?"
+      nps_guide_formula: "NPS = % de promoteurs moins % de détracteurs. Les passifs comptent dans le total mais dans aucun des deux camps, ce qui tire le score vers zéro. Le résultat va de −100 à +100 — un score, pas un pourcentage."
+      nps_guide_needs_work: "Plus de détracteurs que de promoteurs."
+      nps_guide_good: "Là où se situe la plupart des entreprises."
+      nps_guide_great: "Forte fidélité."
+      nps_guide_excellent: "Niveau mondial, et rare."
+      nps_guide_caveat: "Les repères varient selon le secteur — le logiciel tourne souvent autour de 40, les compagnies aériennes et les fournisseurs d'accès près de 0. La tendance dans le temps en dit plus qu'un chiffre isolé, et les commentaires en disent plus que le score."
       score: "Score"
       comment: "Commentaire"

data/config/locales/testimonials.hi.yml

@@ -102,5 +102,17 @@ hi:
       promoters: "प्रमोटर (9–10)"
       passives: "तटस्थ (7–8)"
       detractors: "आलोचक (0–6)"
+      nps_band_needs_work: "सुधार चाहिए"
+      nps_band_good: "अच्छा"
+      nps_band_great: "बहुत अच्छा"
+      nps_band_excellent: "उत्कृष्ट"
+      nps_sample_note: "%{count} जवाबों पर आधारित — निष्कर्ष निकालने के लिए बहुत कम।"
+      nps_guide: "यह कैसे निकलता है, और अच्छा स्कोर क्या है?"
+      nps_guide_formula: "NPS = प्रमोटर का प्रतिशत घटा डिट्रैक्टर का प्रतिशत। पैसिव कुल में गिने जाते हैं पर किसी पक्ष में नहीं, इसलिए वे स्कोर को शून्य की ओर खींचते हैं। नतीजा −100 से +100 तक होता है — यह स्कोर है, प्रतिशत नहीं।"
+      nps_guide_needs_work: "प्रमोटर से ज़्यादा डिट्रैक्टर हैं।"
+      nps_guide_good: "अधिकतर कंपनियाँ यहीं होती हैं।"
+      nps_guide_great: "मज़बूत वफ़ादारी।"
+      nps_guide_excellent: "विश्वस्तरीय, और दुर्लभ।"
+      nps_guide_caveat: "मानक उद्योग के हिसाब से बदलते हैं — सॉफ़्टवेयर अक्सर 40 के आसपास, एयरलाइंस और इंटरनेट प्रदाता 0 के करीब। किसी एक आँकड़े से ज़्यादा समय के साथ रुझान बताता है, और स्कोर से ज़्यादा टिप्पणियाँ।"
       score: "स्कोर"
       comment: "टिप्पणी"

data/config/locales/testimonials.hr.yml

@@ -102,5 +102,17 @@ hr:
       promoters: "Promotori (9–10)"
       passives: "Pasivni (7–8)"
       detractors: "Kritičari (0–6)"
+      nps_band_needs_work: "Treba poboljšati"
+      nps_band_good: "Dobro"
+      nps_band_great: "Vrlo dobro"
+      nps_band_excellent: "Izvrsno"
+      nps_sample_note: "Na temelju %{count} odgovora — premalo za zaključke."
+      nps_guide: "Kako se ovo računa i koji je rezultat dobar?"
+      nps_guide_formula: "NPS = postotak promotora minus postotak kritičara. Neutralni se broje u ukupan zbroj, ali ni na jednu stranu, pa vuku rezultat prema nuli. Rezultat je od −100 do +100 — to je indeks, a ne postotak."
+      nps_guide_needs_work: "Više kritičara nego promotora."
+      nps_guide_good: "Ondje gdje je većina tvrtki."
+      nps_guide_great: "Snažna lojalnost."
+      nps_guide_excellent: "Svjetska razina, i rijetkost."
+      nps_guide_caveat: "Mjerila se razlikuju po industriji — softver je često oko 40, zrakoplovne tvrtke i pružatelji interneta blizu 0. Kretanje kroz vrijeme govori više od jednog broja, a komentari više od rezultata."
       score: "Rezultat"
       comment: "Komentar"

data/config/locales/testimonials.id.yml

@@ -102,5 +102,17 @@ id:
       promoters: "Promotor (9–10)"
       passives: "Pasif (7–8)"
       detractors: "Detraktor (0–6)"
+      nps_band_needs_work: "Perlu perbaikan"
+      nps_band_good: "Baik"
+      nps_band_great: "Sangat baik"
+      nps_band_excellent: "Luar biasa"
+      nps_sample_note: "Berdasarkan %{count} tanggapan — terlalu sedikit untuk disimpulkan."
+      nps_guide: "Bagaimana ini dihitung, dan berapa yang tergolong bagus?"
+      nps_guide_formula: "NPS = persentase promotor dikurangi persentase detraktor. Kelompok pasif dihitung dalam total tetapi tidak masuk ke salah satu sisi, sehingga menarik skor mendekati nol. Hasilnya berkisar dari −100 hingga +100 — sebuah skor, bukan persentase."
+      nps_guide_needs_work: "Detraktor lebih banyak daripada promotor."
+      nps_guide_good: "Kisaran tempat sebagian besar perusahaan berada."
+      nps_guide_great: "Loyalitas yang kuat."
+      nps_guide_excellent: "Kelas dunia, dan jarang."
+      nps_guide_caveat: "Tolok ukur berbeda di tiap industri — perangkat lunak sering di sekitar 40, maskapai dan penyedia internet mendekati 0. Tren dari waktu ke waktu lebih berarti daripada satu angka, dan komentar lebih berarti daripada skor."
       score: "Skor"
       comment: "Komentar"

data/config/locales/testimonials.it.yml

@@ -102,5 +102,17 @@ it:
       promoters: "Promotori (9–10)"
       passives: "Passivi (7–8)"
       detractors: "Detrattori (0–6)"
+      nps_band_needs_work: "Da migliorare"
+      nps_band_good: "Buono"
+      nps_band_great: "Ottimo"
+      nps_band_excellent: "Eccellente"
+      nps_sample_note: "Basato su %{count} risposte: troppo poche per trarne conclusioni."
+      nps_guide: "Come si calcola e qual è un buon punteggio?"
+      nps_guide_formula: "NPS = % di promotori meno % di detrattori. I passivi contano nel totale ma in nessuna delle due parti, quindi spingono il punteggio verso lo zero. Il risultato va da −100 a +100: è un indice, non una percentuale."
+      nps_guide_needs_work: "Più detrattori che promotori."
+      nps_guide_good: "Dove si colloca la maggior parte delle aziende."
+      nps_guide_great: "Forte fedeltà."
+      nps_guide_excellent: "Livello mondiale, e raro."
+      nps_guide_caveat: "I valori di riferimento cambiano con il settore: il software si attesta spesso intorno a 40, le compagnie aeree e i provider internet vicino a 0. L'andamento nel tempo dice più di un singolo numero, e i commenti dicono più del punteggio."
       score: "Punteggio"
       comment: "Commento"

data/config/locales/testimonials.ja.yml

@@ -102,5 +102,17 @@ ja:
       promoters: "推奨者（9–10）"
       passives: "中立者（7–8）"
       detractors: "批判者（0–6）"
+      nps_band_needs_work: "要改善"
+      nps_band_good: "良好"
+      nps_band_great: "優秀"
+      nps_band_excellent: "卓越"
+      nps_sample_note: "%{count}件の回答に基づく結果です。判断するにはまだ少なすぎます。"
+      nps_guide: "どう計算され、どのくらいなら良いのか"
+      nps_guide_formula: "NPS = 推奨者の割合 − 批判者の割合。中立者は母数には入りますがどちらにも数えないため、スコアをゼロに近づけます。結果は −100 から +100 までで、パーセントではなくスコアです。"
+      nps_guide_needs_work: "推奨者より批判者が多い状態です。"
+      nps_guide_good: "多くの企業がこの範囲に入ります。"
+      nps_guide_great: "強いロイヤルティがあります。"
+      nps_guide_excellent: "世界水準で、めったにない値です。"
+      nps_guide_caveat: "目安は業界によって変わります。ソフトウェアは 40 前後、航空会社やインターネット回線事業者は 0 付近になりがちです。単独の数値より時間の推移が、スコアよりコメントのほうが多くを語ります。"
       score: "スコア"
       comment: "コメント"

data/config/locales/testimonials.ko.yml

@@ -102,5 +102,17 @@ ko:
       promoters: "추천 고객 (9–10)"
       passives: "중립 고객 (7–8)"
       detractors: "비추천 고객 (0–6)"
+      nps_band_needs_work: "개선 필요"
+      nps_band_good: "좋음"
+      nps_band_great: "매우 좋음"
+      nps_band_excellent: "탁월함"
+      nps_sample_note: "응답 %{count}건 기준 — 판단하기에는 너무 적습니다."
+      nps_guide: "어떻게 계산되며, 어느 정도면 좋은 점수인가요?"
+      nps_guide_formula: "NPS = 추천 고객 비율 − 비추천 고객 비율. 중립 고객은 전체에는 포함되지만 어느 쪽에도 들어가지 않아 점수를 0에 가깝게 만듭니다. 결과는 −100에서 +100 사이이며, 백분율이 아니라 점수입니다."
+      nps_guide_needs_work: "추천 고객보다 비추천 고객이 많습니다."
+      nps_guide_good: "대부분의 기업이 속하는 구간입니다."
+      nps_guide_great: "충성도가 높습니다."
+      nps_guide_excellent: "세계적인 수준으로, 보기 드뭅니다."
+      nps_guide_caveat: "기준은 업종에 따라 달라집니다. 소프트웨어는 보통 40 안팎, 항공사와 인터넷 사업자는 0 부근입니다. 하나의 숫자보다 시간에 따른 추이가, 점수보다 코멘트가 더 많은 것을 알려 줍니다."
       score: "점수"
       comment: "의견"

data/config/locales/testimonials.lb.yml

@@ -102,5 +102,17 @@ lb:
       promoters: "Promoteuren (9–10)"
       passives: "Passiv (7–8)"
       detractors: "Kritiker (0–6)"
+      nps_band_needs_work: "Muss besser ginn"
+      nps_band_good: "Gutt"
+      nps_band_great: "Ganz gutt"
+      nps_band_excellent: "Excellent"
+      nps_sample_note: "Baséiert op %{count} Äntwerten — ze wéineg fir doraus eppes ofzeleeden."
+      nps_guide: "Wéi gëtt dat gerechent, a wat ass e gudde Score?"
+      nps_guide_formula: "NPS = % vun de Promoteuren ofzunn % vun de Kritiker. D'Passiv zielen an der Gesamtzuel mat, awer op kenger vun de Säiten, sou datt se de Score Richtung null zéien. D'Resultat geet vu −100 bis +100 — e Score, kee Prozentsaz."
+      nps_guide_needs_work: "Méi Kritiker wéi Promoteuren."
+      nps_guide_good: "Do, wou déi meescht Betriber leien."
+      nps_guide_great: "Staark Trei."
+      nps_guide_excellent: "Weltklass, a seelen."
+      nps_guide_caveat: "D'Richtwäerter hänke vum Secteur of — Software läit dacks ronn 40, Fluchgesellschaften an Internetfournisseuren no bei 0. D'Entwécklung iwwer d'Zäit seet méi wéi eng eenzel Zuel, an d'Kommentaren soe méi wéi de Score."
       score: "Score"
       comment: "Kommentar"

data/config/locales/testimonials.nl.yml

@@ -102,5 +102,17 @@ nl:
       promoters: "Promotors (9–10)"
       passives: "Passieven (7–8)"
       detractors: "Criticasters (0–6)"
+      nps_band_needs_work: "Moet beter"
+      nps_band_good: "Goed"
+      nps_band_great: "Zeer goed"
+      nps_band_excellent: "Uitstekend"
+      nps_sample_note: "Gebaseerd op %{count} reacties — te weinig om conclusies aan te verbinden."
+      nps_guide: "Hoe wordt dit berekend en wat is een goede score?"
+      nps_guide_formula: "NPS = % promotors min % criticasters. Passieven tellen mee in het totaal maar aan geen van beide kanten, waardoor ze de score richting nul trekken. De uitkomst loopt van −100 tot +100 — een score, geen percentage."
+      nps_guide_needs_work: "Meer criticasters dan promotors."
+      nps_guide_good: "Waar de meeste bedrijven zitten."
+      nps_guide_great: "Sterke loyaliteit."
+      nps_guide_excellent: "Wereldklasse, en zeldzaam."
+      nps_guide_caveat: "Richtwaarden verschillen per branche — software zit vaak rond de 40, luchtvaartmaatschappijen en internetproviders dicht bij 0. De trend over tijd zegt meer dan één getal, en de opmerkingen zeggen meer dan de score."
       score: "Score"
       comment: "Opmerking"

data/config/locales/testimonials.pl.yml

@@ -102,5 +102,17 @@ pl:
       promoters: "Promotorzy (9–10)"
       passives: "Neutralni (7–8)"
       detractors: "Krytycy (0–6)"
+      nps_band_needs_work: "Wymaga pracy"
+      nps_band_good: "Dobrze"
+      nps_band_great: "Bardzo dobrze"
+      nps_band_excellent: "Znakomicie"
+      nps_sample_note: "Na podstawie %{count} odpowiedzi — zbyt mało, by wyciągać wnioski."
+      nps_guide: "Jak to jest liczone i jaki wynik jest dobry?"
+      nps_guide_formula: "NPS = % promotorów minus % krytyków. Neutralni liczą się do sumy, ale do żadnej ze stron, więc ciągną wynik w stronę zera. Wartość mieści się w przedziale od −100 do +100 — to wskaźnik, nie procent."
+      nps_guide_needs_work: "Więcej krytyków niż promotorów."
+      nps_guide_good: "Poziom większości firm."
+      nps_guide_great: "Silna lojalność."
+      nps_guide_excellent: "Poziom światowy, spotykany rzadko."
+      nps_guide_caveat: "Punkty odniesienia zależą od branży — oprogramowanie często ma około 40, linie lotnicze i dostawcy internetu blisko 0. Trend w czasie mówi więcej niż pojedyncza liczba, a komentarze więcej niż sam wynik."
       score: "Wynik"
       comment: "Komentarz"

data/config/locales/testimonials.pt.yml

@@ -102,5 +102,17 @@ pt:
       promoters: "Promotores (9–10)"
       passives: "Neutros (7–8)"
       detractors: "Detratores (0–6)"
+      nps_band_needs_work: "Precisa melhorar"
+      nps_band_good: "Bom"
+      nps_band_great: "Muito bom"
+      nps_band_excellent: "Excelente"
+      nps_sample_note: "Com base em %{count} respostas — poucas demais para tirar conclusões."
+      nps_guide: "Como isto é calculado e o que é uma boa pontuação?"
+      nps_guide_formula: "NPS = % de promotores menos % de detratores. Os neutros contam no total, mas não em nenhum dos lados, por isso puxam a pontuação para zero. O resultado vai de −100 a +100 — é um índice, não uma percentagem."
+      nps_guide_needs_work: "Mais detratores do que promotores."
+      nps_guide_good: "Onde fica a maioria das empresas."
+      nps_guide_great: "Lealdade forte."
+      nps_guide_excellent: "Nível mundial, e raro."
+      nps_guide_caveat: "As referências variam por setor — software costuma ficar perto de 40, companhias aéreas e provedores de internet perto de 0. A tendência ao longo do tempo diz mais do que um número isolado, e os comentários dizem mais do que a pontuação."
       score: "Nota"
       comment: "Comentário"

data/config/locales/testimonials.ro.yml

@@ -102,5 +102,17 @@ ro:
       promoters: "Promotori (9–10)"
       passives: "Pasivi (7–8)"
       detractors: "Detractori (0–6)"
+      nps_band_needs_work: "Necesită îmbunătățiri"
+      nps_band_good: "Bun"
+      nps_band_great: "Foarte bun"
+      nps_band_excellent: "Excelent"
+      nps_sample_note: "Pe baza a %{count} răspunsuri — prea puține pentru concluzii."
+      nps_guide: "Cum se calculează și ce înseamnă un scor bun?"
+      nps_guide_formula: "NPS = procentul de promotori minus procentul de detractori. Pasivii intră în total, dar în niciuna dintre părți, așa că trag scorul spre zero. Rezultatul merge de la −100 la +100 — este un scor, nu un procent."
+      nps_guide_needs_work: "Mai mulți detractori decât promotori."
+      nps_guide_good: "Acolo unde se află majoritatea companiilor."
+      nps_guide_great: "Loialitate puternică."
+      nps_guide_excellent: "Nivel mondial, și rar."
+      nps_guide_caveat: "Reperele diferă de la o industrie la alta — software-ul stă adesea în jur de 40, companiile aeriene și furnizorii de internet aproape de 0. Tendința în timp spune mai mult decât un singur număr, iar comentariile spun mai mult decât scorul."
       score: "Scor"
       comment: "Comentariu"

data/config/locales/testimonials.ru.yml

@@ -102,5 +102,17 @@ ru:
       promoters: "Промоутеры (9–10)"
       passives: "Нейтралы (7–8)"
       detractors: "Критики (0–6)"
+      nps_band_needs_work: "Требует работы"
+      nps_band_good: "Хорошо"
+      nps_band_great: "Отлично"
+      nps_band_excellent: "Превосходно"
+      nps_sample_note: "Основано на %{count} ответах — слишком мало, чтобы делать выводы."
+      nps_guide: "Как это считается и какой результат хороший?"
+      nps_guide_formula: "NPS = % промоутеров минус % критиков. Нейтралы входят в общее число, но не идут ни в одну из сторон, поэтому тянут результат к нулю. Значение лежит в диапазоне от −100 до +100 — это индекс, а не проценты."
+      nps_guide_needs_work: "Критиков больше, чем промоутеров."
+      nps_guide_good: "Уровень большинства компаний."
+      nps_guide_great: "Высокая лояльность."
+      nps_guide_excellent: "Мировой уровень, встречается редко."
+      nps_guide_caveat: "Ориентиры зависят от отрасли: у софта это часто около 40, у авиакомпаний и провайдеров — около 0. Динамика во времени говорит больше, чем одно число, а комментарии — больше, чем сам индекс."
       score: "Оценка"
       comment: "Комментарий"

data/config/locales/testimonials.th.yml

@@ -102,5 +102,17 @@ th:
       promoters: "ผู้สนับสนุน (9–10)"
       passives: "เป็นกลาง (7–8)"
       detractors: "ผู้ไม่พอใจ (0–6)"
+      nps_band_needs_work: "ต้องปรับปรุง"
+      nps_band_good: "ดี"
+      nps_band_great: "ดีมาก"
+      nps_band_excellent: "ยอดเยี่ยม"
+      nps_sample_note: "จากคำตอบ %{count} รายการ — น้อยเกินกว่าจะสรุปอะไรได้"
+      nps_guide: "คำนวณอย่างไร และเท่าไรถึงเรียกว่าดี"
+      nps_guide_formula: "NPS = สัดส่วนผู้สนับสนุน ลบ สัดส่วนผู้ไม่พอใจ กลุ่มเฉย ๆ นับรวมในยอดทั้งหมดแต่ไม่นับเข้าฝั่งใด จึงดึงคะแนนเข้าใกล้ศูนย์ ผลลัพธ์อยู่ระหว่าง −100 ถึง +100 เป็นคะแนน ไม่ใช่เปอร์เซ็นต์"
+      nps_guide_needs_work: "มีผู้ไม่พอใจมากกว่าผู้สนับสนุน"
+      nps_guide_good: "ช่วงที่บริษัทส่วนใหญ่อยู่"
+      nps_guide_great: "ความภักดีสูง"
+      nps_guide_excellent: "ระดับโลก และพบได้ยาก"
+      nps_guide_caveat: "เกณฑ์เปรียบเทียบต่างกันไปตามอุตสาหกรรม ซอฟต์แวร์มักอยู่ราว 40 ส่วนสายการบินและผู้ให้บริการอินเทอร์เน็ตใกล้ 0 แนวโน้มตามเวลาบอกอะไรได้มากกว่าตัวเลขเดียว และความคิดเห็นบอกได้มากกว่าคะแนน"
       score: "คะแนน"
       comment: "ความคิดเห็น"

data/config/locales/testimonials.tr.yml

@@ -102,5 +102,17 @@ tr:
       promoters: "Destekleyenler (9–10)"
       passives: "Pasifler (7–8)"
       detractors: "Eleştirenler (0–6)"
+      nps_band_needs_work: "Geliştirilmeli"
+      nps_band_good: "İyi"
+      nps_band_great: "Çok iyi"
+      nps_band_excellent: "Mükemmel"
+      nps_sample_note: "%{count} yanıta dayanıyor — sonuç çıkarmak için fazla az."
+      nps_guide: "Bu nasıl hesaplanır ve iyi bir puan nedir?"
+      nps_guide_formula: "NPS = tavsiye edenlerin yüzdesi eksi eleştirenlerin yüzdesi. Kararsızlar toplama dahildir ama iki taraftan birine yazılmaz, bu yüzden puanı sıfıra doğru çeker. Sonuç −100 ile +100 arasındadır — yüzde değil, bir puandır."
+      nps_guide_needs_work: "Eleştirenler tavsiye edenlerden fazla."
+      nps_guide_good: "Çoğu şirketin bulunduğu aralık."
+      nps_guide_great: "Güçlü bağlılık."
+      nps_guide_excellent: "Dünya standartlarında ve nadir."
+      nps_guide_caveat: "Ölçütler sektöre göre değişir — yazılımda genelde 40 civarı, havayollarında ve internet sağlayıcılarında 0'a yakındır. Zaman içindeki eğilim tek bir sayıdan, yorumlar ise puandan daha çok şey anlatır."
       score: "Puan"
       comment: "Yorum"

data/config/locales/testimonials.uk.yml

@@ -102,5 +102,17 @@ uk:
       promoters: "Промоутери (9–10)"
       passives: "Нейтральні (7–8)"
       detractors: "Критики (0–6)"
+      nps_band_needs_work: "Потребує роботи"
+      nps_band_good: "Добре"
+      nps_band_great: "Чудово"
+      nps_band_excellent: "Відмінно"
+      nps_sample_note: "На основі %{count} відповідей — замало, щоб робити висновки."
+      nps_guide: "Як це обчислюється і який результат вважається добрим?"
+      nps_guide_formula: "NPS = % промоутерів мінус % критиків. Нейтральні входять до загальної кількості, але не до жодної зі сторін, тому тягнуть результат до нуля. Значення — від −100 до +100 — це індекс, а не відсотки."
+      nps_guide_needs_work: "Критиків більше, ніж промоутерів."
+      nps_guide_good: "Рівень більшості компаній."
+      nps_guide_great: "Висока лояльність."
+      nps_guide_excellent: "Світовий рівень, трапляється рідко."
+      nps_guide_caveat: "Орієнтири залежать від галузі: у програмного забезпечення це часто близько 40, у авіакомпаній та провайдерів — близько 0. Динаміка в часі говорить більше, ніж одне число, а коментарі — більше, ніж сам індекс."
       score: "Оцінка"
       comment: "Коментар"

data/config/locales/testimonials.ur.yml

@@ -102,5 +102,17 @@ ur:
       promoters: "حامی (9–10)"
       passives: "غیر جانبدار (7–8)"
       detractors: "ناقدین (0–6)"
+      nps_band_needs_work: "بہتری درکار"
+      nps_band_good: "اچھا"
+      nps_band_great: "بہت اچھا"
+      nps_band_excellent: "شاندار"
+      nps_sample_note: "%{count} جوابات کی بنیاد پر — نتیجہ نکالنے کے لیے بہت کم۔"
+      nps_guide: "یہ کیسے نکلتا ہے، اور اچھا اسکور کیا ہے؟"
+      nps_guide_formula: "NPS = پروموٹرز کا فیصد منفی ناقدین کا فیصد۔ غیر جانبدار کل تعداد میں شمار ہوتے ہیں مگر کسی طرف نہیں، اس لیے وہ اسکور کو صفر کی طرف کھینچتے ہیں۔ نتیجہ −100 سے +100 تک ہوتا ہے — یہ اسکور ہے، فیصد نہیں۔"
+      nps_guide_needs_work: "پروموٹرز سے زیادہ ناقدین ہیں۔"
+      nps_guide_good: "زیادہ تر کمپنیاں یہیں ہوتی ہیں۔"
+      nps_guide_great: "مضبوط وفاداری۔"
+      nps_guide_excellent: "عالمی معیار، اور کم یاب۔"
+      nps_guide_caveat: "معیار صنعت کے ساتھ بدلتے ہیں — سافٹ ویئر اکثر 40 کے آس پاس، ایئر لائنز اور انٹرنیٹ فراہم کنندگان 0 کے قریب۔ کسی ایک عدد سے زیادہ وقت کے ساتھ رجحان بتاتا ہے، اور اسکور سے زیادہ تبصرے۔"
       score: "اسکور"
       comment: "تبصرہ"

data/config/locales/testimonials.vi.yml

@@ -102,5 +102,17 @@ vi:
       promoters: "Người ủng hộ (9–10)"
       passives: "Trung lập (7–8)"
       detractors: "Người phản đối (0–6)"
+      nps_band_needs_work: "Cần cải thiện"
+      nps_band_good: "Tốt"
+      nps_band_great: "Rất tốt"
+      nps_band_excellent: "Xuất sắc"
+      nps_sample_note: "Dựa trên %{count} phản hồi — quá ít để rút ra kết luận."
+      nps_guide: "Chỉ số này tính thế nào, và bao nhiêu là tốt?"
+      nps_guide_formula: "NPS = % người ủng hộ trừ % người phản đối. Nhóm trung lập được tính vào tổng nhưng không thuộc bên nào, nên kéo điểm về gần 0. Kết quả nằm trong khoảng −100 đến +100 — là điểm số, không phải phần trăm."
+      nps_guide_needs_work: "Người phản đối nhiều hơn người ủng hộ."
+      nps_guide_good: "Mức mà phần lớn công ty đạt được."
+      nps_guide_great: "Mức độ trung thành cao."
+      nps_guide_excellent: "Đẳng cấp thế giới, và hiếm gặp."
+      nps_guide_caveat: "Mốc tham chiếu thay đổi theo ngành — phần mềm thường quanh 40, hàng không và nhà mạng gần 0. Xu hướng theo thời gian nói lên nhiều hơn một con số, và các bình luận nói lên nhiều hơn điểm số."
       score: "Điểm"
       comment: "Bình luận"

data/config/locales/testimonials.zh-CN.yml

@@ -102,5 +102,17 @@ zh-CN:
       promoters: "推荐者（9–10）"
       passives: "中立者（7–8）"
       detractors: "贬损者（0–6）"
+      nps_band_needs_work: "有待改进"
+      nps_band_good: "良好"
+      nps_band_great: "优秀"
+      nps_band_excellent: "卓越"
+      nps_sample_note: "基于 %{count} 条回复，样本太少，参考价值有限。"
+      nps_guide: "这个分数怎么算，多少算好？"
+      nps_guide_formula: "NPS = 推荐者占比 − 贬损者占比。被动者计入总数，但不计入任何一方，因此会把分数拉向零。结果范围是 −100 到 +100，是分数而不是百分比。"
+      nps_guide_needs_work: "贬损者多于推荐者。"
+      nps_guide_good: "多数公司所处的区间。"
+      nps_guide_great: "客户忠诚度很高。"
+      nps_guide_excellent: "世界一流水平，相当少见。"
+      nps_guide_caveat: "基准随行业而变：软件行业常在 40 左右，航空公司和网络运营商接近 0。趋势比单个数字更有意义，评论又比分数更有意义。"
       score: "分数"
       comment: "评论"

data/lib/generators/testimonials/install/install_generator.rb

@@ -12,8 +12,15 @@ module Testimonials
 
       desc 'Installs testimonials: config initializer, migration, and engine mount.'
 
+      # NPS is the one part of the gem an app can genuinely not want. Skipping
+      # it leaves out the table and writes `config.nps = false`, so nothing
+      # ever reaches a table that isn't there — no runtime introspection, no
+      # boot-time database call. `testimonials:nps` adds it later.
+      class_option :skip_nps, type: :boolean, default: false,
+                              desc: 'Leave out the NPS table and turn the NPS flow off'
+
       def create_initializer
-        copy_file 'initializer.rb', 'config/initializers/testimonials.rb'
+        template 'initializer.rb.tt', 'config/initializers/testimonials.rb'
       end
 
       def create_migration_file
@@ -29,8 +36,12 @@ module Testimonials
         say "\ntestimonials installed. Run `rails db:migrate`, then add", :green
         say '`<%= testimonials_tag %>` before </body> in your layout.'
         say 'Triage testimonials at /testimonials (development only until you set config.authorize_admin).'
-        say 'Optional: run `bin/rails testimonials:seed_demo` for sample testimonials and NPS.'
+        samples = options[:skip_nps] ? 'testimonials' : 'testimonials and NPS'
+        say "Optional: run `bin/rails testimonials:seed_demo` for sample #{samples}."
         say "Collect from outside the app via /testimonials/new.\n"
+        return unless options[:skip_nps]
+
+        say 'Installed without NPS. Add it later with `bin/rails generate testimonials:nps`.', :yellow
       end
 
       private

data/lib/generators/testimonials/install/templates/create_testimonials_tables.rb.tt

@@ -27,6 +27,7 @@ class CreateTestimonialsTables < ActiveRecord::Migration<%= migration_version %>
     add_index :testimonials_testimonials, %i[tenant status]
     add_index :testimonials_testimonials, %i[tenant status consent_given]
 
+<% unless options[:skip_nps] -%>
     create_table :testimonials_nps_responses do |t|
       t.integer :score, null: false
       t.text :comment
@@ -42,6 +43,7 @@ class CreateTestimonialsTables < ActiveRecord::Migration<%= migration_version %>
     end
     add_index :testimonials_nps_responses, %i[tenant score]
 
+<% end -%>
     create_table :testimonials_prompt_events do |t|
       t.string :kind, null: false
       t.string :action, null: false

data/lib/generators/testimonials/install/templates/{initializer.rb → initializer.rb.tt}

@@ -84,7 +84,15 @@ Testimonials.configure do |config|
   # config.public_api = false
 
   # NPS surveys. Promoters (9–10) are offered the testimonial form right away.
+<% if options[:skip_nps] -%>
+  # Installed with --skip-nps, so there is no testimonials_nps_responses table
+  # and the NPS flow, dashboard tab and public page stay off. To add it later:
+  # `bin/rails generate testimonials:nps && bin/rails db:migrate`, then flip
+  # this to true.
+  config.nps = false
+<% else -%>
   # config.nps = true
+<% end -%>
   # config.nps_reprompt_after = 90.days
 
   # Called with each saved Testimonial or NpsResponse — notify Slack, email…

data/lib/generators/testimonials/nps/nps_generator.rb

@@ -0,0 +1,37 @@
+# frozen_string_literal: true
+
+require 'rails/generators'
+require 'rails/generators/active_record'
+
+module Testimonials
+  module Generators
+    # For apps that installed with --skip-nps and later want the 0–10 survey:
+    # creates the testimonials_nps_responses table. A full install already has
+    # it. Additive and safe — nothing reads the table until config.nps is true.
+    #
+    #   bin/rails generate testimonials:nps && bin/rails db:migrate
+    class NpsGenerator < Rails::Generators::Base
+      include ActiveRecord::Generators::Migration
+
+      source_root File.expand_path('templates', __dir__)
+
+      desc 'Adds the NPS responses table for an install that skipped it.'
+
+      def create_migration_file
+        migration_template 'create_testimonials_nps_responses.rb.tt',
+                           'db/migrate/create_testimonials_nps_responses.rb'
+      end
+
+      def post_install
+        say "\nNPS table queued. Run `rails db:migrate`, then set", :green
+        say 'config.nps = true in config/initializers/testimonials.rb to turn the flow on.'
+      end
+
+      private
+
+      def migration_version
+        "[#{ActiveRecord::VERSION::MAJOR}.#{ActiveRecord::VERSION::MINOR}]"
+      end
+    end
+  end
+end

data/lib/generators/testimonials/nps/templates/create_testimonials_nps_responses.rb.tt

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+class CreateTestimonialsNpsResponses < ActiveRecord::Migration<%= migration_version %>
+  def change
+    create_table :testimonials_nps_responses do |t|
+      t.integer :score, null: false
+      t.text :comment
+      t.string :author_id
+      t.string :name
+      t.string :email
+      t.string :page_url
+      t.string :user_agent
+      t.string :locale
+      t.string :tenant # opaque per-tenant key; nil = single global collection
+
+      t.timestamps
+    end
+    add_index :testimonials_nps_responses, %i[tenant score]
+  end
+end

data/lib/generators/testimonials/tenant/templates/add_tenant_to_testimonials.rb.tt

@@ -3,13 +3,17 @@
 class AddTenantToTestimonials < ActiveRecord::Migration<%= migration_version %>
   def change
     add_column :testimonials_testimonials, :tenant, :string
-    add_column :testimonials_nps_responses, :tenant, :string
     add_column :testimonials_prompt_events, :tenant, :string
 
     add_index :testimonials_testimonials, %i[tenant status]
     add_index :testimonials_testimonials, %i[tenant status consent_given]
-    add_index :testimonials_nps_responses, %i[tenant score]
     add_index :testimonials_prompt_events, %i[tenant author_id kind]
     add_index :testimonials_prompt_events, %i[tenant visitor_token kind]
+
+    # An install run with --skip-nps has no NPS table to add the column to.
+    return unless table_exists?(:testimonials_nps_responses)
+
+    add_column :testimonials_nps_responses, :tenant, :string
+    add_index :testimonials_nps_responses, %i[tenant score]
   end
 end

data/lib/testimonials/dashboard.css

@@ -5,6 +5,8 @@
   --pending: #d97706; --approved: #16a34a; --archived: #6b7280;
   --star: #f59e0b; --danger: #dc2626;
   --promoter: #16a34a; --passive: #d97706; --detractor: #dc2626;
+  /* The four bands an NPS number falls into: bad, ordinary, strong, rare. */
+  --nps-needs-work: #dc2626; --nps-good: #d97706; --nps-great: #16a34a; --nps-excellent: #0f766e;
 }
 @media (prefers-color-scheme: dark) {
   :root {
@@ -86,6 +88,51 @@ img.avatar { width: 48px; height: 48px; border-radius: 50%; object-fit: cover; }
         border-radius: 12px; padding: 14px 16px; }
 .stat b { display: block; font-size: 26px; }
 .stat span { color: var(--muted); font-size: 13px; }
+
+/* NPS score card: the number, the band it falls in, and where it sits on the
+   −100..100 scale — so nobody has to google whether 50 is any good. */
+.stat-nps { flex: 2.4; min-width: 240px; }
+.stat-headline { display: flex; align-items: center; gap: 10px; }
+.stat-headline b { display: inline-block; }
+/* `.stat span` would otherwise mute the badge's own white text. */
+.stat .badge { color: #fff; font-size: 12px; }
+.badge.nps-band-needs-work { background: var(--nps-needs-work); }
+.badge.nps-band-good { background: var(--nps-good); }
+.badge.nps-band-great { background: var(--nps-great); }
+.badge.nps-band-excellent { background: var(--nps-excellent); }
+.nps-meter { direction: ltr; margin-top: 10px; }
+.nps-meter-track { position: relative; display: flex; height: 6px; border-radius: 999px; overflow: hidden; }
+.nps-seg { display: block; height: 100%; opacity: .45; }
+.nps-seg.nps-band-needs-work { flex: 100; background: var(--nps-needs-work); }
+.nps-seg.nps-band-good { flex: 30; background: var(--nps-good); }
+.nps-seg.nps-band-great { flex: 40; background: var(--nps-great); }
+.nps-seg.nps-band-excellent { flex: 30; background: var(--nps-excellent); }
+/* Hidden until dashboard.js reads data-nps-marker and positions it, so a
+   score of 50 never renders as if it were −100. */
+.nps-marker { display: none; position: absolute; top: -3px; width: 4px; height: 12px; margin-left: -2px;
+              border-radius: 2px; background: var(--text); box-shadow: 0 0 0 2px var(--surface); }
+.nps-marker.placed { display: block; }
+.nps-meter-ticks { position: relative; height: 14px; margin-top: 3px; color: var(--muted); font-size: 11px; }
+.nps-meter-ticks span { position: absolute; transform: translateX(-50%); }
+.nps-meter-ticks .tick-min { left: 0; transform: none; }
+.nps-meter-ticks .tick-zero { left: 50%; }
+.nps-meter-ticks .tick-good { left: 65%; }
+.nps-meter-ticks .tick-great { left: 85%; }
+.nps-meter-ticks .tick-max { left: 100%; transform: translateX(-100%); }
+.nps-sample { margin: 8px 0 0; font-size: 12px; }
+
+/* The formula and the benchmarks, tucked behind a disclosure. */
+.nps-guide { flex: 0 0 auto; margin-bottom: 14px; background: var(--surface);
+             border: 1px solid var(--border); border-radius: 12px; }
+.nps-guide summary { padding: 10px 16px; color: var(--muted); font-size: 13px; cursor: pointer; }
+.nps-guide summary:hover { color: var(--text); }
+.nps-guide[open] summary { border-bottom: 1px solid var(--border); }
+.nps-guide-body { padding: 12px 16px 14px; font-size: 13px; }
+.nps-guide-body p { margin: 0; max-width: 78ch; }
+.nps-bands { display: grid; grid-template-columns: max-content max-content 1fr; gap: 8px 14px;
+             margin: 12px 0; padding: 0; list-style: none; align-items: baseline; }
+.nps-bands li { display: contents; }
+.nps-bands b { font-variant-numeric: tabular-nums; white-space: nowrap; }
 .best-line-form textarea { width: 100%; padding: 8px; border: 1px solid var(--border); border-radius: 8px;
                          background: var(--surface); color: var(--text); font: inherit; resize: vertical; }
 .best-line-hint { margin: 2px 0 6px; }
@@ -183,5 +230,9 @@ img.avatar { width: 48px; height: 48px; border-radius: 50%; object-fit: cover; }
   .stat-row { display: grid; grid-template-columns: 1fr 1fr; gap: 8px; }
   .stat { min-width: 0; padding: 10px 12px; }
   .stat b { font-size: 22px; }
+  .stat-nps { grid-column: 1 / -1; }
+  .nps-bands { grid-template-columns: max-content 1fr; }
+  .nps-bands b { grid-column: 2; }
+  .nps-bands li > .muted { grid-column: 1 / -1; }
   .share-link { flex: 1 0 100%; margin-left: 0; text-align: center; }
 }

data/lib/testimonials/dashboard.js

@@ -21,6 +21,22 @@
     }
   }, true);
 
+  // Places the NPS score marker on the −100..100 scale. The position is a data
+  // attribute rather than an inline style, which a strict style-src refuses.
+  function placeNpsMarkers() {
+    var markers = document.querySelectorAll("[data-nps-marker]");
+    for (var i = 0; i < markers.length; i++) {
+      var score = parseFloat(markers[i].getAttribute("data-nps-marker"));
+      if (isNaN(score)) continue;
+      markers[i].style.left = ((score + 100) / 2) + "%";
+      markers[i].classList.add("placed");
+    }
+  }
+
+  document.addEventListener("DOMContentLoaded", placeNpsMarkers);
+  document.addEventListener("turbo:load", placeNpsMarkers);
+  placeNpsMarkers();
+
   document.addEventListener("change", function (event) {
     var control = event.target;
     if (!control || !control.dataset || !control.dataset.autosubmit || !control.form) return;

data/lib/testimonials/seeds.rb

@@ -90,7 +90,8 @@ module Testimonials
     def self.load!(tenant: nil)
       {
         testimonials: load_testimonials!(tenant: tenant),
-        nps_responses: load_nps_responses!(tenant: tenant),
+        # An install run with --skip-nps has no table to seed into.
+        nps_responses: (Testimonials.config.nps ? load_nps_responses!(tenant: tenant) : []),
         prompt_events: load_prompt_events!(tenant: tenant)
       }
     end

data/lib/testimonials/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Testimonials
-  VERSION = '0.7.7'
+  VERSION = '0.7.9'
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: testimonials
 version: !ruby/object:Gem::Version
-  version: 0.7.7
+  version: 0.7.9
 platform: ruby
 authors:
 - Yaroslav Shmarov
@@ -97,7 +97,9 @@ files:
 - config/routes.rb
 - lib/generators/testimonials/install/install_generator.rb
 - lib/generators/testimonials/install/templates/create_testimonials_tables.rb.tt
-- lib/generators/testimonials/install/templates/initializer.rb
+- lib/generators/testimonials/install/templates/initializer.rb.tt
+- lib/generators/testimonials/nps/nps_generator.rb
+- lib/generators/testimonials/nps/templates/create_testimonials_nps_responses.rb.tt
 - lib/generators/testimonials/tenant/templates/add_tenant_to_testimonials.rb.tt
 - lib/generators/testimonials/tenant/tenant_generator.rb
 - lib/tasks/testimonials_tasks.rake