워드프레스 사용자 프로필 이름 다루기 (display_name 사용법)

workspace/web

2025. 4. 11. 08:00

📘 워드프레스 REST API를 이용해서 나만의 사이트 만들기 - 4편

워드프레스 사용자 프로필 이름 다루기 (display_name 사용법)

이전 3편에서는 일반 사용자도 직접 회원가입을 할 수 있도록 기능을 구현했고, REST API로 간단하게 작성자 권한의 유저를 생성하는 방법까지 확인했다.

큰 항목들은 처리가 된거같고 앞으로는 조금씩 수정을 하며 보기 좋은 사이트로 바꿔가는 과정만 남았다.

이번에 해볼것은, 가입된 유저의 표시 이름(display_name)을 닉네임(nickname)으로 자동 설정해서 글 목록에 사용자 이름이 깔끔하게 보이도록 만드는 것이다.

🤔 왜 표시 이름(display_name)을 따로 설정해야 할까?

워드프레스에서는 회원가입 시 사용자 계정 이름(username)이 기본적으로 표시 이름으로 설정된다.
하지만 실제로 사용자 목록이나 게시물에 노출될 이름은 별도로 관리되는 display_name 필드다.

그럼 이전에 설정한 닉네임(nickname)은 무엇인가?

🔁 관계 정리: 닉네임(nickname) 과 표시 이름(display name)

nickname 은 그냥 저장되는 사용자 속성 중 하나.
display_name 은 "이 사용자를 뭐라고 표시할 것인가" 를 결정.
워드프레스는 회원 가입 시 별도로 display_name을 지정하지 않으면, username을 자동으로 사용.

🔧 즉, 실제로 외부에 보이는 건?

항상 display_name

댓글 작성자, 게시글 작성자 등 사이트에 보이는 이름은 전부 display_name이다.
nickname은 보통 프로필 설정용 데이터고, 꼭 보이지는 않는다.

내가 지금 만들고 있는 웹은 트위터처럼 짧은 글을 사용자 중심으로 보여주는 구조이기 때문에, 글 옆에 표시될 이름이 계정명이기보다는 친근한 닉네임이 더 자연스럽다.

🔧 닉네임을 표시 이름으로 바꾸기 (자동 설정 플러그인)

REST API로 회원가입할 때 nickname은 전달되지만, display_name은 자동으로 설정되지 않는다.
이를 해결하려면, REST API로 회원가입 후 추가로 display_name만 PATCH 요청하는 방법이 있는데 이 방법은 JWT 로그인 토큰이 필요한 부분이기 때문에, 회원가입 후 바로 로그인까지 처리한 경우에만 가능하다.

이번에도 커스텀 플러그인을 사용하여 사용자가 가입할 때 자동으로 nickname을 display_name으로 설정해 주도록 할 것이다.

아래 플러그인을 설치후 활성화를 하기만 하면 끝이다.