Beranda>Kode sumber PHP>Kategori lainnya
Unduh

Kelola buletin di Laravel

Paket ini menyediakan cara mudah untuk mengintegrasikan langganan ke daftar email berbagai layanan email.

Saat ini dukungan paket ini:

  • Mailcoach (dibuat oleh kami :-))

  • Simpanse Surat

Dukung kami

Kami menginvestasikan banyak sumber daya untuk menciptakan paket sumber terbuka terbaik di kelasnya. Anda dapat mendukung kami dengan membeli salah satu produk berbayar kami.

Kami sangat menghargai Anda mengirimi kami kartu pos dari kota asal Anda, yang menyebutkan paket kami mana yang Anda gunakan. Anda akan menemukan alamat kami di halaman kontak kami. Kami mempublikasikan semua kartu pos yang diterima di dinding kartu pos virtual kami.

Instalasi

Anda dapat menginstal paket ini melalui Composer menggunakan:

 komposer memerlukan spatie/laravel-newsletter

Untuk mempublikasikan file konfigurasi ke config/newsletter.php jalankan:

 vendor tukang php:publish --tag="newsletter-config"

Ini akan menerbitkan file newsletter.php di direktori konfigurasi Anda dengan konten berikut:

 return [/* * Driver yang akan digunakan untuk berinteraksi dengan MailChimp API.     * Anda dapat menggunakan "log" atau "null" untuk mencegah pemanggilan * API langsung dari lingkungan Anda.     */'driver' => env('NEWSLETTER_DRIVER', SpatieNewsletterDriversMailcoachDriver::class),/** * Argumen ini akan diberikan kepada pengemudi.     */'driver_arguments' => ['api_key' => env('NEWSLETTER_API_KEY'),'endpoint' => env('NEWSLETTER_ENDPOINT'),
    ],/* * Nama daftar yang digunakan ketika tidak ada nama daftar yang ditentukan dalam suatu metode.     */'default_list_name' => 'subscribers','lists' => [/* * Kunci ini digunakan untuk mengidentifikasi daftar ini. Ini dapat digunakan * sebagai parameter listName yang disediakan dalam berbagai metode.         * * Anda dapat mengaturnya ke string apa pun yang Anda inginkan dan Anda dapat menambahkan * daftar sebanyak yang Anda inginkan.         */'subscribers' => [/* * Saat menggunakan driver Mailcoach, ini harus berupa UUID daftar Email * yang ditampilkan di UI Mailcoach * * Saat menggunakan driver MailChimp, ini harus berupa id daftar MailChimp.             * http://kb.mailchimp.com/lists/managing-subscribers/find-your-list-id.             */'id' => env('NEWSLETTER_LIST_ID'),
        ],
    ],
];

Menggunakan Pelatih Surat

Agar paket ini dapat berfungsi dengan Mailcoach, Anda perlu menginstal Mailcoach SDK.

 komposer memerlukan spatie/mailcoach-sdk-php

Selanjutnya, Anda harus memberikan nilai untuk API key, endpoint dan list.subscribers.id di file konfigurasi. Anda akan menemukan kunci API dan titik akhir di layar pengaturan Mailcoach. Nilai list.subscribers.id harus berupa UUID daftar email di Mailcoach. Anda akan menemukan nilai ini di layar pengaturan daftar email

Menggunakan MailChimp

Untuk menggunakan MailChimp, instal paket tambahan ini.

 komposer memerlukan drawm/mailchimp-api

Kunci driver file konfigurasi newsletter harus disetel ke SpatieNewsletterDriversMailChimpDriver::class .

Selanjutnya, Anda harus memberikan nilai untuk kunci API dan list.subscribers.id . Anda akan menemukan nilai-nilai ini di UI MailChimp.

Nilai konfigurasi endpoint harus disetel ke nol.

Penggunaan

Setelah Anda menginstal paket dan mengisi nilai di file konfigurasi, bekerja dengan paket ini akan sangat mudah. Semua contoh berikut menggunakan fasad. Jangan lupa untuk mengimpornya di bagian atas file Anda.

 gunakan SpatieNewsletterFacadesNewsletter;

Berlangganan, memperbarui, dan berhenti berlangganan

Berlangganan alamat email dapat dilakukan seperti ini:

 gunakan Buletin;

Buletin::subscribe('[email protected]');

Mari kita berhenti berlangganan seseorang:

 Buletin::berhenti berlangganan('[email protected]');

Untuk Mailcoach, Anda dapat memberikan atribut tambahan sebagai argumen kedua:

 Buletin::subscribe('[email protected]', ['first_name' => 'Rince', 'last_name' => 'Wind']);

Untuk MailChimp Anda bisa meneruskan variabel gabungan sebagai argumen kedua:

 Buletin::subscribe('[email protected]', ['FNAME'=>'Rince', 'LNAME'=>'Wind']);

Anda dapat membuat seseorang berlangganan ke daftar tertentu dengan memberikan nama daftar:

 Buletin::subscribe('[email protected]', listName: 'subscribers');

Argumen ketiga adalah nama daftar yang Anda konfigurasikan di file konfigurasi.

Anda juga dapat berlangganan dan/atau memperbarui seseorang. Orang tersebut akan berlangganan atau diperbarui jika dia sudah berlangganan:

 Buletin::subscribeOrUpdate('[email protected]', ['nama_pertama' => 'Rince', 'nama_akhir' => 'Angin']);

Untuk MailChimp, Anda dapat membuat seseorang berlangganan ke satu atau lebih grup/minat tertentu dengan menggunakan argumen keempat:

 Buletin::subscribeOrUpdate( '[email protected]',
    ['FNAME'=>'Rince','LNAME'=>'Angin'],
    'pelanggan',
    ['interests'=>['interestId'=>benar, 'interestId'=>benar]],
);

Cukup tambahkan false jika Anda ingin menghapus seseorang dari grup/kepentingan.

Berikut cara berhenti berlangganan seseorang dari daftar tertentu:

 Buletin::berhenti berlangganan('[email protected]', 'pelanggan');

Menghapus pelanggan

Menghapus tidak sama dengan berhenti berlangganan. Tidak seperti berhenti berlangganan, menghapus anggota akan mengakibatkan hilangnya seluruh riwayat (tambah/ikut serta/edit) serta penghapusannya dari daftar. Dalam kebanyakan kasus, Anda ingin menggunakan unsubscribe daripada delete .

Berikut cara melakukan penghapusan:

 Buletin::delete('[email protected]');

Mendapatkan info pelanggan

Anda bisa mendapatkan informasi tentang pelanggan dengan menggunakan fungsi getMember :

 Buletin::getMember('[email protected]');

Untuk MailCoach, ini akan mengembalikan instance SpatieMailcoachResources|Subscriber Untuk MailChimp, ini akan mengembalikan array dengan informasi tentang pelanggan.

Jika tidak ada orang yang berlangganan dengan alamat email tersebut, fungsinya akan menghasilkan false

Ada juga metode mudah untuk memeriksa apakah seseorang sudah berlangganan:

 Buletin::hasMember('[email protected]'); //mengembalikan boolean

Selain itu, Anda juga dapat memeriksa apakah pengguna berlangganan daftar Anda:

 Buletin::isSubscribed('[email protected]'); //mengembalikan boolean

Butuh sesuatu yang lain?

Jika Anda memerlukan lebih banyak fungsionalitas, Anda mendapatkan instance API yang mendasarinya

 $api = Buletin::getApi();

Jika Anda kesulitan mendapatkan integrasi MailChimp, Anda dapat melihat kesalahan terakhir dengan:

 Buletin::getApi()->getLastError();

Pengujian

Jalankan tes dengan:

 vendor/tempat sampah/hama

log perubahan

Silakan lihat CHANGELOG untuk informasi lebih lanjut tentang apa yang berubah baru-baru ini.

Berkontribusi

Silakan lihat KONTRIBUSI untuk rinciannya.

Keamanan

Jika Anda menemukan masalah apa pun terkait keamanan, silakan kirim email ke [email protected] alih-alih menggunakan pelacak masalah.

Kredit

  • Freek Van der Herten

  • Semua Kontributor berdedikasi untuk mengalokasikan tenaga kerja pada pemeliharaan dan hal-hal baru yang mengagumkan.

Lisensi

Lisensi MIT (MIT). Silakan lihat File Lisensi untuk informasi lebih lanjut.

Memperluas
Informasi Tambahan
Aplikasi Terkait
Direkomendasikan untuk Anda
Informasi Terkait Semua