django-spire 0.16.10__py3-none-any.whl → 0.16.12__py3-none-any.whl

django_spire/file/apps.py

@@ -1,4 +1,5 @@
 from django.apps import AppConfig
+from django.conf import settings
 
 from django_spire.utils import check_required_apps
 
@@ -13,4 +14,16 @@ class FileConfig(AppConfig):
     URLPATTERNS_NAMESPACE = 'file'
 
     def ready(self) -> None:
+        if not hasattr(settings, 'BASE_FOLDER_NAME'):
+            raise ValueError(
+                f'"BASE_FOLDER_NAME" must be set in the django settings when '
+                f'using "{self.label}".'
+            )
+
+        elif not isinstance(getattr(settings, 'BASE_FOLDER_NAME'), str):
+            raise ValueError(
+                f'"BASE_FOLDER_NAME" must be a string in the django settings when '
+                f'using "{self.label}".'
+            )
+
         check_required_apps(self.label)

django_spire/file/interfaces.py

@@ -2,6 +2,9 @@ from __future__ import annotations
 
 from abc import ABC, abstractmethod
 from dataclasses import dataclass
+
+from django.conf import settings
+from django.core.files.base import ContentFile
 from typing_extensions import TYPE_CHECKING
 
 from django.contrib.contenttypes.models import ContentType
@@ -35,16 +38,27 @@ class FileFormatter:
 
     @property
     def location(self) -> str:
-        return'django-spire/' + str(self.related_field) + '/' + '/' + str(self.app_name) + '/' + random_64_char_token() + '/' + self.name
+        location = settings.BASE_FOLDER_NAME + '/'
+        location += str(self.app_name) + '/'
+
+        if self.related_field is not None:
+            location += str(self.related_field) + '/'
+
+        location += random_64_char_token() + '/'
+        location += self.name
+
+        return location
 
     def null_file_obj(self) -> File:
-        return File(
-            file=self.file,
+        file_obj = File(
             name=self.name,
             size=self.size_verbose(),
             type=self.type,
-            related_field=self.related_field
+            related_field=self.related_field,
         )
+        self.save_file(file_obj)
+
+        return file_obj
 
     def size_verbose(self) -> str:
         if self.file.size < 512000:
@@ -62,6 +76,10 @@ class FileFormatter:
 
         return str(value) + ext
 
+    def save_file(self, file_obj: File):
+        file_path = self.location + '.' + self.type
+        file_obj.file.save(file_path, ContentFile(self.file.read()), save=False)
+
 
 @dataclass
 class FileContentObjectFormatter(FileFormatter):
@@ -69,26 +87,41 @@ class FileContentObjectFormatter(FileFormatter):
 
     @property
     def location(self) -> str:
-        return 'django-spire/' + '/' + str(self.content_object._meta.app_label) + '/' + random_64_char_token() + '/' + self.name
+        location = settings.BASE_FOLDER_NAME + '/'
+        location += str(self.content_object._meta.app_label) + '/'
+
+        if self.related_field is not None:
+            location += str(self.related_field) + '/'
+
+        location += random_64_char_token() + '/'
+        location += self.name
+        return location
 
     def null_file_obj(self) -> File:
-        return File(
+        file_obj = File(
             content_type=ContentType.objects.get_for_model(self.content_object),
             object_id=self.content_object.id,
-            file=self.file,
             name=self.name,
             size=self.size_verbose(),
             type=self.type,
-            related_field=self.related_field
+            related_field=self.related_field,
         )
+        self.save_file(file_obj)
+
+        return file_obj
 
 
 @dataclass
 class FileUploader(ABC):
     related_field: str | None
+    app_name: str = 'Uncategorized'
 
     def null_file_obj(self, file):
-        formatted_file = FileFormatter(file, self.related_field)
+        formatted_file = FileFormatter(
+            file=file,
+            related_field=self.related_field,
+            app_name=self.app_name
+        )
         return formatted_file.null_file_obj()
 
     @abstractmethod

django_spire/help_desk/apps.py

@@ -7,6 +7,14 @@ class HelpDeskConfig(AppConfig):
     default_auto_field = 'django.db.models.BigAutoField'
     label = 'django_spire_help_desk'
     name = 'django_spire.help_desk'
+    MODEL_PERMISSIONS = (
+        {
+            'name': 'help_desk',
+            'verbose_name': 'Help Desk',
+            'model_class_path': 'django_spire.help_desk.models.HelpDeskTicket',
+            'is_proxy_model': False,
+        },
+    )
 
     REQUIRED_APPS = ('django_spire_core',)
     URLPATTERNS_INCLUDE = 'django_spire.help_desk.urls'

django_spire/help_desk/auth/controller.py

@@ -0,0 +1,15 @@
+from django_spire.auth.controller.controller import BaseAuthController
+
+
+class BaseHelpDeskAuthController(BaseAuthController):
+    def can_add(self):
+        return self.request.user.has_perm('django_spire_help_desk.add_helpdeskticket')
+
+    def can_change(self):
+        return self.request.user.has_perm('django_spire_help_desk.change_helpdeskticket')
+
+    def can_delete(self):
+        return self.request.user.has_perm('django_spire_help_desk.delete_helpdeskticket')
+
+    def can_view(self):
+        return self.request.user.has_perm('django_spire_help_desk.view_helpdeskticket')

django_spire/help_desk/templates/django_spire/help_desk/card/ticket_detail_card.html

@@ -7,15 +7,9 @@
 {% endblock %}
 
 {% block card_button %}
-    {% if perms.django_spire_help_desk.change_helpdeskticket %}
-        <div class="pe-3">
-            {% url 'django_spire:help_desk:form:update' pk=ticket.pk as edit_url %}
-            {% include 'django_spire/button/primary_button.html' with button_text='Edit' button_href=edit_url button_icon='bi bi-pencil' %}
-        </div>
-    {% endif %}
-    {% if perms.django_spire_help_desk.delete_helpdeskticket %}
-        {% url 'django_spire:help_desk:page:delete' pk=ticket.pk as delete_url %}
-        {% include 'django_spire/button/danger_button.html' with button_text='Delete' button_href=delete_url button_icon='bi bi-trash' %}
+    {% if AuthController.help_desk.can_change %}
+        {% url 'django_spire:help_desk:form:update' pk=ticket.pk as edit_url %}
+        {% include 'django_spire/button/primary_button.html' with button_text='Edit' button_href=edit_url button_icon='bi bi-pencil' %}
     {% endif %}
 {% endblock %}
 

django_spire/help_desk/templates/django_spire/help_desk/card/ticket_list_card.html

@@ -3,17 +3,16 @@
 {% block card_title_content_style %}{% endblock %}
 
 {% block card_title %}
-    <div class="row justify-content-between">
-        <div class="col text-start">
-            Tickets
+    Tickets
+{% endblock %}
+
+{% block card_button %}
+    {% if AuthController.help_desk.can_add %}
+        <div class="col text-end mb-1">
+            {% url 'django_spire:help_desk:form:create' as create_url %}
+            {% include 'django_spire/button/primary_button.html' with button_text='Add' button_href=create_url button_icon="bi bi-plus" %}
         </div>
-        {% if perms.django_spire_help_desk.add_helpdeskticket %}
-            <div class="col text-end mb-1">
-                {% url 'django_spire:help_desk:form:create' as create_url %}
-                {% include 'django_spire/button/primary_button.html' with button_text='Add' button_href=create_url button_icon="bi bi-plus" %}
-            </div>
-        {% endif %}
-    </div>
+    {% endif %}
 {% endblock %}
 
 {% block card_title_content %}

django_spire/help_desk/templates/django_spire/help_desk/element/icon.html

@@ -0,0 +1,3 @@
+<a href="{% url 'django_spire:help_desk:page:list' %}">
+    <i class="bi bi-headset fs-2 mx-2 text-app-default-text-color"></i>
+</a>

django_spire/help_desk/templates/django_spire/help_desk/form/ticket_form.html

@@ -25,7 +25,7 @@
     <div class="col-12 mb-1 mt-3">
         {% include 'django_glue/form/field/text_field.html' with glue_model_field='ticket.description' %}
     </div>
-    <div class="text-end my-2">
+    <div class="my-2">
         {% include 'django_spire/contrib/form/button/form_submit_button.html' %}
     </div>
 </form>

django_spire/help_desk/templates/django_spire/help_desk/item/ticket_item.html

@@ -1,37 +1,38 @@
 {% extends 'django_spire/item/item.html' %}
 
-{% block item_title_col %}d-none{% endblock %}
+{% block item_title_col %}{% endblock %}
 
 {% block item_row_content %}
-        <a class="col-12 col-sm-4 mb-2 mb-sm-0" href="{% url 'django_spire:help_desk:page:detail' pk=ticket.pk %}">
-            {% include 'django_spire/element/attribute_element.html' with attribute_title=ticket attribute_value=ticket.description|truncatechars:50 %}
-        </a>
-        <div class="col-6 col-sm-2 mb-2 mb-sm-0 text-start">
-            {% include 'django_spire/element/attribute_element.html' with attribute_value=ticket.created_by.get_full_name attribute_title='Created By' %}
-        </div>
-        <div class="col-6 col-sm-2 mb-2 mb-sm-0 text-start">
-            {% include 'django_spire/element/attribute_element.html' with attribute_value=ticket.created_datetime|date:'M d, Y' attribute_title='Created At' %}
-        </div>
-        <div class="col">
-            {% include 'django_spire/element/attribute_element.html' with attribute_title='Purpose' %}
-            {% include 'django_spire/help_desk/element/ticket_purpose_badge.html' %}
-        </div>
-        <div class="col">
-            {% include 'django_spire/element/attribute_element.html' with attribute_title='Priority' %}
-            {% include 'django_spire/help_desk/element/ticket_priority_badge.html' %}
-        </div>
-        <div class="col">
-            {% include 'django_spire/element/attribute_element.html' with attribute_title='Status' %}
-            {% include 'django_spire/help_desk/element/ticket_status_badge.html' %}
-        </div>
-        <div class="col-6 col-sm-1 text-end">
-            {% url 'django_spire:help_desk:page:detail' pk=ticket.pk as detail_url %}
-            {% if perms.django_spire_help_desk.change_helpdeskticket %}
-                {% url 'django_spire:help_desk:form:update' pk=ticket.pk as update_url %}
-            {% endif %}
-            {% if perms.django_spire_help_desk.delete_helpdeskticket %}
-                {% url 'django_spire:help_desk:page:delete' pk=ticket.pk as delete_url %}
-            {% endif %}
-            {% include 'django_spire/dropdown/ellipsis_dropdown.html' with view_url=detail_url edit_url=update_url delete_url=delete_url %}
-        </div>
+    <a class="col-12 col-sm-4 mb-2 mb-sm-0" href="{% url 'django_spire:help_desk:page:detail' pk=ticket.pk %}">
+        {% include 'django_spire/element/attribute_element.html' with attribute_value=ticket.description|truncatechars:50 %}
+    </a>
+    <div class="col-6 col-sm-2 mb-2 mb-sm-0 text-start">
+        {% include 'django_spire/element/attribute_element.html' with attribute_value=ticket.created_by.get_full_name attribute_title='Created By' %}
+    </div>
+    <div class="col-6 col-sm-2 mb-2 mb-sm-0 text-start">
+        {% include 'django_spire/element/attribute_element.html' with attribute_value=ticket.created_datetime|date:'M d, Y' attribute_title='Created At' %}
+    </div>
+    <div class="col">
+        {% include 'django_spire/element/attribute_element.html' with attribute_title='Purpose' %}
+        {% include 'django_spire/help_desk/element/ticket_purpose_badge.html' %}
+    </div>
+    <div class="col">
+        {% include 'django_spire/element/attribute_element.html' with attribute_title='Priority' %}
+        {% include 'django_spire/help_desk/element/ticket_priority_badge.html' %}
+    </div>
+    <div class="col">
+        {% include 'django_spire/element/attribute_element.html' with attribute_title='Status' %}
+        {% include 'django_spire/help_desk/element/ticket_status_badge.html' %}
+    </div>
+{% endblock %}
+
+{% block item_button %}
+    {% url 'django_spire:help_desk:page:detail' pk=ticket.pk as detail_url %}
+    {% if AuthController.help_desk.can_change %}
+        {% url 'django_spire:help_desk:form:update' pk=ticket.pk as update_url %}
+    {% endif %}
+    {% if AuthController.help_desk.can_delete %}
+        {% url 'django_spire:help_desk:page:delete' pk=ticket.pk as delete_url %}
+    {% endif %}
+    {% include 'django_spire/dropdown/ellipsis_dropdown.html' with view_url=detail_url edit_url=update_url delete_url=delete_url %}
 {% endblock %}

django_spire/help_desk/views/form_views.py

@@ -2,14 +2,14 @@ import django_glue as dg
 from django.shortcuts import redirect, get_object_or_404
 from django.urls import reverse
 
-from django_spire.auth.permissions.decorators import permission_required
+from django_spire.auth.controller.controller import AppAuthController
 from django_spire.contrib.form.utils import show_form_errors
 from django_spire.contrib.generic_views import portal_views
 from django_spire.help_desk import forms
 from django_spire.help_desk.models import HelpDeskTicket
 
 
-@permission_required('django_spire_help_desk.add_helpdeskticket')
+@AppAuthController('help_desk').permission_required('can_add')
 def ticket_create_form_view(request):
     ticket = HelpDeskTicket()
 
@@ -42,7 +42,7 @@ def ticket_create_form_view(request):
     )
 
 
-@permission_required('django_spire_help_desk.change_helpdeskticket')
+@AppAuthController('help_desk').permission_required('can_change')
 def ticket_update_form_view(request, pk: int):
     ticket = get_object_or_404(HelpDeskTicket, pk=pk)
 

django_spire/help_desk/views/page_views.py

@@ -1,13 +1,12 @@
-from django.contrib.auth.decorators import login_required
 from django.shortcuts import get_object_or_404
 from django.urls import reverse
 
-from django_spire.auth.permissions.decorators import permission_required
+from django_spire.auth.controller.controller import AppAuthController
 from django_spire.contrib.generic_views import portal_views
 from django_spire.help_desk.models import HelpDeskTicket
 
 
-@permission_required('django_spire_help_desk.delete_helpdeskticket')
+@AppAuthController('help_desk').permission_required('can_delete')
 def ticket_delete_view(request, pk):
     ticket = get_object_or_404(HelpDeskTicket, pk=pk)
 
@@ -21,7 +20,7 @@ def ticket_delete_view(request, pk):
     )
 
 
-@login_required()
+@AppAuthController('help_desk').permission_required('can_view')
 def ticket_detail_view(request, pk):
     ticket = get_object_or_404(HelpDeskTicket, pk=pk)
 
@@ -35,7 +34,7 @@ def ticket_detail_view(request, pk):
     )
 
 
-@login_required()
+@AppAuthController('help_desk').permission_required('can_view')
 def ticket_list_view(request):
     tickets = HelpDeskTicket.objects.order_by('-created_datetime').active()
 

django_spire/knowledge/entry/services/automation_service.py

@@ -35,11 +35,9 @@ class EntryAutomationService(BaseDjangoModelService['Entry']):
                 )
             except Exception as e:
                 errored.append({'file': file_object.name, 'error': str(e)})
-                file_object.file.delete()
-                file_object.delete()
+                file_object.set_deleted()
             else:
-                file_object.file.delete()
-                file_object.delete()
+                file_object.set_deleted()
 
         message = f'Files Converted: {len(file_objects) - len(errored)}'
         if errored:

django_spire/knowledge/entry/services/factory_service.py

@@ -7,7 +7,6 @@ from django.contrib.contenttypes.models import ContentType
 from django_spire.auth.user.models import AuthUser
 from django_spire.contrib.service import BaseDjangoModelService
 from django_spire.file.models import File
-from django_spire.knowledge.entry.tests.constants import ENTRY_IMPORT_RELATED_FIELD
 
 if TYPE_CHECKING:
     from django_spire.knowledge.entry.models import Entry
@@ -34,7 +33,7 @@ class EntryFactoryService(BaseDjangoModelService['Entry']):
 
             file.content_type = ContentType.objects.get_for_model(entry.__class__)
             file.object_id = entry.id
-            file.related_field = ENTRY_IMPORT_RELATED_FIELD
+            file.related_field = None
 
             entry.ordering_services.processor.move_to_position(
                 destination_objects=collection.entries.active(),

django_spire/knowledge/entry/services/tool_service.py

@@ -7,7 +7,6 @@ from django.contrib.contenttypes.models import ContentType
 
 from django_spire.contrib.service import BaseDjangoModelService
 from django_spire.file.models import File
-from django_spire.knowledge.entry.tests.constants import ENTRY_IMPORT_RELATED_FIELD
 
 if TYPE_CHECKING:
     from django.db.models import QuerySet
@@ -19,7 +18,7 @@ class EntryToolService(BaseDjangoModelService['Entry']):
 
     def get_files_to_convert(self) -> QuerySet[File]:
         return (
-            File.objects.related_field(field_name=ENTRY_IMPORT_RELATED_FIELD)
+            File.objects
             .filter(content_type=ContentType.objects.get_for_model(self.obj_class))
             .active()
             .order_by('object_id')

django_spire/knowledge/entry/version/converters/docx_converter.py

@@ -29,7 +29,7 @@ class DocxConverter(BaseConverter):
 
     def convert_file_to_blocks(self, file: File) -> list[models.EntryVersionBlock]:
         markitdown = MarkItDown()
-        markdown_result = markitdown.convert(file.file.path)
+        markdown_result = markitdown.convert(file.file.url)
         markdown_content = markdown_result.markdown
 
         markdown_converter = MarkdownConverter(entry_version=self.entry_version)

django_spire/knowledge/entry/version/converters/markdown_converter.py

@@ -7,6 +7,7 @@ import marko
 
 from typing import TYPE_CHECKING
 
+from django.core.files.storage import default_storage
 from marko.element import Element
 from marko.block import Heading, List, ListItem
 
@@ -31,7 +32,7 @@ class MarkdownConverter(BaseConverter):
         self._order = 0
 
     def convert_file_to_blocks(self, file: File) -> list[models.EntryVersionBlock]:
-        with open(file.file.path, 'r') as f:
+        with default_storage.open(file.file.name, 'r') as f:
             return self.convert_markdown_to_blocks(f.read())
 
     def _convert_heading_block(

django_spire/knowledge/entry/views/form_views.py

@@ -84,9 +84,11 @@ def import_form_view(
         file_form = EntryFilesForm(request.POST, request.FILES)
 
         if file_form.is_valid():
-            file_objects = MultiFileUploader(related_field=None).upload(
-                request.FILES.getlist('import_files')
+            file_uploader = MultiFileUploader(
+                related_field=None,
+                app_name='knowledge'
             )
+            file_objects = file_uploader.upload(request.FILES.getlist('import_files'))
 
             _ = Entry.services.factory.create_from_files(
                 author=request.user,

django_spire/knowledge/entry/views/json_views.py

@@ -41,7 +41,7 @@ def reorder_view(request: WSGIRequest) -> JsonResponse:
         destination_objects=(
             collection.entries
             .has_current_version()
-            .request_user_has_access(user=request.user)
+            .user_has_access(user=request.user)
             .active()
         ),
         position=order,

django_spire/knowledge/templates/django_spire/knowledge/collection/card/context_menu_card.html

@@ -7,23 +7,23 @@
         top: y + 'px',
         left: x + 'px',
     }"
-    class="position-fixed card shadow-lg z-3 vstack cursor-pointer bg-app-layer-one"
+    class="position-fixed card shadow-lg z-3 vstack cursor-pointer bg-app-layer-one border"
     @click.away="hide_menu()"
 >
     <span class="px-2 py-1" x-text="title"></span>
 
     {% if AuthController.knowledge.can_change %}
-        <span class="border-top bg-app-layer-one-hover px-3 text-app-default-link-color" @click="edit_collection()">
+        <span class="border-top bg-app-layer-three-hover px-3 text-app-default-link-color dropdown-item" @click="edit_collection()">
             <i class="bi bi-pencil pe-1"></i>
             Edit Collection
         </span>
     {% endif %}
     {% if AuthController.knowledge.can_add %}
-        <span class="border-top bg-app-layer-one-hover px-3 text-app-default-link-color" @click="add_entry()">
+        <span class="bg-app-layer-three-hover px-3 text-app-default-link-color dropdown-item" @click="add_entry()">
             <i class="bi bi-plus pe-1"></i>
             Add Entry
         </span>
-        <span class="border-top bg-app-layer-one-hover px-3 text-app-default-link-color" @click="import_entry()">
+        <span class="bg-app-layer-three-hover px-3 text-app-default-link-color dropdown-item" @click="import_entry()">
             <i class="bi bi-upload pe-1">
             </i>
             Import Entry
@@ -31,7 +31,7 @@
     {% endif %}
 
     {% if AuthController.knowledge.can_delete %}
-        <span class="border-top bg-app-layer-one-hover px-3 text-app-danger" @click="delete_collection()">
+        <span class="bg-app-layer-three-hover px-3 text-app-danger dropdown-item" @click="delete_collection()">
             <i class="bi bi-trash3 pe-1"></i>
             <span>Delete Collection</span>
         </span>

django_spire/knowledge/templates/django_spire/knowledge/entry/card/context_menu_card.html

@@ -7,31 +7,31 @@
         top: y + 'px',
         left: x + 'px',
     }"
-    class="position-fixed card shadow-lg z-3 vstack cursor-pointer bg-app-layer-one"
+    class="position-fixed card shadow-lg z-3 vstack cursor-pointer bg-app-layer-one border"
     @click.away="hide_menu()"
 >
     <span class="px-2 py-1" x-text="title"></span>
 
     {% if AuthController.knowledge.can_view %}
-        <span class="border-top bg-app-layer-three-hover px-3 text-app-default-link-color" @click="view_entry()">
+        <span class="border-top bg-app-layer-three-hover px-3 text-app-default-link-color dropdown-item" @click="view_entry()">
             <i class="bi bi-eye pe-1"></i>
             <span>View</span>
         </span>
     {% endif %}
 
     {% if AuthController.knowledge.can_change %}
-        <span class="border-top bg-app-layer-three-hover px-3 text-app-default-link-color" @click="edit_entry()">
+        <span class="bg-app-layer-three-hover px-3 text-app-default-link-color dropdown-item" @click="edit_entry()">
             <i class="bi bi-input-cursor-text pe-1"></i>
             <span>Rename</span>
         </span>
-        <span class="border-top bg-app-layer-three-hover px-3 text-app-default-link-color" @click="edit_entry_version()">
+        <span class="bg-app-layer-three-hover px-3 text-app-default-link-color dropdown-item" @click="edit_entry_version()">
             <i class="bi bi-pencil pe-1"></i>
             <span>Edit</span>
         </span>
     {% endif %}
 
     {% if AuthController.knowledge.can_delete %}
-        <span class="border-top bg-app-layer-three-hover px-3 text-app-danger" @click="delete_entry()">
+        <span class="bg-app-layer-three-hover px-3 text-app-danger dropdown-item" @click="delete_entry()">
             <i class="bi bi-trash3 pe-1"></i>
             <span>Delete</span>
         </span>

django_spire/knowledge/templates/django_spire/knowledge/entry/version/block/dropdown/add_dropdown.html

@@ -12,6 +12,7 @@
 {% block dropdown_content %}
     {% for block_type in block_types %}
         <div
+            class="bg-app-layer-one bg-app-layer-three-hover dropdown-item"
             x-data="{
                 create_block() {
                     create_blank_block({block_type: '{{ block_type.value }}', order: version_block.order + 1})

django_spire/notification/app/templates/django_spire/notification/app/dropdown/notification_dropdown.html

@@ -32,7 +32,7 @@
     class="position-relative">
         <span @click='await render_dropdown()'>
             {% block notification_dropdown_trigger %}
-                <i x-bind='trigger' class="bi bi-bell-fill text-white fs-4 cursor-pointer position-absolute"></i>
+                <i x-bind='trigger' class="bi bi-bell-fill fs-4 cursor-pointer position-absolute"></i>
                 <span x-show="new_notification"  x-cloak style="width: 10px; height: 10px; top: -1px; right: -24px;" class="bg-danger rounded-circle position-absolute"></span>
             {% endblock  %}
         </span>

django_spire/notification/app/templates/django_spire/notification/app/dropdown/notification_dropdown_content.html

@@ -2,14 +2,17 @@
     :style="window.innerWidth < 768
     ? 'width: 350px; position: fixed; top: 5%; left: 50%; transform: translateX(-50%);'
     : 'width: 350px'"
-    class="container border rounded-2"
+    class="container border rounded-2 bg-app-layer-two"
 >
     <div class="col-12 w-100">
-        <h6 class="mt-2 ms-2 text-app-secondary text-center">Notifications</h6>
+        <h6 class="mt-2 ms-2 text-center">Notifications</h6>
         <hr class="m-0">
     </div>
 
-    <div style="max-height: 300px !important; overflow-x: hidden !important; overflow-y: scroll !important;" class="text-start">
+    <div
+        style="max-height: 300px !important;"
+        class="text-start overflow-y-scroll overflow-x-hidden"
+    >
         {% for app_notification in app_notification_list %}
             <div class="col-12">
                 {% include app_notification.template %}

django_spire/settings.py

@@ -1,5 +1,6 @@
 DJANGO_SPIRE_AUTH_CONTROLLERS = {
     'ai_chat': 'django_spire.ai.chat.auth.controller.BaseAiChatAuthController',
+    'help_desk': 'django_spire.help_desk.auth.controller.BaseHelpDeskAuthController',
     'knowledge': 'django_spire.knowledge.auth.controller.BaseKnowledgeAuthController',
 }
 

django_spire/theme/templates/django_spire/theme/card/colors_preview_card.html

@@ -22,19 +22,19 @@
     <div class="preview-sample">
         <div class="d-flex flex-wrap">
             <!-- Primary colors -->
-            <div class="p-2 m-1 bg-app-primary text-white" style="width: 40px; height: 40px;"></div>
-            <div class="p-2 m-1 bg-app-primary-soft text-dark" style="width: 40px; height: 40px;"></div>
-            <div class="p-2 m-1 bg-app-primary-dark text-white" style="width: 40px; height: 40px;"></div>
+            <div class="p-2 m-1 bg-app-primary" style="width: 40px; height: 40px;"></div>
+            <div class="p-2 m-1 bg-app-primary-soft" style="width: 40px; height: 40px;"></div>
+            <div class="p-2 m-1 bg-app-primary-dark" style="width: 40px; height: 40px;"></div>
 
             <!-- Secondary colors -->
-            <div class="p-2 m-1 bg-app-secondary text-white" style="width: 40px; height: 40px;"></div>
-            <div class="p-2 m-1 bg-app-secondary-soft text-dark" style="width: 40px; height: 40px;"></div>
-            <div class="p-2 m-1 bg-app-secondary-dark text-white" style="width: 40px; height: 40px;"></div>
+            <div class="p-2 m-1 bg-app-secondary" style="width: 40px; height: 40px;"></div>
+            <div class="p-2 m-1 bg-app-secondary-soft" style="width: 40px; height: 40px;"></div>
+            <div class="p-2 m-1 bg-app-secondary-dark" style="width: 40px; height: 40px;"></div>
 
             <!-- Accent colors -->
-            <div class="p-2 m-1 bg-app-accent text-white" style="width: 40px; height: 40px;"></div>
-            <div class="p-2 m-1 bg-app-accent-soft text-dark" style="width: 40px; height: 40px;"></div>
-            <div class="p-2 m-1 bg-app-accent-dark text-white" style="width: 40px; height: 40px;"></div>
+            <div class="p-2 m-1 bg-app-accent" style="width: 40px; height: 40px;"></div>
+            <div class="p-2 m-1 bg-app-accent-soft" style="width: 40px; height: 40px;"></div>
+            <div class="p-2 m-1 bg-app-accent-dark" style="width: 40px; height: 40px;"></div>
         </div>
     </div>
 {% endblock %}

django_spire/theme/templates/django_spire/theme/card/example_preview_card.html

@@ -24,11 +24,11 @@
         </div>
         <div class="col text-center">
             {% include 'django_spire/element/attribute_element.html' with attribute_title='Dropdown' %}
-            {% include 'django_spire/dropdown/ellipsis_dropdown.html' with view_url='#' edit_url='#' delete_url='#' %}
+            {% include 'django_spire/dropdown/ellipsis_dropdown.html' with view_url='#' edit_url='#' delete_url='#' link_css='text-start' %}
         </div>
         <div class="col text-center">
             {% include 'django_spire/element/attribute_element.html' with attribute_title='Modal' %}
-            {% include 'django_spire/dropdown/ellipsis_modal_dropdown.html' with view_url='#' edit_url='#' delete_url='#' %}
+            {% include 'django_spire/dropdown/ellipsis_modal_dropdown.html' with view_url='#' edit_url='#' delete_url='#' link_css='text-start' %}
         </div>
     </div>
 {% endblock %}