README

欢迎使用AddChat Laravel Pro文档。

直接阅读文档 AddChat Pro Docs

适用于Laravel网站的全方位多用途聊天小部件

AddChat是Laravel的新聊天伙伴。它是一个独立的聊天小部件，使用网站现有的users基础，并允许网站用户互相聊天。

您将获得完整的源代码，因此AddChat在您的服务器/托管上运行，包括数据库。因此，您对自己的数据拥有完全的隐私。无论您是大型企业还是小型企业，AddChat适合所有人。

概述

Addchat Pro是一个聊天小部件，您可以将其集成到现有的或全新的Laravel网站中。AddChat像一个独立的小部件一样运行，满足您所有与业务相关的需求，例如-

用户之间聊天
实时聊天（无需刷新页面）
内部通知系统（节省Pusher月度订阅费用）
客户支持
多用户群组
访客聊天

还有很多其他功能，继续阅读⚡️

为什么选择AddChat ?

一些关键亮点，让您选择AddChat！

节省每月订阅费用（一次性支付，永久使用）
无机密数据泄露
完全隐私
易于安装和更新
使用现有用户数据库
多用途，可用于帮助台、客户支持、用户之间聊天等...

AddChat永远不会修改您的现有数据库表或记录。它也永远不会破坏您的任何网站功能。

AddChat已经过全面测试，准备好在生产网站上使用。

技术规范

AddChat非常轻量，高性能，可扩展且安全。

AddChat前端使用VueJs构建，这是一个纯API的Web应用。
AddChat后端（API）使用Laravel构建
- AddChat Laravel版本是Laravel包，因此，可以通过Composer安装到现有的或全新的Laravel网站中。

用户界面与设计

AddChat使用CSS Flexbox和Sass设计。让我们看看CSS Flexbox有什么特别之处，以及为什么我们使用它。

AddChat是CSS框架独立的。这意味着，无论您的网站使用哪个CSS框架，它都不会影响网站CSS，也不会被它影响。
或其他...
AddChat CSS完全封装（使用#addchat-bot .c-前缀包裹在AddChat包装器中）。
- 因此，它永远不会覆盖您的网站CSS，也不会从中继承。
- AddChat UI具有额外的响应性。针对从额外小设备到大型4K桌面进行优化-
  - 小型手机
  - Android手机
  - iPhone
  - iPad & iPad Pro
  - 小型-中型尺寸笔记本电脑
  - 大型桌面
我们使用了流行的NPM包auto-prefixer，以确保AddChat UI设计在各种类型的浏览器中保持一致，例如Chrome, Firefox, Safari, Edge等。

多区域

添加聊天支持所有语言和时区。添加聊天会根据您网站的默认时区和语言自动适应和调整区域设置。有关在 AddChat Laravel 中添加新语言的更多信息，请参阅语言部分。

添加聊天不会破坏您网站上的任何功能，即使添加聊天出现错误，每个最坏情况场景都有 回退模式。

专业版

这是添加聊天专业版的文档

添加聊天专业版 附带商业许可证。专业版功能齐全，包含许多实用和令人兴奋的功能。

添加聊天 Laravel 专业版
- 实时查看（addchat-laravel-pro.classiebit.com） - 访问专业版实时示例。
- 购买（addchat-laravel-pro） - 在此处购买专业版。

Laravel 安装

添加聊天可以通过 composer 安装。简单... 🍻

先决条件

Laravel 版本 5.5 / 5.6 / 5.7 / 5.8 / 6.x
请确保在全新或现有 Laravel 应用程序上安装添加聊天包。
我们假设您已经设置了数据库。
如果您正在运行版本低于 < 5.7 的 MySql，请在 Laravel config/database.php 中禁用严格模式 'strict' => false

安装

如果您正在现有 Laravel 应用程序上安装添加聊天并且已经拥有认证系统，则 跳过此步骤

如果您正在 全新 Laravel 应用程序 上安装，请运行

Laravel 5.5 到 5.8
```
php artisan make:auth

php artisan migrate
```
Laravel 6.x
```
composer require laravel/ui --dev

php artisan ui vue --auth

npm install && npm run dev

php artisan migrate
```
解压缩 addchat-laravel-pro.zip 文件，复制 addchat-laravel-pro 文件夹并将其放置在您的 Laravel 应用程序根目录中。
- 在您的 Laravel 网站目录中，文件夹名称必须是 addchat-laravel-pro。

打开您的 Laravel 应用程序 composer.json 文件，在末尾粘贴以下代码（在最后一个大括号 } 之前）

"repositories": [{
    "type": "path",
    "url": "addchat-laravel-pro/"
}]

（完成后，composer.json 文件将类似于以下内容）

{
    .
    .
    .
    .
    .
    
    "minimum-stability": "dev",
    "prefer-stable": true,
    "scripts": {
        "post-autoload-dump": [
            "Illuminate\\Foundation\\ComposerScripts::postAutoloadDump",
            "@php artisan package:discover --ansi"
        ],
        "post-root-package-install": [
            "@php -r \"file_exists('.env') || copy('.env.example', '.env');\""
        ],
        "post-create-project-cmd": [
            "@php artisan key:generate --ansi"
        ]
    },


    "repositories": [{
        "type": "path",
        "url": "addchat-laravel-pro/"
    }]

}

通过 Composer 安装 AddChat Laravel 专业版

composer require classiebit/addchat-laravel-pro

运行添加聊天安装命令
```
php artisan addchat:install
```
在安装过程中，它将要求您输入许可证代码。输入许可证代码以完成安装过程。
- 请记住，一个许可证代码仅适用于一个域名。有关更多详细信息，请联系支持。

打开公共布局文件，通常公共布局文件是包含 HTML & BODY 标签的文件。

复制添加聊天 CSS 代码，并将其粘贴在 </head> 标签之前

<!-- 1. Addchat css -->
<link href="<?php echo asset('assets/addchat/css/addchat.min.css') ?>" rel="stylesheet">

复制添加聊天小部件代码，并将其粘贴在 <body> 标签之后

<!-- 2. AddChat widget -->
<div id="addchat_app" 
    data-baseurl="<?php echo url('') ?>"
    data-csrfname="<?php echo 'X-CSRF-Token' ?>"
    data-csrftoken="<?php echo csrf_token() ?>"
></div>

复制添加聊天 JS 代码，并将其粘贴在 </body> 标签之前

<!-- 3. AddChat JS -->
<!-- Modern browsers -->
<script type="module" src="<?php echo asset('assets/addchat/js/addchat.min.js') ?>"></script>
<!-- Fallback support for Older browsers -->
<script nomodule src="<?php echo asset('assets/addchat/js/addchat-legacy.min.js') ?>"></script>

请将 <php ?> 标签替换为 {{}} 括号。

最终的布局将类似于以下内容

<head>

    <!-- **** your site other content **** -->

    <!-- 1. Addchat css -->
    <link href="<?php echo asset('assets/addchat/css/addchat.min.css') ?>" rel="stylesheet">

</head>
<body>

    <!-- 2. AddChat widget -->
    <div id="addchat_app" 
        data-baseurl="<?php echo url('') ?>"
        data-csrfname="<?php echo 'X-CSRF-Token' ?>"
        data-csrftoken="<?php echo csrf_token() ?>"
    ></div>


    
    <!-- **** your site other content **** -->



    <!-- 3. AddChat JS -->
    <!-- 3. AddChat JS -->
    <!-- Modern browsers -->
    <script type="module" src="<?php echo asset('assets/addchat/js/addchat.min.js') ?>"></script>
    <!-- Fallback support for Older browsers -->
    <script nomodule src="<?php echo asset('assets/addchat/js/addchat-legacy.min.js') ?>"></script>

</body>

请注意，php artisan addchat:install 将添加聊天资产发布到您的应用程序 public/assets 目录

addchat.min.js 用于现代浏览器和 addchat-legacy.min.js 用于旧浏览器。这些将根据 type="module" 和 nomodule 自动由浏览器切换，您无需做任何事情。

设置完成，现在直接前往设置文档

elsayed85 / addchat-laravel-pro

维护者

详细信息