wic/woocommerce-api

A client library for the WooCommerce REST API

v0.3.1 2015-10-23 09:10 UTC

Requires

• php: >= 5.4.0
• ext-curl: *
• ext-json: *

GPL v3

• Max Rice
• Gerhard Potgieter
• Web in Color

README

About

A PHP wrapper for the WooCommerce REST API. Easily interact with the WooCommerce REST API using this library.

Feedback and bug reports are appreciated, and fixed ASAP.

Installation

Via Composer

$ composer require wic/woocommerce-api

Requirements

PHP 5.4.x cURL WooCommerce 2.2 at least on the store

Getting started

Generate API credentials (Consumer Key & Consumer Secret) under WP Admin > Your Profile.

Setup the library

use WIC/Client;

$options = array(
    'ssl_verify'      => false,
);

try {

	$client = new Client( 'http://your-store-url.com', $consumer_key, $consumer_secret, $options );

} catch ( ClientException $e ) {

	echo $e->getMessage() . PHP_EOL;
	echo $e->getCode() . PHP_EOL;

	if ( $e instanceof ClientHTTPException ) {

		print_r( $e->get_request() );
		print_r( $e->get_response() );
	}
}

Options

• debug (default false) - set to true to add request/response information to the returned data. This is particularly useful for troubleshooting errors.

• return_as_array (default false) - all methods return data as a stdClass by default, but you can set this option to true to return data as an associative array instead.

• validate_url (default false) - set this to true to verify that the URL provided has a valid, parseable WC API index, and optionally force SSL when supported.

• timeout (default 30) - set this to control the HTTP timeout for requests.

• ssl_verify (default true) - set this to false if you don't want to perform SSL peer verification for every request.

Error handling

Exceptions are thrown when errors are encountered, most will be instances of ClientHTTPException which has two additional methods, get_request() and get_response() -- these return the request and response objects to help with debugging.

Methods

Index

• $client->index->get() - get the API index

Orders

• $client->orders->get() - get a list of orders
• $client->orders->get( null, array( 'status' => 'completed' ) ) - get a list of completed orders
• $client->orders->get( $order_id ) - get a single order

Credit

Copyright (c) 2013-2015 - Web In Color, Gerhard Potgieter, Max Rice and other contributors

License

Released under the GPL3 license