그누보드 첨부 이미지 썸네일 alt 태그에 글 제목 자동 삽입하기

• 목록
• 스크랩

그누보드 첨부 이미지 썸네일 alt 태그에 글 제목 자동 삽입하기

그누보드 게시판의 첨부 이미지 썸네일에 누락된 alt 태그를 글 제목으로 자동 삽입하여 웹 접근성과 검색 엔진 최적화(SEO)를 개선하는 방법을 안내합니다.

썸네일 alt 태그 수정 대상 파일

그누보드 썸네일 생성 함수에서 alt 태그에 글 제목을 넣기 위해 수정해야 하는 파일은 lib/thumbnail.lib.php입니다. 이 방법은 파일 첨부 기능을 통해 썸네일이 생성되는 경우에 한해 적용됩니다.

작업 전 백업

파일 수정 중 발생할 수 있는 오류에 대비하여 반드시 lib/thumbnail.lib.php 파일을 다른 곳에 복사해 두어야 합니다. 문제가 발생하면 원본 파일을 다시 업로드하여 복구할 수 있습니다.

함수 위치 및 수정 내용

lib/thumbnail.lib.php 파일 내에서 get_view_thumbnail 함수를 찾아 global 선언부에 $view를 추가하고 썸네일 태그 생성 시 alt 속성에 게시글 제목을 지정합니다.

get_view_thumbnail 함수 수정 방법

그누보드 첨부 이미지 썸네일의 alt 속성에 글 제목을 자동 삽입하려면 lib/thumbnail.lib.php 파일 내의 get_view_thumbnail 함수를 수정해야 합니다. 단, 이 수정은 게시판 설정의 이미지 폭보다 큰 이미지를 업로드하여 썸네일이 생성되는 경우에만 유효합니다.

1. 전역 변수 $view 추가

lib/thumbnail.lib.php 파일 안에서 get_view_thumbnail 함수를 찾아 global 선언부에 $view를 추가합니다.

function get_view_thumbnail($contents, $thumb_width=0) {
    global $board, $config, $view;
    ...
}

2. 이미지 태그의 alt 속성 수정

이후 이미지 태그를 생성하는 부분의 alt 속성을 아래와 같이 수정하여 게시글 제목($view['wr_subject'])이 들어가도록 지정합니다.

// 수정 예시: alt 속성에 게시글 제목 삽입
alt="'.$view['wr_subject'].'"

파일 수정 전 백업 방법

그누보드 첨부 이미지 썸네일 alt 태그 수정 등 파일 수정 작업 중 발생할 수 있는 오류에 대비하여, 작업 전 반드시 lib/thumbnail.lib.php 파일을 다른 곳에 복사해 두어야 합니다. 이는 코드 수정 후 사이트 오류 발생 시 원본으로 즉시 복구하기 위함입니다.

백업 및 복구 절차

1. 백업 위치: 서버의 lib/thumbnail.lib.php 파일을 다운로드하거나 안전한 다른 위치에 복사해 둡니다.
2. 문제 발생 시 조치: 코드 수정 후 오류가 발생하면 원본 백업 파일을 다시 서버에 업로드하여 복구할 수 있습니다.

썸네일 alt 태그 적용 결과 확인 방법

코드를 수정한 후 썸네일 alt 태그에 글 제목이 정상적으로 들어갔는지 확인하려면 다음 절차를 진행합니다.

1. 수정 후 게시판에 파일을 첨부하여 글을 작성합니다.
2. 웹 브라우저에서 해당 게시글 페이지를 엽니다.
3. 마우스 우클릭 후 '페이지 소스 보기'를 선택하여 이미지 태그의 alt 속성에 글 제목이 정상적으로 출력되는지 확인합니다.

적용 시 주의사항

• 적용 범위: 게시판 설정의 이미지 폭보다 큰 이미지를 올려 썸네일이 생성되는 경우에만 적용됩니다.
• 이미지 유형: 에디터로 삽입한 이미지가 아닌, 파일 첨부 기능을 통해 등록된 이미지에만 영향을 미칩니다.

썸네일 alt 자동 삽입 기능의 적용 범위와 예외 사항

그누보드 첨부 이미지 썸네일 alt 태그에 글 제목을 자동 삽입하는 기능은 모든 이미지에 일괄 적용되지 않으며 특정한 조건과 예외가 존재합니다.

적용 범위 및 예외 상황

• 적용 범위: 게시판 설정의 이미지 폭보다 큰 이미지를 업로드하여 썸네일이 생성되는 경우에만 적용됩니다.
• 이미지 유형: 에디터로 삽입한 이미지가 아닌, 파일 첨부 기능을 통해 등록된 이미지에만 영향을 미칩니다.

대안

• 관리자 설정에서 '파일 설명 사용' 옵션을 활성화하면, 글쓰기 시 파일마다 개별적인 alt 값을 직접 입력할 수 있습니다.

상황별 선택 가이드

• 첨부 이미지 썸네일의 alt 속성을 글 제목으로 자동화하려는 경우
  • 선택 기준: 파일 첨부 기능을 사용하며 썸네일이 생성되는 환경.
  • 다음 행동: lib/thumbnail.lib.php 파일을 백업한 후, get_view_thumbnail 함수 내 $view 전역 변수 선언 및 alt 속성 코드를 수정합니다.
• 에디터 삽입 이미지이거나 썸네일 생성 조건에 맞지 않는 경우
  • 선택 기준: 썸네일 생성 로직이 적용되지 않는 이미지.
  • 다음 행동: 코드 수정 대신 관리자 설정의 '파일 설명 사용' 옵션을 활성화하여 개별적으로 alt 값을 입력합니다.

실행 중 막히는 점

• Q. 코드 수정 후에도 alt 속성이 비어 있습니다.
  • A. 게시판 설정의 이미지 폭보다 작은 이미지는 썸네일이 생성되지 않아 수정 코드가 동작하지 않습니다. 또한, 본문 에디터로 삽입한 이미지는 파일 첨부 썸네일 로직과 별개이므로 적용되지 않습니다.
• Q. 코드 수정 후 사이트 오류가 발생하면 어떻게 하나요?
  • A. 수정 전 별도로 보관해 둔 원본 lib/thumbnail.lib.php 파일을 서버에 다시 업로드하여 즉시 복구하십시오.

함께 보면 좋은 글

• 그누보드 스마트에디터 및 썸네일 이미지 title 및 alt 속성 제어 방법
• 그누보드 이미지 업로드 시 자동 워터마크 삽입 구현 방법
• 그누보드4 게시판 첨부 이미지 리사이즈 및 출력 설정 방법

참고자료

기타 참고자료

• mercury-seed.com — 그누보드 첨부 이미지 썸네일 alt 태그에 글 제목 자동 삽입하기