lesli 5.0.21 → 5.0.23

data/app/controllers/lesli/shared/dashboards_controller.rb

@@ -2,7 +2,7 @@
 
 Lesli
 
-Copyright (c) 2023, Lesli Technologies, S. A.
+Copyright (c) 2026, Lesli Technologies, S. A.
 
 This program is free software: you can redistribute it and/or modify
 it under the terms of the GNU General Public License as published by
@@ -19,7 +19,7 @@ along with this program. If not, see http://www.gnu.org/licenses/.
 
 Lesli · Ruby on Rails SaaS Development Framework.
 
-Made with ♥ by https://www.lesli.tech
+Made with ♥ by LesliTech
 Building a better future, one line of code at a time.
 
 @contact  hello@lesli.tech
@@ -29,288 +29,20 @@ Building a better future, one line of code at a time.
 // · ~·~     ~·~     ~·~     ~·~     ~·~     ~·~     ~·~     ~·~     ~·~
 // · 
 =end
+
 module Lesli
     module Shared
-        class DashboardsController < ApplicationLesliController
-            #before_action :set_dashboard, only: [:show, :update, :destroy, :options]
-
-            def edit 
-            end
-
-            def show 
-                builder = LesliSystem::Klass.new(self)
-                @dashboard = builder.model.dashboard.first
-            end
-
-            # def index
-            #     respond_to do |format|
-            #         format.html {}
-            #         format.json do
-            #             dynamic_info = self.class.dynamic_info
-            #             model = dynamic_info[:model]
-
-            #             dashboards = model.list(current_user, @query)
-            #             respond_with_successful(dashboards)
-            #         end
-            #     end
-            # end
-
-            # def show
-            #     respond_to do |format|
-            #         format.html {}
-            #         format.json do
-            #             return respond_with_not_found unless @dashboard
-            #             respond_with_successful(@dashboard.show)
-            #         end
-            #     end
-            # end
-
-            # def new
-            # end
-
-            # def edit
-            # end
-
-            # # @controller_action_param :name [String] The name of the new dashboard
-            # # @controller_action_param :default [Boolean] A flag that marks this dashboard as default or not. The default dashboard is the dashboard all users will have access to on the root page
-            # # @controller_action_param :main    [Boolean] A flag that marks this dashboard as main. Since a user can have multiple dashboards, this is the one they will see on the root page when loging in
-            # # @controller_action_param :roles_id [Integer] The id of the role that will have access to this dashboard
-            # # @controller_action_param :user_main_id [Integer] The id of the user 
-            # # @controller_action_param :component_attributes [Array] Array of hashes that represent the attributes of the dashboard components
-            # # @controller_action_param :component_attributes.name [String] The name of this component given to the user
-            # # @controller_action_param :component_attributes.component_id [String] An enum value, that indicates which component is being loaded
-            # # @controller_action_param :component_attributes.layout [Integer] Number from 1 to 12, bigger numbers default to 12, smallest numbers default to 1. The column size that the UI component will use
-            # # @controller_action_param :component_attributes.index [Integer] The position of the component in the layout
-            # # @controller_action_param :component_attributes.configuration [Hash] Specific filtering and configuration of the components
-            # # @return [Json] Json that contains wheter the creation of the dashboard was successful or not. 
-            # #     If it is not successful, it returns an error message
-            # # @description Creates a new dashboard associated to the *current_user*'s *account*
-            # # @example
-            # # # Executing this controller's action from javascript's frontend
-            # #     let data = {
-            # #         dashboard: {
-            # #             name: "Sales Dashboard",
-            # #             default: false,
-            # #             roles_id: 3,
-            # #             components_attributes: [
-            # #                 {
-            # #                     name: 'Projects Count',
-            # #                     component_id: projects_component,
-            # #                     layout: 4,
-            # #                     index: 3,
-            # #                     configuration: {}
-            # #                 }, {
-            # #                     name: 'New Customers Count',
-            # #                     component_id: new_customers_component,
-            # #                     layout: 4,
-            # #                     index: 3,
-            # #                     configuration: {}
-            # #                 }
-            # #             ]
-            # #         }
-            # #     };
-            # #     this.http.post('127.0.0.1/help/dashboards', data);
-            # def create
-            #     dynamic_info = self.class.dynamic_info
-            #     module_name = dynamic_info[:module_name]
-            #     model = dynamic_info[:model]
-            #     full_module_name = dynamic_info[:full_module_name].underscore
-
-            #     dashboard = model.new(dashboard_params)
-            #     dashboard["#{full_module_name}_account_id".to_sym] = current_user.account.id
-            #     dashboard.user_creator = current_user
-
-            #     if dashboard.save
-            #         respond_with_successful(dashboard)
-            #     else
-            #         respond_with_error(dashboard.errors.full_messages.to_sentence)
-            #     end
-            # end
-
-            # # @controller_action_param :name [String] The name of the new dashboard
-            # # @controller_action_param :default [Boolean] A flag that marks this dashboard as default or not. The default dashboard is the dashboard all users will have access to on the root page
-            # # @controller_action_param :main    [Boolean] A flag that marks this dashboard as main. Since a user can have multiple dashboards, this is the one they will see on the root page when loging in
-            # # @controller_action_param :roles_id [Integer] The id of the role that will have access to this dashboard
-            # # @controller_action_param :user_main_id [Integer] The id of the user 
-            # # @controller_action_param :component_attributes [Array] Array of hashes that represent the attributes of the dashboard components
-            # # @controller_action_param :component_attributes.name [String] The name of this component given to the user
-            # # @controller_action_param :component_attributes.component_id [String] An enum value, that indicates which component is being loaded
-            # # @controller_action_param :component_attributes.layout [Integer] Number from 1 to 12, bigger numbers default to 12, smallest numbers default to 1. The column size that the UI component will use
-            # # @controller_action_param :component_attributes.index [Integer] The position of the component in the layout
-            # # @controller_action_param :component_attributes.configuration [Hash] Specific filtering and configuration of the components
-            # # @return [Json] Json that contains wheter the dashboard was successfully updated or not. 
-            # #     If it it not successful, it returns an error message
-            # # @description Updates an existing dashboard associated to the *current_user*'s *account*.
-            # # @example
-            # # # Executing this controller's action from javascript's frontend
-            # # let dashboard_id = 4;
-            # # let data = {
-            # #     dashboard: {
-            # #         name: "Sales Dashboard",
-            # #         default: false,
-            # #         roles_id: 3,
-            # #         components_attributes: [
-            # #             {
-            # #                 name: 'Projects Count',
-            # #                 component_id: projects_component,
-            # #                 layout: 4,
-            # #                 index: 3,
-            # #                 configuration: {}
-            # #             }, {
-            # #                 name: 'New Customers Count',
-            # #                 component_id: new_customers_component,
-            # #                 layout: 4,
-            # #                 index: 3,
-            # #                 configuration: {}
-            # #             }
-            # #         ]
-            # #     }
-            # # };
-            # # this.http.put(`127.0.0.1/help/dashboards/${dashboard_id}`, data);
-            # def update
-            #     return respond_with_not_found unless @dashboard
-
-            #     if @dashboard.update(dashboard_params)
-            #         respond_with_successful(@dashboard.show)
-            #     else
-            #         respond_with_error(@dashboard.errors.full_messages.to_sentence)
-            #     end
-            # end
-
-            # # @return [Json] Json that contains wheter the dashboard was successfully deleted or not. 
-            # #     If it it not successful, it returns an error message
-            # # @description Deletes an existing *dashboard* associated to the *current_user*'s *account*.
-            # #     Since the dashboard has details, these are also deleted. However, if there
-            # #     is an existing *cloud_object* associated to the *dashboard*, it cannot be deleted
-            # # @example
-            # #     # Executing this controller's action from javascript's frontend
-            # #     let dashboard_id = 4;
-            # #     this.http.delete(`127.0.0.1/help/dashboards/${dashboard_id}`);
-            # def destroy
-            #     return respond_with_not_found unless @dashboard
-
-            #     if @dashboard.destroy
-            #         respond_with_successful
-            #     else
-            #         respond_with_error(@dashboard.errors.full_messages.to_sentence)
-            #     end
-            # end
 
-            # def options
-            #     dynamic_info = self.class.dynamic_info
-            #     model = dynamic_info[:module_model]
+        # Try to create an instance of the main controller from the engine
+        DASH = "::LesliDashboard::Shared::DashboardsController".safe_constantize
 
-            #     respond_with_successful(model.options(current_user, @query))
-            # end
-
-            # def resource_component
-            #     dynamic_info = self.class.dynamic_info
-            #     component_model = dynamic_info[:component_model]
-
-            #     component_id = sanitize(params[:component_id].to_sym)
-
-            #     # We verify if the method exists, and if it is in the available component list
-            #     if component_model.respond_to?(component_id) && component_model.component_ids[component_id]
-            #         respond_with_successful(component_model.public_send(component_id, current_user, @query))
-            #     else
-            #         respond_with_not_found()
-            #     end
-            # end
-
-            # private
-
-            # # @return [void]
-            # # @description Sets the variable @dashboard. The variable contains the *cloud_object* *dashboard* 
-            # #     to be handled by the controller action that called this method
-            # # @example
-            # #     #suppose params[:id] = 1
-            # #     puts @dashboard # will display nil
-            # #     set_dashboard
-            # #     puts @dashboard # will display an instance of CloudHelp:TicketDashboard
-            # def set_dashboard
-            #     dynamic_info = self.class.dynamic_info
-
-            #     model = dynamic_info[:module_model]
-            #     module_name = dynamic_info[:module_name]
-            #     module_name_full = dynamic_info[:module_name_full].underscore
-
-            #     # When params[:id] is 'default' order of priority is:
-            #     # Main dashboard for user goes first
-            #     # Main dashboard for role goes second
-            #     # Default dashboard goes third
-            #     if params[:id] == "default"
-            #         # Main dashboard for user
-            #         @dashboard = model.find_by(
-            #             #"#{full_module_name}_account_id".to_sym => current_user.account.id,
-            #             account_id: current_user.account.id,
-            #             main: true,
-            #             #user_main_id: current_user.id
-            #         )
-
-            #         return if @dashboard
-                    
-            #         # Main dashboard for role
-            #         # @dashboard = model.find_by(
-            #         #     :account_id => current_user.account.id,
-            #         #     role_id: current_user.roles.first.id
-            #         # )
-            #         # return if @dashboard
-
-            #         # Default dashboard
-            #         @dashboard = model.find_by(
-            #             account_id: current_user.account.id,
-            #             default: true
-            #         )
-            #     else
-            #         @dashboard = model.find_by(
-            #             id: params[:id],
-            #             :account_id => current_user.account.id,
-            #         )
-            #     end
-            # end
-
-            # def dashboard_params
-            #     params.require(:dashboard).permit(
-            #         :name,
-            #         :default,
-            #         :roles_id,
-            #         components_attributes: [
-            #             :id,
-            #             :name,
-            #             :component_id,
-            #             :layout,
-            #             :index,
-            #             {query_configuration: {}},
-            #             {custom_configuration: {}},
-            #             :_destroy
-            #         ]
-            #     )
-            # end
-
-            # private
-
-            # # Build the Rails models and engine information for 
-            # # the current engine implementing the shared dashboards
-            # # Example: For the LesliAudit engine
-            # # {
-            # #     :module_name => "audit", 
-            # #     :module_name_full => "LesliAudit", 
-            # #     :module_model => "LesliAudit::Dashboard", 
-            # #     :module_model_component => "LesliAudit::Dashboard::Component"
-            # # }
-            # def self.dynamic_info
-
-            #     module_info = self.name.split("::")
+        # Create a dummy contoller if the LesliDashboard controller is not installed
+        class DashboardsFallbackController < ApplicationLesliController
+        end
 
-            #     module_name = module_info[0].sub("Lesli", "").downcase
-                
-            #     {
-            #         module_name: module_name,
-            #         module_name_full: module_info[0],
-            #         module_model: "#{ module_info[0] }::Dashboard".constantize,
-            #         module_model_component: "#{ module_info[0] }::Dashboard::Component".constantize
-            #     }
-            # end
+        # Inherit from the available controller from 
+        # LesliDashboard if installed or use dummy controller to avoid any error
+        class DashboardsController < DASH || DashboardsFallbackController
         end
     end
 end

data/app/helpers/lesli/customization_helper.rb

@@ -48,13 +48,13 @@ module Lesli
             logo_path = "#{lesli_instance_code}/brand/#{logo}.svg"
 
             # load favicon as PNG for better compatibility between web browsers
-            logo_path = "#{lesli_instance_code}/brand/#{logo}.png" if logo == "favicon"
+            #logo_path = "#{lesli_instance_code}/brand/#{logo}.png" if logo == "favicon"
 
             # loading logo from core, only if builder engine was not installed
-            logo_path = "lesli/brand/#{logo}.svg" if lesli_instance_code == "lesli"
+            #logo_path = "lesli/brand/#{logo}.svg" if lesli_instance_code == "lesli"
 
             # custom logo from settings
-            logo_path = @lesli[:customization][:logos][logo.to_sym] if @lesli.dig(:customization, :logos, logo.to_sym)
+            #logo_path = @lesli[:customization][:logos][logo.to_sym] if @lesli.dig(:customization, :logos, logo.to_sym)
 
             if mode == "pdf"
                 wicked_pdf_image_tag(logo_path, options)

data/app/helpers/lesli/html_helper.rb

@@ -1,8 +1,120 @@
+=begin
+
+Lesli
+
+Copyright (c) 2026, Lesli Technologies, S. A.
+
+This program is free software: you can redistribute it and/or modify
+it under the terms of the GNU General Public License as published by
+the Free Software Foundation, either version 3 of the License, or
+(at your option) any later version.
+
+This program is distributed in the hope that it will be useful,
+but WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+GNU General Public License for more details.
+
+You should have received a copy of the GNU General Public License
+along with this program. If not, see http://www.gnu.org/licenses/.
+
+Lesli · Ruby on Rails SaaS Development Framework.
+
+Made with ♥ by LesliTech
+Building a better future, one line of code at a time.
+
+@contact  hello@lesli.tech
+@website  https://www.lesli.tech
+@license  GPLv3 http://www.gnu.org/licenses/gpl-3.0.en.html
+
+// · ~·~     ~·~     ~·~     ~·~     ~·~     ~·~     ~·~     ~·~     ~·~
+// · 
+=end
 
 module Lesli
     module HtmlHelper
-        def turbo_link_to body, url, html_options = {}
-            link_to(body, url, class: "link", data: { turbo_frame: '_top' })
+
+        # Prints link tags to add favicon to websites
+        def lesli_favicon
+            icon_path = image_url("lesli/brand/favicon.svg")
+            safe_join([
+                tag.link(href: icon_path, rel: "alternate icon"),
+                tag.link(href: icon_path, rel: "icon", type: "image/svg+xml"),
+                tag.link(href: icon_path, rel: "mask-icon", color: "#ff8a01")
+            ])
+        end
+
+        # build the text for the html document title
+        # this helper works only for rails pages, for vue apps the title must be handled with JS
+        def lesli_website_title
+            # Use instance variable if set, otherwise construct a dynamic title
+            title = @application_html_title || controller_path.delete_prefix("lesli_")
+
+            # Append action name unless it's "index"
+            title += "/#{action_name}" unless action_name == "index"
+
+            # Append company name if present
+            title += " · #{Lesli.config.company.dig(:name)}"
+
+            title
+        end
+
+        # build description using custom data from controller or engine gem description
+        def lesli_website_meta_description
+            # if want to get description from gem you can use:
+            # Gem::Specification.find_by_name(engine_name).description
+            # Gem::Specification.find_by_name(engine_name).summary
+            @application_html_description || ""
+        end
+
+        # return a string with a css class to identify the body
+        # example: builder engine-controller action
+        def lesli_application_body_class
+            [lesli_instance_code, controller_path.sub("_","-").split("/"), action_name].join(" ")
+        end
+
+        # Return a string path to load the template stylesheet
+        # by default we always return the latest version of the template
+        #
+        # stylesheet from main App
+        # lesli_stylesheet_path()               
+        # /assets/application.css
+        #
+        # Specific stylesheet from Engine
+        # lesli_stylesheet_path(:lesli, 'application') 
+        # /assets/lesli/application.css
+        #
+        # Specific stylesheet from gem
+        # lesli_stylesheet_path(:lesli_assets, 'templates/application')
+        # /assets/lesli_assets/templates/application.css
+        def lesli_stylesheet_path(engine = nil, stylesheet = 'application')
+
+            # Stylesheets from specific engine
+            return "#{engine}/#{stylesheet}" if engine.present?
+
+            # Get current engine information
+            engine_code = lesli_engine(:code)
+
+            # Rails main host app stylesheets
+            return 'application' if engine_code == 'root'
+
+            # Rails engines stylesheets
+            "#{engine_code}/#{stylesheet}"
+        end
+
+        # print a custom icon for lesli
+        def lesli_svg(name)
+            content_tag("svg", width: "64px", height: "64px") do
+                "<use xlink:href='##{name}'></use>".html_safe
+            end
+        end
+
+        # Prints objects as JSON code
+        def dd object
+            content_tag(:pre) do 
+                content_tag(:code) do
+                    ERB::Util.html_escape JSON.pretty_generate(object.as_json)
+                end 
+            end 
         end
     end
 end

data/app/helpers/lesli/navigation_helper.rb

@@ -2,7 +2,7 @@
 
 Lesli
 
-Copyright (c) 2023, Lesli Technologies, S. A.
+Copyright (c) 2026, Lesli Technologies, S. A.
 
 This program is free software: you can redistribute it and/or modify
 it under the terms of the GNU General Public License as published by
@@ -68,29 +68,6 @@ module Lesli
             end
         end
 
-        def navigation_link_vue(path, label, icon = nil, reload: false)
-            # default vue router links for single page applications
-            html_element = "router-link"
-            html_options = { to: path, 'active-class': "navigation-link-active" }
-
-            # if reload is nedeed, we use a standard "a" tag
-            if reload
-                html_element = "a"
-                html_options = { href: path }
-            end
-
-            content_tag(html_element, html_options) do
-                # print a simple menu item (without icon)
-                concat content_tag(:span, label, class: "text iconless") unless icon
-
-                # print a full menu item if icon was requested
-                if icon
-                    concat content_tag(:span, nil, class: icon)
-                    concat content_tag(:span, label, class: "text")
-                end
-            end
-        end
-
         # ADMINISTRATION
 
         # 01.01 Admin engine
@@ -107,6 +84,12 @@ module Lesli
 
         # SALES & MARKETING
 
+        # 02.02 Contacts engine
+        def navigation_engine_contacts(title: "Contacts", subtitle: "Customer Relationship Management")
+            return unless defined? LesliContacts
+            navigation_engine_item(title,subtitle,"contacts",lesli_contacts.root_path,controller_path.include?("lesli_contacts"))
+        end
+
         # 02.04 House engine
         def navigation_engine_house(title: "House", subtitle: "cloud_house/house-logo.svg")
             return unless defined? CloudHouse
@@ -266,7 +249,7 @@ module Lesli
         # SECURITY & PRIVACY
 
         # 08.01 Shield engine
-        def navigation_engine_shield(title: "Shield", subtitle: "Authentication & Authorization")
+        def navigation_engine_shield(title: "Shield", subtitle: "Users & Security Management")
             return unless defined? LesliShield
             navigation_engine_item(title, subtitle, "shield", lesli_shield.root_path, controller_path.include?("lesli_shield"))
         end

data/app/helpers/lesli/system_helper.rb

@@ -2,7 +2,7 @@
 
 Lesli
 
-Copyright (c) 2023, Lesli Technologies, S. A.
+Copyright (c) 2026, Lesli Technologies, S. A.
 
 This program is free software: you can redistribute it and/or modify
 it under the terms of the GNU General Public License as published by
@@ -19,19 +19,36 @@ along with this program. If not, see http://www.gnu.org/licenses/.
 
 Lesli · Ruby on Rails SaaS Development Framework.
 
-Made with ♥ by https://www.lesli.tech
+Made with ♥ by LesliTech
 Building a better future, one line of code at a time.
 
 @contact  hello@lesli.tech
-@website  https://www.lesli.dev
+@website  https://www.lesli.tech
 @license  GPLv3 http://www.gnu.org/licenses/gpl-3.0.en.html
 
 // · ~·~     ~·~     ~·~     ~·~     ~·~     ~·~     ~·~     ~·~     ~·~
-// ·
+// · 
 =end
 
 module Lesli
     module SystemHelper
+
+        # build a url path to change locales
+        def language_url(locale)
+            "/lesli/language?locale=#{locale}"
+        end
+
+        # return flag code according to locale code
+        def language_flag(locale)
+            locale = "gb" if locale.to_s == "en"
+            locale
+        end
+
+        # return the name of the language
+        def language_name(locale)
+            Lesli.config.locales.dig(locale) || "undefined"
+        end
+
         # return the engine code of the controller that is handling the http request
         def lesli_controller
             controller_path.split("/")[0]

data/app/helpers/lesli/turbo_helper.rb

@@ -2,7 +2,7 @@
 
 Lesli
 
-Copyright (c) 2023, Lesli Technologies, S. A.
+Copyright (c) 2026, Lesli Technologies, S. A.
 
 This program is free software: you can redistribute it and/or modify
 it under the terms of the GNU General Public License as published by
@@ -32,7 +32,24 @@ Building a better future, one line of code at a time.
 
 module Lesli
     module TurboHelper
-        def render_notifications_stream
+
+        def turbo_link_to body, url, html_options = {}
+            link_to(body, url, class: "link", data: { turbo_frame: '_top' })
+        end
+
+        # Meta-programming to define flash setter methods dynamically
+        # success("Everything worked!")
+        # danger("Oops, there was an error.")
+        # info("Just an informational message.")
+        # warning("This is a warning.")
+        [:info, :success, :warning, :danger].each do |flash_type|
+            define_method(flash_type) do |message|
+                flash[flash_type] = message
+            end
+        end
+
+        def stream_notification_success(message)
+            success(message)
             turbo_stream.replace("application-lesli-notifications") do
                 render("lesli/partials/application-lesli-notifications")
             end

data/app/interfaces/lesli/requester_interface.rb

@@ -2,7 +2,7 @@
 
 Lesli
 
-Copyright (c) 2023, Lesli Technologies, S. A.
+Copyright (c) 2026, Lesli Technologies, S. A.
 
 This program is free software: you can redistribute it and/or modify
 it under the terms of the GNU General Public License as published by
@@ -19,7 +19,7 @@ along with this program. If not, see http://www.gnu.org/licenses/.
 
 Lesli · Ruby on Rails SaaS Development Framework.
 
-Made with ♥ by https://www.lesli.tech
+Made with ♥ by LesliTech
 Building a better future, one line of code at a time.
 
 @contact  hello@lesli.tech
@@ -33,10 +33,6 @@ Building a better future, one line of code at a time.
 module Lesli
     module RequesterInterface
 
-        def set_path
-            @@engine_path = Lesli::Engine.routes.find_script_name({})
-        end
-
         # Set the user language based on user_settings, session configuration or instance default locale
         def set_locale
             # get saved language in session, browser language or the default in config
@@ -76,28 +72,5 @@ module Lesli
                 }
             }
         end
-
-        def get_user_agent(as_string=true)
-
-            http_user_agent = request.env["HTTP_USER_AGENT"]
-
-            # parse user agent
-            user_agent = UserAgent.parse(http_user_agent)
-
-            user_agent_version = user_agent.version.to_a.first(2).join(".")
-
-            # return user agent as object
-            if as_string == false
-                return {
-                    platform: user_agent.platform,
-                    os: user_agent.os,
-                    browser: user_agent.browser,
-                    version: user_agent_version
-                }
-            end
-
-            # return user agent info as string
-            "#{user_agent.platform} #{user_agent.os} - #{user_agent.browser} #{user_agent_version}"
-        end
     end
 end