heidelpay/php-customer-messages

This package is abandoned and no longer maintained. The author suggests using the heidelpay/php-message-code-mapper package instead.

A libary for heidelpay messages.

17.10.11 2017-10-11 11:35 UTC

This package is auto-updated.

Last update: 2019-02-20 19:44:59 UTC


README

Latest Version on Packagist Coverage Status Build Status Codacy Badge

Logo

heidelpay Customer Messages

ATTENTION: This package is abandoned and replaced by heidelpay/php-message-code-mapper.

This library provides user-friendly output of (error)-messages coming from the heidelpay API.

1. Installation

Composer

composer require heidelpay/php-customer-messages

manual Installation

Download the latest release from github and unpack it into a folder of your choice inside your project.

2. Implementation

Composer

require_once 'path/to/autoload.php;
use Heidelpay\CustomerMessages\CustomerMessage;

manual Installation

require_once 'path/to/php-customer-messages/lib/CustomerMessage.php';

Of course, the path needs to match the path from step 1.

3. Usage

Assuming you have received an error code from one of our modules or the heidelpay PHP API and stored it in a variable called $errorcode. To get a message from that code, create a CustomerMessage instance:

$instance = new \Heidelpay\CustomerMessages\CustomerMessage('de_DE');

The constructor takes two (optional) arguments:

  1. The locale (e.g. 'en_US', 'de_DE')
  2. The path to the locales path (for example you want to use your own locale files) containing the .csv files with the codes and messages.

We provide 'de_DE' and 'en_US' locale files with this package. You can find them in the lib/locales folder. If you want to use one of these, the path doesn't need to be provided in the constructor.

By default, 'en_US' is used as the locale.

Now you can return or print out the message by calling the getNessage() method:

return $instance->getMessage($errorcode); echo $instance->getMessage($errorcode);

Error codes are accepted in either the 'XXX.XXX.XXX' or 'HP-Error-XXX.XXX.XXX' format.