= NewbieMistakes = Please feel free to share the things that tripped you up when you started with Django. We'll try to improve Django's error handling to catch such mistakes in the future. == URLconf include() misbehaving == ==== Symptom ==== You're trying to get your URLconf files to work, but getting cryptic errors about how there is no module 'index' (where 'index' is some function you are trying to assign as a view), or module 'foo' has no attribute 'urlpatterns'. ==== Probable cause ==== You may have tried to load your view files using include() in the URLconf file (in tutorial 3, this is myproject/settings/urls/main.py). The include() call assumes that the file it's loading is also a URLconf file. ==== Solution ==== Remove the include(). Just give the module and function name (e.g., {{{'myproject.apps.polls.views.polls.index'}}}) as a string, with no include() around it. == Blank object names == ==== Symptom ==== The automatic admin interface is showing nothing (or a single {{{ }}}) in the "Select [object_type] to change" view. ==== Probable cause ==== You may have forgotten to create a {{{__repr__()}}} function for your model. Django calls {{{__repr__()}}} to find out how to display objects in the admin interface. ==== Solution ==== Add a {{{__repr__()}}} function to all your models. Make it a habit so it becomes automatic. == Integer & NULLS == ==== Problem ==== When you have a Field: current_zip = meta.IntegerField(maxlength=5,blank=True) django will create a not nullable field in the DB. However leaving the field blank (in admin/web) django will try and insert a NULL value in the DB. ==== Solution ==== Add null=True: current_zip = meta.IntegerField(maxlength=5,null=True,blank=True) == Appending to a list in session doesn't work == ==== Problem ==== If you have a list in your session, append operations don't get saved to the object. ==== Solution ==== Copy the list out of the session object, append to it, then copy it back in: {{{ sessionlist = request.session['my_list'] sessionlist.append(new_object) request.session['my_list'] = sessionlist }}} == Errors about undefined attributes with one-char names == ==== Problem ==== You get an AttributeError with some weird attribute name that's only one char long. You don't have that attribute name anywhere in your code. ==== Solution ==== Search your model and code for situations where you have to pass a tuple of values and want to pass a tuple with one element - and that element is a string like in this sample: {{{ #!python class META: ... admin = meta.Admin( list_display = ('total_price'), ... ) }}} It's a standard python error - you are just missing a comma in the list_display assignement like this: {{{ #!python class META: ... admin = meta.Admin( list_display = ('total_price',), ... ) }}} Since a tuple is expected but a string provided, the code will merrily iterate over the characters of the string instead of the tuple elements - and that's where the single-char attribute names come from.