KAPAL 공식 웹사이트 관리자 매뉴얼

한미생명과학인협회(KAPAL) 웹사이트 유지보수, 게시글/행사/임원진/스폰서 관리 및 워드프레스 연동 완벽 가이드

문서 버전 v2.0 (Dual CMS)

최종 개정일 2026년 9월

웹 CMS 접속 패스코드 kapal

호스팅 환경 GoDaddy Linux Apache

1. 개요 및 시스템 구조

새롭게 개편된 KAPAL 웹사이트는 초고속 로딩(SPA 정적 구조)의 장점과 편리한 온라인 수정(CMS)의 장점을 결합하여 설계되었습니다. 복잡한 FTP 파일 전송이나 소스코드 수정 없이, 웹 브라우저에서 버튼 클릭 몇 번으로 즉시 사이트 내용을 변경하고 발행할 수 있습니다.

✨ 듀얼 CMS 지원:
관리자는 자신의 편의에 따라 [방안 A: 웹 전용 퀵 CMS] 또는 [방안 B: 워드프레스(wp-admin)] 중 원하는 방식을 자유롭게 선택하여 사용할 수 있습니다.

2. 두 가지 관리 방식 비교 (방안 A vs 방안 B)

상황과 관리자의 숙련도에 맞춰 최적의 방식을 선택하세요.

비교 항목	방안 A: KAPAL 웹 퀵 CMS 추천 (가장 빠름)	방안 B: 워드프레스 (wp-admin) + 동기화
주요 특징	브라우저에서 직접 입력하고 즉시 서버에 저장되는 올인원 CMS	기존 워드프레스 에디터로 글을 쓰고 새 사이트로 1초 동기화
접속 방법	홈페이지 우측 상단 `[⚙️ Admin CMS]` 버튼 클릭	`https://kapal.org/wp-admin` 직접 접속
로그인 인증	관리자 공용 패스코드: `kapal`	기존 워드프레스 계정 (ID / 비밀번호)
관리 가능 범위	• 게시글 & 뉴스 (Posts & News) • 다가오는 행사 (Events) • 임원진 프로필 (Leadership) • 후원사 로고 & 링크 (Sponsors)	• 게시글 & 공지사항 (Posts) • 워드프레스 미디어 라이브러리 (사진 대량 업로드)
반영 속도	즉시 실시간 반영 (3초) (FTP 불필요)	워드프레스 발행 후 홈페이지에서 `[동기화]` 1회 클릭
자동 백업	저장 시마다 직전 백업 생성 (원클릭 롤백 가능)	워드프레스 DB 원본 유지 + 백업 자동 생성

3. [방안 A] KAPAL 퀵 웹 CMS 상세 사용법

가장 권장되는 직관적이고 빠른 관리 방식입니다. 모든 수정 작업이 GoDaddy 서버의 data/kapal_data.json에 즉시 기록됩니다.

1 관리자 대시보드 로그인

홈페이지 어느 화면에서나 우측 상단의 [⚙️ Admin CMS] 버튼을 누릅니다.

비밀번호 입력란에 kapal을 입력하고 [Unlock]을 클릭하면 관리자 워크스페이스가 열립니다.

2 게시글 & 공지사항 관리 (Posts & News 탭)

새 글 작성: 상단 폼에 제목, 카테고리(Announcement, Event, Job Posting, Networking, Meeting, News, Photo Gallery), 발행일, 요약문, 본문을 입력하고 [Save Post]를 누릅니다.
기존 글 수정: 하단 목록에서 수정하려는 글의 [Edit] 버튼을 누르면 상단 폼에 기존 내용이 자동으로 채워집니다. 수정 후 [Save Post]를 누릅니다.
글 삭제: 하단 목록에서 [Delete]를 누르면 확인창 후 즉시 삭제됩니다.
페이지 노출: 메인 페이지 News & Announcement 영역에는 설정된 카테고리별로 최신순 3개씩 자동 페이징되어 깔끔하게 출력됩니다.

3 행사 일정 관리 (Events 탭)

연례 컨퍼런스(KAC), 심포지엄, 네트워킹 모임 카드 정보를 편집합니다.

행사명 (Title): 예: 10th KAPAL Annual Conference
일시 (Date & Time): 예: Oct 24–25, 2025
장소 (Location): 예: San Diego, CA & Online
등록 링크 (Registration URL): 등록 사이트(구글폼, Eventbrite 등) 주소
설명문 (Description): 행사 개요 및 주요 아젠다

4 임원진 프로필 관리 (Leadership 탭)

회장단, 이사회, 운영진, 고문진의 인명 정보를 관리합니다.

이름 (Name) / 직책 (Role): 예: Alexander Kim / President
구분 (Category): Officers, Directors, Advisors 중 선택
프로필 사진 (Avatar URL): 이미지 URL 또는 업로드 경로 입력
소개글 (Bio): 상세 약력 및 활동 분야

5 후원사 관리 (Sponsors 탭)

스폰서 기업의 로고와 웹사이트 링크를 수정합니다.

후원사명 (Company Name) 입력
등급 (Level): Platinum, Gold, Silver, Supporter 선택
로고 경로 (Logo Asset): 이미지 파일명 또는 경로
웹사이트 주소 (Website URL): 클릭 시 새 창으로 연결될 주소

6 서버 자동 저장 및 안전 복구 (Undo / Backup)

내용을 변경하고 [Save] 버튼을 누르면 브라우저 하단에 "✅ Server Updated! Live for all visitors" 토스트 알림이 뜨며 GoDaddy 서버에 즉시 영구 저장됩니다.

🛡️ 실수 방지 자동 백업 시스템:
저장할 때마다 직전 상태의 백업 파일(data/kapal_data.backup.json)이 서버에 자동 생성됩니다.
만약 실수로 잘못 수정하거나 글을 지운 경우, [Server Sync & Backup] 탭으로 이동하여 [🔄 Undo / Restore Server Backup] 버튼을 누르면 직전 정상 상태로 즉시 되돌릴 수 있습니다.

4. [방안 B] 워드프레스(wp-admin) 연동 사용법

글 작성을 워드프레스 관리자 화면에서 주로 해오셨던 분들을 위한 방식입니다. 워드프레스에 익숙한 간사나 임원진이 평소처럼 워드프레스에 글을 올리면, 버튼 한 번으로 새 사이트에 즉시 반영됩니다.

1 워드프레스 관리자 로그인

웹 브라우저에서 https://kapal.org/wp-admin으로 접속하거나, 관리자 CMS 내의 [WordPress wp-admin ↗] 링크를 클릭합니다.

보유하고 계신 워드프레스 관리자 계정으로 로그인합니다.

2 글 작성 및 카테고리/특성 이미지 지정

워드프레스 좌측 메뉴에서 [글] > [새로 추가]를 클릭합니다.
글 제목과 본문을 자유롭게 작성합니다. (워드프레스 미디어 라이브러리를 통해 고화질 사진 및 서식을 마음껏 삽입할 수 있습니다.)
우측 사이드바 카테고리(Categories)에서 해당 글의 성격에 맞는 항목(예: Announcement, News, Event, Job Posting 등)을 체크합니다.
우측 사이드바 특성 이미지(Featured Image)를 지정하면 홈페이지 카드 뉴스 썸네일로 자동 반영됩니다.
우측 상단 [발행 (Publish)]을 누릅니다.

3 홈페이지에서 '원클릭 동기화' 실행

워드프레스에서 글을 발행한 후, KAPAL 홈페이지로 이동합니다.

홈페이지 우측 상단 [⚙️ Admin CMS] 클릭 (패스코드: kapal)
상단 메뉴바 또는 [Server Sync] 탭의 [🔄 워드프레스 최신 글 동기화 (Sync WordPress Posts)] 버튼 클릭!
확인 창에서 [확인]을 누르면 api/sync_wordpress.php가 워드프레스 DB에서 최신 글 50개를 자동으로 추출하여 새 홈페이지 데이터베이스(kapal_data.json)로 완벽 병합합니다.
화면에 "WordPress synchronization complete!" 메시지가 나타나며 페이지가 새로고침되어 새 글이 즉시 사이트에 노출됩니다.

5. 관리자 필수 주의사항 및 FAQ

⚠️ 절대 주의사항: index.php 파일 덮어쓰기 금지!
GoDaddy 호스팅 루트에 있는 index.php는 워드프레스 보안 엔진에 의해 읽기 전용(권한 444)으로 잠겨 있습니다. FTP로 이 파일을 강제로 덮어쓰려고 하면 "Access Denied" 오류가 발생합니다.
현재 서버는 .htaccess를 통해 index.html이 1순위로 로딩되도록 완벽히 설정되어 있으므로, index.php는 절대 손대거나 덮어씌우지 마십시오.

Q1. 이미지를 새로 업로드해서 글에 넣고 싶을 때는 어떻게 하나요?

두 가지 방법이 있습니다:
1) 방안 B 활용: 워드프레스 미디어 라이브러리(wp-admin > 미디어 > 파일 추가)에 사진을 올린 후, 생성된 URL(예: wp-content/uploads/2026/09/sample.jpg)을 복사하여 방안 A 글 작성 시 본문이나 썸네일에 붙여넣으면 영구적으로 보존됩니다.
2) 외부 클라우드 링크: Imgur, Google Photos 공개 링크, 또는 협회 웹 호스팅 assets/images/ 폴더에 올린 뒤 상대 경로를 입력하셔도 됩니다.

Q2. 관리자 패스코드(현재: `kapal`)를 바꾸고 싶습니다.

패스코드는 보안을 위해 다음 파일에 정의되어 있습니다:

api/save_data.php (라인 12: $ADMIN_PASSCODE = '원하는비밀번호';)
api/sync_wordpress.php (라인 13: $ADMIN_PASSCODE = '원하는비밀번호';)
js/admin.js (라인 58 및 헤더 전송 부분)

해당 파일들의 비밀번호 문자열을 동일하게 수정하시면 원하는 패스코드로 언제든 교체됩니다.

Q3. 글이 3개씩만 보이는 이유는 무엇인가요?

방문자가 첫 화면에서 너무 많은 스크롤을 하지 않고 쾌적하게 읽을 수 있도록 최신 3개씩 페이지당 노출되도록 최적화되어 있습니다. 더 많은 이전 글을 보고 싶을 때는 하단의 페이지 번호(1, 2, 3...)를 클릭하거나 카테고리 탭(Announcement, Event 등)을 누르면 해당 카테고리의 글들만 3개씩 필터링되어 나타납니다.

본 문서는 KAPAL 관리자 및 임원진 전용 운영 지침서입니다.