Download the PHP package eckinox/address-bundle without Composer

On this page you can find all versions of the php package eckinox/address-bundle. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.

FAQ

After the download, you have to make one include require_once('vendor/autoload.php');. After that you have to import the classes with use statements.

Example:
If you use only one package a project is not needed. But if you use more then one package, without a project it is not possible to import the classes with use statements.

In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
Some PHP packages are not free to download and because of that hosted in private repositories. In this case some credentials are needed to access such packages. Please use the auth.json textarea to insert credentials, if a package is coming from a private repository. You can look here for more information.

  • Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
  • To use Composer is sometimes complicated. Especially for beginners.
  • Composer needs much resources. Sometimes they are not available on a simple webspace.
  • If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
  • Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Please rate this library. Is it a good library?

Example code of eckinox/address-bundle

Informations about the package address-bundle

AddressBundle

Le AddressBundle offre la possibilité d'avoir des champs d'auto-complétion utilisant différentes API pour les formulaires contenant des adresses.

Installation du bundle

  1. Installez le bundle via Composer:

  2. Ajoutez le secret:

Remplacez INSERT_CHOSEN_API_NAME pour l'API choisi. Les API disponibles sont les suivantes: GOOGLE_PLACES, ADDRESS_COMPLETE.

Pour générer votre clé d'API, veuillez vous référer aux articles ci-dessous:

  1. Ajouter les routes:
    Créer un fichier eckinox_address.yaml dans le dossier config/routes contenant les lignes suivantes:

Comment utiliser Address Bundle

Créer l'entité

Tout d'abord, créer l'entité qui sera utilisée pour enregistrer les adresses. Pour ce faire, vous n'avez qu'à extend la classe abstraite fournie par le bundle comme suis:

Voici la liste des propriétés définies dans AbstractAddress:

Utiliser l'auto-complete dans les formulaires

Il y a deux manières d'utiliser les adresses dans vos formulaires:

Voici comment les utiliser:

AddressType

Pour utiliser le formulaire AddressAutocompleteType dans vos FormType, vous devez:

  1. Ajouter Eckinox\AddressBundle\Form\Type\AddressType; dans les use de votre formulaire où vous désirez l'afficher.
  2. Puis, utiliser AddressType et passer l'entité d'address désiré à l'aide du paramètre entry_options puis lui passer 'data_class' => MyAddressClass::class, (voir l'exemple ci-dessous).
  3. Ajouter, au besoin, l'API désiré avec l'option api, l'API de Poste Canada "Address Complete" sera utilisé par défaut.

AddressAutocompleteType

Pour utiliser le champ AddressAutocompleteType dans vos FormType, vous devez:

  1. Ajouter Eckinox\AddressBundle\Form\Type\AddressAutocompleteType dans vos use.
  2. Ajouter votre champ AddressAutocompleteType comme vous le feriez avec n'importe quel autre champ.
  3. Ajouter les paramètres désirés:
    1. Il est recommandé de désactiver l'autocomplete du champ pour éviter que les propositions du navigateur passent par-dessus les propositions d'autocomplete. Vous n'avez qu'à ajouter l'attribut suivant au champ: 'autocomplete' => uniqid('noautocomplete').
    2. Il est possible de passer un paramètre api pour choisir l'API à utiliser. Les choix disponibles sont: addressComplete ou googlePlaces. Si aucun API est spécifié, l'api de Poste Canada "Address Complete" sera utilisé par défaut.
    3. Ajouter, au besoin l'option parent qui sert à définir un sélecteur JS valide qui sera utilisé à la place du parentNode. Utile si vous voulez remplir les informations de l'autocomplete sur des champs qui ne sont pas à l'intérieur du parent immédiat. Exemple: .section-wrapper.geo.card

Voici un exemple:

  1. Une fois l'auto-complete ajouté au formulaire, il est possible d'utiliser l'event javascript populate-address pour remplir les champs avec les détails de l'adresse (qui se retrouvent dans event.detail). L'event est déclenché sur l'élément de row du formulaire, donc dans ce cas-ci, sur <tr>. Voici l'event listener utilisé par la liste par défaut qui peut être redéfini et ajusté pour vos besoins spécifiques:

Fonctionnement

Lorsqu'un champ de type AddressAutocompleteType est utilisé dans un formulaire, l'input classique est remplacé par un webcomponent d'autocomplete qui contient le champ utilisé pour la rechercher et la liste qui receveras les résultats de l'API.

Une fois qu'un choix est sélectionné, une autre requête à l'API est lancée et les détails de l'adresse sont retournés. Un event javascript est déclenché et les autres champs d'adresse sont alors remplis.

All versions of address-bundle with dependencies

PHP Build Version
Package Version
Requires php Version >=8.1.10
doctrine/orm Version ^2.19
symfony/form Version ^5.4|^6.0
symfony/framework-bundle Version ^5.4|^6.0
symfony/http-client Version ^5.4|^6.0
symfony/serializer Version ^5.4|^6.0
symfony/translation Version ^5.4|^6.0
symfony/validator Version ^5.4|^6.0
twig/twig Version ^3.8
Composer command for our command line client (download client) This client runs in each environment. You don't need a specific PHP version etc. The first 20 API calls are free. Standard composer command

The package eckinox/address-bundle contains the following files

Loading the files please wait ....