README

Important

This library/repository is deprecated since November 6, 2024, for a more up-to-date library/repository please see https://github.com/pronamic/wp-twinfield.

Documentation

• Twinfield API

Examples

See the examples/ directory for examples of the key client features. You can view them in your browser by running the php built-in web server.

$ php -S localhost:8000 -t examples/

And then browsing to the host and port you specified (in the above example, http://localhost:8000).

Environment variables

export TWINFIELD_USER=
export TWINFIELD_PASSWORD=
export TWINFIELD_ORGANISATION=
export TWINFIELD_OFFICE_CODE=
export TWINFIELD_ARTICLE_CODE=
export TWINFIELD_SUBARTICLE_CODE=
export TWINFIELD_CUSTOMER_CODE=
export TWINFIELD_SALES_INVOICE_TYPE=
export TWINFIELD_SALES_INVOICE_NUMBER=

Travis CI

travis encrypt TWINFIELD_USER=$TWINFIELD_USER --add env.global
travis encrypt TWINFIELD_PASSWORD=$TWINFIELD_PASSWORD --add env.global
travis encrypt TWINFIELD_ORGANISATION=$TWINFIELD_ORGANISATION --add env.global
travis encrypt TWINFIELD_OFFICE_CODE=$TWINFIELD_OFFICE_CODE --add env.global
travis encrypt TWINFIELD_ARTICLE_CODE=$TWINFIELD_ARTICLE_CODE --add env.global
travis encrypt TWINFIELD_CUSTOMER_CODE=$TWINFIELD_CUSTOMER_CODE --add env.global
travis encrypt TWINFIELD_SALES_INVOICE_TYPE=$TWINFIELD_SALES_INVOICE_TYPE --add env.global
travis encrypt TWINFIELD_SALES_INVOICE_NUMBER=$TWINFIELD_SALES_INVOICE_NUMBER --add env.global

Debug PHP SOAP

var_dump( $this->get_wsdl_url() );
var_dump( $this->soap_client->__getFunctions() );
var_dump( $this->soap_client->__getTypes() );

try {
	$test = $this->soap_client->Query( $test );
} catch ( \Exception $e ) {
	var_dump( $e );
}

echo "REQUEST:\n" . $this->soap_client->__getLastRequest() . "\n";

To-do

$client = new Client(
	$client_id,
	$client_secret,
	$redirect_uri
);

$client->set_access_token( ... );

if ( $client->is_access_token_expired() ) {
	
}

$authentication = {}

$authentication->get_user();

$authentication->get_user()->get_organisation();

$authentication->get_organisation();

$authentication->get_cluster_url();

$authentication->get_organisation()->get_offices();

$client = $authentication->get_client();

$client->get_organisation_service();

$offices = $organisation_service->get_offices();

Inspiration

• https://github.com/KnpLabs/php-github-api
• https://github.com/J7mbo/twitter-api-php
• https://github.com/galen/PHP-Instagram-API
• https://github.com/drewm/mailchimp-api
• https://github.com/Happyr/LinkedIn-API-client
• https://github.com/okwinza/cloudflare-api
• https://github.com/jcroll/foursquare-api-client
• https://github.com/googleapis/google-api-php-client
• https://developers.google.com/gmail/api/quickstart/php

Design Patterns

• https://en.wikipedia.org/wiki/Interpreter_pattern

Other

• http://www.accountingcoach.com/blog/accounts-payable-accounts-receivable
• http://blog.fedecarg.com/2009/03/12/domain-driven-design-and-data-access-strategies/
• http://stackoverflow.com/questions/3056447/design-pattern-for-loading-multiple-message-types
• http://www.servicedesignpatterns.com/requestandresponsemanagement/datatransferobject
• http://stackoverflow.com/questions/29592216/how-should-i-store-metadata-in-an-object
• https://secure.php.net/soundex