Jak zintegrować biuletyn MailChimp z aplikacją Laravel?
Czy chcesz zintegrować funkcjonalność newslettera MailChimp ze swoją aplikacją Laravel? MailChimp to usługa marketingu e-mailowego, która pozwala nam wysyłać biuletyny do naszych subskrybentów. W tym artykule pokażę, jak zintegrować biuletyn MailChimp ze stroną Laravel.
MailChimp to jedna z popularnych usług e-mail marketingu, która zarządza subskrybentami Twojej witryny. Korzystając z MailChimp, Twoi subskrybenci otrzymają biuletyn o nowych treściach, ogłoszeniach, ofertach i wielu innych, w zależności od Twojego wyboru. To rodzaj zautomatyzowanego systemu. Właściciel serwisu nie musi pamiętać o wysyłaniu newslettera do subskrybentów. MailChimp radzi sobie sam, co oszczędza nam dużo czasu.
Inni popularni dostawcy usług e-mail marketingu to:
Niedawno opublikowałem artykuł na temat integracji MailChimp przy użyciu MailChimp API i PHP. Jeden z czytelników zapytał o integrację MailChimp w Laravel. Postanowiłem więc napisać ten artykuł, aby odpowiedzieć na pytanie czytelnika.
Powiedziawszy to, zintegrujmy biuletyn MailChimp z aplikacją Laravel.
Uzyskaj klucz API MailChimp i identyfikator odbiorców
Aby zintegrować API MailChimp, musisz uzyskać klucz API i identyfikator publiczności. Wykonaj poniższe czynności, aby uzyskać te poświadczenia.
Zaloguj się na swoje konto MailChimp. Pod ikoną użytkownika wybierz Konto.
Kliknij Extra->Klucze API.
W sekcji Twoje klucze API kliknij Utwórz klucz i skopiuj klucz API, którego potrzebujemy za chwilę.
Teraz masz gotowy klucz API. Następnie zdobądź identyfikator odbiorców, do którego musisz dodać swoich subskrybentów. W tym celu kliknij menu Odbiorcy, a następnie wybierz opcję Ustawienia z menu rozwijanego Zarządzaj odbiorcami.
W Ustawieniach kliknij „Nazwa odbiorców i wartości domyślne".
Na następnej stronie znajdziesz swój identyfikator odbiorców.
Spatie zbudował fantastyczną bibliotekę biuletynu Laravel. Mam zamiar zintegrować biuletyn MailChimp za pomocą tej biblioteki.
Otwórz terminal w katalogu głównym projektu i uruchom polecenie:
composer require spatie/laravel-newsletterPo zainstalowaniu biblioteki uruchom poniższe polecenie, aby opublikować plik konfiguracyjny do config/newsletter.php.
php artisan vendor:publish --provider="SpatieNewsletterNewsletterServiceProvider"Przejdź do katalogu „config” i otwórz plik „newsletter.php”.
newsletter.php
<?php
return [
/*
* The API key of a MailChimp account. You can find yours at
* https://us10.admin.mailchimp.com/account/api-key-popup/.
*/
'apiKey' => env('MAILCHIMP_APIKEY'),
/*
* The listName to use when no listName has been specified in a method.
*/
'defaultListName' => 'subscribers',
/*
* Here you can define properties of the lists.
*/
'lists' => [
/*
* This key is used to identify this list. It can be used
* as the listName parameter provided in the various methods.
*
* You can set it to any string you want and you can add
* as many lists as you want.
*/
'subscribers' => [
/*
* A MailChimp list id. Check the MailChimp docs if you don't know
* how to get this value:
* http://kb.mailchimp.com/lists/managing-subscribers/find-your-list-id.
*/
'id' => env('MAILCHIMP_LIST_ID'),
],
],
/*
* If you're having trouble with https connections, set this to false.
*/
'ssl' => true,
];Nie musisz tutaj wprowadzać żadnych zmian poza wartością ‘ssl’. Jeśli nie masz certyfikatu SSL na swoim serwerze, ustaw tę wartość na false. Możesz zobaczyć stałe MAILCHIMP_APIKEY i MAILCHIMP_LIST_ID w powyższym kodzie. Oznacza to, że musisz dodać te stałe z rzeczywistymi wartościami do swojego .envpliku.
.env
....
MAILCHIMP_APIKEY=YOUR_MAILCHIMP_API_KEY
MAILCHIMP_LIST_ID=YOUR_MAILCHIMP_LIST_IDNastępnie wyczyść pamięć podręczną konfiguracji za pomocą polecenia:
php artisan config:clearZintegruj biuletyn MailChimp z aplikacją Laravel
Zainstalowałeś i skonfigurowałeś bibliotekę. Teraz możesz rozpocząć integrację MailChimp na swojej stronie Laravel. Stwórzmy prosty formularz biuletynu w pliku widoku.
<form action="{{ url('ROUTE_HERE') }}" method="post">
<div class="form-group">
<label for="exampleInputEmail">Email</label>
<input type="email" name="user_email" id="exampleInputEmail" class="form-control">
</div>
{{ csrf_field() }}
<button type="submit" class="btn btn-primary">Submit</button>
</form>Pamiętaj, aby zastąpić symbol zastępczy ROUTE_HERE rzeczywistą wartością. Następnie w pliku kontrolera dodaj fasadę zainstalowanego pakietu.
W funkcji kontrolera, w której zamieszczasz formularz, wpisz kod w następujący sposób:
<?php
namespace AppHttpControllers;
use IlluminateHttpRequest;
use Newsletter;
....
public function store(Request $request)
{
if (! Newsletter::isSubscribed($request->user_email)) {
Newsletter::subscribe($request->user_email);
}
}
?>Tutaj najpierw sprawdzam, czy użytkownik jest już dodany do listy subskrybentów, czy nie. Jeśli nie, dodaj go do listy subskrybentów. Użyłem metody, subscribe()która bezpośrednio zapisuje użytkownika do listy. Jeśli chcesz wysłać użytkownikowi wiadomość e-mail z potwierdzeniem przed zapisaniem się na listę, zastąp poniższą linię
Newsletter::subscribe($request->user_email);z
Newsletter::subscribePending($request->user_email);subscribePending() funkcja ustawia status użytkownika na „oczekujący” na liście MailChimp, dopóki użytkownik nie potwierdzi subskrypcji.
Mailchimp udostępnia również pola odbiorców, które przechowują dodatkowe informacje o użytkownikach bezpośrednio na pulpicie nawigacyjnym MailChimp. Na wszelki wypadek, jeśli chcesz dodać pola Audience, możesz to zrobić, dodając jeszcze jeden parametr w powyższej metodzie. Tutaj dodaję wartości dla domyślnych pól odbiorców FNAME i LNAME.
Newsletter::subscribe($request->user_email, ['FNAME'=>'ENTER_FIRST_NAME', 'LNAME'=>'ENTER_LAST_NAME']);Jeśli chcesz dodać tagi dla subskrybenta, skorzystaj z addTags()metody. Przekaż wiele elementów w tablicy na wypadek konieczności przypisania wielu tagów. W moim przypadku przypisuję subskrybentowi tag „Blogger”.
Newsletter::addTags(['Blogger'], $request->user_email);Użytkownik może usunąć abonenta z listy za pomocą hasła:
Newsletter::delete('SUBSCRIBER_EMAIL');Są to podstawowe metody zwykle wymagane na stronie internetowej. Możesz również sprawdzić dodatkowe funkcje dostarczane przez ten pakiet w serwisie GitHub.
Mam nadzieję, że rozumiesz, jak zintegrować biuletyn MailChimp ze swoją witryną Laravel. Podziel się swoimi przemyśleniami i sugestiami w sekcji komentarzy poniżej.