README

关于MarketplaceKit

MarketplaceKit是一个用于构建不同类型在线市场的平台。MarketplaceKit试图减少构建产品、租赁、服务和列表市场（如Etsy、AirBnB、Handy和Zillow）所需的开发工作量。它通过尝试涵盖市场所需的主要组件来实现这一点，包括以下内容

跨多个字段、地理位置和自定义字段强大的搜索
用户和列表的地理位置定位
前端列表创建和浏览
用户资料
用户之间直接消息
多语言功能

MarketplaceKit使用流行的、文档完善的包，没有太多的开销，以简化开发人员/设计师的生活。因此，做出了以下选择

基于流行的Laravel框架
利用Bootstrap 4提供响应式和移动优先的主题
使用Twig将主题逻辑与开发分离
避免需要编译的JS框架
为不同的列表类型使用不同的小部件（即将推出）

MarketplaceKit易于自定义，可更改设计并支持多语言。

服务器要求

PHP 7.2
- OpenSSL PHP扩展
- PDO PHP扩展
- Mbstring PHP扩展
- Tokenizer PHP扩展
- XML PHP扩展
- Ctype PHP扩展
- JSON PHP扩展
- ImageMagick PHP扩展
MySQL 5.7.7或更高版本
Node JS（8.9.4）- 这仅适用于将SCSS编译为CSS
Git
ImageMagick
Nginx

尽管MarketplaceKit已在Ubuntu 16.04 LTS上进行了测试，但它应与满足上述要求的任何操作系统兼容。建议使用Nginx（https://laravel.net.cn/docs/5.6/deployment#nginx）作为Web服务器。开发人员还应了解Laravel、Bootstrap和Twig，以便在MarketplaceKit的基础上扩展/构建。

安装

通过Composer下载代码

 composer create-project marketplacekit/marketplacekit:dev-master marketplacekit

将您的数据库详细信息添加到.env文件中

DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=homestead
DB_USERNAME=homestead
DB_PASSWORD=secret

创建公共磁盘
```
php artisan storage:link
```
通过运行以下命令创建数据库表
```
php artisan migrate
```
通过运行以下命令对数据库进行初始化
```
php artisan db:seed
```

配置您的Nginx服务器块或Apache虚拟主机，将其指向/public文件夹

例如：nginx

location / {
    try_files $uri $uri/ /index.php?$query_string;
}

例如：apache

Options +FollowSymLinks
RewriteEngine On

RewriteCond %{REQUEST_FILENAME} !-d
RewriteCond %{REQUEST_FILENAME} !-f
RewriteRule ^ index.php [L]

访问您的域名登录并更改默认密码

Default username: admin
Default password: changeme

将您的域名添加到.env文件中的APP_URL
```
APP_URL=https://.com
```
在生产环境中不要忘记添加https://。
安装node模块（可选）
```
npm install
```

Facebook登录

为了使用户能够通过Facebook登录，您需要注册Facebook密钥。

访问https://developers.facebook.com并注册开发人员账户。
通过https://developers.facebook.com/apps创建Facebook应用程序。有关创建Facebook应用程序的说明，请参阅： https://developers.facebook.com/docs/apps/register。
在“产品设置”页面，点击左侧的仪表板链接。
保存App ID和App Secret值，以便可以将它们添加到MarketplaceKit面板中

Google Maps密钥

MarketplaceKit 依赖于 Google Maps 进行地理定位搜索。请访问 https://developers.google.com/maps/documentation/javascript/get-api-key 生成您的密钥。然后您可以在管理面板中添加此密钥。

更新

要更新 MarketplaceKit，请运行

git pull origin master

并且要安装任何新包

composer update

API（注意：进行中）

对于认证：POST /api/auth/login [邮箱，密码] GET /api/auth/me GET /api/auth/refresh

对于所有其他请求，请使用与网站相同的 URL，但在 HTTP 标头中使用 "Accept: application/json"。这将把所有传递给 HTML 的数据转换为 JSON。例如：POST /register GET /browse GET /listing//

许可证

MarketplaceKit 是免费软件，并且根据 GPL 版本 3 许可发布。请参阅 license.txt。

marketplacekit / marketplacekit

维护者

详细信息