워드프레스 목차 플러그인: 목차가 표시되지 않는 경우

Last Updated: 2024년 12월 11일 2개 댓글

워드프레스에서는 무료 또는 유료 목차 플러그인을 사용하여 목차를 표시할 수 있습니다. 무료 목차 플러그인으로는 Easy Table of Contents (쉬운 목차) 플러그인이 있습니다. 이 블로그에는 Tocer (이전 명칭 "Fixed TOC")라는 플러그인이 사용되고 있습니다.

목차 플러그인을 설치하여 세팅해도 목차가 표시되지 않는다고 호소하는 사용자들이 계십니다. 목차가 표시되지 않는 경우 플러그인 설정이 잘못되었거나 플러그인 충돌을 의심할 수 있습니다.

워드프레스 목차 플러그인: 목차가 표시되지 않는 경우

목차는 SEO에 여러 긍정적인 영향을 미칩니다. 사용자 경험을 개선하여 웹사이트의 이탈률을 낮추고 체류 시간을 늘리며, 검색엔진이 콘텐츠의 구조를 더 쉽게 이해할 수 있도록 돕습니다. 특히 구글 검색 결과 페이지에서 추천 스니펫 생성에 도움을 주어 클릭률(CTR)을 높이고, 소제목과 링크를 통해 콘텐츠의 가독성과 탐색성을 향상시킵니다. 또한, 구조화된 콘텐츠는 검색엔진 최적화에 긍정적인 영향을 미쳐 웹사이트의 검색 순위 개선에 기여할 수 있습니다.

목차 플러그인을 설치해도 목차가 표시되지 않는 경우 다음 사항을 확인해보시기 바랍니다.

목차 플러그인 설정 문제 또는 사용법 이해 부족

목차가 표시되지 않는 경우 대부분 이 문제일 수 있습니다.

Easy Table of Contents (쉬운 목차) 플러그인

먼저는 자동 목차 삽입 옵션이 활성화되어야 합니다. 쉬운 목차 플러그인에서는 워드프레스 관리자 페이지 » 설정 » 쉬운 목차 » 일반 탭에서 자동 삽입 옵션에서 자동으로 목차가 추가될 글 유형(예: 글)을 선택하고 언제 표시 옵션에서 제목(헤딩 태그)의 개수를 지정하도록 합니다.

위의 그림과 같이 설정되면 4개 이상의 소제목(헤딩 태그)이 존재할 때 글(포스트)에 자동으로 목차가 표시됩니다.

예를 들어, 글에 소제목(헤딩 태그)이 3개만 있다면 자동으로 목차가 표시되지 않습니다. 소제목은 블록 에디터에서 ##+스페이스를 입력하여 삽입할 수 있습니다. (블록 에디터에서 키보드 단축키를 활용하면 빠르게 글을 작성할 수 있고 마우스 사용을 최소화할 수 있습니다.)

##+스페이스를 입력하면 H2 태그가 삽입되고, ###+스페이스를 입력하면 H3 태그가 적용됩니다.

다른 방법으로 /제목을 입력하여 제목 (헤딩 태그) 블록을 추가할 수도 있습니다.

헤딩 태그에 대한 자세한 정보는 모질라 문서 "<h1>-<h6>: HTML 구획 제목 요소"를 참고하시기 바랍니다.

Tocer 플러그인 (구 명칭 "Fixed TOC")

Tocer 플러그인을 사용하는 경우도 자동 삽입 옵션이 활성화되었는지 체크하고 소제목 개수 설정도 확인하시기 바랍니다.

자동 목차 기능을 활성화하려면 설정 » Tocer » Auto Toc 섹션에서 자동 목차 옵션을 On으로 설정하도록 합니다.

소제목 개수 설정은 SETTINGS에서 설정 템플릿을 만들거나 편집하여 지정할 수 있습니다.

설정 템플릿 편집 화면에서 목차 블록을 선택하고 오른쪽 설정 패널에서 Minimum Headings 값을 변경하여 소제목(헤딩 태그) 개수를 지정할 수 있습니다.

위의 그림과 같이 설정하면 H2, H3, H4, H5, H6 헤딩 태그가 2개 이상이 있으면 자동으로 목차가 표시됩니다.

플러그인 충돌 문제

플러그인 충돌 때문에 목차가 제대로 표시되지 않는 경우가 있을 수 있습니다. 예를 들어, 쉬운 목차 플러그인은 2.0.68 버전으로 업데이트된 후에 치명적인 오류가 발생한 적이 있습니다. 이런 경우 플러그인을 최신 버전으로 업데이트하면 문제가 해결될 수 있습니다.

목차 플러그인 사용을 원치 않는 경우 간단한 스크립트를 만들어 목차를 표시하는 것도 가능합니다.

워드프레스에서는 플러그인을 사용하여 쉽게 기능을 확장할 수 있다는 장점이 있습니다. 플러그인을 잘 활용하면 개발자를 고용하지 않고도 원하는 기능을 구현할 수 있습니다.

하지만 많은 플러그인을 사용할 경우 사이트 속도가 느려질 수 있고 플러그인 간 충돌이 발생할 수도 있습니다. 그러므로 가급적 꼭 필요한 플러그인만 사용하고, 무거운 플러그인이나 잘못 만들어진 플러그인은 가급적 사용하지 않는 것이 바람직합니다.

참고

워드크래커의 아바타 이미지

워드크래커

전문 영한번역가. 워드프레스 애호가. 네이버 카페 「워프사」 운영.

2 개 댓글

댓글 남기기

  1. Tocer를 사용중인데 content부분 헤더가 본문 h2테그처럼 박스가 생기고 꾸며지네요ㅠㅠ 크래커님처럼 깔끔하게 뜨게 하고싶은데 방법이 있을까요 ?

    응답
카카오톡 상담 카톡 서비스 상담