화면 모드
휴대폰 인증 플러그인 설치하기
이 설치 절차는 아이코드 단독 상품에 적용됩니다. 알리고 상품에 포함된 기능을 설치할 때는 해당 상품의 설치 파일과 안내를 사용하세요.
설치 전 준비
- 사이트 파일과 데이터베이스를 백업합니다.
- 그누보드 버전과 회원가입 스킨의 수정 여부를 확인합니다. 기본 샘플 버전은 ReadMe.txt 파일에 있습니다.
- PHP 7.0 이상과 PDO MySQL 확장 사용 여부를 호스팅 업체에 확인합니다. 데이터베이스 최소 버전은 별도로 검증되지 않았으므로 설치 환경을 확인한 뒤 진행합니다.
- 아이코드 계정, 사용할 발신번호, 발송 잔액을 준비합니다.
- 그누보드 최고관리자로 로그인할 수 있는지 확인합니다.
압축파일 구성 확인
압축을 풀면 다음 파일과 폴더가 있습니다. 먼저 각 항목의 역할을 확인한 뒤 아래 순서대로 적용하세요.
text
압축을 푼 폴더/
├── CHANGELOG.txt
├── ReadMe.txt
├── edit_gn5/
│ ├── adm/
│ ├── skin/member/hpcerti/
│ └── mobile/skin/member/hpcerti/
└── plugin/
└── certihp/| 파일·폴더 | 역할과 적용 방법 |
|---|---|
CHANGELOG.txt | 버전별 변경 내역입니다. 변경된 기능과 수정 사항을 확인합니다. |
ReadMe.txt | 설치·사용 안내와 기본 샘플 버전 등 적용 전 확인할 정보입니다. |
edit_gn5/ | 관리자 파일과 PC·모바일 회원가입 스킨입니다. 폴더 자체를 업로드하지 않고 안의 파일을 사이트의 같은 경로에 반영합니다. 자세한 경로는 2단계에서 확인합니다. |
plugin/ | 휴대폰 인증 기능이 들어 있습니다. 안의 certihp/를 사이트의 plugin/ 폴더 아래에 복사합니다. |
CHANGELOG.txt와 ReadMe.txt는 확인용 문서로, 사이트에 업로드할 필요는 없습니다. edit_gn5의 기존 파일을 덮어쓰기 전에는 사이트에서 수정한 내용이 있는지 확인하세요.
1. 플러그인 폴더 복사
이미지를 누르면 새 탭에서 원본 크기로 볼 수 있습니다.
압축을 풀고 plugin/certihp/ 폴더를 그누보드 설치 폴더 아래의 같은 경로에 복사합니다.
예를 들어 사이트의 그누보드 폴더에 plugin/certihp/install.php가 있어야 합니다. 그누보드가 하위 폴더에 설치되어 있다면 그 폴더를 기준으로 적용하세요.
설정 파일은 필요할 때만 만드세요
배포본에는 config.example.php가 들어 있습니다.
발송 횟수나 인증번호 유효시간 등을 바꾸려면 예제를 같은 폴더에 config.php로 복사한 뒤 수정합니다.
기존 config.php가 있다면 새로 복사하지 말고 백업 후 필요한 값만 변경하세요. config.example.php만 수정하면 실제 설정에는 반영되지 않습니다.
기본값으로 사용할 때는 설정 파일을 만들지 않아도 됩니다.
설정 파일 만들기와 변경 방법을 확인하세요.
2. 관리자 파일과 회원가입 스킨 적용
edit_gn5는 배포 파일을 구분하는 폴더 이름입니다. 그 안의 폴더와 파일을 그누보드의 대응 경로에 적용합니다.
| 배포 파일의 위치 | 사이트에 적용할 위치 |
|---|---|
edit_gn5/adm/admin.head.php | adm/admin.head.php |
edit_gn5/adm/css/admin.css | adm/css/admin.css |
edit_gn5/skin/member/hpcerti/ | skin/member/hpcerti/ |
edit_gn5/mobile/skin/member/hpcerti/ | mobile/skin/member/hpcerti/ |
기본 샘플과 같은 버전이며 해당 파일을 수정하지 않은 사이트는 백업 후 적용할 수 있습니다.
버전이 다르거나 디자인·기능을 수정한 사이트는 기존 변경 사항과 휴대폰 인증 관련 코드를 함께 반영해야 합니다. 직접 적용하기 어렵다면 사용 중인 버전과 수정 여부를 알려주세요.
3. 설치 실행
- 사이트의 최고관리자로 로그인합니다.
- 같은 브라우저에서 그누보드 설치 주소 뒤에
/plugin/certihp/install.php를 붙여 접속합니다. - certihp 설치 / 업데이트 결과 화면에서
ERROR항목이 없는지 확인합니다. - 완료되었습니다.가 표시되는지 확인합니다.
- 설치가 완료되면
install.php파일은 삭제하셔도 무방합니다.(보안을 위해 삭제 권장) - 발송 횟수나 인증번호 유효시간 등을 바꾸려면 설정 파일 만들기와 변경 방법을 확인하세요.
기존 버전에서 업데이트할 때도 이 절차가 필요합니다.
파일 복사만으로 설치를 마치지 마세요. 오류가 있으면 설치 문제 해결을 확인합니다.
4. 아이코드와 회원가입 설정
아이코드와 회원가입 설정에서 발송 서비스와 발신번호를 설정한 뒤, 관리자 환경설정 → 기본환경설정 → 회원가입 설정을 엽니다.
- 회원 스킨 선택: 제공된
hpcerti를 선택합니다. 모바일 회원 스킨도 반드시hpcerti로 설정하세요. - 휴대폰 필수 설정: 휴대폰번호 입력 항목에서 보이기와 필수입력을 모두 체크하고 저장합니다.
회원 스킨 설정 화면과 자세한 안내를 확인하세요.
5. 설치 결과 확인
- 관리자와 분리된 일반 사용자 브라우저에서 회원가입 페이지를 엽니다.
- PC와 모바일에서 휴대폰 번호 입력란과 휴대폰인증번호 받기 버튼을 확인합니다.
- 수신 가능한 번호로 요청하고, 도착한 인증번호로 인증확인을 진행합니다.
- 휴대폰 인증이 완료되었습니다.를 확인한 뒤 회원가입까지 마칩니다.
- 관리자에서 WOC-Solution → 휴대폰인증현황을 열어 인증 내역과 가입 사용 여부를 확인합니다.
테스트 발송도 발송 서비스의 요금이 발생할 수 있습니다. 제한 동작은 관리자 로그인 상태에서 면제될 수 있으므로 일반 사용자 환경에서 확인하세요.
설치가 끝나면 plugin/certihp/install.php를 삭제하셔도 좋습니다. 추후 업데이트 때 필요하면 배포 파일에서 다시 복사하여 실행합니다.