자동 스크롤 애드온

 

정밀 자동 스크롤 & TOP 이동 애드온 (게시판 본문 전용)

게시글 본문(상세 페이지)을 읽을 때 긴 본문과 댓글 영역을 손쉽게 탐색할 수 있도록 돕는 

자동 스크롤(Auto Scroll) 및 우측 하단 TOP 이동 버튼 애드온입니다.

 

불필요한 메인 화면이나 게시판 목록 전역에서 노출되어 레이아웃을 해치지 않고, 

실제 게시글을 읽는 화면(document_srl이 존재하는 본문)에서만 스마트하게 동작하도록 최적화되어 있습니다.

 

✨ 주요 특징 및 기능

1. 본문(document_srl) 감지

   • 메인 화면, 게시판 목록, 위젯 페이지 등에서는 애드온이 실행되지 않아 사이트 레이아웃을 깔끔하게 유지합니다.

   • 사용자가 게시글 본문(상세보기)에 진입했을 때만 버튼이 노출되고 애드온이 로드됩니다.

2. 풍부한 관리자 설정 기능 제공

   • 스크롤 속도: 본인의 사이트 분위기에 맞춰 부드러운 스크롤 속도를 소수점 단위(예: 0.9)로 정밀 조절할 수 있습니다.

   • 타겟 영역 지정: 스크롤 시 이동할 댓글 영역 등의 HTML 아이디(ID)를 자유롭게 지정할 수 있습니다. (기본값: comment)

   • 상단 헤더 여백(Gap) 보정: 상단에 고정형 메뉴바(Sticky Header)가 있는 레이아웃을 위해, 스크롤 이동 시 헤더에 가려지지 않도록 여백 pixel 크기를 설정할 수 있습니다.

⚙️ 애드온 설정 항목 가이드

애드온을 켠 뒤 설정 화면에서 아래와 같이 자유롭게 커스텀할 수 있습니다.

• 스크롤 속도 (scroll_speed): 기본값 0.9 (수치가 낮을수록 더 천천히, 높을수록 빠르게 스크롤됩니다.)

• 이동 대상 ID (target_id): 기본값 comment (클릭 시 포커싱할 영역의 CSS ID를 #을 제외하고 입력해 주세요.)

• 상단 헤더 여백 (header_gap): 기본값 80 (상단 고정바가 있다면 해당 바의 높이만큼 입력해 가려짐을 방지하세요.)

📂 설치 경로

다운로드한 파일의 압축을 해제한 후 아래 경로에 업로드해 주세요.

./addons/autoscroll/

📄 라이선스

• GPL v2 (라이믹스 코어와 동일한 오픈소스 라이선스)

• 자유롭게 수정 및 배포가 가능하며, 기여를 환영합니다!