{"id":13563716,"url":"https://github.com/marketplacekit/marketplacekit","last_synced_at":"2025-04-03T20:31:34.044Z","repository":{"id":32640109,"uuid":"133032233","full_name":"marketplacekit/marketplacekit","owner":"marketplacekit","description":"A platform to create an online marketplace","archived":false,"fork":false,"pushed_at":"2023-01-05T01:15:26.000Z","size":32950,"stargazers_count":788,"open_issues_count":104,"forks_count":347,"subscribers_count":81,"default_branch":"master","last_synced_at":"2025-03-06T18:17:49.589Z","etag":null,"topics":["laravel","marketplace","php"],"latest_commit_sha":null,"homepage":"https://marketplacekit.com","language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/marketplacekit.png","metadata":{"files":{"readme":"readme.md","changelog":null,"contributing":null,"funding":null,"license":"license.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2018-05-11T11:37:28.000Z","updated_at":"2025-03-05T14:15:26.000Z","dependencies_parsed_at":"2023-01-14T22:00:59.918Z","dependency_job_id":null,"html_url":"https://github.com/marketplacekit/marketplacekit","commit_stats":null,"previous_names":[],"tags_count":13,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/marketplacekit%2Fmarketplacekit","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/marketplacekit%2Fmarketplacekit/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/marketplacekit%2Fmarketplacekit/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/marketplacekit%2Fmarketplacekit/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/marketplacekit","download_url":"https://codeload.github.com/marketplacekit/marketplacekit/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247074690,"owners_count":20879301,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["laravel","marketplace","php"],"created_at":"2024-08-01T13:01:22.532Z","updated_at":"2025-04-03T20:31:32.973Z","avatar_url":"https://github.com/marketplacekit.png","language":"PHP","funding_links":[],"categories":["PHP"],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\u003cimg src=\"https://marketplace-kit.s3.amazonaws.com/logo.png\"\u003e\u003c/p\u003e\n\n## About MarketplaceKit\n\nMarketplaceKit is a platform for building different types of online marketplaces. MarketplaceKit attempts to reduce the development effort required to build product, rental, service and listing marketplaces such as Etsy, AirBnB, Handy and Zillow. It does this by attempting to cover the main components a marketplace needs, including the following:\n\n- Powerful search across multiple fields, geolocation and custom fields\n- Geolocalization for users and listings\n- Frontend listing creation and browsing\n- User profiles\n- Direct messaging between users\n- Multilingual functionality\n\n\u003ctable\u003e\u003ctr\u003e\u003ctd\u003e\u003cp align=\"center\"\u003e\u003cimg src=\"https://marketplace-kit.s3.amazonaws.com/preview.png\"\u003e\u003c/p\u003e\n\u003c/td\u003e\u003c/tr\u003e\u003c/table\u003e\n\n\nMarketplaceKit uses popular, well documented packages without too much overhead to simplify a developers/designers life. Therefore, the following choices were made:\n\n- Based on the popular Laravel Framework\n- Leverages Bootstrap 4 for a responsive and mobile-first theme out of the box\n- Separates theming logic from development by using Twig\n- Avoids JS frameworks that require compilation\n- Uses different widgets for different listing types (coming soon)\n\nMarketplaceKit is easy to customize, change the design and supports multiple languages.\n\n\n\n## Server Requirements\n\n- PHP 7.2\n  - OpenSSL PHP Extension\n  - PDO PHP Extension\n  - Mbstring PHP Extension\n  - Tokenizer PHP Extension\n  - XML PHP Extension\n  - Ctype PHP Extension\n  - JSON PHP Extension\n  - ImageMagick PHP Extension\n- MySQL 5.7.7 or greater\n- Node JS (8.9.4) - this is only required for compiling SCSS to CSS\n- Git\n- ImageMagick\n- Nginx\n\nAlthough MarketplaceKit has been tested on Ubuntu 16.04 LTS. It should work with any OS that satisfies the above requirements. Nginx (https://laravel.com/docs/5.6/deployment#nginx) is recommended as a webserver. Developers should also have knowledge of Laravel, Bootstrap and Twig for extending/building on top of MarketplaceKit.\n\n\n\n## Installation\n\n- Download the code via composer\n\n  ```\n   composer create-project marketplacekit/marketplacekit:dev-master marketplacekit\n  ```\n\n- Add your database details to the .env file\n\n  ```\n  DB_CONNECTION=mysql\n  DB_HOST=127.0.0.1\n  DB_PORT=3306\n  DB_DATABASE=homestead\n  DB_USERNAME=homestead\n  DB_PASSWORD=secret\n  ```\n\n- Create the public disk\n\n  ```\n  php artisan storage:link\n  ```\n  \n- Create the database tables by running\n\n  ```\n  php artisan migrate\n  ```\n\n- Seed the database by running\n\n  ```\n  php artisan db:seed\n  ```\n\n- Configure your Nginx server block or Apache Vhost to point to the /public folder\n\n  e.g. nginx\n\n  ```\n  location / {\n      try_files $uri $uri/ /index.php?$query_string;\n  }\n  ```\n\n  e.g. apache\n\n  ```\n  Options +FollowSymLinks\n  RewriteEngine On\n  \n  RewriteCond %{REQUEST_FILENAME} !-d\n  RewriteCond %{REQUEST_FILENAME} !-f\n  RewriteRule ^ index.php [L]\n  ```\n\n- Visit your domain login and change the default password\n\n  ```\n  Default username: admin\n  Default password: changeme\n  ```\n  \n- Add your domain to APP_URL in .env file\n  ```\n  APP_URL=http://localhost.com\n  ```\n  Don't forget to add https:// in production.\n  \n- Install the node modules (Optional)\n    ```\n    npm install\n    ```\n\n\n### Facebook login\n\nIn order for your users to login via Facebook you need to register for a Facebook key.\n\n- Go to https://developers.facebook.com and register for a developer account.\n- Create a Facebook app via https://developers.facebook.com/apps. Instructions for creating a Facebook application can be found here: https://developers.facebook.com/docs/apps/register.\n- On the \"Product Setup\" page, click the Dashboard link on the left-hand side.\n- Save the App ID and App Secret values so you can add them to the MarketplaceKit panel\n\n\n\n### Google Maps Keys\n\nMarketplaceKit relies on Google Maps for geolocalized searches. Please visit https://developers.google.com/maps/documentation/javascript/get-api-key to generate  your key. You can then add this in the admin panel.\n\n\n### Updating\nTo update MarketplaceKit please run:\n```\ngit pull origin master\n```\n\nand to install any new packages\n```\ncomposer update\n```\n\n### API (Note: Work in progress)\nFor authentication:\nPOST    /api/auth/login     [email, password]\nGET     /api/auth/me\nGET     /api/auth/refresh\n\nFor all other requests please use the same URLs as the website but use use \"Accept: application/json\" in the HTTP headers. This will convert all data passed to HTML into JSON. e.g.\nPOST    /register\nGET     /browse\nGET     /listing/\u003cHASH\u003e/\u003cSLUG\u003e\n\n## License\nMarketplaceKit is free software, and is released under the terms of the \u003cabbr title=\"GNU General Public License\"\u003eGPL\u003c/abbr\u003e version 3. See \u003ca href=\"license.txt\"\u003elicense.txt\u003c/a\u003e.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmarketplacekit%2Fmarketplacekit","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmarketplacekit%2Fmarketplacekit","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmarketplacekit%2Fmarketplacekit/lists"}