그누보드5 소셜 로그인 플러그인 설치 및 설정 방법

• 목록
• 스크랩

그누보드5 소셜 로그인 플러그인 설치 및 설정 방법

그누보드5 사이트에 소셜 로그인 플러그인을 안전하게 업로드하고, API 키 설정부터 커스텀 스킨 코드 삽입 및 백업·복구 방법까지 실용적으로 적용할 수 있습니다.

그누보드5 소셜 로그인 플러그인 파일 업로드 방법

SIR 자료실 등에서 제공하는 소셜 로그인 플러그인 압축파일을 해제한 뒤, 관련 폴더를 그누보드 설치 경로에 업로드합니다. 이는 일반적인 설치 방식이며, 사용 중인 테마나 서버 환경에 따라 파일 권한 설정이 추가로 필요할 수 있습니다.

폴더별 업로드 및 적용 방식

• extend 폴더 및 plugin 폴더: 원본 파일과 충돌하지 않으므로 그대로 업로드할 수 있습니다.
• mobile 및 skin 폴더:
  • 기본 basic 스킨을 사용하는 경우: 파일들을 그대로 덮어씌워 적용할 수 있습니다.
  • 커스텀 스킨을 사용하는 경우: 전체를 덮어쓰지 않고 필요한 코드만 별도로 삽입해야 합니다.

extend/oauth.extend.php 파일 설정 방법

그누보드5 소셜 로그인 연동을 위해 extend/oauth.extend.php 파일을 열어 각 소셜 앱 서비스에서 발급받은 API 키를 입력하고, 설정 상수를 수정하여 회원가입 허용 여부와 테이블 생성 여부를 제어할 수 있습니다.

설정 상수 예시

// 회원가입을 허용하지 않는 경우 false 로 변경
define('G5_OAUTH_MEMBER_REGISTER', true);
// 회원가입 선택여부
define('G5_OAUTH_MEMBER_REGISTER_SELECT', true);
// 소셜 회원가입 테이블 생성, 테이블 생성 후 false 로 변경
define('G5_OAUTH_TABLE_CREATE', true);

커스텀 스킨 소셜 로그인 버튼 호출 코드 추가 방법

기본 스킨이 아닌 커스텀 스킨을 이용하는 경우, 로그인 및 회원가입 관련 스킨 파일에 소셜 로그인 버튼 호출 코드를 직접 추가해야 합니다. 스킨 구조에 따라 버튼이 레이아웃을 벗어날 수 있으므로, 삽입 후 CSS 조정이 필요할 수 있습니다.

스킨 파일별 추가 코드

• login.skin.php: <?php include_once(G5_PLUGIN_PATH.'/oauth/login.skin.inc.php'); ?>
• member_confirm.skin.php: <?php include_once(G5_PLUGIN_PATH.'/oauth/member_confirm.skin.inc.php'); ?>
• register_form.skin.php: <?php include_once(G5_PLUGIN_PATH.'/oauth/register_form.skin.inc.php'); ?>

적용 시 주의사항

설정 파일과 스킨 코드를 수정하기 전에 기존 파일을 안전하게 백업해야 하며, 코드 수정이 완료된 후에는 로그인 화면에서 소셜 로그인 버튼이 정상적으로 출력되는지 확인해야 합니다.

변경 전 백업 및 적용 후 확인 절차

설정 파일과 스킨 코드를 수정하기 전에 기존 파일을 안전하게 백업해야 합니다. 파일 업로드와 코드 수정이 완료된 후에는 로그인 화면에서 소셜 로그인 버튼이 정상적으로 출력되는지 확인하고, 실제 소셜 로그인을 시도하여 가입 및 인증 과정이 원활하게 작동하는지 점검해야 합니다. 단, 테스트 시에는 실제 사용자가 아닌 관리자 계정으로 먼저 확인하는 것이 안전합니다.

복구 방법

적용 후 오류가 발생하거나 로그인 과정에 문제가 생기면 사전에 백업해 둔 원본 파일로 즉시 복원하여 원래 상태로 되돌립니다.

그누보드5 소셜 로그인 플러그인 설치 및 설정 가이드

그누보드 운영 환경에 따라 소셜 로그인 플러그인 설치 및 설정 절차를 선택하세요.

내 상황에 따른 선택 기준 및 다음 행동

• 기본 basic 스킨 사용 시
  • 선택 기준: 스킨 수정 이력이 없는 표준 환경
  • 다음 행동: extend, plugin, mobile, skin 폴더를 모두 그누보드 설치 경로에 덮어씌워 업로드합니다.
• 커스텀 스킨 사용 시
  • 선택 기준: 스킨 디자인이 수정되어 있어 파일 덮어쓰기가 불가능한 환경
  • 다음 행동: extend, plugin 폴더만 업로드하고, 스킨 파일(login.skin.php 등)에 소셜 로그인 버튼 호출 코드를 직접 추가합니다.
• API 키 및 설정 적용 시
  • 선택 기준: 플러그인 설치 후 소셜 연동 및 회원가입 정책 설정이 필요한 경우
  • 다음 행동: extend/oauth.extend.php 파일을 수정하여 API 키를 입력하고, 회원가입 허용 및 테이블 생성 상수를 설정합니다.

실전 FAQ

Q. 커스텀 스킨에 버튼 코드를 추가했는데 버튼이 보이지 않아요.

• 대안: G5_PLUGIN_PATH 경로가 정확한지 확인하고, include_once 문이 해당 스킨 파일 내 적절한 위치(로그인 버튼 주변)에 삽입되었는지 점검하세요.

Q. 테이블 생성 후 G5_OAUTH_TABLE_CREATE 상수는 어떻게 처리하나요?

• 예외: 테이블 생성 완료 후에는 해당 상수를 false로 변경하여 불필요한 테이블 생성 시도를 방지해야 합니다.

Q. 적용 후 오류가 발생하면 어떻게 하나요?

• 대안: 수정 전 백업해 둔 원본 파일을 즉시 복원하여 사이트 접속 및 로그인 기능을 정상화한 후, 코드 삽입 위치를 다시 확인하세요. 만약 복원 후에도 오류가 지속된다면, 플러그인 파일과 기존 테마 파일 간의 PHP 버전 호환성 문제를 의심해 볼 수 있습니다.

함께 보면 좋은 글

• 네이버 소셜 로그인(네아로) 도메인 www 설정 문제 해결
• 그누보드5 소셜 로그인 연동을 위한 네이버 및 카카오 개발자 센터 설정 방법
• 그누보드5 페이스북 및 카카오 소셜 로그인 API 연동 설정 방법

참고자료

기타 참고자료

• mercury-seed.com — 그누보드5 소셜 로그인 플러그인 설치 및 설정 방법