Giter VIP home page Giter VIP logo

woocommercemobile's Introduction

Header

WooCommerceMobile

Version

Flutter mobile WooCommerce application for your customers.

Convert your working WooComerce online store into full-featured mobile application, that allow customers to look for products, add them to cart, make orders, and more.

Application functionality

1. Featured products

Presents to the user all the products and categories that are listed in your WooCommerce website.

  • Paginated lazy load of products (default page size is 10).
  • Displays all available categories with corresponding image.
  • Search by keywords query.
  • Supports two different lists UI:
    • Grid list display
    • Feed list display (like Instagram)
  • Filtering products by:
    • Highest or lowest price
    • Featured or on sale
    • Available now or by back order
  • Sorting products by:
    • Rating
    • Popularity
    • Date (ASC/DESC)
    • Price (ASC/DESC)
    • Alphabet (ASC/DESC)

Header

2. Catalog

Presents to the user all the categories with corresponding products for each category.

  • Paginated lazy load of categories.
  • Paginated lazy load of products for each of category.
  • Dynamic UI coloring for category image and name (choosing color depending on image to match contrast).
  • Sorting categories by alphabet (ASC/DESC).
  • Viewing separate screen with paginated products list of particular category.
  • Filtering products list of particular category by terms.

Powered by WooApp plugin APIs.

Header

3. Cart

Allows to have a cart of some products, which allows to create and store a list of products that user is about to order.

Cart functionality works only for authorized users. If you try to interact with cart functionality on any screen, app will ask user to login or register.

  • Displays the list of products that were added by user.
  • If no products were added, displays the empty state, with button that routes user to Fetured products screen.
  • For empty state displays the carousel with recently viewed products (if any).
  • Deletion of product from the cart.
  • Edit product quantity, and recalculate the product price.
  • Routes user to Order checkout screen.
  • Supports adding physical generic product.
  • Supports adding physical variable product and will display variations that user needs to select.

Powered by CoCart plugin APIs.

Header

4. Product

Presents all the information about particular product from the store.

  • Contains information about the product:
    • Images
    • Name
    • Price
    • Rating
    • Availability status
    • Description
    • Properties / terms
  • Supported CTA actions:
    • Open zoomable galley with all the product images.
    • Add / Remove from Wish List
    • Opening Product Reviews
    • Sharing product link
    • Open any of the Viewed / Category related product
    • Add to cart, or checkout if already added
  • Carousel with recently viewed products
  • Carousel with related category products

Header

Server requirements

Build instructions

In order to build the app, you need to create the .env file in project root directory, with the necessary variables.

Here is the example of .env file:

# Base URL for the WooCommerce REST API 
WOO_BASE_URL = https://woocommerce.store/wp-json/wc/v3/

# Base URL for the CoCart REST API
CO_CART_BASE_URL = https://woocommerce.store/wp-json/cocart/v2/

# Base URL for the WordPress REST API 
WP_BASE_URL = https://woocommerce.store/wp-json/

# WooCommerce API Public token
AUTH_PUBLIC_TOKEN = (( SOME TOKEN STRING HERE ))

# WooCommerce API Secret token
AUTH_SECRET_TOKEN = (( SOME TOKEN STRING HERE ))

# CoCart API Public token
CO_CART_PUBLIC_TOKEN = (( SOME TOKEN STRING HERE ))

# CoCart API Secret token
CO_CART_SECRET_TOKEN = (( SOME TOKEN STRING HERE ))

For the security reasons do not commit or share with anyone content of this file. For this repo .env file is added to .gitignore.

After that you can build the app using your local flutter environment (Android Studio, VS Code, or just execute flutter build / flutter run in console).

Available languages

User interface of the app is translated for languages listed below:

  • English
  • Українська
  • Русский

Any contributions to the translations are welcome.

License

This license of the software is opensource, but contains some restrictions.

  • The software is provided as is and may contain some issues.
  • Commercial usage of this app and any fork that is based on this app is not allowed without author permission.
  • Distribution of this app and any fork that is based on this app to any public store (like Google Play, App Store, F-Droid) is not allowed without author permission.
  • Every fork that is based on this app should contain original copyright UI section.

Full license agreement is available here.

Maintainers

woocommercemobile's People

Contributors

shifthackz avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar  avatar

Forkers

beepixl

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.