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 Vhost，使其指向/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。

roobykon / marketplacekit

维护者

详细信息