Skip to content
TheChatArchiveThe Chat Archive
gpt-4o-2024-08-06· OpenAIAi2 WildChat-4.8M (AI2)

MultiSelectField در جنگو

  1. User

    MultiSelectField در جنگو

  2. Assistant

    در جنگو، اگر بخواهید فیلدی داشته باشید که امکان انتخاب چندگانه از میان یک لیست را فراهم کند، می‌توانید از ManyToManyField استفاده کنید یا یک راه‌حل سفارشی با استفاده از models.CharField و یک ویجت مخصوص در فرم‌ها پیاده‌سازی کنید. اما MultiSelectField به طور پیش‌فرض در جنگو وجود ندارد. با این حال، می‌توانید از کتابخانه‌های شخص ثالث استفاده کنید یا خودتان این قابلیت را پیاده‌سازی کنید.

    یکی از کتابخانه‌های محبوب برای این کار django-multiselectfield است. برای استفاده از آن، مراحل زیر را دنبال کنید:

    نصب

    ابتدا بسته را نصب کنید:

    pip install django-multiselectfield
    

    استفاده

    بعد از نصب، می‌توانید MultiSelectField را به مدل خود اضافه کنید:

    from django.db import models
    from multiselectfield import MultiSelectField
    
    class MyModel(models.Model):
        MY_CHOICES = (
            ('val1', 'Label 1'),
            ('val2', 'Label 2'),
            ('val3', 'Label 3'),
            # ...
        )
    
        my_field = MultiSelectField(choices=MY_CHOICES)
    
    

    مهاجرت

    مثل همیشه، پس از ایجاد تغییرات در مدل، باید مهاجرت‌های خود را بسازید و اعمال کنید:

    python manage.py makemigrations
    python manage.py migrate
    

    استفاده در فرم‌ها

    در فرم‌هایتان به صورت عادی می‌توانید از این فیلد استفاده کنید:

    from django import forms
    
    class MyForm(forms.ModelForm):
        class Meta:
            model = MyModel
            fields = ['my_field']
    

    حالا به کاربر اجازه می‌دهید که چندین گزینه را از طریق یک چک باکس انتخاب کند.

    توجه داشته باشید که این فیلد در مدل به صورت یک رشته کاراکتری ذخیره می‌شود که مقادیر انتخاب‌شده را، معمولاً با کاما، از یکدیگر جدا می‌کند. اگر به یک راه‌حل پیشرفته‌تر نیاز دارید، باید به طور مستقیم از رابطه‌های چند به چند (ManyToManyField) استفاده کنید.

  3. User

    from django.db import models from django.conf import settings from multiselectfield import MultiSelectField

    Create your models here.

    class Specialty(models.Model): name = models.CharField(max_length=100, unique=True, verbose_name="تخصص")

    def __str__(self):
        return self.name
    class Meta:
        db_table = 'tbl_doctor_specialtys2'
        verbose_name_plural = 'تخصص های پزشکی'
    

    class University(models.Model): name = models.CharField(max_length=100, unique=True, verbose_name="نام دانشگاه")

    def __str__(self):
        return self.name
    class Meta:
        db_table = 'tbl_doctor_universitys2'
        verbose_name_plural = 'دانشگاه های پزشکی'
    

    class Degree(models.Model): name = models.CharField(max_length=100, unique=True, verbose_name="مقطع تحصیلی")

    def __str__(self):
        return self.name
    class Meta:
        db_table = 'tbl_doctor_degrees2'
        verbose_name_plural = 'مدارج تحصیلی'
    

    def Specialty_choices(): specialtys = Specialty.objects.all() choices = [(item.id, item.name) for item in specialtys] return choices

    class Doctor(models.Model): user = models.OneToOneField(settings.AUTH_USER_MODEL, on_delete=models.CASCADE, verbose_name="کاربر") specialties = MultiSelectField(choices=Specialty_choices(), null=True, verbose_name="تخصص‌ها") university = models.ForeignKey(University, on_delete=models.SET_NULL, null=True, verbose_name="فارغ التحصیل") degree = models.ForeignKey(Degree, on_delete=models.SET_NULL, null=True, verbose_name="مدرک تحصیلی")

    def __str__(self):
        return f"{self.user.first_name} {self.user.last_name}"
    class Meta:
        db_table = 'tbl_doctor21'
        verbose_name_plural = 'اطلاعات دکتر'
    

    پنل ادمینشونو بنویس

  4. Assistant

    برای ایجاد یک رابط ادمین برای مدل‌های جنگو، می‌توانید از ماژول admin استفاده کنید. در اینجا نحوه تعریف پنل ادمین برای مدل‌های شما آمده است. برای این کار، فایل admin.py را در اپلیکیشن خود باز کرده و مدل‌هایتان را به آن اضافه کنید:

    from django.contrib import admin
    from .models import Specialty, University, Degree, Doctor
    
    @admin.register(Specialty)
    class SpecialtyAdmin(admin.ModelAdmin):
        list_display = ('name',)
        search_fields = ('name',)
    
    @admin.register(University)
    class UniversityAdmin(admin.ModelAdmin):
        list_display = ('name',)
        search_fields = ('name',)
    
    @admin.register(Degree)
    class DegreeAdmin(admin.ModelAdmin):
        list_display = ('name',)
        search_fields = ('name',)
    
    @admin.register(Doctor)
    class DoctorAdmin(admin.ModelAdmin):
        list_display = ('user', 'get_specialties', 'university', 'degree')
        search_fields = ('user__first_name', 'user__last_name')
        list_filter = ('university', 'degree')
    
        def get_specialties(self, obj):
            return ", ".join([str(specialty) for specialty in obj.specialties])
        get_specialties.short_description = 'تخصص‌ها'
    

    توضیحات:

    • list_display: این گزینه مشخص می‌کند که کدام فیلدها در صفحه لیست مدل نمایش داده شوند.

    • search_fields: این فیلدها برای جستجوی سریع در بالای صفحه لیست مدل استفاده می‌شوند.

    • list_filter: این گزینه‌ها به شما اجازه می‌دهند مدل‌ها را از طریق یک فیلتر در سمت چپ پنل ادمین فیلتر کنید.

    • get_specialties: این تابع برای نمایش رشته‌ای از تخصص‌ها در پنل ادمین استفاده می‌شود، زیرا مقادیر چندگانه به صورت مستقیم نمایش‌پذیر نیستند.

    مطمئن شوید که اپلیکیشن شما در INSTALLED_APPS تنظیمات پروژه‌تان قرار داده شده باشد و دسترسی به ادمین برای کاربران مربوطه فراهم باشد.

  5. User

    چطوری میتونم پنل ادمین رو بینویسم که Specialty_choices فابلیت سرچ هم داشته باش بین داده هایی ک در مدل داخلش ریخته شده و همچنین در صورت زیاد بودن داده های قابلیت اسکروال هم داشته باش

  6. Assistant

    برای اینکه قابلیت جستجو و اسکرول در انتخاب‌های چندگانه (که مربوط به MultiSelectField است) در پنل ادمین جنگو فعال کنید، باید یک ویجت جاوااسکریپتی یا پلاگین برای این کار به ادمین اضافه کنید. یکی از روش‌های محبوب برای دستیابی به این هدف استفاده از ویجت‌های select2 است.

    مراحل انجام کار:

    1. نصب وابستگی‌ها: ابتدا باید مطمئن شوید که کتابخانه‌های جاوااسکریپتی و CSS مربوط به select2 در پروژه شما وجود دارند.

    2. بارگذاری select2 در ادمین: برای استفاده از select2 در ادمین، باید فایل‌های جاوااسکریپت و CSS را بارگذاری کنید. می‌توانید این کار را با اورراید کردن متدهای ادمین انجام دهید.

    3. تنظیم ویجت select2 برای فیلد MultiSelectField: کلاس‌های جاوااسکریپتی select2 را به فیلد MultiSelectField خود اعمال کنید.

    در اینجا مثال چگونگی تحقق این هدف آمده است:

    مراحل پیاده‌سازی

    1. افزودن فایل‌های CSS و جاوااسکریپت: اولین قدم این است که مطمئن شوید که فایل‌های select2 در قالب‌های ادمین شما وارد شده‌اند. برای این کار، فایل‌های مربوطه را دانلود کرده و در پروژه‌تان قرار دهید.

    مثلاً، می‌توانید آنها را در مسیری مشابه static/js/ و static/css/ ذخیره کنید.

    1. افزودن به admin.py و استفاده از ویجت select2:

    ابتدا کدهای CSS و جاوااسکریپت را به کلاس ادمین اضافه کنید:

    from django.contrib import admin
    from django import forms
    from .models import Specialty, University, Degree, Doctor
    
    class DoctorForm(forms.ModelForm):
        class Meta:
            model = Doctor
            fields = '__all__'
            widgets = {
                'specialties': forms.SelectMultiple(attrs={'class': 'select2'}),
            }
    
    class DoctorAdmin(admin.ModelAdmin):
        form = DoctorForm
        list_display = ('user', 'get_specialties', 'university', 'degree')
        search_fields = ('user__first_name', 'user__last_name')
        list_filter = ('university', 'degree')
    
        def get_specialties(self, obj):
            return ", ".join([str(specialty) for specialty in obj.specialties])
        get_specialties.short_description = 'تخصص‌ها'
    
        class Media:
            css = {
                'all': ('css/select2.min.css',),  # مسیر فایل CSS select2
            }
            js = ('js/select2.min.js',)  # مسیر فایل جاوااسکریپت select2
    
    admin.site.register(Specialty, SpecialtyAdmin)
    admin.site.register(University, UniversityAdmin)
    admin.site.register(Degree, DegreeAdmin)
    admin.site.register(Doctor, DoctorAdmin)
    
    1. جاوااسکریپت اضافی برای فعال‌سازی select2:

    در داخل فایل جاوااسکریپت که بارگذاری می‌کنید (مثلاً admin.js) می‌توانید کدی که select2 را فعال می‌کند اضافه کنید. مطمئن شوید که این فایل جاوااسکریپت بعد از select2.min.js بارگذاری شود:

    // static/js/admin.js
    document.addEventListener('DOMContentLoaded', function() {
        $('select.select2').select2();
    });
    

    مطمئن شوید که admin.js نیز در کلاس Media در admin.py اضافه شده باشد:

        class Media:
            css = {
                'all': ('css/select2.min.css',),
            }
            js = ('js/select2.min.js', 'js/admin.js')
    

    حالا، وقتی به پنل ادمین می‌روید و فرم دکتر را باز می‌کنید، فیلد تخصص‌ها باید از ویجت select2 بهره ببرد و قابلیت جستجو و اسکرول داشته باشد. توجه داشته باشید که مسیر فایل‌های جاوااسکریپت و CSS بسته به نحوه سازمان‌دهی پروژه شما ممکن است متفاوت باشد و باید متناسب با آن تنظیم شود.