com2care_website/apps/products/admin.py

from django.contrib import admin

from .models import Article, ArticleCitation, ArticleSection, MainProduct, SubProduct, SubProductVersion


class ArticleCitationInline(admin.TabularInline):
    model = ArticleCitation
    extra = 1
    fields = ("text", "url", "order")
    ordering = ("order",)


class ArticleSectionInline(admin.TabularInline):
    model = ArticleSection
    extra = 1
    fields = ("title", "value_format", "value", "order")
    ordering = ("order",)


class SubProductArticleInline(admin.StackedInline):
    model = Article
    fk_name = "sub_product"
    extra = 0
    fields = ("badge", "title", "description", "order")
    ordering = ("order",)
    show_change_link = True


class MainProductArticleInline(admin.StackedInline):
    model = Article
    fk_name = "main_product"
    extra = 0
    fields = ("badge", "title", "description", "order")
    ordering = ("order",)
    show_change_link = True


RELEASE_VERSION_INLINE_FIELDS = (
    "version",
    "is_featured_stable",
    "windows_download_url",
    "macos_download_url",
    "linux_download_url",
    "source_code_url",
    "package_resource_url",
    "release_notes",
    "is_active",
    "order",
)


class SubProductVersionInline(admin.TabularInline):
    model = SubProductVersion
    fk_name = "sub_product"
    extra = 0
    ordering = ("order", "version")
    fields = RELEASE_VERSION_INLINE_FIELDS


class MainProductVersionInline(admin.TabularInline):
    model = SubProductVersion
    fk_name = "main_product"
    extra = 0
    ordering = ("order", "version")
    fields = RELEASE_VERSION_INLINE_FIELDS


class SubProductInline(admin.StackedInline):
    model = SubProduct
    extra = 0
    fields = ("name", "slug", "distribution", "short_description", "image", "logo", "show_on_homepage", "homepage_order", "order", "is_active")
    ordering = ("order",)
    show_change_link = True
    prepopulated_fields = {"slug": ("name",)}


@admin.register(MainProduct)
class MainProductAdmin(admin.ModelAdmin):
    list_display = ("name", "show_on_homepage", "homepage_order", "order", "is_active", "created_at")
    list_filter = ("is_active", "show_on_homepage")
    search_fields = ("name", "description")
    prepopulated_fields = {"slug": ("name",)}
    list_editable = ("order", "is_active", "show_on_homepage", "homepage_order")
    inlines = [MainProductArticleInline, MainProductVersionInline, SubProductInline]
    fieldsets = (
        (
            None,
            {
                "fields": (
                    "name",
                    "slug",
                    "short_description",
                    "distribution",
                    "package_resource_button_text",
                    "package_source_button_text",
                )
            },
        ),
        ("Description", {"fields": ("description_format", "description")}),
        ("Media", {"fields": ("image",)}),
        ("Homepage", {"fields": ("show_on_homepage", "homepage_order")}),
        ("Settings", {"fields": ("order", "is_active")}),
    )


@admin.register(SubProduct)
class SubProductAdmin(admin.ModelAdmin):
    list_display = (
        "name",
        "main_product",
        "distribution",
        "show_on_homepage",
        "homepage_order",
        "order",
        "is_active",
        "created_at",
    )
    list_filter = ("is_active", "distribution", "main_product", "show_on_homepage")
    search_fields = ("name", "description", "main_product__name")
    prepopulated_fields = {"slug": ("name",)}
    list_editable = ("order", "is_active", "show_on_homepage", "homepage_order")
    raw_id_fields = ("main_product",)
    inlines = [SubProductArticleInline, SubProductVersionInline]
    fieldsets = (
        (
            None,
            {
                "fields": (
                    "main_product",
                    "name",
                    "slug",
                    "distribution",
                    "short_description",
                    "package_resource_button_text",
                    "package_source_button_text",
                )
            },
        ),
        ("Description", {"fields": ("description_format", "description")}),
        ("Media", {"fields": ("image", "logo")}),
        ("Homepage", {"fields": ("show_on_homepage", "homepage_order")}),
        ("Settings", {"fields": ("order", "is_active")}),
    )


@admin.register(Article)
class ArticleAdmin(admin.ModelAdmin):
    list_display = ("title", "parent", "order", "created_at")
    list_filter = ("main_product", "sub_product__main_product")
    search_fields = ("title", "description", "main_product__name", "sub_product__name")
    list_editable = ("order",)
    raw_id_fields = ("main_product", "sub_product")
    inlines = [ArticleSectionInline, ArticleCitationInline]
    fieldsets = (
        (None, {"fields": ("main_product", "sub_product", "badge", "title")}),
        ("Description", {"fields": ("description_format", "description")}),
        ("Citation Badge", {"fields": ("citation_count_display", "citation_count_label"), "description": "Number and optional label for the dashed citation circle badge. Both are optional — a label without a number shows an empty circle with the label; neither hides the badge entirely."}),
        ("Settings", {"fields": ("order",)}),
    )

    @admin.display(description="Parent")
    def parent(self, obj):
        if obj.main_product_id:
            return obj.main_product
        if obj.sub_product_id:
            return obj.sub_product
        return "—"


@admin.register(ArticleSection)
class ArticleSectionAdmin(admin.ModelAdmin):
    list_display = ("title", "article", "value_format", "order")
    search_fields = ("title", "value", "article__title")
    list_editable = ("order",)
    raw_id_fields = ("article",)
    fieldsets = (
        (None, {"fields": ("article", "title")}),
        ("Content", {"fields": ("value_format", "value")}),
        ("Settings", {"fields": ("order",)}),
    )


@admin.register(SubProductVersion)
class SubProductVersionAdmin(admin.ModelAdmin):
    list_display = (
        "parent",
        "version",
        "is_featured_stable",
        "is_active",
        "order",
    )
    list_filter = ("is_active", "is_featured_stable", "main_product", "sub_product__main_product")
    search_fields = ("main_product__name", "sub_product__name", "version")
    list_editable = ("is_active", "order")
    raw_id_fields = ("main_product", "sub_product")
    fieldsets = (
        (
            None,
            {
                "fields": (
                    "main_product",
                    "sub_product",
                    "version",
                    "is_featured_stable",
                )
            },
        ),
        (
            "Installable downloads",
            {
                "fields": (
                    "windows_download_url",
                    "macos_download_url",
                    "linux_download_url",
                    "source_code_url",
                )
            },
        ),
        ("Package link", {"fields": ("package_resource_url",)}),
        ("Details", {"fields": ("release_notes",)}),
        ("Settings", {"fields": ("is_active", "order")}),
    )

    @admin.display(description="Parent")
    def parent(self, obj):
        if obj.main_product_id:
            return obj.main_product
        if obj.sub_product_id:
            return obj.sub_product
        return "—"