워드프레스 목차 플러그인 Fixed TOC가 Tocer로 바뀌었습니다

Last Updated: 2024년 11월 08일 댓글

워드프레스는 다양한 무료 및 유료 목차(TOC) 플러그인이 있습니다. 무료 플러그인으로는 쉬운 목차 플러그인이 많이 사용됩니다. 이 블로그에는 Fixed TOC라는 유료 목차 플러그인이 사용되고 있습니다. Fixed TOC는 최근 Tocer로 이름이 바뀌고 기능적인 면에서도 많은 변화가 있었습니다. 사실상 다른 플러그인이라고 해도 무방합니다.

Tocer 개발자는 블록 에디터 대응을 위해 Tocer로 바꾸었으며 기존의 Fixed TOC는 한동안 사용할 수는 있지만 활발히 업데이트하지 않을 것이라고 밝혔습니다. 그러므로 Fixed TOC를 사용하는 경우 가능하면 Tocer로 바꾸는 것을 고려하시기 바랍니다.

워드프레스 목차 플러그인 Fixed TOC가 Tocer로 변경

워드프레스 유료 목차 플러그인인 Fixed TOC 플러그인이 최근 Tocer로 명칭이 바뀌었습니다. 플러그인 판매자에 의하면 테마를 비롯하여 모든 것이 이제 블록이므로 목차를 구텐베르크 블록으로 변환하기로 했다고 하면서, Tocer는 Fixed TOC와는 완전히 다른 플러그인이라고 합니다.

Tocer에서는 세 가지 방법으로 목차를 넣을 수 있습니다.

  1. 블록 에디터 블록으로 삽입 (수동 삽입)
  2. 자동 목차 삽입
  3. 숏코드를 사용하여 목차 삽입

숏코드는 아마 고전 편집기를 위해 지원되는 것 같습니다만, 고전 편집기에서 Tocer라 제대로 작동하는지는 확인하지 않았습니다.

워드프레스 5.0 버전부터 기본 편집기가 블록 에디터로 바뀌었기 때문에 이제는 고전 편집기는 놓아주고 블록 에디터(구텐베르크)를 사용하는 것이 바람직하지 않나 생각됩니다.

자동으로 목차를 넣도록 설정해도 특정 페이지나 게시글에서 수동으로 블록 에디터 블록으로 삽입할 경우 블록으로 삽입한 목차가 표시되는 것 같습니다.

Tocer로 변경 후 에러가 발생하는 경우

이 블로그에서 Fixed TOC를 제거하고 Tocer를 설치하여 테스트해보니 몇 가지 오류가 발생했습니다.

  1. GeneratePress 테마에서 '위로 이동 버튼' (Back to Top Button)과 충돌 발생
  2. 포스트를 여러 페이지로 분할한 경우 목차 내의 메뉴 항목 클릭 시 치명적인 오류 발생 (긴 포스트는 여러 페이지로 분할하는 것이 가능합니다.)

플러그인 개발자에게 연락하여 위의 문제를 보고하니 버그를 수정해주었습니다. 글을 여러 페이지로 분할한 경우에는 블록 에디터에서 목차 블록을 추가하면 에러가 발생하지 않도록 에러가 해결되었습니다.

이외에 Contents 라벨을 변경하는 방법 등을 몰라서 헤맸는지만 조금 살펴보니 스타일을 템플릿으로 만들어 연결하도록 방식이 바뀌었네요.

기본적인 사용 방법

Tocer 플러그인을 활성화하면 워드프레스 알림판 » 설정 » Tocer에서 목차 관련 설정을 할 수 있습니다.

Fixed TOC에서는 많은 옵션이 제공되었지만, Tocer를 활성화하고 설정 페이지를 방문하면 너무 옵션이 없어서 당황해할 수도 있을 것 같습니다.

스타일 등을 세부적으로 설정하는 부분은 템플릿을 만들어 로드할 수 있도록 되어 있습니다. 그래서 설정 페이지에 설정할 옵션이 별로 없는 것처럼 보일 수 있습니다.

설정 페이지에는 크게 세 부분에 대한 옵션을 선택할 수 있도록 되어 있습니다.

블록 에디터용 TOC 블록 설정

Tocer Global Settings 페이지의 윗부분은 아래 그림과 같이 되어 있습니다.

General에서 Covert Heading to ID는 영어, 프랑스어, 스페인어, 독일어 등 라틴문자 계열의 언어가 지원되고 한국어는 지원이 안 될 것도 같습니다. 저는 이 부분은 체크하지 않았습니다.

Gutenberg 섹션에서는 위와 같이 다소 썰렁한 옵션만 있습니다. TOC 설정을 템플릿으로 만들고 Default Inherited Toc Settings에서 템플릿을 선택할 수 있도록 되어 있습니다.

Click To Manage 링크를 클릭하여 새로운 설정 템플릿을 만들 수 있습니다. 글/페이지 작성 화면과 비슷합니다. 목차 이름을 입력하고, 목차 블록을 클릭하면 오른쪽에 블록 설정 옵션들이 표시됩니다.

너무 많은 설정이 있네요. 예를 들어, Common 옆의 플러스 아이콘을 클릭하면 이 섹션에서 지정할 수 있는 옵션들이 표시됩니다.

저는 옵션은 전혀 건드리지 않고 기본 설정을 사용하고 있습니다. 라벨만 "Contents"에서 "목차"로 변경하고 글자 크기를 줄였습니다. 참고로 다음과 같은 코드를 사용하여 번역하는 것도 가능합니다(차일드 테마 내의 함수 파일에 추가).

add_filter('tocer_render_toc_args', function($args){
	$args['header_title'] = '제목 번역';
	return $args;
});

Default Inherited Toc Settings에서 생성한 설정 템플릿을 선택하거나 None으로 그대로 둘 수 있습니다. None으로 그대로 두면 기본 TOC 설정이 로드되는 것 같습니다.

블록 에디터에서 TOC를 수동으로 삽입할 수 있습니다. 그런 경우에 위에서 설정한 TOC 설정 템플릿이 적용될 것으로 보입니다.

블록 편집기에서 목차를 수동으로 넣으려면 /Tocer를 입력하여 Tocer를 선택하면 됩니다(구텐베르크 키보드 단축키 참조).

자동 목차 설정

Auto Toc 섹션에서는 자동 목차 기능을 사용할지 여부를 선택할 수 있습니다.

자동 목차 기능을 활성화하면 위의 그림과 같이 몇 가지 추가적인 옵션이 표시됩니다.

MIN Headings에서는 최소 헤딩 태그(소목차 태그) 개수를 지정하고 SETTINGS에서는 스타일 등이 지정된 설정 템플릿을 선택할 수 있습니다.

예를 들어, 헤딩 태그(H2, H3, H4...)가 2개 이상일 때 목차를 자동으로 표시하려면 MIN HEADINGS에서 "2"를 선택하면 됩니다.

AUTO TOC POSITION IN POST는 포스트에서 자동 목차 위치를 지정합니다. 다음과 같은 위치를 선택할 수 있습니다.

  • 게시글 상단
  • 게시글 하단
  • 첫 번째 소제목 앞
  • 첫 번째 소제목 뒤
  • 두 번째 소제목 앞
  • 두 번째 소제목 뒤

숏코드

Shortcode 섹션에서는 쇼트코드를 활성화할 것인지를 선택합니다.

활성화하면 [toc] 또는 [tocer] 숏코드를 사용하여 목차를 삽입할 수 있습니다.

DEFAULT SETTINGS에서는 기본 설정을 로드할 템플릿을 선택할 수 있습니다. 기본 설정을 사용하고 싶은 경우 마찬가지로 None을 선택합니다.

요약

  1. Fixed TOC가 Tocer로 바뀜
  2. Fixed TOC와 Tocer는 완전히 별개의 플러그인임
  3. Tocer는 목차를 블록 에디터의 블록으로 추가 가능
  4. Tocer에서는 블록 에디터의 블록, 자동 목차, 숏코드 등의 방식으로 목차 추가 가능
  5. Fixed TOC는 당분간 작동하겠지만 활발히 업데이트가 안 되므로 가급적 Tocer로 변경하는 것이 바람직함
  6. Tocer에서는 설정 템플릿을 만들어 로드하는 방식으로 바뀜
  7. Tocer를 사용하는 경우에는 Fixed TOC를 삭제하세요.

사용자 정의 목차 설정을 만드는 방법

Tocer에서는 사용자 정의 목차를 만들어 로드하는 방식으로 스타일을 지정할 수 있습니다. 자세한 방법은 다음 글을 참고해보세요.

마치며

Tocer 플러그인을 다운로드하면 Fixed TOC와 Tocer 설치 파일이 모두 포함되어 있습니다.

Fixed TOC는 적극적으로 업데이트가 안 될 예정이므로 가급적이면 Tocer를 선택하면 좋을 듯합니다. 만약 Tocer가 이용 중인 테마나 플러그인과 충돌이 발생한다면 플러그인 판매자에게 연락하여 버그를 보고할 수 있을 것입니다.

참고


댓글 남기기

Leave a Comment