flutter_woocommerce 0.0.3

Flutter Android iOS

Woocommerce api integration with flutter supporting various features

flutter_woocommerce #

Let's integrate woo api with flutter easily.

Getting Started #

Import

import 'package:flutter_woocommerce/flutter_woocommerce.dart';
import 'package:flutter_woocommerce/flutter_woocommerce_utils.dart';

Create instance

FlutterWoocommerce flutterWoocommerce = FlutterWoocommerce(
      url: <url>,
      consumerKey: <your_consumerKey>,
      consumerSecret: <your_consumerSecret>,
  );

Basic CRUD Requests #

Create #

Create data using POST request. Use postReq( String endPoint, Map data ) method. It will return Json Object if no error. Then assign it with corresponding Object. And will return WooError if there is error.

Example of creating a customer using POST Request

  createCustomer() async {
    Customer newCustomer = Customer(
        firstName: "Ma Tin",
        lastName: "Shwe",
        userName: "matinshwe",
        email: "matinshwe@someone.com");
    newCustomer.password = "12345";
    var result =
        await flutterWoocommerce.postReq('customers', newCustomer.toMap());
    if (result is! WooError) {
      Customer createdCustomer = Customer.fromJSON(result);
      print(createdCustomer.userName + " is created successfully!");
    } else {
      WooError err = result;
      print(err.message);
    }
  }

Read #

Read data using GET request. Use getReq( String endpoint ) method. It will return Json Object if no error. Assign it with corresponding Object. And will return WooError if there is error.

But sometimes you may need to use POST to read data according to condition.

Example of reading list of customers using GET Request

  fetchAllOrders() async {
    List<Order> orderList = [];
    var result = await flutterWoocommerce.getReq('orders');
    if (result is !WooError) {
      List<dynamic> resultList = result;
      resultList.forEach((order) {
        orderList.add(Order.fromJSON(order));
      });
    }else{
      WooError err = result;
      print(err.message);
    }
    print(orderList.length);
  }

Update #

Update data using PUT request. Use putReq( String endPoint, Map data ) method. It will return Json Object if no error. Assign it with corresponding Object. And will return WooError if there is error.

Example of updating a product using PUT Request

  updateProduct() async{
    ProductItem productItem = ProductItem(regularPrice: "USD 500");
    var result =
        await flutterWoocommerce.putReq('products/57', productItem.toMap());
    if (result is! WooError) {
      ProductItem createdCustomer = ProductItem.fromJSON(result);
      print(createdCustomer.name + " is updated successfully!");
    } else {
      WooError err = result;
      print(err.message);
    }
  }

Delete #

Delete data using DELETE request. Use deleteReq( String endPoint) method. It will return Json Object if no error. Assign it with corresponding Object. And will return WooError if there is error.

Example of deleting an order using DELETE Request

  deleteOrder() async {
    var result = await flutterWoocommerce.deleteReq('orders/27');
    if (result is! WooError) {
      Order order = Order.fromJSON(result);
      print(order.id.toString() + " is deleted successfully!");
    } else {
      WooError err = result;
      print(err.message);
    }
  }

Authentication #

Intented for customer and admin login. You must install JWT_auth plugin first in your wordpress site.

Use customerLogin( User user ) method to authenticate. It will return WooAuthedUser object if exist.

For Example:

  loginCutomer() async{
    var result = await flutterWoocommerce.customerLogin(User(username: 'username', password: "12345"));
    if(result is! WooError){
      WooAuthedUser wooAuthedUser = result;
      print(wooAuthedUser.displayName);
    }else{
      WooError err = result;
      print(err.message);
    }
  }

Bonus Methods #

There are some additional methods to save your time.

customerSignUp(User user)           => Customer
getCustomers()                      => List<Customer>
updateCustomer(Customer customer)   => Customer
getCustomerByEmail(String email)    => Customer

Objects #

Ready to use util objects. Unchecked items are not completed yet.

  • [x] Coupon
  • [x] Customer
  • [x] Billing
  • [x] Shipping
  • [x] Order
  • [x] LineItem
  • [x] Taxes
  • [x] TaxLine
  • [x] Refund(Order)
  • [x] ShippingLine
  • [x] FeeLine
  • [x] CouponLine
  • [ ] ProductItem
  • [ ] ProductVar
  • [ ] ProductAttr
  • [ ] ProductAttrTerms
  • [ ] ProductCateg
  • [ ] ProductShipClasses
  • [ ] ProductTags
  • [ ] ProductRev
  • [ ] TaxRates
  • [ ] TaxClasses
  • [ ] Settings
  • [ ] SettingsOpt
  • [ ] PaymentGatways
  • [ ] ShippingZones
  • [ ] ShippingZonesMtds
  • [ ] ShippingMtds
  • [ ] SystemStatus
  • [ ] SystemStatTools
  • [ ] data
10
likes
100
pub points
57%
popularity

Publisher

yehtethein.me

Woocommerce api integration with flutter supporting various features

Repository (GitHub)
View/report issues

Documentation

Documentation
API reference

License

BSD (LICENSE)

Dependencies

flutter, http

More

Packages that depend on flutter_woocommerce