smhg / salutation-php

Salutation generator

salutation

Generates a salutation based on predefined formats.

Use case

In e-mails, dashboards and others, you often want to start with a personalised greeting. This might be to multiple people, of which you might have complete, partial or no names available. Some might have titles which are to be used when adressing them. And things might differ across locales.

As an example, you might need to greet a list of 3 users: one is a regular person (Joe Bloggs), one is a company without a contact's name (ACME) and one a physician/doctor (Jane Smith). First name concatenation would lead to:

Dear Joe, , Jane,

While what you want is:

Dear Joe, Dr. Smith,

Installation

composer require smhg/salutation

Usage

use Salutation;

$salutation = new Salutation('nl_BE', array(
	array(
		'first' => 'Jan',
		'last' => 'Jansens'
	),
	array(
		'title' => 'Dr.',
		'first' => 'Peter',
		'last' => 'Peters'
	)
));

echo $salutation;
// Beste Jan, Dr. Peters,

Features

• Locale aware formatting
• Title based formatting
• Nameless greeting

salutation-php's Issues

string generation for multiple names does not ignore empty names

new Salutation('nl_BE', array(
    array(
        'title' => '',
        'first' => '',
        'last' => ''
    ),
    array(
        'title' => 'Dr.',
        'first' => 'Peter',
        'last' => 'Peters'
    )
));

Results in Beste , Dr. Peters,, which should be Beste Dr. Peters,.

include organisations

custom greeting

include gender