- License: Dual license AGPL v3 / Proprietary
- Github Repository: https://github.com/ShopwareAG/shopware-4
- Issue-Tracker: http://jira.shopware.de/jira
Shopware 4 is the next generation of open source e-commerce software made in Germany. Based on bleeding edge technologies like Symfony 2
, Doctrine 2
& Zend Framework
Shopware comes as the perfect platform for your next eCommerce project.
Furthermore Shopware 4 provides an event-driven plugin-system and an advanced hook system, which unleashes the truth power and gives you the ability to customize every part of it.
Visit the forum at http://forum.shopware.de/
- PHP 5.3.2 or above
- PHP's
cURL
andGD
library - An Apache web server
- Apache's
mod_rewrite
module - MySQL 5.1.0 or above
Follow the instruction below if you want to install Shopware 4 using Git.
1.) Clone the git repository to the desired location using:
git clone https://github.com/ShopwareAG/shopware-4.git
In case you wish to contribute to Shopware, fork the master tree rather than cloning it and create a pull request via Github. For further information please visit the section "Get involved" in this document.
2.) Set the correct directory permissions:
chmod 755 config.php
chmod 755 -R cache
chmod 755 -R files
chmod 755 -R media
chmod 755 -R engine/Library/Mpdf/tmp
chmod 755 -R engine/Library/Mpdf/ttfontdata
chmod 755 -R engine/Shopware/Plugins/Community
Depending on your server configuration it might be neccesarry to set whole write permissions (777) to the files and folders above. Also you can start testing with lower permissions due to security reasons (644 for example), if your php-process can write to those files.
3.) An Ant Buildfile is used to set up the configuration and database connection:
cd build/
ant configure
ant build-config build-composer-install build-database
4.) Download the demo data files and extract them:
Go to the checkout directory and download the demo data files:
wget -O demo.zip files.shopware.de/download.php?package=demo
Unzip the files to the checkout directory:
unzip demo.zip
You can now access your shop
Backend Login: demo/demo
Shopware is available under dual license (AGPL v3 and proprietary license). If you want to contribute code (features or bugfixes) you have to create a pull request that considers a valid license information. You can either contribute your code under New BSD or MIT license.
If you want to contribute to the backend part of Shopware and you got in touch with ExtJS
-based code these parts must be licensed under GPL V3, this is due to the license terms of Sencha Inc.
If you are not sure, how to contribute code under right license and right way you can contact us under [email protected]. Further you can conclude a contribution aggreement with us to get more safety around your code submits.
To start contributing, just fork the repository and clone your fork to your local machine:
git clone [email protected]:[YOUR USERNAME]/shopware-4.git
After having done this, configure the upstream remote:
cd shopware-4
git remote add upstream git://github.com/ShopwareAG/shopware-4.git
git config branch.master.remote upstream
To keep your master up-to-date:
git checkout master
git pull --rebase
php build/ApplyDeltas.php
Checkout a new topic-branch and you're ready to start hacking and contributing to Shopware:
git checkout -b feature/your-cool-feature
If you're done hacking, filling bugs or building fancy new features push your changes to your forked repo:
git push origin feature/your-cool-feature
... and send us a pull request with your changes. We'll verify the pull request and merge it with the master
Branch.
For mosts tests a configured database connection is required.
The tests are located in the tests/Shopware/
directory
You can run the entire test suite with the following command:
vendor/bin/phpunit -c tests/Shopware
If you want to test a single component, add its path after the phpunit command, e.g.:
vendor/bin/phpunit -c tests/Shopware tests/Shopware/Tests/Components/Api/
All contributions should follow the PSR-1 and PSR-2 coding standards.
We've always had a sympathetic ear for our community, so please feel free to submit tickets with bug reports or feature requests. In order to have one place to go, we've decided to close the GitHub issue tracker in favor of our Jira issue tracker, which is directly connected to our development division.
Shopware is distributed under a dual license (AGPL v3 and proprietary license). You can find the whole license text in the license.txt
file.
The changelog and all available commits are located under https://github.com/ShopwareAG/shopware-4/commits/master.
- Shopware AG - Homepage of shopware AG
- Shopware Wiki - Shopware Wiki
- Shopware Forum - Community forum
- Shopware Marketplace - Shopware Store
- Shopware Developer Guide - Shopware 4 Developer Guide
- Shopware Designer Guide - Shopware 4 Designer Guide