OneSignal WordPress 플러그인은 초기화 스크립트와 서비스 워커를 자동으로 포함합니다. 버전 3+는 플러그인의 sdk_files 디렉터리에 일반 OneSignalSDKWorker.js를 호스팅하고 플러그인의 init에서 경로를 설정합니다. 워커를 사이트 루트에 업로드하지 않으며 serviceWorkerPath를 직접 설정하지도 않습니다.
게시물, 페이지 또는 사용자 지정 게시물 유형을 게시하면 OneSignal이 구독자에게 자동으로 알림을 보낼 수 있습니다.
OneSignal Push Notifications 메타박스—필요한 경우 드래그하여 위치를 변경할 수 있습니다
게시물이 게시되거나 업데이트될 때 알림 보내기 체크박스가 보이지 않으면 다음 항목을 확인하세요:
편집기 오른쪽과 아래쪽의 메타박스를 확인하세요. 필요에 따라 드래그 앤 드롭할 수 있습니다.
편집기 상단의 화면 옵션을 확인하여 OneSignal Push Notifications 메타박스가 체크되어 있는지 확인하세요.
OneSignal Push Notifications 메타박스가 체크된 화면 옵션
사용자 지정 게시물 유형을 사용하고 있는지 확인하세요. 일반적으로 URL에서 post_type=your_custom_type 형태로 확인할 수 있습니다. 그렇다면 OneSignal WordPress 플러그인 설정의 사용자 지정 게시물 유형 필드에 해당 유형을 추가하세요.
Console 탭을 열고 페이지를 새로 고치고 빨간색 또는 노란색 OneSignal 관련 오류를 찾습니다.
도움이 필요하면 일반적인 OneSignal 콘솔 오류를 참조하세요.
3
브라우저에서 구독 상태 확인
페이지 로딩이 완료되고 콘솔에 OneSignal 오류가 없는 것을 확인한 후 다음을 붙여넣습니다:
JavaScript
OneSignal.User.PushSubscription.id
방문자가 구독한 경우 문자열(구독 ID)을 반환합니다. 구독하지 않았거나 구독이 아직 준비되지 않은 경우 null 또는 빈 값이 표시될 수 있습니다. **OneSignal is not defined**가 표시되면 몇 초 기다린 후 다시 시도하거나, 먼저 일반적인 OneSignal 콘솔 오류의 콘솔 오류를 수정하세요—SDK가 지연 로더를 통해 아직 로드 중일 수 있습니다.
콘솔에서 OneSignal 구독 ID를 찾습니다.
4
OneSignal 대시보드에서 구독 ID 확인
OneSignal 대시보드에서 Audience > Subscriptions으로 이동하여 위에서 반환된 ID를 검색합니다.
구독 ID에 대해 OneSignal 대시보드를 검색합니다.
5
테스트 푸시 알림 보내기
구독이 존재하고 상태가 구독됨인 경우 푸시 가이드를 따라 알림을 보냅니다.
아무것도 나타나지 않으면 브라우저별 수정 사항에 대해 알림이 표시되지 않음을 참조하세요.
Installing service worker failed.. 403 or 404 error
서비스 워커 파일 누락(403/404).
플러그인은 sdk_files 디렉터리에서 OneSignalSDKWorker.js를 제공합니다. WordPress.org 설치는 onesignal-free-web-push-notifications 폴더를 사용합니다. zip에서 설치한 경우 폴더가 다를 수 있습니다. your-site.com과 폴더 이름을 wp-admin의 플러그인과 일치하도록 교체하세요:https://your-site.com/wp-content/plugins/onesignal-free-web-push-notifications/sdk_files/OneSignalSDKWorker.js다음 한 줄의 JavaScript가 표시되어야 합니다:
해당 URL이 404를 반환하거나 차단된 경우 일반적인 플러그인 지원을 참조하여 CDN, 캐시 또는 보안 플러그인 규칙을 수정하세요.이전 플러그인 버전(v2)은 동일한 sdk_files 디렉터리에서 OneSignalSDKWorker.js.php를 제공했습니다. 콘솔이 여전히 .js.php URL을 요청하는 경우 레거시 워커를 사용 중인 것입니다. 해당 설치에만 적용되는 PHP 실행 참고 사항은 Solid Security 및 .htaccess 예시를 참조하세요.
CDN 및 캐싱 플러그인은 OneSignal의 필수 파일을 차단할 수 있습니다. WordPress.org 설치는 플러그인 디렉터리 **onesignal-free-web-push-notifications**를 사용합니다. zip에서 설치한 경우 폴더가 다를 수 있습니다(예: OneSignal-WordPress-Plugin). wp-admin의 플러그인 또는 wp-content/plugins/를 확인하고 아래 경로에서 해당 이름으로 대체하세요.다음 플러그인별 설정을 사용하세요:
WP Engine은 CDN을 통해 플러그인 URL을 재작성할 수 있습니다. HTML Post-Processing 규칙은 환경마다 다릅니다. 아래 스니펫은 예시일 뿐입니다—적용 전에 WP Engine 지원 또는 사용자 포털에서 경로를 확인하세요.WP Engine plugin > General Settings > HTML Post-Processing에서 다음과 유사한 규칙이 필요할 수 있습니다. 모든 자리 표시자를 귀하의 사이트와 WP Engine CDN 호스트명의 값으로 교체하세요:
Hummingbird > Asset Optimization으로 이동합니다. JavaScript(OneSignal 자산이 있는 경우 CSS도) 아래에서 URL에 onesignal-free-web-push-notifications 또는 **OneSignalSDK**가 포함된 파일을 찾습니다. 축소/결합/지연에서 제외하거나 해당 자산을 로드하지 않음 최적화로 전환하여 플러그인이 이를 재작성하거나 지연시키지 않도록 하세요.
버전 3+는 정적 OneSignalSDKWorker.js 파일을 제공합니다. 해당 워커에 대해서는 플러그인 디렉터리에서 PHP 실행이 필요하지 않습니다.여전히 플러그인 v2를 실행 중이거나 워커 URL이 .js.php로 끝나는 경우 OneSignalSDKWorker.js.php가 실행될 수 있도록 System Tweaks에서 Disable PHP in Plugins(또는 동등한 옵션)를 비활성화하세요.
v2 .js.php 워커를 여전히 제공하는 경우에만 플러그인의 PHP 실행 차단을 비활성화하세요.
버전 3+는 워커에 대해 PHP 실행이 필요하지 않습니다. Prevent PHP execution이 켜져 있어도 v3 .js 파일에는 문제가 없습니다.여전히 OneSignalSDKWorker.js.php(v2)를 제공하는 경우 Prevent PHP execution을 비활성화 상태로 유지하세요. Defender > Security Tweaks로 이동하여 설정을 확인합니다.
알림에 사용되는 이미지를 자체 호스팅하지 마세요. 자체 알림 아이콘 또는 이미지를 호스팅하면 알림이 전송될 때 모든 수신자의 브라우저가 동시에 이미지를 가져오려고 시도하므로 서버에 과부하가 걸릴 수 있습니다.
서버 부하를 줄이려면 동시 액세스 수가 많은 환경에 최적화된 이미지 호스팅 솔루션 또는 CDN 서비스를 사용하세요.
