FAQ d'installation WooCommerce

Questions

J'ai bien configuré Alma, mais rien ne s'affiche

  • Vérifiez tout d'abord que vous respectez bien les prérequis énoncés en haut de page
  • Vérifiez la devise utilisée pour votre boutique : Alma n'est disponible que pour les paiements en Euros, et sera donc désactivé si la devise de la boutique est différente
  • Vérifiez la langue de votre boutique ou de WordPress : par défaut, Alma sera désactivé pour toute langue autre que le Français (locales fr_FR, fr_BE, etc.).
    Voir ci-après pour activer Alma sur d'autres langues.

Comment activer Alma pour une autre langue que le Français ?

L'extension Alma utilise un filtre pour donner la main aux développeurs sur l'activation ou non de l'extension en fonction d'une langue donnée.

Pour exploiter ce filtre, suivez les étapes suivantes :

  • Dans le répertoire <installation wordpress>/wp-content/plugins, créez un répertoire "alma-lang"
  • Créez le fichier <installation wordpress>/wp-content/plugins/alma-lang/alma-lang.php
  • Dans ce fichier, copiez le contenu suivant :
<?php
/**
 * Plugin Name: Alma Language Override
 */
function alma_language_override($enable, $locale) {
    // Editez cette ligne //
    $extra_alma_languages = array( 'en_US' );
    if ( in_array( $locale, $extra_alma_languages, true ) ) {
        return true;
    }
  return $enable;
}
add_filter('alma_wc_enable_for_locale', 'alma_language_override', 10, 2);

Ce code vous permet de rajouter une ou plusieurs langues pour lesquelles activer Alma.
Vous devrez remplacer les valeurs <LOCALE 1>, <LOCALE 2> (et potentiellement en rajouter, séparées par des virgules) par le code de langue que vous voulez activer.
Par exemple, pour activer Alma en Anglais (en plus du Français), la ligne à éditer devient :

$extra_alma_languages = array( 'en_US' );

Pour rajouter l'Anglais et l'Allemand :

$extra_alma_languages = array( 'en_US', 'de_DE' );

Référez-vous à la colonne "WordPress" locale de cette page pour trouver les codes à utiliser.

  • Une fois votre fichier enregistré sur votre serveur, rendez-vous dans le tableau de bord WordPress, sur la page des extensions installées.
  • Là, vous trouverez une nouvelle extension nommée "Alma Language Override" :
  • Cliquez sur "Activer" pour activer les nouvelles langues que vous avez choisies
  • Note : il est également possible d'ajouter ce code dans le fichier functions.php de votre thème

Comment changer la langue de la page de paiement Alma si la langue de votre site n'est pas prise en charge ?

Lorsque le client choisi son moyen de paiement sur la page de paiement Alma :

  • Si la langue de votre site est le français, la page de paiement Alma sera en français
  • Sinon, la page de paiement Alma sera en anglais

Vous pouvez toutefois surcharger ce comportement en ajoutant le code suivant dans un plugin dédié ou dans le fichier functions.php de votre thème :

/**
 * Override alma-woocommerce default payment locale
 *
 * @param string $locale the locale will be given to alam payment api
 *
 * @see https://getalma.eu/documentation/api-reference/#payment to check which lang are allowed in ALMA API
 */
function alma_payment_lang_override($locale) {
    if ($locale != 'fr') { // <= Edit this test

            return 'nl';
    }

  return $locale;
}
add_filter('alma_wc_checkout_payment_locale', 'alma_payment_lang_override', 10, 1);

Pour voir la liste des locales supportées par la page de paiement Alma, vous pouvez consulter la documentation suivants

Notes

En cas de difficultés ou de besoin plus spécifique lié aux langues, nous vous invitons à vous rapprocher du développeur ou de l'agence en charge de la maintenance de votre boutique, en les référant à cette page.

Nous ne sommes en effet pas en capacité de répondre aux demandes de développement sur mesure, chaque boutique ayant son propre contexte que votre développeur/agence sera plus à même de prendre en compte pour ce genre de personnalisation.


Did this page help you?