U
@h @ s d Z ddlmZ ddlmZ ddlmZ ddlm Z ddl
m Z ddl m
Z
mZ ddlmZ dd lmZ d
d lmZmZmZmZmZmZmZ G d d
d
eZG dd deZG dd dej Z G dd dej Z e eG dd dej Z!e eG dd dej Z"e eG dd dej Z#edej$_%edej$_&ed ej$_'G d d d eZ(G d d d eZ)e eG d!d" d"ej Z*e eG d#d$ d$ej Z+ej$,esej$ ee! ej$,esej$ ee" ej$,esej$ ee# d%S )&a;
Django Admin Configuration for Agency and Brand Management
This module provides comprehensive admin interface configurations for:
- Agency: Marketing/advertising agencies
- Brand: Brands managed by agencies
- Advertisers: Users associated with brands
Author: Generated for Django Admin Interface
Created: 2025
)admin) format_html) gettext_lazy)reverse) mark_safe)CountQ)messages)SimpleListFilter )AgencyBrand
Advertiser
BrandCategory BrandStatus
AgencyTypeAgencyTeamMemberc @ s, e Zd ZdZedZdZdd Zdd ZdS ) BrandCountFilterz
Custom filter to filter agencies by number of brands they manage.
Provides quick filtering options for agencies with different brand volumes.
z Brand Count brand_countc C s, dt dfdt dfdt dfdt dffS ) z,Define filter options for brand count ranges0z No Brands1-5z
1-5 Brands6-10z 6-10 Brands11+z
11+ Brands_selfrequestZ model_admin r apps/agencies/admin.pylookups% s
zBrandCountFilter.lookupsc C st |j tdd}| dkr(|jddS | dkr@|jddS | dkrX|jd dS | d
krp|jd d S |S )
z.Apply filtering logic based on selected optionbrands)r r r r )r )Zbrand_count__ranger )
r )Zbrand_count__gte)annotater valuefilterr r querysetr r r r* . s zBrandCountFilter.querysetN __name__
__module__ __qualname____doc__r titleZparameter_namer r* r r r r r s
r c @ s, e Zd ZdZedZdZdd Zdd ZdS ) ActiveBrandsFilterz
Filter to show agencies based on their active brand status.
Helps identify agencies with active vs inactive brand portfolios.
zActive Brands Status
active_brandsc C s" dt dfdt dfdt dffS )z-Define filter options for active brand status
has_activezHas Active Brands no_activezNo Active Brands
all_activezAll Brands Activer r r r r r F s
zActiveBrandsFilter.lookupsc C s~ | dkr |jtjd S | dkr<|jtjd S | dkrz|jtdtdttjdddjdt
d d
S |S ) z'Apply filtering logic for active brandsr3 )Zbrands__statusr4 r5 r! r( ) total_brandsr2 r r2 )Ztotal_brands__gtr7 ) r' r( r ACTIVEZdistinctZexcluder& r r modelsFr) r r r r* N s zActiveBrandsFilter.querysetNr+ r r r r r1 > s
r1 c @ sN e Zd ZdZeZdZdZdZdZ dZ
dZ e dZ
e d Zd
d Ze d e_d
S ) BrandInlinez
Inline admin for Brand model within Agency admin.
Allows management of brands directly from the agency detail page.
r r r$ )namecategorystatus is_featured logo_previewr@ Zcollapser
ZBrandsc C s |j rtd|j jS tdS )z
Display a small preview of the brand logo in the inline form.
Returns HTML for image display or placeholder text.
zV
zNo logologor urlr r objr r r r@ x s zBrandInline.logo_preview Logo PreviewN)r, r- r. r/ r
modelextramin_numZmax_numfieldsreadonly_fieldsclassesr verbose_nameverbose_name_pluralr@ short_descriptionr r r r r; e s r; c @ s0 e Zd ZdZeZdZdZdZe dZ
e dZ dS )AdvertisersInlinez
Inline admin for Advertisers model within Brand admin.
Shows users associated with each brand for quick management.
r r )id_userr> r AdvertisersN) r, r- r. r/ r rI rJ rK rL r rO rP r r r r rR s rR c @ s e Zd ZdZdZdZeeddfZdZ dZ
dZ dZ e
d d
e
d d fe
d
dde
ddffZegZdd Ze
de_de_dd Ze
de_dd Ze
de_d d Ze
d e_d d Ze
d!e_d"d# Ze
d$e_d%d& Ze
d'e_d(d)gZd*S )+ AgencyAdminz
Comprehensive admin interface for Agency model.
Provides full CRUD operations with enhanced filtering and display options.
)r<
owner_linkr active_brand_countdescription_short
created_atstatus_indicatorr<
is_deletedowner)r< descriptionowner__usernameZ owner__email )r] Basic Information)r< r] r^ z.Core agency information and ownership details.rL r^ Metadata)r\ rY rB z/Administrative metadata and status information.rL rN r^ c C s0 |j r(td|j jgd}td||j jS tdS )z
Create a clickable link to the owner's user profile.
Provides easy navigation to related user information.
admin:accounts_user_changeargs{}zNo Owner)r] r pkr usernamer r rG rE r r r rV s zAgencyAdmin.owner_linkZOwnerr_ c C s. |j }|dkr*td}td||j|S dS )z
Display the total number of brands managed by this agency.
Includes a link to filter brands by this agency.
r z admin:agencies_brand_changelistz/{} brandsz0 brands)r! countr r ri r rG rl rE r r r r s
zAgencyAdmin.brand_countz Total Brandsc C s |j jtjd }| dS )z
Display the number of active brands managed by this agency.
Provides quick insight into agency activity level.
r> z active)r! r( r r8 rl )r rG rl r r r rW s z AgencyAdmin.active_brand_countz
Active Brandsc C s4 |j r,t|j dkr&|j dd d S |j S tdS )z
Display truncated description for better list view readability.
Shows first 50 characters with ellipsis if longer.
2 N...No description)r^ lenr rF r r r rX s &z AgencyAdmin.description_short Descriptionc C s& |j rtdtdS tdtdS dS )z
Visual indicator for agency status based on deletion flag.
Uses color-coded badges for quick status recognition.
u: ● {}ZDeletedu< ● {}ZActiveN)r\ r r rF r r r rZ s z AgencyAdmin.status_indicatorStatusc C s" |j dd}| || d dS )z|
Bulk action to mark selected agencies as deleted.
Soft delete functionality for data preservation.
r r\ z! agencies were marked as deleted.Nupdate message_userr r r* updatedr r r mark_as_deleted" s
zAgencyAdmin.mark_as_deletedz!Mark selected agencies as deletedc C s" |j dd}| || d dS )zk
Bulk action to restore deleted agencies.
Allows recovery of soft-deleted records.
r ru z agencies were restored.Nrv ry r r r restore_agencies/ s
z AgencyAdmin.restore_agencieszRestore selected agenciesr{ r| N)r, r- r. r/ list_displaylist_display_linksr r1 list_filter
search_fieldsordering
list_per_pagelist_select_relatedr fieldsetsr; inlinesrV rQ admin_order_fieldr rW rX rZ r{ r| actionsr r r r rU sN
rU c @ s" e Zd ZdZdZdZdZdZdZdZ dZ
d Z e d
d e d d
fe dde dd
ffZ
dZdZegZdd Ze de_dd Ze de_dd Ze de_d e_d d Ze d e_d e_d!d" Ze d#e_d$d% Ze d&e_d'd( Ze d)e_d*d+ Ze d,e_d-d. Z e d/e _d0d1d2gZ d3S )4
BrandAdminz
Comprehensive admin interface for Brand model.
Provides advanced brand management with visual elements and filtering.
)logo_thumbnailr< agency_linkr= status_badger? advertiser_count created_info)r< r r? )r> r= r? agencyrY )r< r^ agency__namer[ )r zBrand Identity)r< rD r@ r^ zCCore brand identity elements including name, logo, and description.rb ZClassification)r r= r> r? z,Brand categorization and status information.rA r c C s |j rtd|j jS tdS )zv
Display small logo thumbnail in list view.
Provides visual brand identification at a glance.
znzNo Logo
)rD r rE rF r r r r s zBrandAdmin.logo_thumbnailZLogoc C s |j rtd|j jS tdS )zs
Display larger logo preview in detail view.
Shows full-size logo for detailed inspection.
z~zNo logo uploadedrC rF r r r r@ s zBrandAdmin.logo_previewrH c C s0 |j r(td|j jgd}td||j jS tdS )zp
Create clickable link to the parent agency.
Enables easy navigation to agency details.
admin:agencies_agency_changerf rh No Agency)r r ri r r< r rk r r r r s zBrandAdmin.agency_linkr r c
C s@ t jdt jdt jdt jdt jdi}||jd}td|| S )z
Display color-coded status badge for visual status identification.
Uses different colors for different status types.
#28a745#6c757d#ffc107#dc3545z#17a2b8z{})
r r8 ZINACTIVEZPENDINGZ SUSPENDEDZARCHIVEDgetr> r get_status_displayr rG Z
status_colorscolorr r r r s" zBrandAdmin.status_badgert r> c C s. |j }|dkr*td}td||j|S dS )zy
Display count of advertisers associated with this brand.
Provides insight into brand team size.
r z%admin:agencies_advertisers_changelistz3{} advertisersz
0 advertisers)Zadvertisers_setrl r r ri rm r r r r s
zBrandAdmin.advertiser_countrT c C s$ t |dr |jr |jdS tdS )zj
Display creation date information.
Shows when the brand was added to the system.
rY %Y-%m-%dZUnknown)hasattrrY strftimer rF r r r r s zBrandAdmin.created_infoCreatedc C s$ |j tjd}| || d dS )zu
Bulk action to activate selected brands.
Sets status to active for multiple brands at once.
rn z brands were activated.N)rw r r8 rx ry r r r activate_brands s
zBrandAdmin.activate_brandszActivate selected brandsc C s" |j dd}| || d dS )z{
Bulk action to mark selected brands as featured.
Highlights important brands across the platform.
Tr z brands were marked as featured.Nrv ry r r r feature_brands s
zBrandAdmin.feature_brandsz Mark selected brands as featuredc C s" |j dd}| || d dS )zw
Bulk action to remove featured status from selected brands.
Removes highlighting from brands.
Fr z" brands were unmarked as featured.Nrv ry r r r unfeature_brands s
zBrandAdmin.unfeature_brandsz+Remove featured status from selected brandsr r r N) r, r- r. r/ r} r~ Z
list_editabler r r r r r r rM Zfilter_horizontalrR r r rQ r@ r r r r r r r r r r r r r r @ sT
r c @ s e Zd ZdZdZdZdZdZdZdZ dZ
e d d
e d d ffZ d
d Z
e de
_de
_dd Ze de_de_dd Ze de_de_dd Ze de_d d Ze d e_d d Ze d!e_d"d#gZd$S )%AdvertisersAdminzg
Admin interface for Advertisers model.
Manages the relationship between users and brands.
) user_info
brand_linkstatus_displayrelationship_info)r )r>
brand__agencyZbrand__categoryZ
brand__status)id_user__usernameZid_user__emailZid_user__first_nameZid_user__last_name brand__name)r r )rS brandr r` Z Relationship)rS r r> z/Define the relationship between user and brand.rb c C sX |j rPtd|j jgd}|j r.|j n|j j}td|||j jpL|j jS tdS )z
Display comprehensive user information with link.
Shows name, username, and email for easy identification.
re rf ={}
{}zNo User)rS r ri
get_full_namerj r emailr )r rG rE Z display_namer r r r R s zAdvertisersAdmin.user_infoZUserr c C sL |j rDtd|j jgd}|j jr*|j jjntd}td||j j|S tdS )z}
Display brand information with link to brand admin.
Shows brand name and parent agency for context.
zadmin:agencies_brand_changerf r r zNo Brand)r r ri r r< r r )r rG rE Z agency_namer r r r c s zAdvertisersAdmin.brand_linkr
r c C s@ |j r8ddddd}||j d}td||j S tdS )zs
Display formatted status information.
Provides visual styling for different status types.
r r r r )activeinactivependingZ suspendedz5{}z No Status)r> r lowerr r0 r r r r r r t s z AdvertisersAdmin.status_displayrt r> c C s g }|j r(|j jr(|d|j |j rL|j jrL|d|j |jrxt|jdrx|jjrjdnd}|| |rt d
|S t dS )z
Display additional context about the user-brand relationship.
Shows helpful metadata for relationship management.
z
Category: zBrand: is_activez Active Userz
Inactive Userz
zNo additional info) r r= appendZget_category_displayr> r rS r r r joinr )r rG Z
info_partsZ user_statusr r r r s
z"AdvertisersAdmin.relationship_infozAdditional Infoc C s" |j dd}| || d dS )zL
Bulk action to activate selected advertiser relationships.
r rn z) advertiser relationships were activated.Nrv ry r r r activate_relationships s
z'AdvertisersAdmin.activate_relationshipsz Activate selected relationshipsc C s" |j dd}| || d dS )zN
Bulk action to deactivate selected advertiser relationships.
r rn z+ advertiser relationships were deactivated.Nrv ry r r r deactivate_relationships s
z)AdvertisersAdmin.deactivate_relationshipsz!Deactivate selected relationshipsr r N)r, r- r. r/ r} r~ r r r r r r r r rQ r r r r r r r r r r r r s:
r z Agency & Brand Management Systemz Agency Adminz$Welcome to Agency & Brand Managementc @ s, e Zd ZdZedZdZdd Zdd ZdS ) PremiumTypeFilterzJ
Filter to distinguish between premium and standard agency types.
zPremium StatusZpremium_statusc C s dt dfdt dffS )z(Define filter options for premium statuspremiumz
Premium TypesstandardzStandard Typesr r r r r r s
zPremiumTypeFilter.lookupsc C s4 | dkr|jddS | dkr0|jddS |S )z-Apply filtering logic based on premium statusr T
is_premiumr F)r' r( r) r r r r* s
zPremiumTypeFilter.querysetNr+ r r r r r s
r c @ s, e Zd ZdZedZdZdd Zdd ZdS ) AgencyTypeUsageFilterzH
Filter agency types by the number of agencies using each type.
z Usage CountZ agency_usagec C s, dt dfdt dfdt dfdt dffS ) z&Define filter options for agency usageunusedz Unused Types1-10z
1-10 Agencies11-50z11-50 Agencies50+z 50+ Agenciesr r r r r r s
z AgencyTypeUsageFilter.lookupsc C s~ |j tdtdddd}| dkr2|jddS | dkrJ|jd d
S | d krb|jd d
S | d
krz|jddS |S )z+Apply filtering logic based on agency countagenciesFZagencies__is_deletedr6 agency_countr r r )r r$ )Zagency_count__ranger )r% ro r ro )Zagency_count__gte)r& r r r' r( r) r r r r* s z AgencyTypeUsageFilter.querysetNr+ r r r r r s
r c s e Zd ZdZdddddddd gZdgZd
Zeed d d
gZ ddgZ
ddgZ e dde ddfe dde ddfe dde ddfe ddd e d d ffZ
d d
d d gZd!d" Ze d#e_de_d$d% Ze d&e_d'd( Ze d)e_d e_d*d+ Ze d,e_d-d. Ze d/e_d0d1 Ze d2e_d e_d3d4 Ze d5e_d6d7 Ze d8e_d9d: Ze d;e_ fdd? Ze d@e_dAdB Z e dCe _dDdE Z e dFe _dGdH Z e dIe _dJdKdLdMgZ dNZ dNZ! Z"S )OAgencyTypeAdmina
Comprehensive admin configuration for AgencyType model.
This admin class provides:
- Enhanced list display with visual elements
- Custom filters for better navigation
- Bulk actions for efficient management
- Search and ordering capabilities
name_with_colordescription_truncated
sort_orderis_premium_displayagency_count_displayusage_percentagecreated_at_formattedrZ r` r rY
updated_atr< r^ ra )r< r^ z(Core information about this agency type.rb zDisplay Settings)
color_coder z+Visual appearance and ordering preferences.zFeatures & Status)r r\ z"Feature flags and status settings.rc )rY r rB z System-generated timestamps.rd
color_previewdetailed_agency_statsc C s" |j rtd|j |jS td|jS )z@
Display agency type name with color indicator.
zz{})r r r< rF r r r r d s z AgencyTypeAdmin.name_with_colorz Agency Typec C sH |j r:t|j dkr4|j dd d }td|j |S |j S tdtdS )z=
Display truncated description with tooltip.
P Nrp z{} {}rq )r^ rr r r )r rG Z truncatedr r r r v s z%AgencyTypeAdmin.description_truncatedrs c C s" |j rtdtdS tdtdS )z?
Display premium status with visual indicator.
u> ⭐ {}ZPremiumz'{}ZStandard)r r r rF r r r r s z"AgencyTypeAdmin.is_premium_displayZTypec C s t |dd}|dkr&|jjdd }|dkrz0td}td||j||dkrTtd ntd
W S td ||dkr|td ntd
Y S X td td S )
zF
Display count of agencies using this type with link.
r NFru r z admin:agencies_agency_changelistz[{} {}r r r z-{} {}z&0 {})getattrr r( rl r r idr rm r r r r s&
z$AgencyTypeAdmin.agency_count_displayZUsagec C s zt jjdd }|dkr&tdW S t|dd}|dkrL|jjdd }|| d }|dkrfd }n|d
krtd }nd }td
||W S tk
r td Y S X dS )z>
Display usage percentage among all agencies.
Fru r #-r Nd r r$ r r z:{:.1f}%z&-)r Zobjectsr( rl r r r Exception)r rG Ztotal_agenciesrl Z
percentager r r r r s(
z AgencyTypeAdmin.usage_percentagez Market Sharec C s |j r|j dS dS )z2
Display formatted creation date.
r -)rY r rF r r r r s z$AgencyTypeAdmin.created_at_formattedr c C s g }|j r|d t|dd}|dkr:|jjdd }|dkrN|d n|dkr`|d |jrp|d
|rtd |S d S )
z3
Display overall status indicator.
u% ⭐r NFru r u? ⚠️r$ u> 📈u< 🗑️ r ) r r r r r( rl r\ r r )r rG Z
indicatorsrl r r r rZ s
z AgencyTypeAdmin.status_indicatorrt c C s$ |j rtd|j |j S tdtdS )zA
Display color preview in form (readonly field).
z{} {}z No color set)r r r rF r r r r s z AgencyTypeAdmin.color_previewz
Color Previewc C sh |j rZ|j }|jjddd }|jjddd }|jjdd }td||||S tdtdS )zM
Display detailed agency count information (readonly field).
TF)r r\ ru zTotal: {} agencies
Active: {} agencies
Inactive: {} agencies
Deleted: {} agencies
r z Save to see agency statistics)ri r rl r( r r )r rG Ztotalr r Zdeletedr r r r
s
z%AgencyTypeAdmin.detailed_agency_statszAgency Statisticsc s* t |}|jtdtdddd}|S )z6
Optimize queryset with related data.
r Fr r6 r )super get_querysetr& r r r) __class__r r r & s
z AgencyTypeAdmin.get_querysetc C s& |j dd}| j|| ddd dS )zG
Bulk action to mark selected agency types as premium.
Tr z% agency types were marked as premium.successlevelNrv ry r r r make_premium3 s z AgencyTypeAdmin.make_premiumz Mark selected types as premiumc C s& |j dd}| j|| ddd dS )zH
Bulk action to mark selected agency types as standard.
Fr z& agency types were marked as standard.r r Nrv ry r r r
make_standard@ s z AgencyTypeAdmin.make_standardz Mark selected types as standardc C sZ t |d}t|dD ] \}}|d |_|jdgd q| j|dt| ddd d
S ) zO
Bulk action to reset sort order based on name alphabetically.
r< r r$ r )Z
update_fieldszSort order reset for z agency types.r r N)listZorder_by enumerater Zsaverx rr )r r r* Z sorted_typesiZ agency_typer r r reset_sort_orderM s
z AgencyTypeAdmin.reset_sort_orderz Reset sort order alphabeticallyc
C s z>t }|r,| j|dt| ddd n| j|ddd W n< tk
rz } z | j|dt| dd W 5 d }~X Y nX d S )
zO
Action to create default agency types using the model method.
zCreated z default agency types.r r z:No new agency types were created (they may already exist).infoz Error creating default types: errorN)r create_default_typesrx rr r str)r r r* Z
created_typeser r r r ^ s&
z$AgencyTypeAdmin.create_default_typeszCreate default agency typesr r r r T)#r, r- r. r/ r} r~ r r r r r r r r rM r rQ r r r r r r rZ r r r r r r r r Z save_on_topZpreserve_filters
__classcell__r r r r r
s "
r c @ s e Zd ZdZddddddgZddddd gZd
d d d
gZd
dd gZdd Ze de_
dd Z e de _
d
e _ dd Z
e de
_
de
_ dS )AgencyTeamMemberAdminz9
Admin configuration for AgencyTeamMember model.
user_displayr Z
departmentZis_primary_contactZ is_publicyears_experience_displayr rY Zuser__first_nameZuser__last_nameZ user__emailr z-is_primary_contactc C s2 |j r$td|j p|j j|j jS tdtdS )z"Display user full name with email.z({}
{}r zNo user assigned)userr r rj r r rF r r r r s z"AgencyTeamMemberAdmin.user_displayz Team Memberc C sN |j r@z$td|j jgd}td||j jW S |j j Y S X tdtdS )z Display agency name with link.r rf rh r z No agency)r r r r r< r rk r r r r s z!AgencyTeamMemberAdmin.agency_linkr c C s |j rtd|j S tdS )z,Display years of experience with formatting.z{} yearsr )years_experiencer rF r r r r s z.AgencyTeamMemberAdmin.years_experience_displayZ
Experiencer N)r, r- r. r/ r} r r r r r rQ r r r r r r r r s8
r N)-r/ Zdjango.contribr Zdjango.utils.htmlr Zdjango.utils.translationr r Z django.urlsr Zdjango.utils.safestringr Zdjango.db.modelsr r r Zdjango.contrib.adminr
r9 r r
r r r r r r r1 Z
TabularInliner; rR registerZ
ModelAdminrU r r ZsiteZ site_headerZ
site_titleZ index_titler r r r Z
is_registeredr r r r sP $!'" $ Y 0 G