워드프레스를 쓰다 보면 [contact-form-7 id=”123″] 같은 대괄호 코드를 만나게 됩니다. 처음 보면 오류처럼 보이지만, 이것이 워드프레스의 대표 기능인 쇼트코드입니다. 정체를 알면 사이트 관리가 훨씬 수월해집니다.
쇼트코드의 정체
쇼트코드는 긴 프로그램 코드를 대괄호 한 줄로 불러 쓰는 단축키입니다. 라고 쓰면 워드프레스가 그 자리를 이미지 갤러리로 바꿔서 출력합니다. 문의폼, 지도, 상품 목록처럼 복잡한 기능을 코드 지식 없이 본문 아무 곳에나 삽입할 수 있게 해주는 장치입니다. 대괄호 안의 id=”123″ 같은 부분은 옵션으로, 어떤 폼을 보여줄지 등을 지정합니다.
넣는 방법 — 블록 에디터 기준
- 글 편집 화면에서 + 버튼을 누르고 ‘쇼트코드’ 블록을 검색해 추가합니다.
- 블록 안에 대괄호를 포함한 쇼트코드 전체를 붙여넣고 저장하면 끝입니다.
- 클래식 에디터라면 본문에 그대로 입력해도 동일하게 동작합니다.
쇼트코드 자체는 보통 플러그인 설정 화면에서 복사해 옵니다. 예를 들어 Contact Form 7은 관리자 → 문의 메뉴에서 폼마다 복사용 쇼트코드를 제공합니다.
실무에서 자주 쓰는 예시
[contact-form-7 …]은 문의폼, 은 갤러리, 우커머스의
대괄호가 화면에 그대로 보일 때
방문자 화면에 [something] 문구가 날것으로 노출된다면, 그 쇼트코드를 해석해 줄 플러그인이 비활성화됐거나 삭제된 상태라는 뜻입니다. 플러그인 목록에서 해당 기능의 플러그인이 켜져 있는지 먼저 확인하고, 최근 업데이트 후 생긴 증상이라면 플러그인 충돌 해결 가이드의 격리 절차로 원인을 찾으세요. 더 이상 안 쓰는 플러그인이라면 본문에 남은 쇼트코드를 지워주면 됩니다.
플러그인을 삭제하기 전, 그 플러그인의 쇼트코드를 어느 페이지에 썼는지 목록을 남겨 두세요. 삭제 후 대괄호가 노출되는 페이지를 찾아다니는 수고를 덜 수 있습니다.
※ 쇼트코드가 많아질수록 어떤 플러그인 소속인지 관리가 어려워집니다. 페이지별 사용 현황을 문서로 관리하면 개편 때 큰 도움이 됩니다.
사이트 곳곳의 쇼트코드 정리나 기능 개선이 필요하시면 IDC.KR 문의 페이지로 편하게 남겨 주세요. 현황 진단부터 정리까지 도와드립니다.