由於愚蠢的版權侵犯,我不得不重命名這個包。
請注意,程式碼中沒有任何更改(仍然是相同的命名空間)。僅包名稱已變更。命名空間可能會在稍後的主要版本中發生變更。
laravel feedback component可讓您輕鬆在網站上實現客戶回饋元件。它是用 VueJS 建構的,但可以在任何類型的 Laravel 專案中實現。您只需在佈局中添加幾行即可。
您可能知道很多網站都使用對講機的聊天系統,或者 crisp、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 指令發布其資產。安裝軟體包後,您還應該執行 migrate 命令:
php artisan kustomer:publish
php artisan migrate
這將建立一個新的回饋表。
您可以透過編輯config/kustomer.php
根據需要更新元件的配置。
我鼓勵您仔細閱讀此設定檔。
您在組件中看到的所有文字都是可翻譯的。發布資產後,您將在resources/lang/vendor/en/kustomer.php中找到文本
回饋標籤也儲存在此文件中,並且feedbacks
陣列必須與設定檔中的陣列相符。
在您的public/
目錄中,您將找到需要包含到 html 佈局中的已編譯 css 和 js 檔案。
將這些包含在您希望元件顯示的頁面上:
< head >
< script src = " {{ asset ( ' vendor/kustomer/js/kustomer.js ' ) } } " defer ></ script >
</ head >
< body >
@include ( ' kustomer::kustomer ' )
</ body >
注意如果您執行 VueJS 應用程序,則必須在
#app
容器之外新增#kustomer
容器。這是因為 kustomer 預設運行在自己的 vue 實例上。如果您想要變更此設置,請參閱將資產包含在您自己的資產中
更新此包時,您應該重新發布資產:
php artisan vendor:publish --tag=kustomer-assets --force
這將重新發布已編譯的 JS 和 CSS 文件,以及位於public/vendor/kustomer/assets
中的 svg 文件。如果您想使用自己的鏡像,請更新設定檔。
或者,您可以將.vue
和.sass
檔案匯入到您自己的resources/js
和resources/sass
資料夾中,從而允許您大量自訂回饋元件元件和佈局。
這也將使您最終在應用程式中只得到一個已編譯的.js
和.css
。
但是,如果您嘗試更新最新版本,則應該小心,因為您的變更可能會遺失。
需要兩個 npm 套件:
您可以透過npm 或yarn 添加它們。
我們使用 axios 發出 HTTP 請求來傳送回饋,因此請確保 axios 已安裝並在您的 vue 應用程式中進行設定。
與 Laravel 腳手架 javascript 中一樣,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 Nova 工具。
當新的回饋被正確儲存時,我們將調度一個 Laravel 事件。
您可以偵聽此事件並觸發任何類型的偵聽器。接下來發生的事情由你決定!您可以向管理員發送電子郵件、記錄一些數據或您能想到的任何內容。
在您的EventServiceProvider
中,您可以更新$listen
屬性來新增事件。
protected $ listen = [
' MydnicKustomerEventsNewFeedback ' => [
' AppListenersYourOwnListener ' , // change this
],
// ...
];
Laravel Kustomer 是一款根據 MIT 許可證授權的開源軟體。
在此專案中,您會發現一些來自 FlatIcon 的 svg 圖示。您可以在自己的專案中隨意更改它們。