custom-d / cd-contact-form
适用于Laravel安装的基本联系表单包
v1.2.4
2024-06-24 23:18 UTC
Requires
- php: ^8.1
- anhskohbo/no-captcha: ^3.4
- illuminate/contracts: ^9.0|^10.0|^11.0
- phpsa/laravel-api-controller: *
- spatie/laravel-package-tools: ^1.9.2
Requires (Dev)
- friendsofphp/php-cs-fixer: ^3.8
- nunomaduro/collision: ^6.0|^7.0|^8.0
- nunomaduro/larastan: ^2.0.1
- orchestra/testbench: ^7.0|^8.0|^9.0
- pestphp/pest: ^1.21
- pestphp/pest-plugin-laravel: ^1.1
- phpsa/laravel-api-controller: >=5.0
- phpstan/extension-installer: ^1.1
- phpstan/phpstan-deprecation-rules: ^1.0
- phpstan/phpstan-phpunit: ^1.0
- phpunit/phpunit: ^9.5|^10.0
README
安装
使用以下命令安装:composer require custom-d/cd-contact-form
运行php artisan cdcontactform:install
进行安装
或手动发布迁移文件,可选地发布翻译文件和配置文件
php artisan vendor:publish --tag=cd-contact-form-migrations
php artisan vendor:publish --tag=cd-contact-form-config
php artisan vendor:publish --tag=cd-contact-form-translations
php artisan migrate
(可选) 更新您的用户模型,并添加以下作用域
public function scopeContactFormNotify(Builder $query): Builder
{
return $query->where('role' , 'admin');
}
根据您的项目定制查询。
如果您想列出电子邮件地址,请参阅环境变量CD_CONTACT_FORM_NOTIFICATION_EMAILS
。
环境变量
您需要在.env
文件中设置以下变量。
默认使用NoCaptcha,您可以从Google获取密钥此处
名称 | 用途 |
---|---|
CD_CONTACT_FORM_NOTIFICATION_EMAILS | 将发送管理员通知的原始电子邮件地址(以逗号分隔) |
NOCAPTCHA_SECRET | NoCaptcha的密钥 |
NOCAPTCHA_SITEKEY | NoCaptcha的密钥 |
配置文件
许多内容可以通过发布的配置文件进行自定义。请参阅文件内的文档。
验证规则
验证规则可以在配置文件中设置,在validation_rules
键下,以及消息在validation_messages
键下。
翻译
通知电子邮件可以通过以下值进行翻译
管理员通知
subject
: '收到来自 :Name 的新消息',问候语
: '',body_before
: '### 以下信息已被提供',正文之后
: '',
自定义其他字段显示
在您的AppServiceProvider的boot方法中添加
AdminNotification::formatFieldsUsing(fn($name) => str($name)->replace('_', ' ')->title()->toString());