postnhost 0.0.0 → 0.1.0

data/app/helpers/postnhost/common_css_helper.rb

@@ -0,0 +1,97 @@
+module Postnhost
+  module CommonCssHelper
+    def icon(name, css_class: "w-4 h-4", subfolder: nil)
+      path_parts = %w[app assets images postnhost icons]
+      path_parts << subfolder if subfolder
+      path_parts << "#{name}.svg"
+
+      file_path = Postnhost::Engine.root.join(*path_parts)
+      svg_content = File.read(file_path)
+      svg_content.sub("<svg", "<svg class=\"#{css_class}\" aria-hidden=\"true\"").html_safe
+    end
+
+    # Button class helpers
+    def button_classes(variant: :primary, disabled: false)
+      base = "inline-flex items-center justify-center font-medium rounded-xl transition-all duration-200 text-sm focus:outline-none focus:ring-2 focus:ring-offset-2 px-4 py-2"
+
+      variant_classes = case variant
+                        when :secondary
+                          "bg-white text-gray-700 hover:bg-gray-50 border border-gray-200 focus:ring-gray-500"
+                        when :danger
+                          "bg-red-50 text-red-700 hover:bg-red-100 focus:ring-red-500"
+                        else
+                          "bg-gray-900 text-white hover:bg-gray-800 focus:ring-gray-900"
+                        end
+
+      disabled_classes = disabled ? "opacity-50 cursor-not-allowed" : "cursor-pointer"
+
+      "#{base} #{variant_classes} #{disabled_classes}"
+    end
+
+    def icon_button_classes(variant: :default)
+      base = "text-gray-400 transition-colors"
+
+      hover_classes = case variant
+                      when :danger then "hover:text-red-600"
+                      else "hover:text-gray-600"
+                      end
+
+      "#{base} #{hover_classes}"
+    end
+
+    def page_header_classes
+      "flex flex-col space-y-4 md:flex-row md:items-center md:justify-between md:space-y-0"
+    end
+
+    def form_card_classes
+      "bg-white rounded-2xl border border-gray-200 p-6 space-y-6"
+    end
+
+    def error_container_classes
+      "bg-red-50 border border-red-200 rounded-lg p-4"
+    end
+
+    def table_row_classes
+      "px-6 py-4 hover:bg-gray-50 transition-colors duration-200"
+    end
+
+    def stats_badge_classes(variant: :blue)
+      base = "items-center px-2.5 py-0.5 rounded-full text-xs font-medium"
+
+      color_classes = case variant
+                      when :purple then "bg-purple-100 text-purple-800"
+                      when :green then "bg-green-100 text-green-800"
+                      when :gray then "bg-gray-100 text-gray-800"
+                      else "bg-blue-100 text-blue-800"
+                      end
+
+      "#{base} #{color_classes}"
+    end
+
+    def editor_button_classes(variant: :secondary)
+      base = "w-full py-2.5 px-4 rounded-xl focus:outline-none focus:ring-2 focus:ring-offset-2 transition duration-200 text-sm font-medium text-center block"
+
+      variant_classes = case variant
+                        when :primary
+                          "bg-green-600 text-white hover:bg-green-700 focus:ring-green-600"
+                        else
+                          "bg-white border border-gray-300 text-gray-700 hover:bg-gray-50 focus:ring-gray-900 cursor-pointer"
+                        end
+
+      "#{base} #{variant_classes}"
+    end
+
+    # Form field class helpers
+    def form_label_classes
+      "block text-sm font-medium text-gray-700 mb-2"
+    end
+
+    def form_input_classes
+      "block w-full rounded-xl border-gray-200 bg-gray-50 px-4 py-3 text-sm font-medium text-gray-900 transition-all duration-200 focus:border-gray-900 focus:bg-white focus:ring-0"
+    end
+
+    def form_textarea_classes
+      "block w-full rounded-xl border-gray-200 bg-gray-50 px-4 py-3 text-sm font-medium text-gray-900 transition-all duration-200 focus:border-gray-900 focus:bg-white focus:ring-0"
+    end
+  end
+end

data/app/helpers/postnhost/navigation_helper.rb

@@ -0,0 +1,148 @@
+module Postnhost
+  module NavigationHelper
+    def navigation_label(item)
+      return if item.blank?
+
+      @navigation_label_cache ||= {}
+      cache_key = navigation_item_cache_key(item)
+      return @navigation_label_cache[cache_key] if @navigation_label_cache.key?(cache_key)
+
+      @navigation_label_cache[cache_key] =
+        item.label_for(locale_key: @current_language&.html_lang, default_locale_key: default_navigation_locale_key).presence ||
+        navigation_target_label(item)
+    end
+
+    def navigation_href(item)
+      return if item.blank? || item.kind != "link"
+
+      @navigation_href_cache ||= {}
+      cache_key = navigation_item_cache_key(item)
+      return @navigation_href_cache[cache_key] if @navigation_href_cache.key?(cache_key)
+
+      @navigation_href_cache[cache_key] = resolve_navigation_href(item)
+    end
+
+    def navigation_link_options(item)
+      return {} unless item.target_kind == "external"
+
+      rel_value = item.nofollow ? "noopener noreferrer nofollow" : "noopener noreferrer"
+      { target: "_blank", rel: rel_value }
+    end
+
+    def default_navigation_locale_key
+      @default_navigation_locale_key ||= @default_language&.html_lang || I18n.default_locale.to_s
+    end
+
+    private
+
+    def resolve_navigation_href(item)
+      case item.target_kind
+      when "article"
+        article = navigation_target(item)
+        return unless article
+
+        if localized_navigation?
+          variant = navigation_variant(article)
+          return postnhost.localized_public_article_path(@current_language.html_lang, article.slug) if variant.present?
+        end
+
+        postnhost.public_article_path(article.slug)
+      when "page"
+        page = navigation_target(item)
+        return unless page
+
+        if localized_navigation?
+          variant = navigation_variant(page)
+          return postnhost.localized_public_static_page_path(locale: @current_language.html_lang, slug: page.slug) if variant.present?
+        end
+
+        postnhost.public_static_page_path(slug: page.slug)
+      when "category"
+        category = navigation_target(item)
+        return if category.blank?
+
+        language_category_path(category.slug, @current_language)
+      when "static_page"
+        language_static_page_path(item.target_slug, @current_language)
+      when "external"
+        item.url
+      when "text"
+        nil
+      end
+    end
+
+    def navigation_target_label(item)
+      @navigation_target_label_cache ||= {}
+      cache_key = navigation_target_cache_key(item)
+      return @navigation_target_label_cache[cache_key] if @navigation_target_label_cache.key?(cache_key)
+
+      @navigation_target_label_cache[cache_key] = resolve_navigation_target_label(item)
+    end
+
+    def resolve_navigation_target_label(item)
+      case item.target_kind
+      when "article"
+        article = navigation_target(item)
+        return if article.blank?
+
+        if localized_navigation?
+          variant = navigation_variant(article)
+          return variant.title if variant.present?
+        end
+
+        article.title
+      when "page"
+        page = navigation_target(item)
+        return if page.blank?
+
+        if localized_navigation?
+          variant = navigation_variant(page)
+          return variant.title if variant.present?
+        end
+
+        page.title
+      when "category"
+        category = navigation_target(item)
+        category.present? ? localized_category_name(category, @current_language) : nil
+      when "static_page"
+        item.target_slug.to_s.tr("_-", " ").humanize
+      when "external"
+        item.url
+      when "text"
+        nil
+      end
+    end
+
+    def navigation_target(item)
+      @navigation_target_cache.fetch(item.target_kind, {})[item.target_id]
+    end
+
+    def navigation_variant(record)
+      case record
+      when Postnhost::Snapshot::Article
+        @navigation_variant_cache.fetch(record.class.name, {})[record.article_id]
+      when Postnhost::Snapshot::Page
+        @navigation_variant_cache.fetch(record.class.name, {})[record.page_id]
+      end
+    end
+
+    def navigation_item_cache_key(item)
+      [item.id || item.object_id, @current_language&.id, @current_language&.html_lang]
+    end
+
+    def navigation_target_cache_key(item)
+      [
+        item.target_kind,
+        item.target_id,
+        item.target_slug,
+        item.url,
+        @current_language&.id,
+        @current_language&.html_lang
+      ]
+    end
+
+    def localized_navigation?
+      @current_language.present? && !@current_language.default?
+    end
+  end
+end

data/app/helpers/postnhost/pagy_helper.rb

@@ -0,0 +1,103 @@
+module Postnhost
+  module PagyHelper
+    DEFAULT_PAGINATION_SLOTS = 7
+
+    def pagination_nav(pagy)
+      return "".html_safe if pagy.pages <= 1
+
+      content_tag(:nav,
+                  class: "flex items-center justify-center space-x-2",
+                  aria: { label: I18n.t("postnhost.public.pagination.navigation", default: "Pagination") }) do
+        safe_join(
+          [
+            pagination_previous_link(pagy),
+            *pagination_series_fragments(pagy),
+            pagination_next_link(pagy)
+          ],
+          ""
+        )
+      end
+    end
+
+    # Keep first pages canonical while preserving unrelated query parameters.
+    def pagination_url(pagy, page)
+      pagy.page_url(page == 1 ? :first : page)
+    end
+
+    def pagination_series(pagy)
+      slots = pagy.options.fetch(:slots, DEFAULT_PAGINATION_SLOTS)
+      return [] if slots.zero?
+      return (1..pagy.pages).to_a if slots >= pagy.pages
+
+      half = (slots - 1) / 2
+      start = if pagy.page <= half
+                1
+              elsif pagy.page > pagy.pages - slots + half
+                pagy.pages - slots + 1
+              else
+                pagy.page - half
+              end
+
+      (start...(start + slots)).to_a.tap do |series|
+        next if pagy.options[:compact] || slots < DEFAULT_PAGINATION_SLOTS
+
+        series[0] = 1
+        series[1] = :gap unless series[1] == 2
+        series[-2] = :gap unless series[-2] == pagy.pages - 1
+        series[-1] = pagy.pages
+      end
+    end
+
+    private
+
+    def pagination_previous_link(pagy)
+      label = I18n.t("postnhost.public.pagination.previous")
+      enabled_classes = "inline-flex items-center justify-center p-2 text-sm font-medium text-gray-500 bg-white border border-gray-300 rounded-lg hover:bg-gray-50 hover:text-gray-700 cursor-pointer"
+      disabled_classes = "inline-flex items-center justify-center p-2 text-sm font-medium text-gray-600 bg-gray-100 border border-gray-200 rounded-lg cursor-not-allowed opacity-50"
+
+      if pagy.previous
+        link_to(pagination_url(pagy, pagy.previous), class: enabled_classes, aria: { label: label }) do
+          icon("chevron-left", css_class: "h-5 w-5")
+        end
+      else
+        tag.span(icon("chevron-left", css_class: "h-5 w-5"),
+                 class: disabled_classes,
+                 aria: { label: label, disabled: true })
+      end
+    end
+
+    def pagination_next_link(pagy)
+      label = I18n.t("postnhost.public.pagination.next")
+      enabled_classes = "inline-flex items-center justify-center p-2 text-sm font-medium text-gray-500 bg-white border border-gray-300 rounded-lg hover:bg-gray-50 hover:text-gray-700 cursor-pointer"
+      disabled_classes = "inline-flex items-center justify-center p-2 text-sm font-medium text-gray-600 bg-gray-100 border border-gray-200 rounded-lg cursor-not-allowed opacity-50"
+
+      if pagy.next
+        link_to(pagination_url(pagy, pagy.next), class: enabled_classes, aria: { label: label }) do
+          icon("chevron-right", css_class: "h-5 w-5")
+        end
+      else
+        tag.span(icon("chevron-right", css_class: "h-5 w-5"),
+                 class: disabled_classes,
+                 aria: { label: label, disabled: true })
+      end
+    end
+
+    def pagination_series_fragments(pagy)
+      pagination_series(pagy).filter_map do |item|
+        case item
+        when Integer
+          if item == pagy.page
+            tag.span(item,
+                     class: "px-3 py-2 text-sm font-medium text-white bg-gray-900 border border-gray-900 rounded-lg",
+                     aria: { current: "page" })
+          else
+            link_to(item, pagination_url(pagy, item),
+                    class: "px-3 py-2 text-sm font-medium text-gray-500 bg-white border border-gray-300 rounded-lg hover:bg-gray-50 hover:text-gray-700 cursor-pointer")
+          end
+        when :gap
+          tag.span("…", class: "px-3 py-2 text-sm font-medium text-gray-300")
+        end
+      end
+    end
+  end
+end

data/app/helpers/postnhost/public_pages_helper.rb

@@ -0,0 +1,287 @@
+module Postnhost
+  module PublicPagesHelper
+    def document_lang
+      return content_for(:lang) if content_for?(:lang)
+
+      @current_language&.html_lang.presence || I18n.locale.to_s.presence || "en"
+    end
+
+    # Language switcher helpers
+    def current_path_without_locale
+      base_path = request.path_info.to_s
+      base_path = "/" if base_path.blank?
+
+      locale = params[:locale].presence
+      stripped_path = locale.present? ? base_path.sub(%r{\A/#{Regexp.escape(locale)}(?=/|$)}, "") : base_path
+
+      stripped_path.presence || "/"
+    end
+
+    def localized_path(language)
+      base_path = current_path_without_locale
+      base_path = "/" if base_path.empty?
+
+      locale_path = if language.default
+                      base_path
+                    else
+                      base_path == "/" ? "/#{language.html_lang}" : "/#{language.html_lang}#{base_path}"
+                    end
+
+      public_template_preview_path("#{request.script_name}#{locale_path}")
+    end
+
+    def public_template_preview_path(path)
+      previewing_template = respond_to?(:user_signed_in?, true) && user_signed_in? && params[:preview_template].present?
+      return path unless previewing_template
+
+      "#{path}?preview_template=#{ERB::Util.url_encode(params[:preview_template])}"
+    end
+
+    # Language-aware navigation helpers for public pages
+    def language_root_path(language)
+      return postnhost.root_path unless language
+
+      if language.default
+        postnhost.root_path
+      else
+        postnhost.localized_root_path(locale: language.html_lang)
+      end
+    end
+
+    def language_search_path(language)
+      return postnhost.public_search_path unless language
+
+      if language.default
+        postnhost.public_search_path
+      else
+        postnhost.localized_public_search_path(language.html_lang)
+      end
+    end
+
+    def language_search_url(language)
+      return postnhost.public_search_url unless language
+
+      if language.default
+        postnhost.public_search_url
+      else
+        postnhost.localized_public_search_url(language.html_lang)
+      end
+    end
+
+    def language_category_path(category_slug, language)
+      return postnhost.public_category_path(category_slug) unless language
+
+      if language.default
+        postnhost.public_category_path(category_slug)
+      else
+        postnhost.localized_public_category_path(language.html_lang, category_slug)
+      end
+    end
+
+    def language_static_page_path(page_slug, language)
+      return postnhost.public_static_page_path(slug: page_slug) unless language
+
+      if language.default
+        postnhost.public_static_page_path(slug: page_slug)
+      else
+        postnhost.localized_public_static_page_path(locale: language.html_lang, slug: page_slug)
+      end
+    end
+
+    def language_author_path(author_slug, language)
+      return unless author_pages_enabled?
+      return postnhost.public_author_path(author_slug) unless language
+
+      if language.default
+        postnhost.public_author_path(author_slug)
+      else
+        postnhost.localized_public_author_path(language.html_lang, author_slug)
+      end
+    end
+
+    def language_author_url(author_slug, language)
+      return unless author_pages_enabled?
+      return postnhost.public_author_url(author_slug) unless language
+
+      if language.default
+        postnhost.public_author_url(author_slug)
+      else
+        postnhost.localized_public_author_url(language.html_lang, author_slug)
+      end
+    end
+
+    # Public page metadata helpers
+    def public_page_number
+      params[:page].to_i
+    end
+
+    def paginated_public_page?
+      public_page_number > 1
+    end
+
+    def public_blog_index_title
+      if paginated_public_page?
+        t(
+          "postnhost.public.site.blog_meta_title_paginated",
+          page: public_page_number,
+          blog_meta_title: t("postnhost.public.site.blog_meta_title")
+        )
+      else
+        t("postnhost.public.site.blog_meta_title")
+      end
+    end
+
+    def public_search_query
+      @search_query.presence || params[:s].to_s.strip.presence
+    end
+
+    def public_search_endpoint?
+      controller_name == "articles" && action_name == "search"
+    end
+
+    def public_search_page?
+      public_search_query.present?
+    end
+
+    def public_search_title
+      t("postnhost.public.search.title", query: public_search_query)
+    end
+
+    def public_search_heading
+      t("postnhost.public.search.heading", query: public_search_query)
+    end
+
+    def public_articles_index_title
+      return public_search_title if public_search_page?
+      return t("postnhost.public.search.submit") if public_search_endpoint?
+
+      public_blog_index_title
+    end
+
+    def public_articles_index_heading
+      public_search_page? ? public_search_heading : public_blog_heading
+    end
+
+    def public_search_trigger_url
+      language_search_path(@current_language)
+    end
+
+    def public_blog_index_url
+      if public_search_endpoint?
+        paginated_public_page? ? language_search_url(@current_language) : request.original_url
+      else
+        paginated_public_page? ? postnhost.root_url : request.original_url
+      end
+    end
+
+    def public_blog_heading
+      if paginated_public_page?
+        t("postnhost.public.blog.page_title", page: public_page_number)
+      else
+        t("postnhost.public.site.blog_tagline")
+      end
+    end
+
+    def show_public_blog_subtitle?
+      !paginated_public_page? && !public_search_page? && !public_search_endpoint?
+    end
+
+    def public_category_title(category)
+      if paginated_public_page?
+        t(
+          "postnhost.public.category.page_title",
+          page: public_page_number,
+          category: localized_category_name(category, @current_language)
+        )
+      else
+        t(
+          "postnhost.public.category.title",
+          category: localized_category_name(category, @current_language)
+        )
+      end
+    end
+
+    def public_category_index_url(category)
+      return postnhost.public_category_url(category.slug) if @localized_category_fallback
+
+      paginated_public_page? ? postnhost.public_category_url(category.slug) : request.original_url
+    end
+
+    def public_category_heading(category)
+      if paginated_public_page?
+        t(
+          "postnhost.public.category.page_heading",
+          page: public_page_number,
+          category: localized_category_name(category, @current_language)
+        )
+      else
+        localized_category_name(category, @current_language)
+      end
+    end
+
+    def public_category_description(category)
+      localized_category_meta_description(category, @current_language)
+    end
+
+    def show_public_category_description?(category)
+      public_category_description(category).present? && !paginated_public_page?
+    end
+
+    # Public layout language switcher helpers
+    def public_article_show_page?
+      controller_name == "articles" && action_name == "show"
+    end
+
+    def public_static_page_show_page?
+      controller_name == "static_pages" && action_name == "show"
+    end
+
+    def show_article_variant_language_switcher?
+      return false unless public_article_show_page?
+      return false if @available_variants.nil?
+
+      if @available_variants.respond_to?(:exists?)
+        @available_variants.offset(1).exists? || (@article.present? && @available_variants.exists?)
+      else
+        @available_variants.size > 1 || (@article.present? && @available_variants.any?)
+      end
+    end
+
+    def show_page_variant_language_switcher?
+      return false unless public_static_page_show_page?
+      return false if @available_variants.nil?
+
+      if @available_variants.respond_to?(:exists?)
+        @available_variants.offset(1).exists? || (@page.present? && @available_variants.exists?)
+      else
+        @available_variants.size > 1 || (@page.present? && @available_variants.any?)
+      end
+    end
+
+    def show_other_languages_switcher?
+      !public_article_show_page? && !public_static_page_show_page? && @other_languages&.any?
+    end
+
+    def localized_language_options(primary)
+      options = [[@current_language.name, localized_path(@current_language)]]
+      primary_language = primary.is_a?(Postnhost::Snapshot::Article) ? @primary_language : primary&.language
+
+      options << [primary_language.name, localized_path(primary_language)] if primary_language.present? && primary_language != @current_language
+
+      return options if @available_variants.blank?
+
+      @available_variants.each do |variant|
+        next if variant.language == @current_language
+
+        options << [variant.language.name, localized_path(variant.language)]
+      end
+
+      options.uniq { |(_, path)| path }
+    end
+
+    def default_language_options
+      [[@current_language.name, localized_path(@current_language)]] +
+        @other_languages.to_a.map { |language| [language.name, localized_path(language)] }
+    end
+  end
+end