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-rs

维护者

详细信息