Opened 15 years ago

Closed 11 years ago

Last modified 11 years ago

#9471 closed New feature (fixed)

Documentation Admin classes with raw_id_fields

Reported by: adroffne@… Owned by: nobody
Component: Documentation Version: 1.0
Severity: Normal Keywords:
Cc: Triage Stage: Accepted
Has patch: no Needs documentation: no
Needs tests: no Patch needs improvement: no
Easy pickings: no UI/UX: no

Description

The Django documentation is very unclear on the raw_id_fields feature. Please, describe the feature better, and add a screenshot showing a sample table of raw_id_fields. Also, explain the magnifying glass chooser aspect.

Most importantly, the documentation seems to treat raw_id_fields like comma-separated lists of IDs; like 1,2,3; rather than one ID per field. Also, note that the user must input the primary key, and the admin coder has to show the user that key somehow.

There should be more about Inline admin classes as compared to model Admin classes and raw_id_fields. Also, describe more on ForeignKey, ManyToMany, and ManyToMany with through.

I have used raw_id_fields in an Inline admin class to add several ManyToMany items for the first time. My understanding of raw_id_fields is limited, and my suggestions above may be plain wrong.

Change History (7)

comment:1 by peter@…, 15 years ago

There is no documentation of this feature. Better to write 'XXX TO DO'!

comment:2 by Jacob, 15 years ago

Triage Stage: UnreviewedAccepted

comment:3 by Luke Plant, 13 years ago

Severity: Normal
Type: New feature

comment:4 by Aymeric Augustin, 12 years ago

UI/UX: unset

Change UI/UX from NULL to False.

comment:5 by Aymeric Augustin, 12 years ago

Easy pickings: unset

Change Easy pickings from NULL to False.

comment:6 by Tim Graham <timograham@…>, 11 years ago

Resolution: fixed
Status: newclosed

In da958eb2098372c20cc3aaf905777b1a8d3144eb:

Fixed #9471 - Expanded ModelAdmin.raw_id_fields docs; thanks adroffne for the suggestion.

comment:7 by Tim Graham <timograham@…>, 11 years ago

In baf1f1dcde1f318fdb6514eaa8497fc958aa69d3:

[1.4.X] Fixed #9471 - Expanded ModelAdmin.raw_id_fields docs; thanks adroffne for the suggestion.

Backport of da958eb209 from master

Note: See TracTickets for help on using tickets.
Back to Top