文件列表:

.dockerignore (202, 2023-01-06)
.editorconfig (367, 2023-01-06)
.env.dist (183, 2023-01-06)
... ...

# About this project This is a non-profit project. The portal is an open-source project that was created in collaboration with the Shopware community to help local retailers in this trying time. It allows local governments, cities, or similar authorities to give local merchants an easy way of keeping in touch with their customers and selling goods and services online. After installing the project on a web server, local authorities can register within the portal. After registration and activation by the portal owner, a sub-portal will be automatically created for each local authority. After this step, local retailers can register within their local authority's sub-portal. Next, customers can register and interact with retailers in their area. [](https://twitter.com/intent/tweet?text=Support%20your%20local%20merchants%21&url=https%3A%2F%2Fgithub.com%2FshopwareDowntown%2Fportal&via=ShopwareDevs&hashtags=Shopware6,community) ## Goal At the time this project is created, the [COVID-19](https://en.wikipedia.org/wiki/Coronavirus_disease_2019) pandemic has a serious impact on the economy. Since retail stores are forced to close, they now need new solutions to generate an income. The portal project is trying to help. It is created to serve the project [downtowns.io](https://downtowns.io/), but since it is open source anyone is able to set up a a web server and provide the same service as downtowns to their local community. ## How it works A picture is worth a thousand words, so here are some example screen designs of the portal. The text is in german, since the portal was initially developed for the german market.  After the registration, the organisation has to be activated by the portal owner. Then these steps follow: - An organisation (e.g. a city) registers within the portal - Organisations are created as a sales channel - Retail stores register within the organisation, internally they are handled as categories - Retail stores can use an App to upload products - Users (buyers) can browse retail stores and see whats in stock This is how the landing page for an organisation or local authority looks:  And here is an example of a retailer's landing page:  ## Technology # How to install ## The Portal Prerequisites: [docker](https://docs.docker.com/install/), [docker-compose](https://docs.docker.com/compose/install/), [node/npm](https://nodejs.org/en/download/) > :warning: **The docker setup currently only works if your user ID is 1000.** > Execute `id -u` on your terminal to check. Clone the project: ```shell script git clone https://github.com/shopwareDowntown/downtown.git ``` Change into the project directory, then start the docker containers, add the cache directory and change into the app container: ```shell script cd downtown ``` ```shell script docker-compose up -d ``` ```shell script docker-compose exec cli bash ``` When inside the app container, do a basic install, generate a JWT secret and an App Secret, then exit the container: ```shell script composer install bin/console system:setup ``` Change the default credentials as listed and confirm those at the end: ```shell script Database user [app]: downtown Database password: uptown Database host [localhost]: mysql Database port [3306]: 3306 Database name [shopware]: downtown ``` ```shell script bin/console system:install --create-database --basic-setup --force exit ``` Check if your URL to /public folder [http://shopware.local] is set in /etc/hosts Please note: - Administration is available at http://localhost/admin with user `admin` and password `shopware` - Each sales channel represents an organisation/local authority - Merchants show up in categories after registration and activation - Merchants register through the separate Angular Merchant Administration described below You can shut down the portal with this command: ```shell script docker-compose down --remove-orphans ``` ## The Angular Merchant Administration Currently there is no docker container available, so you need to start the project using npm. Change into the directory `src/MerchantFrontend`. Then install dependencies and run the project: ```shell script cd src/MerchantFrontend ``` ```shell script npm install && npm run start ``` After the promt `Compiled successfully`, the merchant portal is available at [http://localhost:4200/](http://localhost:4200/). Please be aware: The registration for organisations is currently not wired up to the portal, it's just a hubspot form, for production use replace it with your own. For new organisations please create a sales channel manually in [the portal](http://localhost:8000/admin). Merchants are able to register and choose a category. To activate a merchant either click on the link in the registration request e-mail or, in case you haven't set up e-mail sending in the portal, do it directly in the database: ```shell script docker-compose exec mysql mysql -p # password is root ``` ```sql USE downtown; ``` ```sql UPDATE merchant SET active=1, activation_code = null WHERE email='merchant@email.example'; ``` ```sql quit; ``` ## Using the UI Explaining how to use a UI is easier done via video, so here is a tutorial video on how to configure organisations and merchants: [](https://www.youtube.com/watch?v=7-FxZwOmtv0) ### Payments #### Mollie Plugin Mollie is the selected payment provider for downtown. If you want to enable these payment methods, please install and activate the Mollie plugin. Then activate required payment methods and assign it to your sales channel. Please note, you have to change the APP_URL to be something else then localhost to comply with Mollie API guidelines. Use the /etc/hosts entry for local development. #### Enable Payment Methods for Merchants If you sign is as merchant you'll have access to a new payments tab in your account data. Here you can set your molli API keys and test modes. In addition to this, you can select what payments of your assigned sales channel should be enabled for your merchant. Only payment methods that are valid for the sales channel and are enabled in here will be shown during the checkout. # Contributing You have an idea or you found an issue? Please open an issue here: [shopwareDowntown/portal/issues](https://github.com/shopwareDowntown/portal/issues) Help retailers by contributing to this project. # Contributors [](https://github.com/shyim) [](https://github.com/arnoldstoba) [](https://github.com/PaddyS) [](https://github.com/FloBWer) [](https://github.com/JanPietrzyk) [](https://github.com/PascalThesing)   [](https://github.com/and-wolf) [](https://github.com/oterhaar) [](https://github.com/MalteJanz) [](https://github.com/seggewiss) [](https://github.com/maike93)  [](https://github.com/marcelbrode) [](https://github.com/swDennis)  [](https://github.com/xPand4B)  [](https://github.com/Carlosjan) [](https://github.com/Draykee) [](https://github.com/jakob-kruse) [](https://github.com/lukasrump) [](https://github.com/SebastianFranze) [](https://github.com/Christian-Rades) [](https://github.com/florianklockenkemper) [](https://github.com/niklas-rudde) [](https://github.com/dnoegel)  

近期下载者：

相关文件：

评论：[我要评论] [举报此文件]

收藏者：