بسبب انتهاك غبي لحقوق الطبع والنشر، اضطررت إلى إعادة تسمية هذه الحزمة.
لاحظ أنه لم يتغير شيء في الكود (لا تزال نفس مساحة الاسم). لقد تغير اسم الحزمة فقط. قد تتغير مساحة الاسم لاحقًا في إصدار رئيسي.
يتيح لك laravel feedback component تنفيذ مكون ملاحظات العملاء بسهولة على موقع الويب الخاص بك. تم إنشاؤه باستخدام VueJS ولكن يمكن تنفيذه في أي نوع من مشاريع Laravel. كل ما عليك فعله هو إسقاط بضعة أسطر في تخطيطك.
من المحتمل أنك تعرف الكثير من مواقع الويب التي تستخدم نظام الدردشة الخاص بالاتصال الداخلي، أو chat.io والعديد من دردشة العملاء الأخرى التي تتيح لك الحصول على تعليقات من زوار موقع الويب الخاص بك.
يعد laravel feedback component بديلاً مفتوح المصدر وقابل للتخصيص ويعتمد نفس التصميم. بمجرد التثبيت، سترى المكون على موقع الويب الخاص بك.
لدينا أيضًا أداة Nova لذلك!
سأعمل على تنفيذ نظام دردشة في laravel feedback component ، والذي من المحتمل أن يعمل مع Laravel Nova. تم التخطيط لهذا لـ V2. في الوقت الحالي، يمكنك فقط جمع التعليقات من زوار موقعك.
مكون تعليقات Laravel " data-animated-image = "" style = "max-width: 100%;">
يمكنك استخدام Composer لتثبيت laravel feedback component :
composer require mydnic/laravel-kustomer
بعد تثبيت laravel feedback component ، قم بنشر أصوله باستخدام الأمر kustomer:publish
Artisan. بعد تثبيت الحزمة، يجب عليك أيضًا تشغيل أمر الترحيل:
php artisan kustomer:publish
php artisan migrate
سيؤدي هذا إلى إنشاء جدول تعليقات جديد.
يمكنك تحديث تكوين المكون كما تريد عن طريق تحرير config/kustomer.php
.
أشجعك على قراءة ملف التكوين هذا بعناية.
جميع النصوص التي يمكنك رؤيتها في المكونات قابلة للترجمة. بعد نشر الأصول تجدون النصوص في Resources/lang/vendor/en/kustomer.php
يتم تخزين تسميات التعليقات في هذا الملف أيضًا، ويجب أن تتطابق مصفوفة feedbacks
مع تلك الموجودة في ملف التكوين الخاص بك.
ستجد في الدليل public/
الخاص بك ملفات css وjs مجمعة يجب تضمينها في تخطيط html الخاص بك.
قم بتضمينها في الصفحات التي تريد أن تظهر فيها المكونات:
< head >
< script src = " {{ asset ( ' vendor/kustomer/js/kustomer.js ' ) } } " defer ></ script >
</ head >
< body >
@include ( ' kustomer::kustomer ' )
</ body >
تنبيه: إذا قمت بتشغيل تطبيق VueJS، فيجب عليك إضافة حاوية
#kustomer
خارج حاوية#app
الخاصة بك. وذلك لأن kustomer يعمل على مثيل vue الخاص به افتراضيًا. إذا كنت تريد تغيير ذلك، فراجع تضمين الأصول مع الأصول الخاصة بك
عند تحديث هذه الحزمة، يجب عليك إعادة نشر الأصول:
php artisan vendor:publish --tag=kustomer-assets --force
سيؤدي هذا إلى إعادة نشر ملفات JS وCSS المجمعة، وكذلك ملفات svg الموجودة في public/vendor/kustomer/assets
. إذا كنت تريد استخدام الصور الخاصة بك، يرجى تحديث ملف التكوين.
اختياريًا، يمكنك استيراد ملفات .vue
و .sass
إلى مجلدات resources/js
و resources/sass
الخاصة بك، مما يسمح لك بتخصيص مكونات Feedback Component وتخطيطها بشكل كبير.
سيسمح لك هذا أيضًا بالحصول على ملف .js
و .css
مجمع واحد فقط في تطبيقك.
ومع ذلك، يجب أن تكون حذرًا إذا كنت تحاول تحديث الإصدار الأحدث، لأنه قد يتم فقدان التغييرات التي أجريتها.
مطلوب حزمتين npm:
يمكنك إضافتها عبر npm أو الغزل.
نحن نستخدم أكسيوس لتقديم طلب HTTP لإرسال التعليقات، لذا تأكد من تثبيت أكسيوس مهيأً في تطبيق vue الخاص بك.
كما هو الحال في جافا سكريبت للسقالات Laravel، يجب تكوين axios على النحو التالي:
window . axios = require ( 'axios' ) ;
window . axios . defaults . headers . common [ 'X-Requested-With' ] = 'XMLHttpRequest' ;
let token = document . head . querySelector ( 'meta[name="csrf-token"]' ) ;
if ( token ) {
window . axios . defaults . headers . common [ 'X-CSRF-TOKEN' ] = token . content ;
} else {
console . error ( 'CSRF token not found: https://laravel.com/docs/csrf#csrf-x-csrf-token' ) ;
}
نشر مكون VueJS:
php artisan vendor:publish --tag=kustomer-vue-component
نشر ملف نمط SASS:
php artisan vendor:publish --tag=kustomer-sass-component
ثم في تطبيق vue الخاص بك:
// app.js
Vue . component ( 'kustomer' , require ( './components/Kustomer/Kustomer.vue' ) ) ;
// app.scss
@import ' kustomer ' ;
تحتوي التعليقات بشكل أساسي على 4 سمات:
بمجرد تخزين التعليقات في قاعدة البيانات الخاصة بك، يمكنك استخدام المكتب الخلفي الخاص بك لعرض البيانات ومعالجتها.
يعمل نموذج الملاحظات مثل أي نموذج Eloquent آخر، لذا فهو سهل الاستخدام للغاية في تطبيق Laravel الخاص بك.
باستخدام لارافيل نوفا؟ لا مشكلة !
إذا كنت تستخدم Laravel Nova، فستحتاج بالتأكيد إلى أداة لتصور جميع التعليقات التي تلقيتها.
يمكنك تثبيت أداة Laravel Nova الرسمية هنا.
عندما يتم تخزين التعليقات الجديدة بشكل صحيح، سنرسل حدث Laravel.
يمكنك الاستماع إلى هذا الحدث وإثارة أي نوع من المستمعين. الأمر متروك لك لتقرر ما سيحدث بعد ذلك! يمكنك إرسال بريد إلكتروني إلى المسؤول، أو تسجيل بعض البيانات، أو أي شيء يمكنك التفكير فيه.
في EventServiceProvider
الخاص بك، يمكنك تحديث الخاصية $listen
لإضافة الحدث.
protected $ listen = [
' MydnicKustomerEventsNewFeedback ' => [
' AppListenersYourOwnListener ' , // change this
],
// ...
];
Laravel Kustomer هو برنامج مفتوح المصدر مرخص بموجب ترخيص MIT.
ستجد في هذا المشروع بعض أيقونات svg التي تأتي من FlatIcon. أنت حر في تغييرها في مشروعك الخاص.