Forms

Important form elements:

label: The human-friendly label for the field.
widget: The HTML element used to display the field.
required: A boolean value that indicates whether the field is mandatory or not.
initial: The initial value for the field when the form is displayed.
help_text: An optional string that provides extra guidance or explanation for the field.
Django form fields documentation

Create a new forms.py file in your app directory

The __init__ method is a special method that is automatically called when you create an instance of a class. It allows you to initialize some attributes or perform some actions before using the instance. In Django forms, you can override the __init__ method of your form class to customize its behavior or accept extra arguments.

One common use case for overriding the __init__ method is to pass the request.user object to your form class. The request.user object represents the current logged-in user who is making the request. You may want to access this object in your form class for various reasons, such as filtering a queryset based on the user’s permissions, setting a default value for a field based on the user’s preferences, or validating some data against the user’s profile.

However, by default, Django forms do not accept request.user as an argument. If you try to pass it directly to your form class, you will get an error like AttributeError: 'User' object has no attribute 'get'. This is because Django forms expect certain arguments such as data, files, or initial, and any other argument will be treated as invalid.

To solve this problem, you need to override the __init__ method of your form class and define a parameter that can accept request.user, such as user. Then, you need to pop out this parameter from kwargs, which is a dictionary that contains all keyword arguments passed to your form class. Finally, you need to call the super class’s __init__ method with the remaining arguments in kwargs.
Here is an example of how to do this:

class FormSpecies(forms.ModelForm):
    # ... other code ...
    def __init__(self, user, *args, **kwargs):
        # pop out user from kwargs
        self.user = kwargs.pop('user', None)
        # call super class's __init__
        super(FormSpecies, self).__init__(*args, **kwargs)
        # now you can use self.user in your form fields or methods

This way, you can pass request.user to your form class when you create an instance of it in your view:

forms_species_add = FormSpecies(request.user)

from django import forms
from django.contrib.auth.forms import UserChangeForm
from django.contrib.auth.models import User
from tinymce.widgets import TinyMCE
from captcha.fields import CaptchaField

from .models import DBSpecies, DBFossil, Profile, DBFossilGathering, DBEvent, FossilEvent

class FormSpecies(forms.ModelForm):
    captcha = CaptchaField()
    class Meta:
        model = DBSpecies
        fields = "__all__"
        exclude = ("species_owner", )
        widgets = {
            'species_name':forms.TextInput(attrs={'class':'form-control', 'placeholder':'Species name (required)'}),
            'species_image':forms.FileInput(attrs={'class':'form-control'}),
            'species_description':forms.Textarea(attrs={'class':'form-control'}),
            'species_is_archived':forms.CheckboxInput(attrs={'class': 'form-check-input'}),
        }
    
    def __init__(self, user, *args, **kwargs):
        super(FormSpecies, self).__init__(*args, **kwargs)

class FormFossil(forms.ModelForm):
    class Meta:
        model = DBFossil
        fields = "__all__"
        exclude = ("fossil_owner", "fossil_entry_created", "fossil_entry_updated", )
        widgets = {
            'fossil_species':forms.Select(attrs={'class':'form-control'}),
            'fossil_gathered':forms.Select(attrs={'class':'form-control'}),
            'associated_fossils':forms.SelectMultiple(attrs={'class':'form-control'}),
            'fossil_status':forms.Select(attrs={'class':'form-control'}),
            'fossil_name':forms.TextInput(attrs={'class':'form-control', 'placeholder':'required'}),
            'fossil_description_short':forms.Textarea(attrs={'class':'form-control', 'data-mce-disabled': 'true'}),
            'fossil_description_detailed':TinyMCE(),
            'fossil_is_favourite':forms.CheckboxInput(attrs={'class': 'form-check-input'}),
            'fossil_age_in_years':forms.NumberInput(attrs={'class':'form-control'}),
            'fossil_value':forms.NumberInput(attrs={'class':'form-control'}),
            'fossil_condition':forms.Select(attrs={'class':'form-control'}),
            'fossil_date_acquired':forms.DateInput(attrs={'class':'form-control', 'type':'date'}),
            'fossil_size':forms.NumberInput(attrs={'class':'form-control'}),
            'fossil_weight':forms.NumberInput(attrs={'class':'form-control'}),
            'fossil_location':forms.TextInput(attrs={'class':'form-control'}),
            'fossil_location_latitude':forms.NumberInput(attrs={'class':'form-control'}),
            'fossil_location_longitude':forms.NumberInput(attrs={'class':'form-control'}),
            'fossil_image':forms.FileInput(attrs={'class':'form-control'}),
            'fossil_image_resized':forms.FileInput(attrs={'class':'form-control'}),
            'fossil_public_url':forms.URLInput(attrs={'class':'form-control'}),
            'fossil_collector_name':forms.TextInput(attrs={'class':'form-control'}),
            'fossil_collector_email':forms.EmailInput(attrs={'class':'form-control'}),
            'fossil_collector_phone':forms.TextInput(attrs={'class':'form-control'}),
        }

    def __init__(self, user, *args, **kwargs):
        super(FormFossil, self).__init__(*args, **kwargs)
        self.fields['fossil_species'].queryset = DBSpecies.objects.filter(species_owner=user, species_is_archived=False)
        self.fields['associated_fossils'].queryset = DBFossil.objects.filter(fossil_owner=user)

#################################
##########    EMAIL    ##########
#################################

class FormEmail(forms.Form):
    email = forms.EmailField(widget=forms.TextInput(attrs={'class': 'form-control', 'placeholder': 'Email'}))
    subject = forms.CharField(required=False, widget=forms.TextInput(attrs={'class': 'form-control', 'placeholder': 'Subject'}))
    email_note = forms.CharField(widget=forms.Textarea, required=False)
    include_price = forms.BooleanField(required=False, widget=forms.CheckboxInput(attrs={'class': 'form-check-input',}))

##########################################################
##########    P R O F I L E    S E C T I O N    ##########
##########################################################

class FormAccount(UserChangeForm):
    
    def __init__(self, *args, **kwargs):
        super().__init__(*args, **kwargs)
        self.fields.pop('password', None)

    class Meta:
        model = User
        fields = ('first_name', 'last_name', 'email')
        exclude = ('password', 'password1', 'password2', 'password3')


class FormProfile(forms.ModelForm):
    class Meta:
        model = Profile
        fields = '__all__'
        exclude = ('user', )
        widgets = {
            'user_avatar':forms.FileInput(attrs={'class':'form-control'}),
            'user_additional_email':forms.EmailInput(attrs={'class':'form-control', 'placeholder':'Email'}),
            'user_website':forms.URLInput(attrs={'class':'form-control', 'placeholder':'Website'})
        }


################################################################
##########    G A T H E R I N G S    S E C T I O N    ##########
################################################################

class FormGathering(forms.ModelForm):
    class Meta:
        model = DBFossilGathering
        fields = "__all__"
        exclude = ("gathering_owner", 'gathering_slug')
        widgets = {
            'gathering_name':forms.TextInput(attrs={'class':'form-control', 'placeholder':'required'}),
            'gathering_date':forms.DateInput(attrs={'class':'form-control', 'type':'date'}),
            'gathering_image':forms.FileInput(attrs={'class':'form-control'}),
            'gathering_description':forms.Textarea(attrs={'class':'form-control'}),
            'gathering_location':forms.TextInput(attrs={'class':'form-control'}),
            'gathering_location_geological_time':forms.TextInput(attrs={'class':'form-control'}),
            'gathering_duration': forms.TextInput(attrs={'class': 'form-control'}),
            'gathering_pdf': forms.FileInput(attrs={'class': 'form-control-file'}),
        }

    def __init__(self, user, *args, **kwargs):
        super(FormGathering, self).__init__(*args, **kwargs)

########################################################
##########    E V E N T S    S E C T I O N    ##########
########################################################

class FormEvent(forms.ModelForm):
    class Meta:
        model = DBEvent
        fields = ['event_name', 'event_date', 'event_notes']
        widgets = {
            'event_name':forms.TextInput(attrs={'class':'form-control', 'placeholder':'required'}),
            'event_date':forms.DateInput(attrs={'class':'form-control', 'type':'date'}),
            'event_notes': forms.Textarea(attrs={'class': 'form-control'}),
        }

    def __init__(self, user, *args, **kwargs):
        super(FormEvent, self).__init__(*args, **kwargs)


class FormFossilEvent(forms.ModelForm):
    class Meta:
        model = FossilEvent
        fields = ('fossil', 'fossil_lending_date', 'fossil_lending_date_returned', 'fossil_lending_notes')


        widgets = {
            'fossil': forms.Select(attrs={'class': 'form-control'}),
            'fossil_lending_date':forms.DateInput(attrs={'class':'form-control', 'type':'date'}),
            'fossil_lending_date_returned':forms.DateInput(attrs={'class':'form-control', 'type':'date'}),
            'fossil_lending_notes': forms.Textarea(attrs={'class': 'form-control'}),
        }

    def __init__(self, user, *args, **kwargs):
        super(FormFossilEvent, self).__init__(*args, **kwargs)
        self.fields['fossil'].queryset = DBFossil.objects.filter(fossil_owner=user)

class FormFossilReturn(forms.ModelForm):
    class Meta:
        model = FossilEvent
        fields = ('fossil_lending_date_returned',)

        widgets = {
            'fossil_lending_date_returned':forms.DateInput(attrs={'class':'form-control', 'type':'date'}),
        }

####################################################
##########    S E L E C T    I M A G E    ##########
####################################################

from django.utils.html import format_html

class ImageForm(forms.Form):
    image_choices = (
        ('Ammonite', format_html('<img src="{}" width="100px">', '/static/app_fossils/images/image_option/ammonite.jpg')),
        ('Dinosaur', format_html('<img src="{}" width="100px">', '/static/app_fossils/images/image_option/dinosaur.jpg')),
        ('Fish', format_html('<img src="{}" width="100px">', '/static/app_fossils/images/image_option/fish.jpg')),
        ('Trillobite', format_html('<img src="{}" width="100px">', '/static/app_fossils/images/image_option/trillobite.jpg')),
    )
    selected_image = forms.ChoiceField(choices=image_choices, widget=forms.RadioSelect)