Skip to content
This repository has been archived by the owner on Mar 29, 2022. It is now read-only.

For any issues or questions please get in touch with us support@heidelpay.com

License

Notifications You must be signed in to change notification settings

heidelpay/php-customer-messages

Repository files navigation

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.