MultiSelectField در جنگو
- User
MultiSelectField در جنگو
- 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) استفاده کنید. - 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 = 'اطلاعات دکتر'پنل ادمینشونو بنویس
- 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تنظیمات پروژهتان قرار داده شده باشد و دسترسی به ادمین برای کاربران مربوطه فراهم باشد. -
- User
چطوری میتونم پنل ادمین رو بینویسم که Specialty_choices فابلیت سرچ هم داشته باش بین داده هایی ک در مدل داخلش ریخته شده و همچنین در صورت زیاد بودن داده های قابلیت اسکروال هم داشته باش
- Assistant
برای اینکه قابلیت جستجو و اسکرول در انتخابهای چندگانه (که مربوط به
MultiSelectFieldاست) در پنل ادمین جنگو فعال کنید، باید یک ویجت جاوااسکریپتی یا پلاگین برای این کار به ادمین اضافه کنید. یکی از روشهای محبوب برای دستیابی به این هدف استفاده از ویجتهایselect2است.مراحل انجام کار:
-
نصب وابستگیها: ابتدا باید مطمئن شوید که کتابخانههای جاوااسکریپتی و CSS مربوط به
select2در پروژه شما وجود دارند. -
بارگذاری
select2در ادمین: برای استفاده ازselect2در ادمین، باید فایلهای جاوااسکریپت و CSS را بارگذاری کنید. میتوانید این کار را با اورراید کردن متدهای ادمین انجام دهید. -
تنظیم ویجت
select2برای فیلدMultiSelectField: کلاسهای جاوااسکریپتیselect2را به فیلدMultiSelectFieldخود اعمال کنید.
در اینجا مثال چگونگی تحقق این هدف آمده است:
مراحل پیادهسازی
- افزودن فایلهای CSS و جاوااسکریپت: اولین قدم این است که مطمئن شوید که فایلهای
select2در قالبهای ادمین شما وارد شدهاند. برای این کار، فایلهای مربوطه را دانلود کرده و در پروژهتان قرار دهید.
مثلاً، میتوانید آنها را در مسیری مشابه
static/js/وstatic/css/ذخیره کنید.- افزودن به
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)- جاوااسکریپت اضافی برای فعالسازی
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 بسته به نحوه سازماندهی پروژه شما ممکن است متفاوت باشد و باید متناسب با آن تنظیم شود. -