add has_name parameter for translations

Author: koertho

CHANGELOG.md

@@ -2,6 +2,9 @@
 
 All notable changes to this project will be documented in this file.
 
+## [0.1.4] - 2026-06-19
+- Added: has_name translation parameter including default translations if no name is present 
+
 ## [0.1.3] - 2026-06-19
 - Added: String and Array name parser ([#1](https://github.com/heimrichhannot/salutation-creator/pull/1))
 

README.md

@@ -235,6 +235,7 @@ The following parameters are available in translations:
 - `%name%` - Full name
 - `%formal_name%` - Formal name (usually last name)
 - `%given_name%` - First name
+- `%has_name%` - Containing yes if a name is available, otherwise no. Can be used for conditional translations based on the presence of a name.
 
 
 ## Available (bundled) Classes

src/SalutationCreator.php

@@ -35,6 +35,7 @@ public function generate(SalutationContext $context): string
             '%name%' => $context->getName()?->getFullName() ?? '',
             '%formal_name%' => $context->getName()?->getFormalName() ?? '',
             '%given_name%' => $context->getName()?->getGivenName() ?? '',
+            '%has_name%' => $context->getName() === null ? 'no' : 'yes',
         ];
 
         return trim($this->translator->trans(

translations/salutation_creator+intl-icu.de.yaml

@@ -1,8 +1,11 @@
 format.formal: >
-  {gender, select,
-    m {Sehr geehrter {gender_name} {prefix_titles} {formal_name} {suffix_titles}}
-    f {Sehr geehrte {gender_name} {prefix_titles} {formal_name} {suffix_titles}}
-    other {Sehr geehrte*r {prefix_titles} {name} {suffix_titles}}
+  {has_name, select,
+    yes {{gender, select,
+      m {Sehr geehrter {gender_name} {prefix_titles} {formal_name} {suffix_titles}}
+      f {Sehr geehrte {gender_name} {prefix_titles} {formal_name} {suffix_titles}}
+      other {Sehr geehrte*r {prefix_titles} {formal_name} {suffix_titles}}
+    }}
+    other {Sehr geehrte Damen und Herren}
   }
 format.informal: 'Hallo {given_name}'
 

translations/salutation_creator+intl-icu.en.yaml

@@ -1,8 +1,11 @@
 format.formal: >
-  {gender, select,
-    m {Dear {gender_name} {prefix_titles} {formal_name} {suffix_titles}}
-    f {Dear {gender_name} {prefix_titles} {formal_name} {suffix_titles}}
-    other {Dear {prefix_titles} {name} {suffix_titles}}
+  {has_name, select,
+    yes {{gender, select,
+      m {Dear {gender_name} {prefix_titles} {formal_name} {suffix_titles}}
+      f {Dear {gender_name} {prefix_titles} {formal_name} {suffix_titles}}
+      other {Dear {prefix_titles} {name} {suffix_titles}}
+    }}
+    other {Dear Sir or Madam}
   }
 format.informal: 'Hello {given_name}'