e-shop is an e-commerce web application that sells goods online. Buyers have to create an account to buy products with e-shop. This application has major features such as user authentication with social media accounts such as GitHub, Linkedin, and Pinterest; User Authorization with different roles such as Admin, Author, and user; Goods online payment with methods such as Paypal and Stripe. Customer newsletter subscription with MailChimp. This application has an Administrator dashboard through which all applications' resources are managed; Products Dashboard where only the administrator or author can manage products (create, edit or delete products); Users Dashboard where only the administrator can manage users(delete users, assign roles to users).
These instructions will get you a copy of the project up and running on your local machine for development and testing purposes. See deployment for notes on how to deploy the project on a live system.
What things you need to install the software and how to install them:
- Composer Download link:
- Node.js
- Localhost server
You can get localhost server of your choice in Bitnami.
- Text editor (example. Visual studio code)
- Git Desktop
Download Git Desktop For windows or mac Os
Download Git Desktop For Linux
A step by step series of examples that tell you how to get a development env running
-
Install Your local serve. Find the local server installation procedure for your operating system.
-
Install visual studio Code in your operating system.
-
Install git Desktop. Git will request for your GitHub credentials. Signin to your GitHub account with the GitHub desktop.
-
Install Composer and set command-line php.
for example in windows the path for your command-line php will be
Installation Directory/php/php.exe
where installation Directory will be the path to where local server is installed.
for example
C:\Bitnami\wampstack-7.4.9-0/php/php.exe
-
Install Git and also install the Git Bash.
-
Install Node.js
-
Downloading/cloning the project Files from GitHub.
- Open Your Git Desktop.
- At the top left of Git Desktop Click The File Option on the Toolbar and select the clone repository from the dropdown menu to launch the clone repository dialog pop-up.
- Select Url Option.
- Click clone and wait for the cloning process to finish
- Click Open in Visual Studio Code Option under Open the repository in your external editor.
enter the repository url as
https://github.com/JohnyIrush/e-shop.git
then set the local path as
Installation Directory/framewoks/
- Set bash as the default shell. Click terminal at the main toolbar, then select new terminal from the dropdown menu.
- Select bash as default shell. At the top left of the new terminal window just before the big Plus sign click the down arrow. click select default shell to launch the installed shells list pop up. At the top click select Git Bash.
-
In your shell Run the following commands
- Composer packages: composer install
- Nodejs packages: npm install
- Create a database
- Create a file called .env and copy all the contents of .env.example into the .env file
- Enter the Database credentials
Run the following command to launch e-shop
php artisan serve
We use SemVer for versioning. For the versions available, see the tags on this repository.
- **John Irungu ** - Initial work
This project is licensed under the MIT License - see the LICENSE.md file for details