laravel newsletter
5.2.0
이 패키지는 다양한 이메일 서비스의 이메일 목록에 대한 구독을 통합하는 쉬운 방법을 제공합니다.
현재 이 패키지는 다음을 지원합니다.
우편마차(우리가 만들었습니다 :-))
메일침프
우리는 동급 최고의 오픈 소스 패키지를 만드는 데 많은 리소스를 투자합니다. 유료 제품 중 하나를 구매하여 우리를 지원할 수 있습니다.
귀하가 사용하고 있는 당사 패키지를 언급하면서 귀하의 고향에서 엽서를 보내주셔서 진심으로 감사드립니다. 연락처 페이지에서 주소를 확인하실 수 있습니다. 우리는 수신된 모든 엽서를 가상 엽서 월에 게시합니다.
다음을 사용하여 Composer를 통해 이 패키지를 설치할 수 있습니다.
작곡가에게는 spatie/laravel-newsletter가 필요합니다.
구성 파일을 config/newsletter.php 에 게시하려면 다음을 실행하세요:
php artisan Vendor:publish --tag="newsletter-config"
그러면 다음 내용이 포함된 newsletter.php 파일이 구성 디렉터리에 게시됩니다.
return [/* * MailChimp API와 상호작용하는 데 사용할 드라이버입니다. * "log" 또는 "null"을 사용하여 사용자 환경에서 직접 API를 * 호출하는 것을 방지할 수 있습니다. */'driver' => env('NEWSLETTER_DRIVER', SpatieNewsletterDriversMailcoachDriver::class),/** * 이 인수는 드라이버에 제공됩니다. */'driver_arguments' => ['api_key' => env('NEWSLETTER_API_KEY'),'엔드포인트' => env('NEWSLETTER_ENDPOINT'),
],/* * 메소드에 목록 이름이 지정되지 않은 경우 사용할 목록 이름입니다. */'default_list_name' => 'subscribers','lists' => [/* * 이 키는 이 목록을 식별하는 데 사용됩니다. 다양한 메소드에서 제공되는 listName 매개변수로 *를 사용할 수 있습니다. * * 원하는 문자열로 설정할 수 있으며 * 원하는 만큼 목록을 추가할 수 있습니다. */'subscribers' => [/* * Mailcoach 드라이버를 사용할 때는 Mailcoach UI에 표시되는 이메일 목록 UUID여야 합니다. * * MailChimp 드라이버를 사용할 때는 MailChimp 목록 ID여야 합니다. * http://kb.mailchimp.com/lists/managing-subscribers/find-your-list-id. */'id' => env('NEWSLETTER_LIST_ID'),
],
],
];이 패키지를 Mailcoach와 함께 사용하려면 Mailcoach SDK를 설치해야 합니다.
작곡가에게는 spatie/mailcoach-sdk-php가 필요합니다.
다음으로 구성 파일에 API 키, 엔드포인트 및 list.subscribers.id 에 대한 값을 제공해야 합니다. Mailcoach 설정 화면에서 API 키와 엔드포인트를 찾을 수 있습니다. list.subscribers.id 값은 Mailcoach 이메일 목록의 UUID여야 합니다. 이메일 목록의 설정 화면에서 이 값을 찾을 수 있습니다.
MailChimp를 사용하려면 이 추가 패키지를 설치하세요.
작곡가에게는 drawm/mailchimp-api가 필요합니다.
newsletter 구성 파일의 driver 키는 SpatieNewsletterDriversMailChimpDriver::class 로 설정되어야 합니다.
다음으로 API 키와 list.subscribers.id 값을 제공해야 합니다. MailChimp UI에서 이러한 값을 찾을 수 있습니다.
endpoint 구성 값은 null로 설정되어야 합니다.
패키지를 설치하고 구성 파일에 값을 입력한 후에는 이 패키지를 사용하는 것이 매우 쉽습니다. 다음 예제에서는 모두 Facade를 사용합니다. 파일 상단에서 가져오는 것을 잊지 마세요.
SpatieNewsletterFacadesNewsletter를 사용하세요.
이메일 주소를 구독하는 방법은 다음과 같습니다.
뉴스레터를 사용하세요.
뉴스레터::subscribe('[email protected]');누군가의 구독을 취소해 봅시다:
뉴스레터::unsubscribe('[email protected]');Mailcoach의 경우 추가 속성을 두 번째 인수로 전달할 수 있습니다.
Newsletter::subscribe('[email protected]', ['first_name' => 'Rince', 'last_name' => 'Wind']);MailChimp의 경우 병합 변수를 두 번째 인수로 전달할 수 있습니다.
뉴스레터::subscribe('[email protected]', ['FNAME'=>'린스', 'LNAME'=>'바람']);목록 이름을 전달하여 특정 목록을 구독할 수 있습니다.
뉴스레터::subscribe('[email protected]', listName: '구독자');세 번째 인수는 구성 파일에서 구성한 목록의 이름입니다.
누군가를 구독하거나 업데이트할 수도 있습니다. 해당 사용자가 이미 구독 중인 경우 구독되거나 업데이트됩니다.
Newsletter::subscribeOrUpdate('[email protected]', ['first_name' => 'Rince', 'last_name' => 'Wind']);MailChimp의 경우 네 번째 인수를 사용하여 누군가를 하나 이상의 특정 그룹/관심사에 가입시킬 수 있습니다.
뉴스레터::subscribeOrUpdate( '[email protected]', ['FNAME'=>'린스','LNAME'=>'바람'], '구독자', ['interests'=>['interestId'=>참, 'interestId'=>참]], );
그룹/관심사에서 누군가를 제거하려면 false 추가하기만 하면 됩니다.
특정 목록에서 누군가의 구독을 취소하는 방법은 다음과 같습니다.
뉴스레터::unsubscribe('[email protected]', '구독자'); 삭제는 구독 취소와 다릅니다. 구독 취소와 달리 회원을 삭제하면 모든 기록(추가/선택/수정)이 손실될 뿐만 아니라 목록에서도 제거됩니다. 대부분의 경우 delete 대신 unsubscribe 사용하려고 합니다.
삭제를 수행하는 방법은 다음과 같습니다.
뉴스레터::delete('[email protected]'); getMember 함수를 사용하여 구독자에 대한 정보를 얻을 수 있습니다.
뉴스레터::getMember('[email protected]'); MailCoach의 경우 SpatieMailcoachResources|Subscriber 인스턴스를 반환합니다. MailChimp의 경우 구독자 정보가 포함된 배열을 반환합니다.
해당 이메일 주소로 구독하는 사람이 없으면 함수는 false 반환합니다.
누군가가 이미 구독하고 있는지 확인하는 편리한 방법도 있습니다.
뉴스레터::hasMember('[email protected]'); //부울을 반환합니다.이 외에도 사용자가 목록을 구독하는지 확인할 수도 있습니다.
뉴스레터::isSubscribed('[email protected]'); //부울을 반환합니다.더 많은 기능이 필요한 경우 다음을 사용하여 기본 API의 인스턴스를 얻습니다.
$api = 뉴스레터::getApi();
MailChimp 통합을 가져오는 데 문제가 있는 경우 다음을 통해 마지막 오류를 확인할 수 있습니다.
뉴스레터::getApi()->getLastError();
다음을 사용하여 테스트를 실행하세요.
공급업체/빈/해충
최근 변경된 사항에 대한 자세한 내용은 변경 로그를 참조하세요.
자세한 내용은 CONTRIBUTING을 참조하세요.
보안 관련 문제를 발견한 경우 문제 추적기를 사용하는 대신 [email protected]로 이메일을 보내주세요.
프리크 반 데르 헤르텐
모든 기여자는 유지 관리 및 새로운 멋진 기능에 인력을 할당하는 데 전념합니다.
MIT 라이센스(MIT). 자세한 내용은 라이센스 파일을 참조하십시오.
