Django Admin 커스터마이징 제대로 하기

Django Admin, 제대로 꾸며보기: 내 경험과 팁!

Django Admin? 처음엔 그냥 기본 기능만 쓰면 되겠지 했는데, 프로젝트가 커지면서 관리가 너무 힘들더라고요. 그래서 직접 꾸며보기 시작했죠. 이 글에선 제가 Django Admin 커스터마이징을 하면서 깨달은 점들을, 마치 수다 떠는 것처럼 편하게 풀어놓을게요. 어려운 용어는 최대한 쉽게 설명해 드릴 테니, 걱정 마세요!

일단 Django Admin 커스터마이징은 크게 두 가지로 나눠 생각하면 돼요. 모델(Model) 레벨과 관리자(Admin) 레벨이죠. 모델 레벨은 데이터 자체를 손보는 거예요. 예를 들어, 블로그 게시글에 '카테고리' 필드를 추가하고 싶다면, models.py 파일에서 모델을 수정해야 해요. 이건 마치 레고 블록을 새로 끼워 넣는 것과 같다고 생각하면 편하죠. 새로운 필드를 추가하거나, 기존 필드의 종류를 바꾸거나, 아예 필드를 삭제할 수도 있어요.

그런데 모델만 바꾼다고 Admin 화면이 바뀌진 않아요. Admin 화면을 직접 조작하려면 관리자 레벨 커스터마이징을 해야 해요. 이건 admin.py 파일에서 ModelAdmin 클래스를 이용해서 하는데, 여기서 필드의 표시 순서를 바꾸거나, 어떤 필드는 읽기 전용으로 만들거나, 필터를 추가하거나, 심지어는 아예 새로운 기능을 추가할 수도 있답니다. 정말 막강한 기능이죠!

자, 이제 실제 코드를 보여드릴게요. 제가 블로그 앱(blog 앱이라고 가정할게요)을 만들었는데, 게시글(Post 모델)에 작성자(author), 제목(title), 내용(content), 발행일(published_date) 필드가 있어요. models.py는 이렇게 생겼죠. (코드 생략 - 원문의 models.py 코드)

그리고 admin.py는 이렇게 설정했어요. (코드 생략 - 원문의 admin.py 코드)

이 코드를 보면, list_display에서 게시글 목록에 어떤 필드를 보여줄지 정하고, list_filter는 필터링 기능을 추가했어요. search_fields는 제목과 내용을 검색할 수 있도록 했고요. readonly_fields는 발행일을 읽기 전용으로 만들었죠. 그리고 content_preview는 내용의 앞 50자만 보여주는 커스텀 필드를 추가한 예시입니다. 신기하죠? 이렇게 조금만 바꿔도 Admin 화면이 훨씬 보기 좋고 사용하기 편해진답니다.

여기서 잠깐! 모델을 바꿨다면, python manage.py makemigrations 와 python manage.py migrate 명령어를 꼭 실행해야 데이터베이스에 반영된다는 것을 잊지 마세요. 이 부분은 꼭 기억해 주세요! 저는 이걸 깜빡하고 한참 헤맨 적이 있답니다… ㅠㅠ

그리고 보안도 중요해요. 아무나 Admin 페이지에 접근하지 못하도록 권한 관리를 잘 해야 해요. Django는 사용자 그룹별로 권한을 설정하는 기능을 제공하니까, 꼭 활용해 보세요.

Admin 화면 디자인을 완전히 바꾸고 싶다면 커스텀 템플릿을 사용할 수도 있지만, 이건 상당히 복잡하니 정말 필요할 때만 하는 게 좋아요. 저도 처음엔 멋진 디자인을 만들고 싶었지만… 결국 기본 디자인을 조금만 손보는 것으로 만족했답니다. 😅

마지막으로, Admin을 커스터마이징 한 후에는 꼭 테스트를 해봐야 해요. 예상치 못한 오류가 발생할 수 있으니까요. 저는 항상 작은 변화를 주고 테스트를 반복하는 방식으로 작업했어요. 그리고 모든 변경 사항은 꼼꼼히 문서화해 두는 것도 잊지 마세요. 나중에 다시 확인해야 할 때 정말 도움이 된답니다.

결론적으로, Django Admin 커스터마이징은 정말 유용하지만, 너무 과하게 하면 오히려 관리가 어려워질 수 있어요. 필요한 기능만 추가하고, 항상 최소한의 변경으로 최대의 효과를 내도록 노력하는 것이 중요해요. 이 글이 여러분의 Django Admin 커스터마이징 여정에 조금이나마 도움이 되었으면 좋겠네요! 혹시 궁금한 점이 있다면 언제든지 질문해 주세요!