plugin sylius

Lyra Collect pour Sylius

Lyra Collect for Sylius est un plugin open source qui relie les sites e-commerce basés sur Sylius à la passerelle de paiement sécurisée Lyra Collect développée par Lyra Network.

Installation et mise à niveau

Avec le compositeur

• Exigez le plugin avec composer en utilisant la commande suivante :

 composer require lyranetwork/sylius-lyranetwork-plugin dev-lyra

• Ajoutez la ligne suivante dans le fichier bundles.php situé dans [sylius-root]/config/ :

 LyranetworkLyraLyranetworkLyraPlugin::class => ['all' => true],

• Ajoutez les routes Lyra dans le fichier routes.yaml situé dans [sylius-root]/config/ :

 sylius_lyra :
   resource : " @LyranetworkLyraPlugin/Resources/config/routing.yaml "

• Ajoutez les rappels Lyra dans le fichier _ sylius.yaml situé dans [sylius-root]/config/packages :

 winzou_state_machine :
  sylius_payment :
    callbacks :
      after :
        custom_action :
          on : ["process", "authorize", "complete"]
          do : ["@lyranetworklyra.order_service", "sendConfirmationEmail"]
          args : ["object"]

• Ajoutez les services Lyra dans le fichier services.yaml situé dans [sylius-root]/config :

 services:
[...]
    lyranetworklyra.order_service:
      class: LyranetworkLyraServiceOrderService
      public: true

• Videz le cache de chargement automatique à l'aide de la commande suivante :

 composer dump-autoload

Prudent

• Ajoutez les modèles remplacés. Si vous avez déjà remplacé l'un des fichiers suivants, vous devez le fusionner avec le nôtre. Vous les trouverez dans le répertoire LyranetworkLyra/Resources/views/bundles/.

 SyliusAdminBundlePaymentMethod_form.html.twig
SyliusAdminBundleOrderShow_payment.html.twig
SyliusShopBundleCheckoutSelectPayment_choice.html.twig
SyliusUiBundleFormtheme.html.twig

• Sinon, copiez-les simplement avec la commande suivante :

 cp -R vendor/lyranetwork/sylius-lyranetwork-plugin/LyranetworkLyra/Resources/views/bundles/* templates/bundles/

• Videz le cache avec la commande suivante :

 php bin/console cache:clear

Le plugin devrait désormais être disponible dans la liste des modes de paiement que vous pouvez créer.

Avec le fichier zip du plugin

• Décompressez le module dans votre dossier racine Sylius.
• Ajoutez dans le fichier [sylius-root]/composer.json , dans autoload psr-4 la ligne suivante :

 "Lyranetwork\Lyra\": "LyranetworkLyra/src/"

• Ajoutez la ligne suivante dans le fichier bundles.php situé dans [sylius-root]/config/ :

 LyranetworkLyraLyranetworkLyraPlugin::class => ['all' => true],

• Ajoutez les routes Lyra dans le fichier routes.yaml situé dans [sylius-root]/config/ :

 sylius_lyra :
   resource : " @LyranetworkLyraPlugin/Resources/config/routing.yaml "

• Ajoutez les rappels Lyra dans le fichier _ sylius.yaml situé dans [sylius-root]/config/packages :

 winzou_state_machine :
  sylius_payment :
    callbacks :
      after :
        custom_action :
          on : ["process", "authorize", "complete"]
          do : ["@lyranetworklyra.order_service", "sendConfirmationEmail"]
          args : ["object"]

• Ajoutez les services Lyra dans le fichier services.yaml situé dans [sylius-root]/config :

 services:
[...]
    lyranetworklyra.order_service:
      class: LyranetworkLyraServiceOrderService
      public: true

• Videz le cache de chargement automatique à l'aide de la commande suivante :

 composer dump-autoload

Prudent

• Ajoutez les modèles remplacés. Si vous avez déjà remplacé l'un des fichiers suivants, vous devez le fusionner avec le nôtre. Vous les trouverez dans le répertoire LyranetworkLyra/Resources/views/bundles/.

 SyliusAdminBundlePaymentMethod_form.html.twig
SyliusAdminBundleOrderShow_payment.html.twig
SyliusShopBundleCheckoutSelectPayment_choice.html.twig
SyliusUiBundleFormtheme.html.twig

• Sinon, copiez-les simplement avec la commande suivante :

 cp -R LyranetworkLyra/Resources/views/bundles/* templates/bundles/

• Ouvrez la ligne de commande dans le répertoire racine de Sylius et exécutez les commandes suivantes pour extraire les traductions du plugin :

 php bin/console translation:extract en LyranetworkLyraPlugin --dump-messages
php bin/console translation:extract fr LyranetworkLyraPlugin --dump-messages
php bin/console translation:extract es LyranetworkLyraPlugin --dump-messages
php bin/console translation:extract de LyranetworkLyraPlugin --dump-messages
php bin/console translation:extract pt LyranetworkLyraPlugin --dump-messages
php bin/console translation:extract br LyranetworkLyraPlugin --dump-messages

• Videz le cache avec la commande suivante :

 php bin/console cache:clear

Le plugin devrait désormais être disponible dans la liste des moyens de paiement que vous pouvez créer.

Configuration

Dans l'interface d'administration de Sylius :

• Allez dans Configuration > Payment methods .
• Cliquez sur le bouton Create en haut à droite de la page pour afficher la liste des modes de paiement disponibles.
• Choisissez Payment by Lyra Collect pour l'ajouter et le configurer.
• Vous pouvez désormais saisir vos identifiants Lyra Collect et configurer votre mode de paiement.
• N'oubliez pas de donner un code à votre moyen de paiement, de définir le nom dans les sections de langue en bas et de sauvegarder en cliquant sur le bouton Create .

Désinstallation

Avec le compositeur

 composer remove lyranetwork/sylius-lyranetwork-plugin

Avec le fichier zip du module

• Supprimez le dossier LyranetworkLyra dans votre dossier racine Sylius
• Supprimez dans le fichier sylius/composer.json , dans autoload psr-4 la ligne :

 "Lyranetwork\Lyra\": "LyranetworkLyra/src/"

Supprimer et annuler les modifications

• Supprimez la ligne suivante du fichier bundles.php situé dans [sylius-root]/config/ :

 LyranetworkLyraLyranetworkLyraPlugin::class => ['all' => true],

• Supprimez les routes Lyra dans le fichier routes.yaml situé dans [sylius-root]/config/

 sylius_lyra :
    resource : " @LyranetworkLyraPlugin/Resources/config/routing.yaml "

• Supprimez les rappels Lyra dans le fichier _ sylius.yaml situé dans [sylius-root]/config/packages :

 winzou_state_machine :
  sylius_payment :
    callbacks :
      after :
        custom_action :
          on : ["process", "authorize", "complete"]
          do : ["@lyranetworklyra.order_service", "sendConfirmationEmail"]
          args : ["object"]

• Supprimez les services Lyra dans le fichier services.yaml situé dans [sylius-root]/config :

 services:
[...]
    lyranetworklyra.order_service:
      class: LyranetworkLyraServiceOrderService
      public: true

• Supprimez ou annulez la fusion de tous les fichiers de modèles ajoutés dans templates/bundles/

 SyliusAdminBundlePaymentMethod_form.html.twig
SyliusAdminBundleOrderShow_payment.html.twig
SyliusShopBundleCheckoutSelectPayment_choice.html.twig
SyliusUiBundleFormtheme.html.twig

• Ouvrez la ligne de commande dans le répertoire racine de Sylius et exécutez les commandes suivantes :

 composer dump-autoload
php bin/console cache:clear

Licence

Chaque fichier source du module de paiement Lyra Collect inclus dans cette distribution est sous licence The MIT License (MIT).

Veuillez consulter LICENSE.txt pour le texte intégral de la licence MIT. Il est également disponible sur le Web à cette URL : https://opensource.org/licenses/mit-license.html.