الصفحة الرئيسية>PHP كود المصدر>فئات أخرى
تنزيل

إدارة النشرات الإخبارية في Laravel

توفر هذه الحزمة طريقة سهلة لدمج الاشتراكات في قوائم البريد الإلكتروني لخدمات البريد الإلكتروني المختلفة.

حاليًا تدعم هذه الحزمة:

  • Mailcoach (الذي صممناه :-))

  • ميل تشيمب

ادعمنا

نحن نستثمر الكثير من الموارد في إنشاء أفضل الحزم مفتوحة المصدر في فئتها. يمكنك دعمنا عن طريق شراء أحد منتجاتنا المدفوعة.

نحن نقدر بشدة إرسالك لنا بطاقة بريدية من مسقط رأسك، مع ذكر الحزمة (الحزم) التي تستخدمها. ستجد عنواننا على صفحة الاتصال لدينا. ننشر جميع البطاقات البريدية المستلمة على جدار البطاقات البريدية الافتراضية لدينا.

تثبيت

يمكنك تثبيت هذه الحزمة عبر Composer باستخدام:

 يتطلب الملحن نشرة إخبارية من spatie/laravel

لنشر ملف التكوين إلى config/newsletter.php قم بتشغيل:

 بائع PHP الحرفي: نشر --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'),'endpoint' => env('NEWSLETTER_ENDPOINT'),
    ],/* * اسم القائمة المطلوب استخدامه عندما لا يتم تحديد اسم قائمة في إحدى الطرق.     */'default_list_name' => 'subscribers','lists' => [/* * يستخدم هذا المفتاح لتحديد هذه القائمة. يمكن استخدامه * كمعلمة listName المتوفرة في الطرق المختلفة.         * * يمكنك ضبطها على أي سلسلة تريدها ويمكنك إضافة * أي عدد تريده من القوائم.         */'subscribers' => [/* * عند استخدام برنامج تشغيل Mailcoach، يجب أن يكون هذا هو UUID لقائمة البريد الإلكتروني * الذي يتم عرضه في واجهة مستخدم Mailcoach * * عند استخدام برنامج تشغيل MailChimp، يجب أن يكون هذا هو معرف قائمة MailChimp.             * http://kb.mailchimp.com/lists/managing-subscribers/find-your-list-id.             */'id' => env('NEWSLETER_LIST_ID'),
        ]،
    ]،
];

باستخدام ميلكوتش

للسماح لهذه الحزمة بالعمل مع Mailcoach، تحتاج إلى تثبيت Mailcoach SDK.

 يتطلب الملحن Spatie/mailcoach-sdk-php

بعد ذلك، يجب عليك توفير قيم لمفتاح API ونقطة النهاية و list.subscribers.id في ملف التكوين. ستجد مفتاح API ونقطة النهاية في شاشة إعدادات Mailcoach. يجب أن تكون قيمة list.subscribers.id هي UUID لقائمة البريد الإلكتروني في Mailcoach. ستجد هذه القيمة على شاشة الإعدادات الخاصة بقائمة البريد الإلكتروني

باستخدام ميل تشيمب

لاستخدام MailChimp، قم بتثبيت هذه الحزمة الإضافية.

 يتطلب الملحن drawem/mailchimp-api

يجب تعيين مفتاح driver لملف تكوين newsletter على SpatieNewsletterDriversMailChimpDriver::class .

بعد ذلك، يجب عليك توفير قيم لمفتاح API و list.subscribers.id . ستجد هذه القيم في واجهة مستخدم MailChimp.

يجب تعيين قيمة تكوين endpoint على قيمة خالية.

الاستخدام

بعد تثبيت الحزمة وملء القيم الموجودة في ملف التكوين، سيكون العمل مع هذه الحزمة أمرًا سهلاً. جميع الأمثلة التالية تستخدم الواجهة. لا تنس استيراده في أعلى ملفك.

 استخدم SpatieNewsletterFacadesNewsletter؛

الاشتراك والتحديث وإلغاء الاشتراك

يمكن إجراء الاشتراك بعنوان بريد إلكتروني على النحو التالي:

 استخدام النشرة الإخبارية؛

النشرة الإخبارية::subscribe('[email protected]');

دعونا نلغي اشتراك شخص ما:

 النشرة الإخبارية::unsubscribe('[email protected]');

بالنسبة إلى Mailcoach، يمكنك تمرير سمات إضافية كوسيطة ثانية:

 النشرة الإخبارية::subscribe('[email protected]', ['first_name' => 'Rince', 'last_name' => 'Wind']);

بالنسبة إلى MailChimp، يمكنك تمرير متغيرات الدمج باعتبارها الوسيطة الثانية:

 النشرة الإخبارية::subscribe('[email protected]', ['FNAME'=>'Rince', 'LNAME'=>'Wind']);

يمكنك اشتراك شخص ما في قائمة محددة عن طريق تمرير اسم القائمة:

 النشرة الإخبارية::subscribe('[email protected]', listName: 'subscribers');

هذه الوسيطة الثالثة هي اسم القائمة التي قمت بتكوينها في ملف التكوين.

يمكنك أيضًا الاشتراك و/أو تحديث شخص ما. سيتم اشتراك الشخص أو تحديثه إذا كان مشتركًا بالفعل:

 النشرة الإخبارية::subscribeOrUpdate('[email protected]', ['first_name' => 'Rince', 'last_name' => 'Wind']);

بالنسبة إلى MailChimp، يمكنك اشتراك شخص ما في مجموعة (مجموعات)/اهتمامات محددة أو أكثر باستخدام الوسيطة الرابعة:

 النشرة الإخبارية::subscribeOrUpdate( '[email protected]',
    ['FNAME'=>'رنس','LNAME'=>'ريح'],
    "المشتركون"،
    ['interests'=>['interestId'=>صحيح، 'interestId'=>صحيح]]،
);

ما عليك سوى إضافة false إذا كنت تريد إزالة شخص ما من مجموعة/اهتمام.

إليك كيفية إلغاء اشتراك شخص ما من قائمة محددة:

 النشرة الإخبارية::unsubscribe('[email protected]', 'subscribers');

حذف المشتركين

الحذف ليس مثل إلغاء الاشتراك. على عكس إلغاء الاشتراك، سيؤدي حذف العضو إلى فقدان كل السجل (إضافة/اشتراك/تعديلات) بالإضافة إلى إزالته من القائمة. في معظم الحالات، تريد استخدام unsubscribe بدلاً من delete .

إليك كيفية إجراء الحذف:

 النشرة الإخبارية::delete('[email protected]');

الحصول على معلومات المشترك

يمكنك الحصول على معلومات عن المشترك باستخدام وظيفة getMember :

 النشرة الإخبارية::getMember('[email protected]');

بالنسبة إلى MailCoach، سيؤدي هذا إلى إرجاع مثيل SpatieMailcoachResources|Subscriber بالنسبة إلى MailChimp، سيؤدي هذا إلى إرجاع مصفوفة تحتوي على معلومات حول المشترك.

إذا لم يكن هناك أي شخص مشترك بعنوان البريد الإلكتروني هذا، فسترجع الوظيفة false

هناك أيضًا طريقة ملائمة للتحقق مما إذا كان شخص ما مشتركًا بالفعل:

 النشرة الإخبارية::hasMember('[email protected]'); // إرجاع قيمة منطقية

بالإضافة إلى ذلك، يمكنك أيضًا التحقق مما إذا كان المستخدم مشتركًا في قائمتك:

 النشرة الإخبارية::isSubscribed('[email protected]'); // إرجاع قيمة منطقية

هل تحتاج إلى شيء آخر؟

إذا كنت بحاجة إلى المزيد من الوظائف، فستحصل على مثيل لواجهة برمجة التطبيقات الأساسية

 $api = النشرة الإخبارية::getApi();

إذا كنت تواجه مشكلة في الحصول على تكامل MailChimp، فيمكنك رؤية الخطأ الأخير من خلال:

 النشرة الإخبارية::getApi()->getLastError();

اختبار

قم بإجراء الاختبارات باستخدام:

 بائع / بن / الآفات

سجل التغيير

الرجاء مراجعة سجل التغيير للحصول على مزيد من المعلومات حول ما تغير مؤخرًا.

المساهمة

يرجى الاطلاع على المساهمة للحصول على التفاصيل.

حماية

إذا اكتشفت أي مشكلات متعلقة بالأمان، فيرجى إرسال بريد إلكتروني إلى [email protected] بدلاً من استخدام أداة تعقب المشكلات.

الاعتمادات

  • فريك فان دير هيرتن

  • يتم تكريس جميع المساهمين لتخصيص القوى العاملة للصيانة والأشياء الرائعة الجديدة.

رخصة

رخصة معهد ماساتشوستس للتكنولوجيا (MIT). يرجى الاطلاع على ملف الترخيص لمزيد من المعلومات.

يوسع
معلومات إضافية
تطبيقات ذات صلة
نوصي لك
أخبار ذات صلة الكل