diff --git a/hub/services/admin/__init__.py b/hub/services/admin/__init__.py
index 3c79092..fba7be9 100644
--- a/hub/services/admin/__init__.py
+++ b/hub/services/admin/__init__.py
@@ -4,6 +4,7 @@
from .articles import *
from .base import *
from .content import *
+from .images import *
from .leads import *
from .pricing import *
from .providers import *
diff --git a/hub/services/admin/images.py b/hub/services/admin/images.py
new file mode 100644
index 0000000..917d0db
--- /dev/null
+++ b/hub/services/admin/images.py
@@ -0,0 +1,115 @@
+from django.contrib import admin
+from django.utils.html import format_html
+from django.urls import reverse
+from django.utils.safestring import mark_safe
+from ..models.images import ImageLibrary
+
+
+@admin.register(ImageLibrary)
+class ImageLibraryAdmin(admin.ModelAdmin):
+ """
+ Admin interface for the Image Library.
+ """
+
+ list_display = [
+ "image_thumbnail",
+ "name",
+ "category",
+ "get_dimensions",
+ "get_file_size_display",
+ "usage_count",
+ "uploaded_by",
+ "uploaded_at",
+ ]
+
+ list_filter = [
+ "category",
+ "uploaded_at",
+ "uploaded_by",
+ ]
+
+ search_fields = [
+ "name",
+ "description",
+ "alt_text",
+ "tags",
+ ]
+
+ readonly_fields = [
+ "width",
+ "height",
+ "file_size",
+ "usage_count",
+ "uploaded_at",
+ "updated_at",
+ "image_preview",
+ ]
+
+ prepopulated_fields = {"slug": ("name",)}
+
+ fieldsets = (
+ ("Image Information", {"fields": ("name", "slug", "description", "alt_text")}),
+ ("Image File", {"fields": ("image", "image_preview")}),
+ ("Categorization", {"fields": ("category", "tags")}),
+ (
+ "Metadata",
+ {
+ "fields": ("width", "height", "file_size", "usage_count"),
+ "classes": ("collapse",),
+ },
+ ),
+ (
+ "Timestamps",
+ {
+ "fields": ("uploaded_by", "uploaded_at", "updated_at"),
+ "classes": ("collapse",),
+ },
+ ),
+ )
+
+ def image_thumbnail(self, obj):
+ """
+ Display small thumbnail in list view.
+ """
+ if obj.image:
+ return format_html(
+ '
',
+ obj.image.url,
+ )
+ return "No Image"
+
+ image_thumbnail.short_description = "Thumbnail"
+
+ def image_preview(self, obj):
+ """
+ Display larger preview in detail view.
+ """
+ if obj.image:
+ return format_html(
+ '',
+ obj.image.url,
+ )
+ return "No Image"
+
+ image_preview.short_description = "Preview"
+
+ def get_dimensions(self, obj):
+ """
+ Display image dimensions.
+ """
+ if obj.width and obj.height:
+ return f"{obj.width} × {obj.height}"
+ return "Unknown"
+
+ get_dimensions.short_description = "Dimensions"
+
+ def save_model(self, request, obj, form, change):
+ """
+ Set uploaded_by field to current user if not already set.
+ """
+ if not change: # Only set on creation
+ obj.uploaded_by = request.user
+ super().save_model(request, obj, form, change)
+
+ class Media:
+ css = {"all": ("admin/css/image_library.css",)}
diff --git a/hub/services/forms/image_library.py b/hub/services/forms/image_library.py
new file mode 100644
index 0000000..1770456
--- /dev/null
+++ b/hub/services/forms/image_library.py
@@ -0,0 +1,149 @@
+from django import forms
+from django.utils.safestring import mark_safe
+from django.utils.html import format_html
+from django.urls import reverse
+from ..models.images import ImageLibrary
+
+
+class ImageLibraryWidget(forms.Select):
+ """
+ Custom widget for selecting images from the library with thumbnails.
+ """
+
+ def __init__(self, attrs=None, choices=(), show_thumbnails=True):
+ self.show_thumbnails = show_thumbnails
+ super().__init__(attrs, choices)
+
+ def format_value(self, value):
+ """
+ Format the selected value for display.
+ """
+ if value is None:
+ return ""
+ return str(value)
+
+ def render(self, name, value, attrs=None, renderer=None):
+ """
+ Render the widget with thumbnails.
+ """
+ if attrs is None:
+ attrs = {}
+
+ # Add CSS class for styling
+ attrs["class"] = attrs.get("class", "") + " image-library-select"
+
+ # Get all images for the select options
+ images = ImageLibrary.objects.all().order_by("name")
+
+ # Build choices with thumbnails
+ choices = [("", "--- Select an image ---")]
+ for image in images:
+ thumbnail_html = ""
+ if self.show_thumbnails and image.image:
+ thumbnail_html = format_html(
+ ' ',
+ image.image.url,
+ )
+
+ choice_text = (
+ f"{image.name} ({image.get_category_display()}){thumbnail_html}"
+ )
+ choices.append((image.pk, choice_text))
+
+ # Build the select element
+ select_html = format_html(
+ '',
+ name,
+ attrs.get("id", ""),
+ self._build_attrs_string(attrs),
+ self._build_options(choices, value),
+ )
+
+ # Add preview area
+ preview_html = ""
+ if value:
+ try:
+ image = ImageLibrary.objects.get(pk=value)
+ preview_html = format_html(
+ ''
+ '
'
+ '
{} - {}x{} - {}
'
+ "
![]()
", attr_string)
+
+ except ImageLibrary.DoesNotExist:
+ # Return empty string or placeholder if image not found
+ return format_html(
+ '
',
+ css_class,
+ )
+
+
+@register.simple_tag
+def image_library_url(slug_or_id):
+ """
+ Get the URL of an image from the image library.
+
+ Usage:
+ {% image_library_url "my-image-slug" %}
+ {% image_library_url image_id %}
+ """
+ try:
+ if isinstance(slug_or_id, str):
+ image = ImageLibrary.objects.get(slug=slug_or_id)
+ else:
+ image = ImageLibrary.objects.get(pk=slug_or_id)
+
+ return image.image.url
+
+ except ImageLibrary.DoesNotExist:
+ return "/static/images/placeholder.png"
+
+
+@register.simple_tag
+def image_library_info(slug_or_id):
+ """
+ Get information about an image from the image library.
+
+ Usage:
+ {% image_library_info "my-image-slug" as img_info %}
+ {{ img_info.name }} - {{ img_info.width }}x{{ img_info.height }}
+ """
+ try:
+ if isinstance(slug_or_id, str):
+ image = ImageLibrary.objects.get(slug=slug_or_id)
+ else:
+ image = ImageLibrary.objects.get(pk=slug_or_id)
+
+ return {
+ "name": image.name,
+ "alt_text": image.alt_text,
+ "width": image.width,
+ "height": image.height,
+ "file_size": image.get_file_size_display(),
+ "category": image.get_category_display(),
+ "tags": image.get_tags_list(),
+ "url": image.image.url,
+ }
+
+ except ImageLibrary.DoesNotExist:
+ return {
+ "name": "Image not found",
+ "alt_text": "Image not found",
+ "width": None,
+ "height": None,
+ "file_size": "Unknown",
+ "category": "Unknown",
+ "tags": [],
+ "url": "/static/images/placeholder.png",
+ }
diff --git a/hub/services/utils/image_library.py b/hub/services/utils/image_library.py
new file mode 100644
index 0000000..c0b72b2
--- /dev/null
+++ b/hub/services/utils/image_library.py
@@ -0,0 +1,243 @@
+from django.core.files.base import ContentFile
+from django.utils.text import slugify
+from ..models.images import ImageLibrary
+import os
+
+try:
+ import requests
+except ImportError:
+ requests = None
+from PIL import Image as PILImage
+
+
+def create_image_from_file(
+ file_path, name, description="", alt_text="", category="other", tags=""
+):
+ """
+ Create an ImageLibrary entry from a local file.
+
+ Args:
+ file_path: Path to the image file
+ name: Name for the image
+ description: Optional description
+ alt_text: Alternative text for accessibility
+ category: Image category
+ tags: Comma-separated tags
+
+ Returns:
+ ImageLibrary instance or None if failed
+ """
+ try:
+ if not os.path.exists(file_path):
+ print(f"File not found: {file_path}")
+ return None
+
+ # Generate slug
+ slug = slugify(name)
+
+ # Check if image already exists
+ if ImageLibrary.objects.filter(slug=slug).exists():
+ print(f"Image with slug '{slug}' already exists")
+ return ImageLibrary.objects.get(slug=slug)
+
+ # Create image library entry
+ image_lib = ImageLibrary(
+ name=name,
+ slug=slug,
+ description=description,
+ alt_text=alt_text or name,
+ category=category,
+ tags=tags,
+ )
+
+ # Read and save the image file
+ with open(file_path, "rb") as f:
+ image_lib.image.save(
+ os.path.basename(file_path), ContentFile(f.read()), save=True
+ )
+
+ print(f"Created image library entry: {name}")
+ return image_lib
+
+ except Exception as e:
+ print(f"Error creating image library entry: {e}")
+ return None
+
+
+def create_image_from_url(
+ url, name, description="", alt_text="", category="other", tags=""
+):
+ """
+ Create an ImageLibrary entry from a URL.
+
+ Args:
+ url: URL to the image
+ name: Name for the image
+ description: Optional description
+ alt_text: Alternative text for accessibility
+ category: Image category
+ tags: Comma-separated tags
+
+ Returns:
+ ImageLibrary instance or None if failed
+ """
+ if requests is None:
+ print("requests library is not installed. Cannot download from URL.")
+ return None
+
+ try:
+ # Generate slug
+ slug = slugify(name)
+
+ # Check if image already exists
+ if ImageLibrary.objects.filter(slug=slug).exists():
+ print(f"Image with slug '{slug}' already exists")
+ return ImageLibrary.objects.get(slug=slug)
+
+ # Download the image
+ response = requests.get(url)
+ response.raise_for_status()
+
+ # Create image library entry
+ image_lib = ImageLibrary(
+ name=name,
+ slug=slug,
+ description=description,
+ alt_text=alt_text or name,
+ category=category,
+ tags=tags,
+ )
+
+ # Save the image
+ filename = url.split("/")[-1]
+ if "?" in filename:
+ filename = filename.split("?")[0]
+
+ image_lib.image.save(filename, ContentFile(response.content), save=True)
+
+ print(f"Created image library entry from URL: {name}")
+ return image_lib
+
+ except Exception as e:
+ print(f"Error creating image library entry from URL: {e}")
+ return None
+
+
+def get_image_by_slug(slug):
+ """
+ Get an image from the library by slug.
+
+ Args:
+ slug: Slug of the image
+
+ Returns:
+ ImageLibrary instance or None if not found
+ """
+ try:
+ return ImageLibrary.objects.get(slug=slug)
+ except ImageLibrary.DoesNotExist:
+ return None
+
+
+def get_images_by_category(category):
+ """
+ Get all images from a specific category.
+
+ Args:
+ category: Category name
+
+ Returns:
+ QuerySet of ImageLibrary instances
+ """
+ return ImageLibrary.objects.filter(category=category)
+
+
+def get_images_by_tags(tags):
+ """
+ Get images that contain any of the specified tags.
+
+ Args:
+ tags: List of tags or comma-separated string
+
+ Returns:
+ QuerySet of ImageLibrary instances
+ """
+ if isinstance(tags, str):
+ tags = [tag.strip() for tag in tags.split(",")]
+
+ from django.db.models import Q
+
+ query = Q()
+ for tag in tags:
+ query |= Q(tags__icontains=tag)
+
+ return ImageLibrary.objects.filter(query).distinct()
+
+
+def cleanup_unused_images():
+ """
+ Find and optionally clean up unused images from the library.
+
+ Returns:
+ List of ImageLibrary instances with usage_count = 0
+ """
+ unused_images = ImageLibrary.objects.filter(usage_count=0)
+
+ print(f"Found {unused_images.count()} unused images:")
+ for image in unused_images:
+ print(f" - {image.name} ({image.slug})")
+
+ return unused_images
+
+
+def optimize_image(image_library_instance, max_width=1920, max_height=1080, quality=85):
+ """
+ Optimize an image in the library by resizing and compressing.
+
+ Args:
+ image_library_instance: ImageLibrary instance
+ max_width: Maximum width in pixels
+ max_height: Maximum height in pixels
+ quality: JPEG quality (1-100)
+
+ Returns:
+ bool: True if optimization was successful
+ """
+ try:
+ if not image_library_instance.image:
+ return False
+
+ # Open the image
+ with PILImage.open(image_library_instance.image.path) as img:
+ # Calculate new dimensions while maintaining aspect ratio
+ ratio = min(max_width / img.width, max_height / img.height)
+
+ if ratio < 1: # Only resize if image is larger than max dimensions
+ new_width = int(img.width * ratio)
+ new_height = int(img.height * ratio)
+
+ # Resize the image
+ img_resized = img.resize(
+ (new_width, new_height), PILImage.Resampling.LANCZOS
+ )
+
+ # Save the optimized image
+ img_resized.save(
+ image_library_instance.image.path,
+ format="JPEG",
+ quality=quality,
+ optimize=True,
+ )
+
+ # Update the image properties
+ image_library_instance._update_image_properties()
+
+ print(f"Optimized image: {image_library_instance.name}")
+ return True
+ else:
+ print(f"Image already optimal: {image_library_instance.name}")
+ return True
+
+ except Exception as e:
+ print(f"Error optimizing image {image_library_instance.name}: {e}")
+ return False
diff --git a/hub/settings.py b/hub/settings.py
index 8e6f3e6..120d9cb 100644
--- a/hub/settings.py
+++ b/hub/settings.py
@@ -245,6 +245,7 @@ JAZZMIN_SETTINGS = {
"new_window": True,
},
{"name": "Articles", "url": "/admin/services/article/"},
+ {"name": "Image Library", "url": "/admin/services/imagelibrary/"},
{"name": "FAQs", "url": "/admin/services/websitefaq/"},
],
"show_sidebar": True,
@@ -257,6 +258,7 @@ JAZZMIN_SETTINGS = {
"services.VSHNAppCatAddon": "single",
"services.ServiceOffering": "single",
"services.Plan": "single",
+ "services.ImageLibrary": "single",
},
"related_modal_active": True,
}