phil/contact-bundle

phil/contact-bundle amène les fiches de phil/contact dans Symfony. ContactCardType est un formulaire pour le nom, l'organisation et le titre d'une fiche, avec des collections de courriels, de lignes téléphoniques, d'adresses Web et d'identifiants de messagerie. Les utilisateurs ajoutent et retirent des entrées avec les boutons de son thème de formulaire, pilotés par un contrôleur Stimulus. Les entrées vides sont écartées, et une entrée incorrecte rend son propre champ invalide. Sur demande, le formulaire demande aussi le nom d'une personne en ses parties, par PersonNameType, qu'une culture ordonne et trie. Le bundle enregistre aussi le type de colonne Doctrine phil_contact, qui conserve une fiche dans une seule colonne JSON. VCardResponse envoie une fiche en pièce jointe .vcf et JSContactResponse en JSContact, et le lecteur JSContact est un service pour les importations. Les fonctions Twig contact_vcard et contact_json_ld écrivent une fiche en vCard ou en JSON-LD schema.org, comme nœud du graphe de la page lorsque phil/structured-data-bundle en rassemble un, et person_name écrit un nom tel qu'il s'affiche ou se trie. Les libellés et les messages sont en anglais et en français.

Il s'adresse aux applications Symfony où un rédacteur ou un administrateur saisit les coordonnées d'une personne ou d'une organisation, et où les visiteurs les téléchargent ou les moteurs de recherche les lisent. Les champs de téléphone, d'adresse Web et d'identifiant de messagerie viennent de phil/phone-bundle, phil/url-bundle et phil/instant-messenger-bundle. Le formulaire accepte ce que ces paquets acceptent, et ses options limitent les genres d'adresses Web et les services de messagerie offerts.

Hors de Symfony, ou pour la fiche seule, utilisez phil/contact. Le bundle est une mince couche au-dessus : les transformateurs de formulaire, le type de colonne et l'extension Twig font chacun la traduction entre Symfony et les types-valeurs de la bibliothèque.

État

Documentation

Démarrage rapide

composer require phil/contact-bundle

#[ORM\Column(type: 'phil_contact', nullable: true)]
private ?ContactCard $contact = null;

$builder->add('contact', ContactCardType::class, ['structured_name' => true]);

{{ contact_json_ld(shop.contact) }}
{{ person_name(shop.contact, 'sort') }}

Prérequis

PHP 8.5 ou plus récent ; phil/contact, phil/phone-bundle, phil/url-bundle et phil/instant-messenger-bundle 0.1 ; symfony/dependency-injection, symfony/form et symfony/options-resolver 8.2 ou plus récent. Doctrine DBAL, HttpFoundation et Twig sont facultatifs.

Contribuer

Les contributions sont les bienvenues sur le monodépôt PHIL : lisez le guide de contribution et le code de conduite. Signalez une vulnérabilité en privé, comme l'explique la politique de sécurité, jamais dans un ticket public.

Licence

MIT, © Philippe Gamache, doing business as Le Gnome Archiviste; a Parler Haut Interagir Librement project. Voir LICENSE.