rails-image-post-solution 0.1.26 → 0.1.27

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 21cf30ddd082d430c2fa3970e75b3de50d6cb2971b31a9e01e0e20cca46fc1fb
-  data.tar.gz: 1efb01401bde8a221233fab8b32d27f8fb97314e3e7c61e5ca9e184d98af356d
+  metadata.gz: bc9e3914820aa23b6ad617eed7f8c27e3be5a62957861beeafab4e646bf76717
+  data.tar.gz: 7ffe366b6d5c1863c949949d718a73efe76b7a776e8bc8e26db4dcf4b0b58f58
 SHA512:
-  metadata.gz: e18c577fab39605d71b399f97663ebed7add09bbf101f57c1e2ad43b72a2641e85ea63bc1841f52e7fb90d8db49d72f85e8421951c169db65629db3571e129c6
-  data.tar.gz: 19835241b9c1651a7aec885a0bc721558c7ce0cd42bda78f045f32a84894e28968e8dbe62b9117835dda3e2a65b15e40f9eec88fc98403150c1b9c3aa3ec2ed3
+  metadata.gz: 5fe7e0e0bb33daf2713a5dbd8a15c112afce7e9b03e1bb6935cc3047a1e268ef2c0776c651defd78867e8042d5dd3889fee556fb1aa84cc95a9b98f3cdfcb788
+  data.tar.gz: 6694496e85862431e4e18e7ed97da31b3e5b6a0f03d8a1067c5d46c8c41ca4ec7c4989375580c85ce8d9d866afcabdd1be9b089bd781d99930858e20afc1649e

data/README.md

@@ -20,6 +20,11 @@ A comprehensive Rails engine for image reporting, AI-powered moderation using Op
 - **Frozen Posts Management**: Review, unfreeze, or permanently freeze flagged content
 - **Enhanced Reporting**: Extended admin views with detailed statistics
 
+### Internationalization
+- **Full i18n Support**: Seamlessly integrates with locale-scoped routes
+- **15+ Languages**: Supports ja, en, ko, zh-CN, zh-TW, es, fr, de, ru, th, vi, id, pt, tr, it
+- **Automatic Locale Handling**: Works with your application's locale configuration
+
 ## Requirements
 
 - Ruby >= 3.4.7
@@ -60,6 +65,22 @@ rails db:migrate
 
 Mount the engine in your `config/routes.rb`:
 
+**For applications WITH locale-scoped routes:**
+
+```ruby
+Rails.application.routes.draw do
+  # Wrap all routes including the engine mount in a locale scope
+  scope "(:locale)", locale: /[a-z]{2}(-[A-Z]{2})?/ do
+    # Mount the engine - all admin features will be accessible at /:locale/moderation/admin/*
+    mount RailsImagePostSolution::Engine => "/moderation"
+
+    # ... your other routes
+  end
+end
+```
+
+**For applications WITHOUT locale-scoped routes:**
+
 ```ruby
 Rails.application.routes.draw do
   # Mount the engine - all admin features will be accessible at /moderation/admin/*
@@ -69,6 +90,8 @@ Rails.application.routes.draw do
 end
 ```
 
+**Important**: The engine itself does NOT add locale scoping to its internal routes. Locale handling should be done at the mount level in the host application's routes file.
+
 ## Configuration
 
 Edit `config/initializers/rails_image_post_solution.rb`:
@@ -140,7 +163,14 @@ The provided partials include:
 Admins can access the dashboard at:
 
 ```
+# Without locale
 /moderation/admin/image_reports
+
+# With locale (if using locale-scoped routes)
+/ja/moderation/admin/image_reports
+/en/moderation/admin/image_reports
+/de/moderation/admin/image_reports
+# ... etc
 ```
 
 Features:
@@ -149,6 +179,7 @@ Features:
 - View detailed information about each report
 - Mark reports as confirmed (inappropriate) or dismissed (safe)
 - View AI moderation results
+- Multi-language support (automatically uses your application's current locale)
 
 ### AI Moderation
 
@@ -300,46 +331,129 @@ The engine provides the following routes when mounted at `/moderation`:
 
 ### Using Route Helpers
 
-The engine automatically makes route helpers available in your application. You can use them directly:
+The engine automatically makes route helpers available in your application:
 
+**In host application views/controllers** (accessing host app routes):
 ```ruby
-# In your views or controllers
-admin_image_reports_path          # => /moderation/admin/image_reports
-admin_user_path(@user)             # => /moderation/admin/users/:id
-image_reports_path                 # => /moderation/image_reports
+# Use main_app prefix to access host application routes
+main_app.root_path(locale: I18n.locale)           # => /ja/
+main_app.stages_path(locale: I18n.locale)         # => /ja/stages
+main_app.user_path(@user, locale: I18n.locale)   # => /ja/users/:id
+```
 
-# Or use the engine namespace explicitly
-rails_image_post_solution.admin_image_reports_path
+**Accessing engine routes from host application:**
+```ruby
+# Use engine namespace
+rails_image_post_solution.admin_image_reports_path    # => /moderation/admin/image_reports (or /ja/moderation/admin/image_reports)
+rails_image_post_solution.admin_user_path(@user)      # => /moderation/admin/users/:id
+rails_image_post_solution.image_reports_path          # => /moderation/image_reports
+
+# In locale-scoped applications, locale is automatically included via mount point
+```
+
+**In engine views/controllers:**
+```ruby
+# Engine routes (no prefix needed within engine)
+admin_image_reports_path                    # => /admin/image_reports
+admin_user_path(id: @user.id)              # => /admin/users/:id
+
+# Host app routes (use main_app prefix)
+main_app.root_path(locale: I18n.locale)    # => /ja/
 ```
 
 ### User-Facing Routes
 
 ```
-POST   /moderation/image_reports                        # Create report
+POST   (/:locale)/moderation/image_reports                        # Create report
 ```
 
 ### Admin Routes
 
+**Image Reports:**
+```
+GET    (/:locale)/moderation/admin/image_reports                  # List all reports
+GET    (/:locale)/moderation/admin/image_reports/:id              # View report details
+PATCH  (/:locale)/moderation/admin/image_reports/:id/confirm      # Mark as inappropriate
+PATCH  (/:locale)/moderation/admin/image_reports/:id/dismiss      # Mark as safe
+```
+
+**User Management:**
+```
+GET    (/:locale)/moderation/admin/users                          # List all users
+GET    (/:locale)/moderation/admin/users/:id                      # View user details
+POST   (/:locale)/moderation/admin/users/:id/suspend              # Suspend user
+POST   (/:locale)/moderation/admin/users/:id/unsuspend            # Unsuspend user
+POST   (/:locale)/moderation/admin/users/:id/ban                  # Ban user
+POST   (/:locale)/moderation/admin/users/:id/unban                # Unban user
+```
+
+**Frozen Posts:**
 ```
-GET    /moderation/admin/image_reports                  # List all reports
-GET    /moderation/admin/image_reports/:id              # View report details
-PATCH  /moderation/admin/image_reports/:id/confirm      # Mark as inappropriate
-PATCH  /moderation/admin/image_reports/:id/dismiss      # Mark as safe
-GET    /moderation/admin/users                          # List all users
-GET    /moderation/admin/users/:id                      # View user details
-POST   /moderation/admin/users/:id/suspend              # Suspend user
-POST   /moderation/admin/users/:id/unsuspend            # Unsuspend user
-POST   /moderation/admin/users/:id/ban                  # Ban user
-POST   /moderation/admin/users/:id/unban                # Unban user
-GET    /moderation/admin/frozen_posts                   # List frozen posts
-POST   /moderation/admin/frozen_posts/unfreeze_stage/:id           # Unfreeze a stage
-POST   /moderation/admin/frozen_posts/unfreeze_comment/:id         # Unfreeze a comment
-POST   /moderation/admin/frozen_posts/permanent_freeze_stage/:id   # Permanently freeze a stage
-POST   /moderation/admin/frozen_posts/permanent_freeze_comment/:id # Permanently freeze a comment
-DELETE /moderation/admin/frozen_posts/destroy_stage/:id            # Delete a frozen stage
-DELETE /moderation/admin/frozen_posts/destroy_comment/:id          # Delete a frozen comment
+GET    (/:locale)/moderation/admin/frozen_posts                                  # List frozen posts
+POST   (/:locale)/moderation/admin/frozen_posts/unfreeze_stage/:id              # Unfreeze a stage
+POST   (/:locale)/moderation/admin/frozen_posts/unfreeze_comment/:id            # Unfreeze a comment
+POST   (/:locale)/moderation/admin/frozen_posts/permanent_freeze_stage/:id      # Permanently freeze a stage
+POST   (/:locale)/moderation/admin/frozen_posts/permanent_freeze_comment/:id    # Permanently freeze a comment
+DELETE (/:locale)/moderation/admin/frozen_posts/destroy_stage/:id               # Delete a frozen stage
+DELETE (/:locale)/moderation/admin/frozen_posts/destroy_comment/:id             # Delete a frozen comment
 ```
 
+Note: `(/:locale)` means the locale parameter is optional and depends on your application's routing configuration.
+
+## Internationalization (i18n)
+
+### Supported Languages
+
+The engine includes translations for 15 languages:
+- 🇯🇵 Japanese (ja)
+- 🇺🇸 English (en)
+- 🇰🇷 Korean (ko)
+- 🇨🇳 Simplified Chinese (zh-CN)
+- 🇹🇼 Traditional Chinese (zh-TW)
+- 🇪🇸 Spanish (es)
+- 🇫🇷 French (fr)
+- 🇩🇪 German (de)
+- 🇷🇺 Russian (ru)
+- 🇹🇭 Thai (th)
+- 🇻🇳 Vietnamese (vi)
+- 🇮🇩 Indonesian (id)
+- 🇵🇹 Portuguese (pt)
+- 🇹🇷 Turkish (tr)
+- 🇮🇹 Italian (it)
+
+### Locale Configuration
+
+The engine automatically uses your application's `I18n.locale`. To configure available locales in your host application:
+
+```ruby
+# config/application.rb
+config.i18n.available_locales = [:ja, :en, :ko, :zh_CN, :zh_TW, :es, :fr, :de, :ru, :th, :vi, :id, :pt, :tr, :it]
+config.i18n.default_locale = :ja
+```
+
+### Language Switching in Views
+
+When implementing language switching in your application header, use this pattern to preserve the current path with different locales:
+
+```erb
+<% I18n.available_locales.each do |locale| %>
+  <%
+    # Preserve query parameters but replace locale in the path
+    new_path = request.path.sub(%r{^/([a-z]{2}(-[A-Z]{2})?)(/|$)}, "/#{locale}\\3")
+
+    # If path doesn't start with a locale, add one
+    unless request.path.match?(%r{^/[a-z]{2}(-[A-Z]{2})?(/|$)})
+      new_path = "/#{locale}#{request.path}"
+    end
+
+    new_path += "?#{request.query_string}" if request.query_string.present?
+  %>
+  <%= link_to t("languages.#{locale}"), new_path, class: "language-menu-item #{'active' if I18n.locale == locale}" %>
+<% end %>
+```
+
+This ensures that users can switch languages while staying on the same page, whether they're in the host application or the engine's admin pages.
+
 ## Customization
 
 ### Custom Admin Check
@@ -373,6 +487,25 @@ class CustomImageModerationJob < RailsImagePostSolution::ImageModerationJob
 end
 ```
 
+### Custom Locale Management
+
+The engine respects your application's locale configuration. If you need custom locale handling:
+
+```ruby
+# app/controllers/application_controller.rb
+class ApplicationController < ActionController::Base
+  before_action :set_locale
+
+  def set_locale
+    I18n.locale = params[:locale] || I18n.default_locale
+  end
+
+  def default_url_options
+    { locale: I18n.locale }
+  end
+end
+```
+
 ## Database Schema
 
 The gem creates one table: `image_reports`

data/app/views/rails_image_post_solution/admin/frozen_posts/index.html.erb

@@ -19,9 +19,9 @@
 
   <!-- Filters -->
   <div class="admin-filters">
-    <%= link_to t('admin.frozen_posts.index.filters.all'), admin_frozen_posts_path, class: "filter-btn #{'active' if @filter == 'all'}" %>
-    <%= link_to t('admin.frozen_posts.index.filters.temporary'), admin_frozen_posts_path(filter: "temporary"), class: "filter-btn #{'active' if @filter == 'temporary'}" %>
-    <%= link_to t('admin.frozen_posts.index.filters.permanent'), admin_frozen_posts_path(filter: "permanent"), class: "filter-btn #{'active' if @filter == 'permanent'}" %>
+    <%= link_to t('admin.frozen_posts.index.filters.all'), rails_image_post_solution.admin_frozen_posts_path, class: "filter-btn #{'active' if @filter == 'all'}" %>
+    <%= link_to t('admin.frozen_posts.index.filters.temporary'), rails_image_post_solution.admin_frozen_posts_path(filter: "temporary"), class: "filter-btn #{'active' if @filter == 'temporary'}" %>
+    <%= link_to t('admin.frozen_posts.index.filters.permanent'), rails_image_post_solution.admin_frozen_posts_path(filter: "permanent"), class: "filter-btn #{'active' if @filter == 'permanent'}" %>
   </div>
 
   <!-- Frozen Posts List -->
@@ -29,90 +29,90 @@
     <% if @frozen_posts.any? %>
       <table class="admin-table">
         <thead>
-          <tr>
-            <th><%= t('admin.frozen_posts.index.table.type') %></th>
-            <th><%= t('admin.frozen_posts.index.table.content') %></th>
-            <th><%= t('admin.frozen_posts.index.table.poster') %></th>
-            <th><%= t('admin.frozen_posts.index.table.freeze_reason') %></th>
-            <th><%= t('admin.frozen_posts.index.table.status') %></th>
-            <th><%= t('admin.frozen_posts.index.table.frozen_at') %></th>
-            <th><%= t('admin.frozen_posts.index.table.actions') %></th>
-          </tr>
+        <tr>
+          <th><%= t('admin.frozen_posts.index.table.type') %></th>
+          <th><%= t('admin.frozen_posts.index.table.content') %></th>
+          <th><%= t('admin.frozen_posts.index.table.poster') %></th>
+          <th><%= t('admin.frozen_posts.index.table.freeze_reason') %></th>
+          <th><%= t('admin.frozen_posts.index.table.status') %></th>
+          <th><%= t('admin.frozen_posts.index.table.frozen_at') %></th>
+          <th><%= t('admin.frozen_posts.index.table.actions') %></th>
+        </tr>
         </thead>
         <tbody>
-          <% @frozen_posts.each do |post| %>
-            <tr class="report-row status-<%= post.frozen_type %>">
-              <td>
-                <% if post.is_a?(Stage) %>
-                  <span class="post-type-badge stage"><%= t('admin.frozen_posts.index.post_types.stage') %></span>
-                <% else %>
-                  <span class="post-type-badge comment"><%= t('admin.frozen_posts.index.post_types.comment') %></span>
-                <% end %>
-              </td>
-              <td class="content-cell">
+        <% @frozen_posts.each do |post| %>
+          <tr class="report-row status-<%= post.frozen_type %>">
+            <td>
+              <% if post.is_a?(Stage) %>
+                <span class="post-type-badge stage"><%= t('admin.frozen_posts.index.post_types.stage') %></span>
+              <% else %>
+                <span class="post-type-badge comment"><%= t('admin.frozen_posts.index.post_types.comment') %></span>
+              <% end %>
+            </td>
+            <td class="content-cell">
+              <% if post.is_a?(Stage) %>
+                <div class="post-title"><%= link_to post.title, stage_path(post, locale: I18n.locale), target: "_blank", class: "user-link" %></div>
+                <div class="post-excerpt"><%= truncate(post.description, length: 80) %></div>
+              <% else %>
+                <div class="post-title">
+                  <%= link_to "#{t('admin.frozen_posts.index.comment_prefix')}: #{post.multiplay_recruitment.title}", multiplay_recruitment_path(post.multiplay_recruitment, locale: I18n.locale), target: "_blank", class: "user-link" %>
+                </div>
+                <div class="post-excerpt"><%= truncate(post.content, length: 80) %></div>
+              <% end %>
+            </td>
+            <td>
+              <%= link_to post.user.display_name, rails_image_post_solution.admin_user_path(id: post.user.id), class: "user-link" %>
+            </td>
+            <td class="reason-cell">
+              <%= truncate(post.frozen_reason, length: 100) %>
+            </td>
+            <td>
+              <% if post.temporarily_frozen? %>
+                <span class="status-badge status-pending"><%= t('admin.frozen_posts.index.status_badges.temporary') %></span>
+              <% elsif post.permanently_frozen? %>
+                <span class="status-badge status-confirmed"><%= t('admin.frozen_posts.index.status_badges.permanent') %></span>
+              <% end %>
+            </td>
+            <td>
+              <%= l(post.frozen_at, format: :long) %>
+            </td>
+            <td class="actions-cell">
+              <div class="action-buttons">
                 <% if post.is_a?(Stage) %>
-                  <div class="post-title"><%= link_to post.title, stage_path(post), target: "_blank", class: "user-link" %></div>
-                  <div class="post-excerpt"><%= truncate(post.description, length: 80) %></div>
+                  <% unless post.permanently_frozen? %>
+                    <%= button_to t('admin.frozen_posts.index.actions.permanent_freeze'), rails_image_post_solution.permanent_freeze_stage_admin_frozen_posts_path(id: post.id),
+                                  method: :post,
+                                  class: "btn-action btn-warning",
+                                  data: { confirm: t('admin.frozen_posts.index.confirm.permanent_freeze') } %>
+                  <% end %>
+                  <%= button_to t('admin.frozen_posts.index.actions.unfreeze'), rails_image_post_solution.unfreeze_stage_admin_frozen_posts_path(id: post.id),
+                                method: :post,
+                                class: "btn-action btn-success",
+                                data: { confirm: t('admin.frozen_posts.index.confirm.unfreeze') } %>
+                  <%= button_to t('admin.frozen_posts.index.actions.delete'), rails_image_post_solution.destroy_stage_admin_frozen_posts_path(id: post.id),
+                                method: :delete,
+                                class: "btn-action btn-danger",
+                                data: { confirm: t('admin.frozen_posts.index.confirm.delete') } %>
                 <% else %>
-                  <div class="post-title">
-                    <%= link_to "#{t('admin.frozen_posts.index.comment_prefix')}: #{post.multiplay_recruitment.title}", multiplay_recruitment_path(post.multiplay_recruitment), target: "_blank", class: "user-link" %>
-                  </div>
-                  <div class="post-excerpt"><%= truncate(post.content, length: 80) %></div>
-                <% end %>
-              </td>
-              <td>
-                <%= link_to post.user.display_name, admin_user_path(id: post.user.id), class: "user-link" %>
-              </td>
-              <td class="reason-cell">
-                <%= truncate(post.frozen_reason, length: 100) %>
-              </td>
-              <td>
-                <% if post.temporarily_frozen? %>
-                  <span class="status-badge status-pending"><%= t('admin.frozen_posts.index.status_badges.temporary') %></span>
-                <% elsif post.permanently_frozen? %>
-                  <span class="status-badge status-confirmed"><%= t('admin.frozen_posts.index.status_badges.permanent') %></span>
-                <% end %>
-              </td>
-              <td>
-                <%= l(post.frozen_at, format: :long) %>
-              </td>
-              <td class="actions-cell">
-                <div class="action-buttons">
-                  <% if post.is_a?(Stage) %>
-                    <% unless post.permanently_frozen? %>
-                      <%= button_to t('admin.frozen_posts.index.actions.permanent_freeze'), admin_frozen_posts_permanent_freeze_stage_path(id: post.id),
-                          method: :patch,
-                          class: "btn-action btn-warning",
-                          data: { confirm: t('admin.frozen_posts.index.confirm.permanent_freeze') } %>
-                    <% end %>
-                    <%= button_to t('admin.frozen_posts.index.actions.unfreeze'), admin_frozen_posts_unfreeze_stage_path(id: post.id),
-                        method: :patch,
-                        class: "btn-action btn-success",
-                        data: { confirm: t('admin.frozen_posts.index.confirm.unfreeze') } %>
-                    <%= button_to t('admin.frozen_posts.index.actions.delete'), admin_frozen_posts_destroy_stage_path(id: post.id),
-                        method: :delete,
-                        class: "btn-action btn-danger",
-                        data: { confirm: t('admin.frozen_posts.index.confirm.delete') } %>
-                  <% else %>
-                    <% unless post.permanently_frozen? %>
-                      <%= button_to t('admin.frozen_posts.index.actions.permanent_freeze'), admin_frozen_posts_permanent_freeze_comment_path(id: post.id),
-                          method: :patch,
-                          class: "btn-action btn-warning",
-                          data: { confirm: t('admin.frozen_posts.index.confirm.permanent_freeze') } %>
-                    <% end %>
-                    <%= button_to t('admin.frozen_posts.index.actions.unfreeze'), admin_frozen_posts_unfreeze_comment_path(id: post.id),
-                        method: :patch,
-                        class: "btn-action btn-success",
-                        data: { confirm: t('admin.frozen_posts.index.confirm.unfreeze') } %>
-                    <%= button_to t('admin.frozen_posts.index.actions.delete'), admin_frozen_posts_destroy_comment_path(id: post.id),
-                        method: :delete,
-                        class: "btn-action btn-danger",
-                        data: { confirm: t('admin.frozen_posts.index.confirm.delete') } %>
+                  <% unless post.permanently_frozen? %>
+                    <%= button_to t('admin.frozen_posts.index.actions.permanent_freeze'), rails_image_post_solution.permanent_freeze_comment_admin_frozen_posts_path(id: post.id),
+                                  method: :post,
+                                  class: "btn-action btn-warning",
+                                  data: { confirm: t('admin.frozen_posts.index.confirm.permanent_freeze') } %>
                   <% end %>
-                </div>
-              </td>
-            </tr>
-          <% end %>
+                  <%= button_to t('admin.frozen_posts.index.actions.unfreeze'), rails_image_post_solution.unfreeze_comment_admin_frozen_posts_path(id: post.id),
+                                method: :post,
+                                class: "btn-action btn-success",
+                                data: { confirm: t('admin.frozen_posts.index.confirm.unfreeze') } %>
+                  <%= button_to t('admin.frozen_posts.index.actions.delete'), rails_image_post_solution.destroy_comment_admin_frozen_posts_path(id: post.id),
+                                method: :delete,
+                                class: "btn-action btn-danger",
+                                data: { confirm: t('admin.frozen_posts.index.confirm.delete') } %>
+                <% end %>
+              </div>
+            </td>
+          </tr>
+        <% end %>
         </tbody>
       </table>
     <% else %>
@@ -123,6 +123,6 @@
   </div>
 
   <div class="admin-actions">
-    <%= link_to t('admin.frozen_posts.index.back'), root_path, class: "btn btn-secondary" %>
+    <%= link_to t('admin.frozen_posts.index.back'), main_app.root_path(locale: I18n.locale), class: "btn btn-secondary" %>
   </div>
 </div>

data/lib/rails_image_post_solution/engine.rb

@@ -14,10 +14,15 @@ module RailsImagePostSolution
       #{root}/app/controllers
     ]
 
-    # Prepend view paths so engine views are found
-    initializer "rails_image_post_solution.view_paths" do
+    # Prepend view paths so engine views are found from host app
+    initializer "rails_image_post_solution.view_paths", before: :load_config_initializers do |app|
+      # Add engine views to all view paths
       ActiveSupport.on_load(:action_controller) do
-        prepend_view_path Engine.root.join("app", "views")
+        append_view_path RailsImagePostSolution::Engine.root.join("app", "views")
+      end
+
+      ActiveSupport.on_load(:action_view) do
+        ActionView::Base.prepend_view_path RailsImagePostSolution::Engine.root.join("app", "views")
       end
     end
 

data/lib/rails_image_post_solution/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module RailsImagePostSolution
-  VERSION = "0.1.26"
+  VERSION = "0.1.27"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: rails-image-post-solution
 version: !ruby/object:Gem::Version
-  version: 0.1.26
+  version: 0.1.27
 platform: ruby
 authors:
 - dhq_boiler