custom-d/cd-contact-form

适用于Laravel安装的基本联系表单包

v1.2.4 2024-06-24 23:18 UTC

This package is auto-updated.

Last update: 2024-09-13 13:28:49 UTC


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_SECRETNoCaptcha的密钥
NOCAPTCHA_SITEKEYNoCaptcha的密钥

配置文件

许多内容可以通过发布的配置文件进行自定义。请参阅文件内的文档。

验证规则

验证规则可以在配置文件中设置,在validation_rules键下,以及消息在validation_messages键下。

翻译

通知电子邮件可以通过以下值进行翻译

管理员通知

  • subject: '收到来自 :Name 的新消息',
  • 问候语: '',
  • body_before: '### 以下信息已被提供',
  • 正文之后: '',

自定义其他字段显示

在您的AppServiceProvider的boot方法中添加

AdminNotification::formatFieldsUsing(fn($name) => str($name)->replace('_', ' ')->title()->toString());