Download the PHP package talanoff/laravel-wubook without Composer

Laravel WuBook

Laravel WuBook was created by, and is maintained by Filippo Galante, and is a WuBook Wired API bridge for Laravel 5. Feel free to check out the contribution guidelines. In order to use the API you have to request a provider key by sending an E-Mail at [email protected], in order to connect your WuBook account, and you'll be free to try all its features.

Installation

Either PHP 5.5+ or HHVM 3.6+ are required.

To get the latest version of Laravel WuBook, simply require the project using Composer:

Instead, you may of course manually update your require block and run composer update if you so choose:

The package uses the fxmlrpc client to make a call to the Wired API service. The standard dependencies are used to create the HTTP client and message, feel free to create a pull request in order to add new features.

Once Laravel WuBook is installed, you need to register the service provider. Open up config/app.php and add the following to the providers key.

You can register the WuBook facade in the aliases key of your config/app.php file if you like.

Configuration

Laravel WuBook requires connection configuration.

Create a config/wubook.php file in your app that you can modify to set your configuration. Also, make sure you check for changes to the original config file in this package between releases.

Account parameters

The lcode parameter is a property ID provided by WuBook and you can find it the main control panel within the profile management section.

The provider_key is released by the WuBook development team and if you need to create a new key associated with your WuBook account, please write an E-Mail at [email protected].

cache_token parameter

If cache_token parameter is set to true, all the API function will use a cached value and automatically renew it if necessary. If you need to retrieve the current token, call the method

The package will store also a 'wubook.token.ops' key, in order to trace the number of calls made with current token, in order to refresh it if the maximum number of operation has been reached.

Attention: If cache_token is set to false, the package will not check if the token has exceeded the maximum number of operations!

The values stored inside the cache will expire after 3600 seconds and if the cache_token parameter is set to true it will be automatically renewed. Please read http://tdocs.wubook.net/wired/policies.html

Usage

WuBookManager

This is the class of most interest. It is bound to the ioc container as 'wubook' and can be accessed using the Facades\WuBook facade. In order to make a call to the Wired API, you may call these methods that refers to a specific area of the service.

• auth(): please read the authentication documentation
• availability(): please read the availabity documentation
• cancellation_policies(): please read the cancellation policies documentation
• channel_manager(): please read the channel manager documentation
• corporate_functions(): please read the corporate functions documentation
• extras(): please read the extras documentation
• prices(): please read the prices documentation
• reservations(): please read the reservations documentation (fetching, handling)
• restrictions(): please read the restrictions documentation
• rooms(): please read the rooms documentation
• transactions(): please read the transactions documentation

Facades\WuBook

This facade will dynamically pass static method calls to the 'wubook' object in the ioc container which by default is the WuBookManager class.

WuBookServiceProvider

This class contains no public methods of interest. This class should be added to the providers array in config/app.php. This class will setup ioc bindings.

WuBook API methods results

The fxmlrpc client always returns an associative array, that may be changed by the package in order to retrieve the resulting data from the XML/RPC function.

If an error occured during the call, a WuBookException will be thrown. If the call is successfully executed (see http://tdocs.wubook.net/wired/return.html) an array will be returned with this values:

Only the WuBookAuth API returns different values for a successful call:

Real Examples

Here you can see an example of just how simple this package is to use. Out of the box, the default cache_token parameter is set to false so:

If you prefer to use dependency injection over facades like me, then you can easily inject the manager like so:

For more information on how to use the \LaravelWubook\WuBookManager class we are calling behind the scenes here, check out the Wired API doc.

Further Information

There are other classes in this package that are not documented here. This is because they are not intended for public use and are used internally by this package.

Security

If you discover a security vulnerability within this package, please send an e-mail to Filippo Galante at [email protected]. All security vulnerabilities will be promptly addressed.

License

Laravel WuBook is licensed under The MIT License (MIT).