django-object-actions icon indicating copy to clipboard operation
django-object-actions copied to clipboard

Naming things

Open crccheck opened this issue 9 years ago • 1 comments

I could have sworn I had a naming things issue before. I'm not that happy with some of the name choices I made.

  • [ ] INSTALLED_APPS name: django_object_actions stays the same
  • [ ] main admin mixin: DjangoObjectActions
  • [ ] admin mixin w/o template: BaseDjangoObjectActions
  • [x] model admin attribute: objectactions :arrow_right: change_actions ?
  • [ ] decorator: takes_instance_or_queryset :arrow_right: to_queryset ?
  • [ ] template context variable: objectactions :arrow_right: ?
  • [ ] docs: "tools" :arrow_right: "change actions", "action tools"

This is really the only thing blocking a 1.0 release

model admin attribute, objectactions

The scope of the project is expanding a bit. The Django admin has conventions for standard admin views. The docs show there's the:

  • add view
  • change view
  • changelist view
  • delete view
  • history view

Each of those could potentially have their own sets of actions. If we re-use the existing names, we end up with add_actions, change_actions, changelist_actions, delete_actions, and history_actions.

template context variable: objectactions

For every view, it'd be nice to have the same context variable. We don't need to differentiate between each kind.

crccheck avatar Dec 05 '15 05:12 crccheck

I just found this project. It works as expected and I'm going to use it in a lot of places. Thanks a lot. I'm also willing to help but I have some difficulties understanding the checklist.

If the name in INSTALLED_APPS remains the same, the checkbox should be checked, right?

Renaming the takes_instance_or_queryset decorator to just to_queryset seems like an easy task and I can do it if this is all that needs to be done.

About the objectactions context variable I have some suggestions: custom_actions, actions_list, admin_actions and custom_admin_actions.

Actually, I don't think objectactions is that bad, except for the missing underscore. The first time I read it like objections. Maybe object_actions will be better.

DjangoObjectActions can be renamed to CustomActionsMixin or CustomObjectActionsMixin. The same goes with BaseDjangoObjectActions.

About the docs, change actions sounds nice.

gatsinski avatar Feb 17 '18 21:02 gatsinski