tiny_admin 0.6.0 → 0.8.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 0dfe9b2fef29073201e228daf3a7d89003902f8d98108e58cb8245fdb9a533e3
-  data.tar.gz: 6634891a9bbc2585549a759cd061a25234b834ebdcc0b77fbbb9bd2297b0a626
+  metadata.gz: 71d42ca63e3a410de95780d584cdfb61dd94feb95b503f5f55379efabec9477e
+  data.tar.gz: 96c4b375cb65327635199296d11f54335e6c5266dacce39a7316e0eb2844046c
 SHA512:
-  metadata.gz: 78b49e3f8b7efe941e24734692db4e4baaa2159f58a10f49ce0563f8c4cfa5950f3e155184016faff12c415ff1a6632d4ee06cd61659a466d170d4b7954becf7
-  data.tar.gz: 16c4fe68dca49b84c4c8ca834c9e3c2ce2304f5a78dc378cfdde837462a96a4e00030e5098083d025ad9ab28060ea2aa581725434ffeec1582715e5fa725ff28
+  metadata.gz: d377537524247253a871e016d3d5e688e47ab07d40c6d33814c5dfc0be761e734d3de3c8c23d3e3981d3f949ce15d230312b4c71fb2d7d6f33aeb45cc352223f
+  data.tar.gz: 4ddb16c2f1fbfefced95deb426cf369d28201866f800eee1f4b14895bd938233f6f67bf51d784a7edf340b48d7a75230a86b679db9ec71c07f18b726c23971a4

data/README.md

@@ -1,6 +1,9 @@
 # Tiny Admin
 
-[![Gem Version](https://badge.fury.io/rb/tiny_admin.svg)](https://badge.fury.io/rb/tiny_admin) [![Linters](https://github.com/blocknotes/tiny_admin/actions/workflows/linters.yml/badge.svg)](https://github.com/blocknotes/tiny_admin/actions/workflows/linters.yml) [![Specs](https://github.com/blocknotes/tiny_admin/actions/workflows/specs.yml/badge.svg)](https://github.com/blocknotes/tiny_admin/actions/workflows/specs.yml)
+[![Gem Version](https://badge.fury.io/rb/tiny_admin.svg)](https://badge.fury.io/rb/tiny_admin)
+[![Gem Downloads](https://badgen.net/rubygems/dt/tiny_admin)](https://rubygems.org/gems/tiny_admin)
+[![Linters](https://github.com/blocknotes/tiny_admin/actions/workflows/linters.yml/badge.svg)](https://github.com/blocknotes/tiny_admin/actions/workflows/linters.yml)
+[![Specs](https://github.com/blocknotes/tiny_admin/actions/workflows/specs.yml/badge.svg)](https://github.com/blocknotes/tiny_admin/actions/workflows/specs.yml)
 
 A compact and composable dashboard component for Ruby.
 
@@ -16,7 +19,7 @@ Please ⭐ if you like it.
 
 ## Install
 
-- Add to your Gemfile: `gem 'tiny_admin', '~> 0.6'`
+- Add to your Gemfile: `gem 'tiny_admin', '~> 0.8'`
 - Mount the app in a route (check some examples with: Hanami, Rails, Roda and standalone in [extra](extra))
   + in Rails, update _config/routes.rb_: `mount TinyAdmin::Router => '/admin'`
 - Configure the dashboard using `TinyAdmin.configure` and/or `TinyAdmin.configure_from_file` with a YAML config file (see [configuration](#configuration) below):
@@ -80,6 +83,9 @@ The following options are supported:
 - `title` (String): root section's title;
 - `page` (String): a view object to render;
 - `redirect` (String): alternative to _page_ option - redirects to a specific slug;
+- `widgets` (Array): list of widgets (as View components) to present.
+
+> 📚 [Wiki Root page](https://github.com/blocknotes/tiny_admin/wiki/Root) available
 
 Example:
 
@@ -87,10 +93,15 @@ Example:
 root:
   title: MyAdmin
   redirect: posts
+  widgets:
+    - LatestAuthorsWidget
+    - LatestPostsWidget
 ```
 
 `helper_class` (String): class or module with helper methods, used for attributes' formatters.
 
+> 📚 [Wiki Helper methods page](https://github.com/blocknotes/tiny_admin/wiki/Helper-methods) available
+
 `page_not_found` (String): a view object to render when a missing page is requested.
 
 `record_not_found` (String): a view object to render when a missing record is requested.
@@ -106,11 +117,15 @@ root:
 
 `extra_styles` (String): inline CSS styles.
 
+> 📚 [Wiki Styles and scripts page](https://github.com/blocknotes/tiny_admin/wiki/Styles-and-scripts) available
+
 `authentication` (Hash): define the authentication method, properties:
 
 - `plugin` (String): a plugin class to use (ex. `TinyAdmin::Plugins::SimpleAuth`);
 - `password` (String): a password hash used by _SimpleAuth_ plugin (generated with `Digest::SHA512.hexdigest("some password")`).
 
+> 📚 [Wiki Authentication page](https://github.com/blocknotes/tiny_admin/wiki/Authentication) available
+
 Example:
 
 ```yml
@@ -124,8 +139,11 @@ authentication:
 - `slug` (String): section reference identifier;
 - `name` (String): section's title;
 - `type` (String): the type of section: `content`, `page`, `resource` or `url`;
+- `widgets` (Array): list of widgets (as View components) to present;
 - other properties depends on the section's type.
 
+> 📚 [Wiki Pages page](https://github.com/blocknotes/tiny_admin/wiki/Pages) available
+
 For _content_ sections:
 
 - `content` (String): the HTML content to present.
@@ -139,6 +157,9 @@ type: content
 content: >
   <h1>Test content!</h1>
   <p>Some test content</p>
+widgets:
+  - LatestAuthorsWidget
+  - LatestPostsWidget
 ```
 
 For _url_ sections:
@@ -175,10 +196,14 @@ For _resource_ sections:
 
 - `model` (String): the class to use to fetch the data on an item of a collection;
 - `repository` (String): the class to get the properties related to the model;
+
+> 📚 [Wiki Repository page](https://github.com/blocknotes/tiny_admin/wiki/Repository) available
+
 - `index` (Hash): collection's action options (see below);
 - `show` (Hash): detail's action options (see below);
 - `collection_actions` (Array of hashes): custom collection's actions;
 - `member_actions` (Array of hashes): custom details's actions;
+- `widgets` (Array): list of widgets (as View components) to present;
 - `only` (Array of strings): list of supported actions (ex. `index`);
 - `options` (Array of strings): resource options (ex. `hidden`).
 
@@ -256,6 +281,9 @@ Example:
           header: The author
           link_to: authors
           call: author, name
+      widgets:
+        - LatestAuthorsWidget
+        - LatestPostsWidget
 ```
 
 ### Sample
@@ -280,6 +308,9 @@ authentication:
   # password: 'f1891cea80fc05e433c943254c6bdabc159577a02a7395dfebbfbc4f7661d4af56f2d372131a45936de40160007368a56ef216a30cb202c66d3145fd24380906'
 root:
   title: Test Admin
+  widgets:
+    - LatestAuthorsWidget
+    - LatestPostsWidget
   # page: RootPage
 helper_class: AdminHelper
 page_not_found: PageNotFound

data/lib/tiny_admin/actions/index.rb

@@ -3,34 +3,38 @@
 module TinyAdmin
   module Actions
     class Index < BasicAction
-      attr_reader :current_page,
+      attr_reader :context,
+                  :current_page,
                   :fields_options,
-                  :filters_list,
                   :links,
+                  :options,
                   :pagination,
                   :pages,
                   :params,
                   :query_string,
-                  :repository,
-                  :sort
+                  :repository
 
       def call(app:, context:, options:)
+        @context = context
+        @options = options || {}
         evaluate_options(options)
         fields = repository.fields(options: fields_options)
-        filters = prepare_filters(fields, filters_list)
-        records, total_count = repository.list(page: current_page, limit: pagination, filters: filters, sort: sort)
+        filters = prepare_filters(fields)
+        records, count = repository.list(page: current_page, limit: pagination, filters: filters, sort: options[:sort])
+        attributes = {
+          actions: context.actions,
+          fields: fields,
+          filters: filters,
+          links: options[:links],
+          prepare_record: ->(record) { repository.index_record_attrs(record, fields: fields_options) },
+          records: records,
+          slug: context.slug,
+          title: repository.index_title,
+          widgets: options[:widgets]
+        }
 
-        prepare_page(Views::Actions::Index) do |page|
-          setup_pagination(page, TinyAdmin.settings.components[:pagination], total_count: total_count)
-          page.update_attributes(
-            actions: context.actions,
-            fields: fields,
-            filters: filters,
-            links: links,
-            prepare_record: ->(record) { repository.index_record_attrs(record, fields: fields_options) },
-            records: records,
-            title: repository.index_title
-          )
+        prepare_page(Views::Actions::Index, slug: context.slug, attributes: attributes) do |page|
+          setup_pagination(page, TinyAdmin.settings.components[:pagination], total_count: count)
         end
       end
 
@@ -40,17 +44,13 @@ module TinyAdmin
         @fields_options = attribute_options(options[:attributes])
         @params = context.request.params
         @repository = context.repository
-        @filters_list = options[:filters]
         @pagination = options[:pagination] || 10
-        @sort = options[:sort]
-        @links = options[:links]
-
         @current_page = (params['p'] || 1).to_i
         @query_string = params_to_s(params.except('p'))
       end
 
-      def prepare_filters(fields, filters_list)
-        filters = (filters_list || []).map { _1.is_a?(Hash) ? _1 : { field: _1 } }
+      def prepare_filters(fields)
+        filters = (options[:filters] || []).map { _1.is_a?(Hash) ? _1 : { field: _1 } }
         filters = filters.each_with_object({}) { |filter, result| result[filter[:field]] = filter }
         values = (params['q'] || {})
         fields.each_with_object({}) do |(name, field), result|

data/lib/tiny_admin/actions/show.rb

@@ -8,16 +8,18 @@ module TinyAdmin
         repository = context.repository
         record = repository.find(context.reference)
         prepare_record = ->(record_data) { repository.show_record_attrs(record_data, fields: fields_options) }
+        attributes = {
+          actions: context.actions,
+          fields: repository.fields(options: fields_options),
+          prepare_record: prepare_record,
+          record: record,
+          reference: context.reference,
+          slug: context.slug,
+          title: repository.show_title(record),
+          widgets: options[:widgets]
+        }
 
-        prepare_page(Views::Actions::Show) do |page|
-          page.update_attributes(
-            actions: context.actions,
-            fields: repository.fields(options: fields_options),
-            prepare_record: prepare_record,
-            record: record,
-            title: repository.show_title(record)
-          )
-        end
+        prepare_page(Views::Actions::Show, slug: context.slug, attributes: attributes)
       rescue Plugins::BaseRepository::RecordNotFound => _e
         prepare_page(options[:record_not_found_page] || Views::Pages::RecordNotFound)
       end

data/lib/tiny_admin/authentication.rb

@@ -12,7 +12,11 @@ module TinyAdmin
       end
 
       r.post 'unauthenticated' do
-        render_login(warnings: ['Failed to authenticate'])
+        warning = TinyAdmin.settings.helper_class.label_for(
+          'Failed to authenticate',
+          options: ['authentication.unauthenticated']
+        )
+        render_login(warnings: [warning])
       end
 
       r.get 'logout' do
@@ -24,7 +28,10 @@ module TinyAdmin
     private
 
     def render_login(notices: nil, warnings: nil, errors: nil)
-      page = prepare_page(TinyAdmin.settings.authentication[:login], options: %i[no_menu compact_layout])
+      login = TinyAdmin.settings.authentication[:login]
+      return unless login
+
+      page = prepare_page(login, options: %i[no_menu compact_layout])
       page.messages = {
         notices: notices || flash['notices'],
         warnings: warnings || flash['warnings'],

data/lib/tiny_admin/context.rb

@@ -1,18 +1,13 @@
 # frozen_string_literal: true
 
 module TinyAdmin
-  class Context
-    include Singleton
-
-    attr_accessor :actions,
-                  :navbar,
-                  :pages,
-                  :reference,
-                  :repository,
-                  :request,
-                  :resources,
-                  :router,
-                  :settings,
-                  :slug
-  end
+  Context = Struct.new(
+    :actions,
+    :reference,
+    :repository,
+    :request,
+    :router,
+    :slug,
+    keyword_init: true
+  )
 end

data/lib/tiny_admin/field.rb

@@ -16,6 +16,19 @@ module TinyAdmin
       messages.inject(target) { |result, msg| result&.send(msg) } if messages.any?
     end
 
+    def translate_value(value)
+      if options && options[:method]
+        method, *args = options[:method].split(',').map(&:strip)
+        if options[:converter]
+          Object.const_get(options[:converter]).send(method, value, options: args || [])
+        else
+          TinyAdmin.settings.helper_class.send(method, value, options: args || [])
+        end
+      else
+        value&.to_s
+      end
+    end
+
     class << self
       def create_field(name:, title: nil, type: nil, options: {})
         field_name = name.to_s

data/lib/tiny_admin/plugins/active_record_repository.rb

@@ -6,10 +6,7 @@ module TinyAdmin
       def index_record_attrs(record, fields: nil)
         return record.attributes.transform_values(&:to_s) unless fields
 
-        fields.to_h do |name, field|
-          value = record.send(name)
-          [name, translate_value(value, field)]
-        end
+        fields.to_h { [_1, record.send(_1)] }
       end
 
       def index_title

data/lib/tiny_admin/plugins/base_repository.rb

@@ -10,20 +10,6 @@ module TinyAdmin
       def initialize(model)
         @model = model
       end
-
-      def translate_value(value, field)
-        if field[:method]
-          method, *options = field[:method].split(',').map(&:strip)
-          if field[:converter]
-            converter = Object.const_get(field[:converter])
-            converter.send(method, value, options: options || [])
-          else
-            TinyAdmin.settings.helper_class.send(method, value, options: options || [])
-          end
-        else
-          value&.to_s
-        end
-      end
     end
   end
 end

data/lib/tiny_admin/router.rb

@@ -2,14 +2,14 @@
 
 module TinyAdmin
   class Router < BasicApp
-    TinyAdmin.settings.load_settings
+    extend Forwardable
+
+    def_delegator TinyAdmin, :route_for
 
     route do |r|
-      context.router = r
-      context.settings = TinyAdmin.settings
+      TinyAdmin.settings.load_settings
 
       r.on 'auth' do
-        context.slug = nil
         r.run Authentication
       end
 
@@ -26,15 +26,14 @@ module TinyAdmin
       end
 
       r.post '' do
-        context.slug = nil
         r.redirect TinyAdmin.settings.root_path
       end
 
-      context.pages.each do |slug, page_data|
+      store.pages.each do |slug, page_data|
         setup_page_route(r, slug, page_data)
       end
 
-      context.resources.each do |slug, options|
+      store.resources.each do |slug, options|
         setup_resource_routes(r, slug, options: options || {})
       end
 
@@ -43,6 +42,10 @@ module TinyAdmin
 
     private
 
+    def store
+      @store ||= TinyAdmin.settings.store
+    end
+
     def render_page(page)
       if page.respond_to?(:messages=)
         page.messages = { notices: flash['notices'], warnings: flash['warnings'], errors: flash['errors'] }
@@ -51,76 +54,83 @@ module TinyAdmin
     end
 
     def root_route(router)
-      context.slug = nil
       if TinyAdmin.settings.root[:redirect]
         router.redirect route_for(TinyAdmin.settings.root[:redirect])
       else
-        page = TinyAdmin.settings.root[:page]
-        page_class = page.is_a?(String) ? Object.const_get(page) : page
-        render_page prepare_page(page_class)
+        page_class = to_class(TinyAdmin.settings.root[:page])
+        render_page prepare_page(page_class, attributes: TinyAdmin.settings.root.slice(:content, :title, :widgets))
       end
     end
 
     def setup_page_route(router, slug, page_data)
       router.get slug do
-        context.slug = slug
-        page = prepare_page(page_data[:class])
-        page.update_attributes(content: page_data[:content]) if page_data[:content]
-        render_page page
+        attributes = page_data.slice(:content, :title, :widgets)
+        render_page prepare_page(page_data[:class], slug: slug, attributes: attributes)
       end
     end
 
     def setup_resource_routes(router, slug, options:)
       router.on slug do
-        context.slug = slug
-        setup_collection_routes(router, options: options)
-        setup_member_routes(router, options: options)
+        setup_collection_routes(router, slug, options: options)
+        setup_member_routes(router, slug, options: options)
       end
     end
 
-    def setup_collection_routes(router, options:)
-      context.repository = options[:repository].new(options[:model])
+    def setup_collection_routes(router, slug, options:)
+      repository = options[:repository].new(options[:model])
       action_options = options[:index] || {}
 
       # Custom actions
       custom_actions = setup_custom_actions(
         router,
         options[:collection_actions],
-        repository: context.repository,
-        options: action_options
+        options: action_options,
+        repository: repository,
+        slug: slug
       )
 
       # Index
       if options[:only].include?(:index) || options[:only].include?('index')
         router.is do
-          context.actions = custom_actions
-          context.request = request
+          context = Context.new(
+            actions: custom_actions,
+            repository: repository,
+            request: request,
+            router: router,
+            slug: slug
+          )
           index_action = TinyAdmin::Actions::Index.new
           render_page index_action.call(app: self, context: context, options: action_options)
         end
       end
     end
 
-    def setup_member_routes(router, options:)
-      context.repository = options[:repository].new(options[:model])
+    def setup_member_routes(router, slug, options:)
+      repository = options[:repository].new(options[:model])
       action_options = (options[:show] || {}).merge(record_not_found_page: TinyAdmin.settings.record_not_found)
 
       router.on String do |reference|
-        context.reference = reference
-
         # Custom actions
         custom_actions = setup_custom_actions(
           router,
           options[:member_actions],
-          repository: context.repository,
-          options: action_options
+          options: action_options,
+          repository: repository,
+          slug: slug,
+          reference: reference
         )
 
         # Show
         if options[:only].include?(:show) || options[:only].include?('show')
           router.is do
-            context.actions = custom_actions
-            context.request = request
+            context = Context.new(
+              actions: custom_actions,
+              reference: reference,
+              repository: repository,
+              request: request,
+              router: router,
+              slug: slug
+            )
             show_action = TinyAdmin::Actions::Show.new
             render_page show_action.call(app: self, context: context, options: action_options)
           end
@@ -128,15 +138,20 @@ module TinyAdmin
       end
     end
 
-    def setup_custom_actions(router, custom_actions, repository:, options:)
-      context.repository = repository
+    def setup_custom_actions(router, custom_actions, options:, repository:, slug:, reference: nil)
       (custom_actions || []).each_with_object({}) do |custom_action, result|
         action_slug, action = custom_action.first
-        action_class = action.is_a?(String) ? Object.const_get(action) : action
+        action_class = to_class(action)
 
         router.get action_slug.to_s do
-          context.actions = {}
-          context.request = request
+          context = Context.new(
+            actions: {},
+            reference: reference,
+            repository: repository,
+            request: request,
+            router: router,
+            slug: slug
+          )
           custom_action = action_class.new
           render_page custom_action.call(app: self, context: context, options: options)
         end

data/lib/tiny_admin/section.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+module TinyAdmin
+  class Section
+    attr_reader :name, :options, :path, :slug
+
+    def initialize(name:, slug: nil, path: nil, options: {})
+      @name = name
+      @options = options
+      @path = path || TinyAdmin.route_for(slug)
+      @slug = slug
+    end
+  end
+end

data/lib/tiny_admin/settings.rb

@@ -3,11 +3,11 @@
 module TinyAdmin
   class Settings
     include Singleton
-    include Utils
 
     DEFAULTS = {
       %i[authentication plugin] => Plugins::NoAuth,
       %i[authentication login] => Views::Pages::SimpleAuthLogin,
+      %i[components field_value] => Views::Components::FieldValue,
       %i[components flash] => Views::Components::Flash,
       %i[components head] => Views::Components::Head,
       %i[components navbar] => Views::Components::Navbar,
@@ -19,7 +19,8 @@ module TinyAdmin
       %i[repository] => Plugins::ActiveRecordRepository,
       %i[root_path] => '/admin',
       %i[root page] => Views::Pages::Root,
-      %i[root title] => 'TinyAdmin'
+      %i[root title] => 'TinyAdmin',
+      %i[sections] => []
     }.freeze
 
     OPTIONS = %i[
@@ -38,6 +39,8 @@ module TinyAdmin
       style_links
     ].freeze
 
+    attr_reader :store
+
     OPTIONS.each do |option|
       define_method(option) do
         self[option]
@@ -70,15 +73,14 @@ module TinyAdmin
         end
       end
 
-      context.pages ||= {}
-      context.resources ||= {}
-      self.sections ||= []
+      @store ||= TinyAdmin::Store.new(self)
       self.root_path = '/' if root_path == ''
 
       if authentication[:plugin] <= Plugins::SimpleAuth
-        authentication[:logout] ||= { name: 'logout', path: "#{root_path}/auth/logout" }
+        logout_path = "#{root_path}/auth/logout"
+        authentication[:logout] ||= TinyAdmin::Section.new(name: 'logout', slug: 'logout', path: logout_path)
       end
-      context.navbar = prepare_navbar(sections, logout: authentication[:logout])
+      store.prepare_sections(sections, logout: authentication[:logout])
     end
 
     def reset!
@@ -97,7 +99,7 @@ module TinyAdmin
       if value.is_a?(Hash)
         value.each_key do |key2|
           path = [key, key2]
-          if DEFAULTS[path].is_a?(Class) || DEFAULTS[path].is_a?(Module)
+          if (DEFAULTS[path].is_a?(Class) || DEFAULTS[path].is_a?(Module)) && self[key][key2].is_a?(String)
             self[key][key2] = Object.const_get(self[key][key2])
           end
         end
@@ -105,59 +107,5 @@ module TinyAdmin
         self[key] = Object.const_get(self[key])
       end
     end
-
-    def prepare_navbar(sections, logout:)
-      items = sections.each_with_object({}) do |section, list|
-        unless section.is_a?(Hash)
-          section_class = section.is_a?(String) ? Object.const_get(section) : section
-          next unless section_class.respond_to?(:to_h)
-
-          section = section_class.to_h
-        end
-
-        slug = section[:slug].to_s
-        case section[:type]&.to_sym
-        when :content
-          list[slug] = add_content_section(slug, section)
-        when :page
-          list[slug] = add_page_section(slug, section)
-        when :resource
-          list[slug] = add_resource_section(slug, section)
-        when :url
-          list[slug] = add_url_section(slug, section)
-        end
-      end
-      items['auth/logout'] = logout if logout
-      items
-    end
-
-    def add_content_section(slug, section)
-      context.pages[slug] = { class: content_page, content: section[:content] }
-      { name: section[:name], path: route_for(slug), class: content_page }
-    end
-
-    def add_page_section(slug, section)
-      page = section[:page]
-      page_class = page.is_a?(String) ? Object.const_get(page) : page
-      context.pages[slug] = { class: page_class }
-      { name: section[:name], path: route_for(slug), class: page_class }
-    end
-
-    def add_resource_section(slug, section)
-      repo = section[:repository] || repository
-      context.resources[slug] = {
-        model: section[:model].is_a?(String) ? Object.const_get(section[:model]) : section[:model],
-        repository: repo.is_a?(String) ? Object.const_get(repo) : repo
-      }
-      resource_options = section.slice(:resource, :only, :index, :show, :collection_actions, :member_actions)
-      resource_options[:only] ||= %i[index show]
-      context.resources[slug].merge!(resource_options)
-      hidden = section[:options] && (section[:options].include?(:hidden) || section[:options].include?('hidden'))
-      { name: section[:name], path: route_for(slug) } unless hidden
-    end
-
-    def add_url_section(_slug, section)
-      section.slice(:name, :options).tap { _1[:path] = section[:url] }
-    end
   end
 end

data/lib/tiny_admin/store.rb

@@ -0,0 +1,67 @@
+# frozen_string_literal: true
+
+module TinyAdmin
+  class Store
+    include Utils
+
+    attr_reader :navbar, :pages, :resources, :settings
+
+    def initialize(settings)
+      @pages = {}
+      @resources = {}
+      @settings = settings
+    end
+
+    def prepare_sections(sections, logout:)
+      @navbar = sections.each_with_object([]) do |section, list|
+        unless section.is_a?(Hash)
+          section_class = to_class(section)
+          next unless section_class.respond_to?(:to_h)
+
+          section = section_class.to_h
+        end
+
+        slug = section[:slug].to_s
+        case section[:type]&.to_sym
+        when :content
+          list << add_content_section(slug, section)
+        when :page
+          list << add_page_section(slug, section)
+        when :resource
+          list << add_resource_section(slug, section)
+        when :url
+          list << add_url_section(slug, section)
+        end
+      end
+      navbar << logout if logout
+    end
+
+    private
+
+    def add_content_section(slug, section)
+      pages[slug] = { class: settings.content_page, content: section[:content], widgets: section[:widgets] }
+      TinyAdmin::Section.new(name: section[:name], slug: slug)
+    end
+
+    def add_page_section(slug, section)
+      pages[slug] = { class: to_class(section[:page]) }
+      TinyAdmin::Section.new(name: section[:name], slug: slug)
+    end
+
+    def add_resource_section(slug, section)
+      resource = section.slice(:resource, :only, :index, :show, :collection_actions, :member_actions)
+      resource[:only] ||= %i[index show]
+      resources[slug] = resource.merge(
+        model: to_class(section[:model]),
+        repository: to_class(section[:repository] || settings.repository)
+      )
+
+      hidden = section[:options] && (section[:options].include?(:hidden) || section[:options].include?('hidden'))
+      TinyAdmin::Section.new(name: section[:name], slug: slug) unless hidden
+    end
+
+    def add_url_section(slug, section)
+      TinyAdmin::Section.new(name: section[:name], options: section[:options], path: section[:url], slug: slug)
+    end
+  end
+end

data/lib/tiny_admin/support.rb

@@ -15,6 +15,10 @@ module TinyAdmin
         Kernel.format(options.first, value) if value && options&.any?
       end
 
+      def label_for(value, options: [])
+        value
+      end
+
       def round(value, options: [])
         value&.round(options&.first&.to_i || 2)
       end

data/lib/tiny_admin/utils.rb

@@ -14,37 +14,33 @@ module TinyAdmin
       list.join('&')
     end
 
-    def prepare_page(page_class, options: nil)
+    def prepare_page(page_class, slug: nil, attributes: nil, options: nil)
       page_class.new.tap do |page|
         page.options = options
         page.head_component = TinyAdmin.settings.components[:head]&.new
         page.flash_component = TinyAdmin.settings.components[:flash]&.new
         page.navbar_component = TinyAdmin.settings.components[:navbar]&.new
         page.navbar_component&.update_attributes(
-          current_slug: context&.slug,
+          current_slug: slug,
           root_path: TinyAdmin.settings.root_path,
           root_title: TinyAdmin.settings.root[:title],
-          items: options&.include?(:no_menu) ? [] : context&.navbar
+          items: options&.include?(:no_menu) ? [] : TinyAdmin.settings.store&.navbar
         )
+        attrs = attributes || {}
+        attrs[:widgets] = attrs[:widgets].map { to_class(_1) } if attrs[:widgets]
+        page.update_attributes(attrs) unless attrs.empty?
         yield(page) if block_given?
       end
     end
 
-    def route_for(section, reference: nil, action: nil, query: nil)
-      root_path = TinyAdmin.settings.root_path == '/' ? nil : TinyAdmin.settings.root_path
-      route = [root_path, section, reference, action].compact.join("/")
-      route << "?#{query}" if query
-      route[0] == '/' ? route : route.prepend('/')
+    def to_class(klass)
+      klass.is_a?(String) ? Object.const_get(klass) : klass
     end
 
-    def to_label(string)
+    def humanize(string)
       return '' unless string
 
       string.respond_to?(:humanize) ? string.humanize : string.tr('_', ' ').capitalize
     end
-
-    def context
-      TinyAdmin::Context.instance
-    end
   end
 end

data/lib/tiny_admin/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module TinyAdmin
-  VERSION = '0.6.0'
+  VERSION = '0.8.0'
 end

data/lib/tiny_admin/views/actions/index.rb

@@ -4,14 +4,16 @@ module TinyAdmin
   module Views
     module Actions
       class Index < DefaultLayout
-        attr_accessor :actions, :fields, :filters, :links, :pagination_component, :prepare_record, :records
+        attr_accessor :actions, :fields, :filters, :links, :pagination_component, :prepare_record, :records, :slug
 
         def template
           super do
             div(class: 'index') {
               div(class: 'row') {
                 div(class: 'col-4') {
-                  h1(class: 'title') { title }
+                  h1(class: 'title') {
+                    title
+                  }
                 }
                 div(class: 'col-8') {
                   actions_buttons
@@ -31,13 +33,15 @@ module TinyAdmin
                 if filters&.any?
                   div(class: 'col-3') {
                     filters_form = TinyAdmin::Views::Components::FiltersForm.new
-                    filters_form.update_attributes(section_path: route_for(context.slug), filters: filters)
+                    filters_form.update_attributes(section_path: TinyAdmin.route_for(slug), filters: filters)
                     render filters_form
                   }
                 end
               }
 
               render pagination_component if pagination_component
+
+              render TinyAdmin::Views::Components::Widgets.new(widgets)
             }
           end
         end
@@ -65,13 +69,7 @@ module TinyAdmin
                 attributes.each do |key, value|
                   field = fields[key]
                   td(class: "field-value-#{field.name} field-value-type-#{field.type}") {
-                    if field.options && field.options[:link_to]
-                      a(href: route_for(field.options[:link_to], reference: value)) {
-                        field.apply_call_option(record) || value
-                      }
-                    else
-                      value
-                    end
+                    render TinyAdmin.settings.components[:field_value].new(field, value, record: record)
                   }
                 end
 
@@ -82,15 +80,20 @@ module TinyAdmin
                       links.each do |link|
                         whitespace
                         if link == 'show'
-                          a(href: route_for(context.slug, reference: record.id), class: link_class) { 'show' }
+                          a(href: TinyAdmin.route_for(slug, reference: record.id), class: link_class) {
+                            label_for('Show', options: ['actions.index.links.show'])
+                          }
                         else
-                          a(href: route_for(context.slug, reference: record.id, action: link), class: link_class) {
-                            to_label(link)
+                          a(href: TinyAdmin.route_for(slug, reference: record.id, action: link), class: link_class) {
+                            fallback = humanize(link)
+                            label_for(fallback, options: ["actions.index.links.#{link}"])
                           }
                         end
                       end
                     else
-                      a(href: route_for(context.slug, reference: record.id), class: link_class) { 'show' }
+                      a(href: TinyAdmin.route_for(slug, reference: record.id), class: link_class) {
+                        label_for('Show', options: ['actions.index.links.show'])
+                      }
                     end
                   }
                 }
@@ -103,7 +106,7 @@ module TinyAdmin
           ul(class: 'nav justify-content-end') {
             (actions || {}).each do |action, action_class|
               li(class: 'nav-item mx-1') {
-                href = route_for(context.slug, action: action)
+                href = TinyAdmin.route_for(slug, action: action)
                 a(href: href, class: 'nav-link btn btn-outline-secondary') {
                   action_class.respond_to?(:title) ? action_class.title : action
                 }

data/lib/tiny_admin/views/actions/show.rb

@@ -4,7 +4,7 @@ module TinyAdmin
   module Views
     module Actions
       class Show < DefaultLayout
-        attr_accessor :actions, :fields, :prepare_record, :record
+        attr_accessor :actions, :fields, :prepare_record, :record, :reference, :slug
 
         def template
           super do
@@ -25,16 +25,12 @@ module TinyAdmin
                     div(class: 'field-header col-2') { field.options[:header] || field.title }
                   end
                   div(class: 'field-value col-10') {
-                    if field.options[:link_to]
-                      a(href: route_for(field.options[:link_to], reference: value)) {
-                        field.apply_call_option(record) || value
-                      }
-                    else
-                      value
-                    end
+                    render TinyAdmin.settings.components[:field_value].new(field, value, record: record)
                   }
                 }
               end
+
+              render TinyAdmin::Views::Components::Widgets.new(widgets)
             }
           end
         end
@@ -45,7 +41,7 @@ module TinyAdmin
           ul(class: 'nav justify-content-end') {
             (actions || {}).each do |action, action_class|
               li(class: 'nav-item mx-1') {
-                href = route_for(context.slug, reference: context.reference, action: action)
+                href = TinyAdmin.route_for(slug, reference: reference, action: action)
                 a(href: href, class: 'nav-link btn btn-outline-secondary') {
                   action_class.respond_to?(:title) ? action_class.title : action
                 }

data/lib/tiny_admin/views/basic_layout.rb

@@ -5,7 +5,11 @@ module TinyAdmin
     class BasicLayout < Phlex::HTML
       include Utils
 
-      attr_accessor :content
+      attr_accessor :content, :widgets
+
+      def label_for(value, options: [])
+        TinyAdmin.settings.helper_class.label_for(value, options: options)
+      end
 
       def update_attributes(attributes)
         attributes.each do |key, value|

data/lib/tiny_admin/views/basic_widget.rb

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+module TinyAdmin
+  module Views
+    class BasicWidget < Phlex::HTML
+    end
+  end
+end

data/lib/tiny_admin/views/components/field_value.rb

@@ -0,0 +1,33 @@
+# frozen_string_literal: true
+
+module TinyAdmin
+  module Views
+    module Components
+      class FieldValue < BasicComponent
+        attr_reader :field, :value, :record
+
+        def initialize(field, value, record:)
+          @field = field
+          @value = value
+          @record = record
+        end
+
+        def template
+          translated_value = field.translate_value(value)
+          value_class = field.options[:options]&.include?('value_class') ? "value-#{value}" : nil
+          if field.options[:link_to]
+            a(href: TinyAdmin.route_for(field.options[:link_to], reference: translated_value)) {
+              span(class: value_class) {
+                field.apply_call_option(record) || translated_value
+              }
+            }
+          else
+            span(class: value_class) {
+              translated_value
+            }
+          end
+        end
+      end
+    end
+  end
+end

data/lib/tiny_admin/views/components/filters_form.rb

@@ -17,8 +17,12 @@ module TinyAdmin
                 when :boolean
                   select(class: 'form-select', id: "filter-#{name}", name: "q[#{name}]") {
                     option(value: '') { '-' }
-                    option(value: '0', selected: filter[:value] == '0') { 'false' }
-                    option(value: '1', selected: filter[:value] == '1') { 'true' }
+                    option(value: '0', selected: filter[:value] == '0') {
+                      TinyAdmin.settings.helper_class.label_for('false', options: ['components.filters_form.boolean.false'])
+                    }
+                    option(value: '1', selected: filter[:value] == '1') {
+                      TinyAdmin.settings.helper_class.label_for('true', options: ['components.filters_form.boolean.true'])
+                    }
                   }
                 when :date
                   input(type: 'date', class: 'form-control', id: "filter-#{name}", name: "q[#{name}]", value: filter[:value])
@@ -40,9 +44,13 @@ module TinyAdmin
             end
 
             div(class: 'mt-3') {
-              a(href: section_path, class: 'button_clear btn btn-secondary text-white') { 'clear' }
+              a(href: section_path, class: 'button_clear btn btn-secondary text-white') {
+                TinyAdmin.settings.helper_class.label_for('Clear', options: ['components.filters_form.buttons.clear'])
+              }
               whitespace
-              button(type: 'submit', class: 'button_filter btn btn-secondary') { 'filter' }
+              button(type: 'submit', class: 'button_filter btn btn-secondary') {
+                TinyAdmin.settings.helper_class.label_for('Filter', options: ['components.filters_form.buttons.submit'])
+              }
             }
           }
         end

data/lib/tiny_admin/views/components/navbar.rb

@@ -23,14 +23,14 @@ module TinyAdmin
               }
               div(class: 'collapse navbar-collapse', id: 'navbarNav') {
                 ul(class: 'navbar-nav') {
-                  items.each do |slug, item|
+                  items.each do |item|
                     classes = %w[nav-link]
-                    classes << 'active' if slug == current_slug
-                    link_attributes = { class: classes.join(' '), href: item[:path], 'aria-current' => 'page' }
-                    link_attributes.merge!(item[:options]) if item[:options]
+                    classes << 'active' if item.slug == current_slug
+                    link_attributes = { class: classes.join(' '), href: item.path, 'aria-current' => 'page' }
+                    link_attributes.merge!(item.options) if item.options
 
                     li(class: 'nav-item') {
-                      a(**link_attributes) { item[:name] }
+                      a(**link_attributes) { item.name }
                     }
                   end
                 }

data/lib/tiny_admin/views/components/widgets.rb

@@ -0,0 +1,35 @@
+# frozen_string_literal: true
+
+module TinyAdmin
+  module Views
+    module Components
+      class Widgets < BasicComponent
+        def initialize(widgets)
+          @widgets = widgets
+        end
+
+        def template
+          return if @widgets.nil? || @widgets.empty?
+
+          div(class: 'container widgets') {
+            @widgets.each_slice(2).each do |row|
+              div(class: 'row') {
+                row.each do |widget|
+                  next unless widget < Phlex::HTML
+
+                  div(class: 'col') {
+                    div(class: 'card') {
+                      div(class: 'card-body') {
+                        render widget.new
+                      }
+                    }
+                  }
+                end
+              }
+            end
+          }
+        end
+      end
+    end
+  end
+end

data/lib/tiny_admin/views/pages/content.rb

@@ -7,7 +7,11 @@ module TinyAdmin
         def template
           super do
             div(class: 'content') {
-              unsafe_raw(content)
+              div(class: 'content-data') {
+                unsafe_raw(content)
+              }
+
+              render TinyAdmin::Views::Components::Widgets.new(widgets)
             }
           end
         end

data/lib/tiny_admin/views/pages/root.rb

@@ -7,7 +7,7 @@ module TinyAdmin
         def template
           super do
             div(class: 'root') {
-              h1(class: 'title') { 'Tiny Admin' }
+              render TinyAdmin::Views::Components::Widgets.new(widgets)
             }
           end
         end

data/lib/tiny_admin/views/pages/simple_auth_login.rb

@@ -11,12 +11,16 @@ module TinyAdmin
 
               form(class: 'form_login', method: 'post') {
                 div(class: 'mt-3') {
-                  label(for: 'secret', class: 'form-label') { 'Password' }
+                  label(for: 'secret', class: 'form-label') {
+                    label_for('Password', options: ['pages.simple_auth_login.inputs.password'])
+                  }
                   input(type: 'password', name: 'secret', class: 'form-control', id: 'secret')
                 }
 
                 div(class: 'mt-3') {
-                  button(type: 'submit', class: 'button_login btn btn-primary') { 'login' }
+                  button(type: 'submit', class: 'button_login btn btn-primary') {
+                    label_for('Login', options: ['pages.simple_auth_login.buttons.submit'])
+                  }
                 }
               }
             }

data/lib/tiny_admin.rb

@@ -4,6 +4,7 @@ require 'phlex'
 require 'roda'
 require 'zeitwerk'
 
+require 'forwardable'
 require 'singleton'
 require 'yaml'
 
@@ -23,9 +24,16 @@ module TinyAdmin
     end
   end
 
+  def route_for(section, reference: nil, action: nil, query: nil)
+    root_path = settings.root_path == '/' ? nil : settings.root_path
+    route = [root_path, section, reference, action].compact.join("/")
+    route << "?#{query}" if query
+    route[0] == '/' ? route : route.prepend('/')
+  end
+
   def settings
     TinyAdmin::Settings.instance
   end
 
-  module_function :configure, :configure_from_file, :settings
+  module_function :configure, :configure_from_file, :route_for, :settings
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: tiny_admin
 version: !ruby/object:Gem::Version
-  version: 0.6.0
+  version: 0.8.0
 platform: ruby
 authors:
 - Mattia Roccoberton
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2023-04-28 00:00:00.000000000 Z
+date: 2023-05-10 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: phlex
@@ -87,19 +87,24 @@ files:
 - lib/tiny_admin/plugins/no_auth.rb
 - lib/tiny_admin/plugins/simple_auth.rb
 - lib/tiny_admin/router.rb
+- lib/tiny_admin/section.rb
 - lib/tiny_admin/settings.rb
+- lib/tiny_admin/store.rb
 - lib/tiny_admin/support.rb
 - lib/tiny_admin/utils.rb
 - lib/tiny_admin/version.rb
 - lib/tiny_admin/views/actions/index.rb
 - lib/tiny_admin/views/actions/show.rb
 - lib/tiny_admin/views/basic_layout.rb
+- lib/tiny_admin/views/basic_widget.rb
 - lib/tiny_admin/views/components/basic_component.rb
+- lib/tiny_admin/views/components/field_value.rb
 - lib/tiny_admin/views/components/filters_form.rb
 - lib/tiny_admin/views/components/flash.rb
 - lib/tiny_admin/views/components/head.rb
 - lib/tiny_admin/views/components/navbar.rb
 - lib/tiny_admin/views/components/pagination.rb
+- lib/tiny_admin/views/components/widgets.rb
 - lib/tiny_admin/views/default_layout.rb
 - lib/tiny_admin/views/pages/content.rb
 - lib/tiny_admin/views/pages/page_not_found.rb