product_tours 0.1.0

data/config/locales/product_tours.bg.yml

@@ -0,0 +1,11 @@
+bg:
+  product_tours:
+    close: "Затвори"
+    back: "Назад"
+    next: "Напред"
+    done: "Готово"
+    dialog: "Урок за продукта"
+    video: "Видео урок"
+    unavailable: "Този урок не е наличен."
+    dashboard:
+      title: "Продуктови обиколки"

data/config/locales/product_tours.bn.yml

@@ -0,0 +1,11 @@
+bn:
+  product_tours:
+    close: "বন্ধ করুন"
+    back: "ফিরে যান"
+    next: "পরবর্তী"
+    done: "সম্পন্ন"
+    dialog: "পণ্য টিউটোরিয়াল"
+    video: "টিউটোরিয়াল ভিডিও"
+    unavailable: "এই টিউটোরিয়ালটি উপলভ্য নয়।"
+    dashboard:
+      title: "পণ্য পরিচিতি"

data/config/locales/product_tours.de.yml

@@ -0,0 +1,11 @@
+de:
+  product_tours:
+    close: "Schließen"
+    back: "Zurück"
+    next: "Weiter"
+    done: "Fertig"
+    dialog: "Produkttutorial"
+    video: "Tutorialvideo"
+    unavailable: "Dieses Tutorial ist nicht verfügbar."
+    dashboard:
+      title: "Produkttouren"

data/config/locales/product_tours.el.yml

@@ -0,0 +1,11 @@
+el:
+  product_tours:
+    close: "Κλείσιμο"
+    back: "Πίσω"
+    next: "Επόμενο"
+    done: "Τέλος"
+    dialog: "Οδηγός προϊόντος"
+    video: "Βίντεο οδηγός"
+    unavailable: "Αυτός ο οδηγός δεν είναι διαθέσιμος."
+    dashboard:
+      title: "Περιηγήσεις προϊόντος"

data/config/locales/product_tours.en.yml

@@ -0,0 +1,11 @@
+en:
+  product_tours:
+    close: "Close"
+    back: "Back"
+    next: "Next"
+    done: "Done"
+    dialog: "Product tutorial"
+    video: "Tutorial video"
+    unavailable: "This tutorial is unavailable."
+    dashboard:
+      title: "Product tours"

data/config/locales/product_tours.es.yml

@@ -0,0 +1,11 @@
+es:
+  product_tours:
+    close: "Cerrar"
+    back: "Atrás"
+    next: "Siguiente"
+    done: "Listo"
+    dialog: "Tutorial del producto"
+    video: "Video tutorial"
+    unavailable: "Este tutorial no está disponible."
+    dashboard:
+      title: "Recorridos del producto"

data/config/locales/product_tours.fr.yml

@@ -0,0 +1,11 @@
+fr:
+  product_tours:
+    close: "Fermer"
+    back: "Retour"
+    next: "Suivant"
+    done: "Terminé"
+    dialog: "Tutoriel produit"
+    video: "Vidéo du tutoriel"
+    unavailable: "Ce tutoriel n’est pas disponible."
+    dashboard:
+      title: "Visites guidées"

data/config/locales/product_tours.hi.yml

@@ -0,0 +1,11 @@
+hi:
+  product_tours:
+    close: "बंद करें"
+    back: "वापस"
+    next: "अगला"
+    done: "पूरा हुआ"
+    dialog: "उत्पाद ट्यूटोरियल"
+    video: "ट्यूटोरियल वीडियो"
+    unavailable: "यह ट्यूटोरियल उपलब्ध नहीं है।"
+    dashboard:
+      title: "उत्पाद परिचय"

data/config/locales/product_tours.hr.yml

@@ -0,0 +1,11 @@
+hr:
+  product_tours:
+    close: "Zatvori"
+    back: "Natrag"
+    next: "Dalje"
+    done: "Gotovo"
+    dialog: "Vodič kroz proizvod"
+    video: "Video vodič"
+    unavailable: "Ovaj vodič nije dostupan."
+    dashboard:
+      title: "Vodiči kroz proizvod"

data/config/locales/product_tours.id.yml

@@ -0,0 +1,11 @@
+id:
+  product_tours:
+    close: "Tutup"
+    back: "Kembali"
+    next: "Berikutnya"
+    done: "Selesai"
+    dialog: "Tutorial produk"
+    video: "Video tutorial"
+    unavailable: "Tutorial ini tidak tersedia."
+    dashboard:
+      title: "Tur produk"

data/config/locales/product_tours.it.yml

@@ -0,0 +1,11 @@
+it:
+  product_tours:
+    close: "Chiudi"
+    back: "Indietro"
+    next: "Avanti"
+    done: "Fatto"
+    dialog: "Tutorial del prodotto"
+    video: "Video tutorial"
+    unavailable: "Questo tutorial non è disponibile."
+    dashboard:
+      title: "Tour del prodotto"

data/config/locales/product_tours.ja.yml

@@ -0,0 +1,11 @@
+ja:
+  product_tours:
+    close: "閉じる"
+    back: "戻る"
+    next: "次へ"
+    done: "完了"
+    dialog: "製品チュートリアル"
+    video: "チュートリアル動画"
+    unavailable: "このチュートリアルは利用できません。"
+    dashboard:
+      title: "製品ツアー"

data/config/locales/product_tours.ko.yml

@@ -0,0 +1,11 @@
+ko:
+  product_tours:
+    close: "닫기"
+    back: "뒤로"
+    next: "다음"
+    done: "완료"
+    dialog: "제품 튜토리얼"
+    video: "튜토리얼 동영상"
+    unavailable: "이 튜토리얼을 사용할 수 없습니다."
+    dashboard:
+      title: "제품 둘러보기"

data/config/locales/product_tours.lb.yml

@@ -0,0 +1,11 @@
+lb:
+  product_tours:
+    close: "Zoumaachen"
+    back: "Zeréck"
+    next: "Weider"
+    done: "Fäerdeg"
+    dialog: "Produktutorial"
+    video: "Tutorialvideo"
+    unavailable: "Dësen Tutorial ass net verfügbar."
+    dashboard:
+      title: "Produkttouren"

data/config/locales/product_tours.nl.yml

@@ -0,0 +1,11 @@
+nl:
+  product_tours:
+    close: "Sluiten"
+    back: "Terug"
+    next: "Volgende"
+    done: "Klaar"
+    dialog: "Producttutorial"
+    video: "Tutorialvideo"
+    unavailable: "Deze tutorial is niet beschikbaar."
+    dashboard:
+      title: "Productrondleidingen"

data/config/locales/product_tours.pl.yml

@@ -0,0 +1,11 @@
+pl:
+  product_tours:
+    close: "Zamknij"
+    back: "Wstecz"
+    next: "Dalej"
+    done: "Gotowe"
+    dialog: "Samouczek produktu"
+    video: "Film instruktażowy"
+    unavailable: "Ten samouczek jest niedostępny."
+    dashboard:
+      title: "Prezentacje produktu"

data/config/locales/product_tours.pt.yml

@@ -0,0 +1,11 @@
+pt:
+  product_tours:
+    close: "Fechar"
+    back: "Voltar"
+    next: "Seguinte"
+    done: "Concluir"
+    dialog: "Tutorial do produto"
+    video: "Vídeo tutorial"
+    unavailable: "Este tutorial não está disponível."
+    dashboard:
+      title: "Tours do produto"

data/config/locales/product_tours.ro.yml

@@ -0,0 +1,11 @@
+ro:
+  product_tours:
+    close: "Închide"
+    back: "Înapoi"
+    next: "Înainte"
+    done: "Gata"
+    dialog: "Tutorial de produs"
+    video: "Videoclip tutorial"
+    unavailable: "Acest tutorial nu este disponibil."
+    dashboard:
+      title: "Tururi de produs"

data/config/locales/product_tours.ru.yml

@@ -0,0 +1,11 @@
+ru:
+  product_tours:
+    close: "Закрыть"
+    back: "Назад"
+    next: "Далее"
+    done: "Готово"
+    dialog: "Руководство по продукту"
+    video: "Обучающее видео"
+    unavailable: "Это руководство недоступно."
+    dashboard:
+      title: "Обзоры продукта"

data/config/locales/product_tours.th.yml

@@ -0,0 +1,11 @@
+th:
+  product_tours:
+    close: "ปิด"
+    back: "ย้อนกลับ"
+    next: "ถัดไป"
+    done: "เสร็จสิ้น"
+    dialog: "บทแนะนำผลิตภัณฑ์"
+    video: "วิดีโอบทแนะนำ"
+    unavailable: "บทแนะนำนี้ไม่พร้อมใช้งาน"
+    dashboard:
+      title: "ทัวร์ผลิตภัณฑ์"

data/config/locales/product_tours.tr.yml

@@ -0,0 +1,11 @@
+tr:
+  product_tours:
+    close: "Kapat"
+    back: "Geri"
+    next: "İleri"
+    done: "Bitti"
+    dialog: "Ürün eğitimi"
+    video: "Eğitim videosu"
+    unavailable: "Bu eğitim kullanılamıyor."
+    dashboard:
+      title: "Ürün turları"

data/config/locales/product_tours.uk.yml

@@ -0,0 +1,11 @@
+uk:
+  product_tours:
+    close: "Закрити"
+    back: "Назад"
+    next: "Далі"
+    done: "Готово"
+    dialog: "Посібник із продукту"
+    video: "Навчальне відео"
+    unavailable: "Цей посібник недоступний."
+    dashboard:
+      title: "Огляди продукту"

data/config/locales/product_tours.ur.yml

@@ -0,0 +1,11 @@
+ur:
+  product_tours:
+    close: "بند کریں"
+    back: "واپس"
+    next: "اگلا"
+    done: "مکمل"
+    dialog: "پروڈکٹ ٹیوٹوریل"
+    video: "ٹیوٹوریل ویڈیو"
+    unavailable: "یہ ٹیوٹوریل دستیاب نہیں ہے۔"
+    dashboard:
+      title: "پروڈکٹ ٹورز"

data/config/locales/product_tours.vi.yml

@@ -0,0 +1,11 @@
+vi:
+  product_tours:
+    close: "Đóng"
+    back: "Quay lại"
+    next: "Tiếp theo"
+    done: "Xong"
+    dialog: "Hướng dẫn sản phẩm"
+    video: "Video hướng dẫn"
+    unavailable: "Hướng dẫn này không khả dụng."
+    dashboard:
+      title: "Chuyến tham quan sản phẩm"

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

@@ -0,0 +1,11 @@
+"zh-CN":
+  product_tours:
+    close: "关闭"
+    back: "返回"
+    next: "下一步"
+    done: "完成"
+    dialog: "产品教程"
+    video: "教程视频"
+    unavailable: "此教程不可用。"
+    dashboard:
+      title: "产品导览"

data/config/routes.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+ProductTours::Engine.routes.draw do
+  get 'widget.js', to: 'widgets#show', as: :widget_script
+  get 'dashboard.js', to: 'widgets#dashboard', as: :dashboard_script
+  get 'dashboard.css', to: 'widgets#dashboard_stylesheet', as: :dashboard_stylesheet
+
+  scope :widget, as: :widget do
+    get :post, to: 'tours#resolve'
+    post :signal, to: 'tours#signal'
+  end
+
+  get 'media/:id', to: 'media#show', as: :media, constraints: { id: /\d+/ }
+
+  resources :posts do
+    post :refresh_video_metadata, on: :member
+    post :add_translation, on: :member
+    patch :publish, on: :member
+    patch :unpublish, on: :member
+    get :video_preview, on: :collection
+  end
+  root to: 'posts#index'
+end

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

@@ -0,0 +1,44 @@
+# frozen_string_literal: true
+
+require 'rails/generators'
+require 'rails/generators/active_record'
+
+module ProductTours
+  module Generators
+    class InstallGenerator < Rails::Generators::Base
+      include ActiveRecord::Generators::Migration
+
+      source_root File.expand_path('templates', __dir__)
+      desc 'Installs product_tours: initializer, posts migration, and engine mount.'
+
+      def create_initializer
+        copy_file 'initializer.rb', 'config/initializers/product_tours.rb'
+      end
+
+      def create_migration_file
+        migration_template 'create_product_tours_posts.rb.tt', 'db/migrate/create_product_tours_posts.rb'
+      end
+
+      def mount_engine
+        route %(mount_product_tours at: "/product_tours")
+      end
+
+      def post_install
+        say "\nproduct_tours installed. Run `bin/rails db:migrate`.", :green
+        say 'The migration adds ready-to-use demo posts in development.'
+        say "\nCopy this into any ERB view to try them:\n\n"
+        say ProductTours::Seeds.trigger_html
+        say 'Manage tutorials at /product_tours (development only until config.authorize_admin is set).'
+        say 'Run `bin/rails product_tours:seed_demo` any time to refresh every demo locale.'
+        say 'Run `bin/rails active_storage:install` for uploads and '
+        say '`bin/rails action_text:install` for rich descriptions.\n'
+      end
+
+      private
+
+      def migration_version
+        "[#{ActiveRecord::VERSION::MAJOR}.#{ActiveRecord::VERSION::MINOR}]"
+      end
+    end
+  end
+end

data/lib/generators/product_tours/install/templates/create_product_tours_posts.rb.tt

@@ -0,0 +1,29 @@
+# frozen_string_literal: true
+
+class CreateProductToursPosts < ActiveRecord::Migration<%= migration_version %>
+  def change
+    create_table :product_tours_posts do |t|
+      t.string :key, null: false
+      t.string :locale, null: false
+      t.string :status, null: false, default: "draft"
+      t.string :title, null: false
+      t.text :video_url
+      t.json :video_metadata, null: false, default: {}
+      t.string :action_label
+      t.text :action_url
+      t.string :action_post_key
+
+      t.timestamps
+    end
+
+    add_index :product_tours_posts, %i[locale key], unique: true
+    add_index :product_tours_posts, :locale
+    add_index :product_tours_posts, :status
+
+    reversible do |direction|
+      direction.up do
+        ProductTours::Seeds.load_for_install!
+      end
+    end
+  end
+end

data/lib/generators/product_tours/install/templates/initializer.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+ProductTours.configure do |config|
+  # Who can see and invoke product tours. Defaults to everyone.
+  # config.enabled = ->(request) { true }
+
+  # Who can manage tutorials at the mount path. Defaults to development only.
+  # config.authorize_admin = ->(request) { request.env["warden"]&.user&.admin? }
+
+  # Render the dashboard in your own admin shell.
+  # config.admin_layout = "admin/application"
+
+  # Tutorials resolve in the page's current I18n.locale and fall back to
+  # I18n.default_locale when no translation exists.
+
+  # Optional dedicated Active Storage service for uploaded videos.
+  # config.storage_service = :product_tours
+
+  # Keep this in sync only when mounting the engine manually.
+  # config.mount_path = "/product_tours"
+end

data/lib/product_tours/configuration.rb

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+
+module ProductTours
+  class Configuration
+    attr_accessor :enabled, :authorize_admin, :admin_layout, :mount_path,
+                  :storage_service
+
+    def initialize
+      @enabled = ->(_request) { true }
+      @authorize_admin = ->(_request) { Rails.env.development? }
+      @admin_layout = 'product_tours/application'
+      @mount_path = '/product_tours'
+      @storage_service = nil
+    end
+
+    def widget_endpoint = "#{mount_path.to_s.chomp('/')}/widget"
+  end
+end

data/lib/product_tours/content_security_policy.rb

@@ -0,0 +1,24 @@
+# frozen_string_literal: true
+
+module ProductTours
+  module ContentSecurityPolicy
+    FRAME_SOURCES = %w[
+      https://www.youtube-nocookie.com
+      https://player.vimeo.com
+      https://www.loom.com
+      https://www.tella.tv
+      https://embed.voomly.com
+    ].freeze
+
+    module_function
+
+    def apply!(policy)
+      return unless policy
+
+      sources = Array(policy.directives['frame-src'])
+      sources = Array(policy.directives['default-src']) if sources.empty?
+      sources = sources.reject { |source| source == "'none'" }
+      policy.frame_src(*(sources + FRAME_SOURCES).uniq)
+    end
+  end
+end