frappe / webshop

Open Source eCommerce Platform
GNU General Public License v3.0
108 stars 120 forks source link

Frappe Webshop

Frappe Webshop is an Open Source eCommerce Platform, developed primarily using Python and JavaScript. Frappe Webshop was developed as part of the Frappe framework, which is designed to help developers quickly create business applications with minimal code by offering a combination of easy to use front-end and back-end development tools. Frappe Webshop is specifically targeted to help small to medium sized businesses with increasing their digital presence and being able to easily create online stores for their brands. Frappe Webshop can be integrated with ERPNext, which is an enterprise resource planning system used by businesses to record all their transactions in a single system. Frappe Webshop emphasizes simplicity, customization, and clean interfaces, providing businesses with the ability to create a tailored user experience both efficently and for free.

Table of Contents

Why choose Frappe Webshop?

Example Frappe Webshop Interface

Frappe Webshop

Features

Setup

  1. Install bench.

    Installation using Docker

    $ git clone https://github.com/frappe/frappe_docker.git
    $ cd frappe_docker

    See more details here: Containerized Installation

    Easy Install Script

    $ wget https://raw.githubusercontent.com/frappe/bench/develop/easy-install.py
    $ python3 easy-install.py --prod --email your@email.tld

    See more details here: Easy Install Script

    Manual Installation (recommended only for local development)

    $ pip install frappe-bench

    See more details here: Manual Installation

    Bench

    More information on usage of bench and its commands.

  2. Install ERPNext (only required if bench was installed using manual installation).
  3. Once ERPNext is installed, add the webshop app to your bench by running

    $ bench get-app webshop
  4. After that, you can install the webshop app on the required site by running
    $ bench --site sitename install-app webshop

Usage

Once setup has been completed, eCommerce features can be set up. This guide explains how to begin setup of the eCommerce features in conjunction with ERPNext. Many common features and customization options are explained, providing a solid framework for users to get started with building their eCommerce platforms. Note that for best results, users should have some Items setup using ERPNext before attempting to create a store. Creating items is a simple process that can be done through the Webshop interface by accessing > Home > Stock > Items and Pricing > Item.

Contributing

To contribute to the development of the Frappe Webshop, please make a fork of this repository and make edits within the forked repository. Once satisfied that a contribution should be deployed, create a pull request from your forked repository to this repository. Changes that are accepted will be merged into the main development branch and thus be rolled out to users. To make changes using the bench command line interface, make a clone of this repo using the following command:

$ git clone https://github.com/frappe/webshop.git

For more information on using the bench command line interface, please reference this page.

License

Licensed under the GNU GENERAL PUBLIC LICENSE V3. This is an open-source project meant to help businesses create online commerce platforms. (See LICENSE for more information).