Module OAuth Google – PrestaShop 8.2

Documentation d’installation

Module OAuth Google pour PrestaShop 8.2

---

📋 Table des matières

1. Prérequis
2. Installation du module
3. Configuration Google Cloud Console
4. Configuration dans PrestaShop
5. Test et validation
6. Dépannage
7. Support

---

1. Prérequis {#prerequis}

Configuration minimale requise

• PrestaShop : Version 8.0.0 à 8.99.99
• PHP : Version 7.4, 8.0, 8.1 ou 8.2
• SSL : Certificat SSL actif (https://)
• Navigateurs : Chrome 90+, Firefox 88+, Safari 14+, Edge 90+

Accès nécessaires

• Accès administrateur PrestaShop
• Compte Google (pour créer le projet)
• Email pour recevoir les identifiants

---

2. Installation du module {#installation}

Étape 1 : Téléchargement

1. Téléchargez le fichier googleconnect.zip
2. Ne pas décompresser le fichier

Étape 2 : Upload dans PrestaShop

1. Connectez-vous à votre back-office PrestaShop
2. Allez dans Modules > Gestionnaire de modules
3. Cliquez sur Installer un module (bouton en haut à droite)
4. Glissez le fichier ZIP ou cliquez pour sélectionner
5. Attendez la fin de l’upload

Étape 3 : Installation

1. Le module apparaît dans la liste
2. Cliquez sur Installer
3. Message de confirmation : « Module installé avec succès »

---

3. Configuration Google Cloud Console {#google-config}

Étape 1 : Créer un projet

1. Allez sur Google Cloud Console
2. Connectez-vous avec votre compte Google
3. Cliquez sur Sélectionner un projet > Nouveau projet
4. Nom du projet : « PrestaShop OAuth »
5. Cliquez sur Créer

Étape 2 : Activer l’API

1. Dans le menu, allez dans API et services > Bibliothèque
2. Recherchez « Google+ API » ou « People API »
3. Cliquez sur Activer

Étape 3 : Configurer l’écran de consentement

1. Menu API et services > Écran de consentement OAuth
2. Type d’utilisateur : Externe
3. Cliquez sur Créer
4. Remplissez :
   • Nom de l’application : Nom de votre boutique
   • Email d’assistance : Votre email
   • Logo : Logo de votre boutique (optionnel)
   • Domaines autorisés : votre-domaine.com
5. Cliquez sur Enregistrer et continuer
6. Scopes : Laissez par défaut
7. Utilisateurs test : Ajoutez votre email
8. Enregistrer

Étape 4 : Créer les identifiants

1. Menu API et services > Identifiants
2. Cliquez sur + Créer des identifiants > ID client OAuth
3. Type d’application : Application Web
4. Nom : « PrestaShop Google Connect »
5. URIs de redirection autorisés – IMPORTANT :
   https://votre-site.com/module/googleconnect/callback

   ⚠️ Remplacez votre-site.com par votre domaine

6. Cliquez sur Créer
7. Copiez :
   • Client ID : xxxxxxxxxxxx.apps.googleusercontent.com
   • Client Secret : GOCSPX-xxxxxxxxxxxx

---

4. Configuration dans PrestaShop {#prestashop-config}

Étape 1 : Accéder à la configuration

1. Back-office PrestaShop
2. Modules > Gestionnaire de modules
3. Recherchez « Google Connect »
4. Cliquez sur Configurer

Étape 2 : Saisir les identifiants

1. Activer Google Connect : OUI
2. Client ID : Collez l’ID copié depuis Google
3. Client Secret : Collez le Secret copié
4. Cliquez sur Enregistrer

Étape 3 : Vérifier l’affichage

1. Ouvrez votre boutique en navigation privée
2. Allez sur la page de connexion
3. Le bouton « Se connecter avec Google » doit apparaître

---

5. Test et validation {#test}

Test de connexion

1. Cliquez sur « Se connecter avec Google »
2. Fenêtre Google : Choisissez votre compte
3. Acceptez les permissions
4. Redirection vers votre boutique
5. Compte créé/connexion réussie ✓

Vérification du compte

1. Back-office > Clients
2. Le nouveau client apparaît
3. Email vérifié automatiquement
4. Nom et prénom récupérés

---

6. Dépannage {#depannage}

Erreur « 400: redirect_uri_mismatch »

Solution : Vérifiez l’URL de callback dans Google Console

• Doit être EXACTEMENT : https://votre-site.com/module/googleconnect/callback
• Attention au https (pas http)
• Pas de slash final

Bouton n’apparaît pas

Solutions :

1. Vérifiez que le module est activé
2. Videz le cache PrestaShop
3. Videz le cache navigateur
4. Vérifiez les hooks : displayCustomerLoginFormBefore

Erreur « 403: Forbidden »

Solution : Application en mode test

• Google Console > Écran de consentement
• Ajoutez des utilisateurs test OU
• Publiez l’application (après validation Google)

Page blanche après connexion

Solutions :

1. Activez le mode debug PrestaShop
2. Vérifiez les logs d’erreur
3. PHP version compatible ?
4. Permissions fichiers correctes (755/644)

---

7. Support {#support}

Support communautaire

• Documentation en ligne
• FAQ sur le site
• Forum PrestaShop

Support premium (45€/heure)

• Installation complète
• Débogage personnalisé
• Adaptations sur-mesure
• Contact : s.tuna@simpleagencewebcommunity.com

Informations module

• Version : 1.0.1
• Auteur : Songül TUNA
• License : Propriétaire
• Compatibilité : PS 8.0 – 8.99

---

Notes importantes

⚠️ Sécurité : Ne partagez JAMAIS votre Client Secret ⚠️ SSL obligatoire : Google refuse les connexions non-https ⚠️ RGPD : Informez vos clients de l’utilisation de Google ⚠️ Backup : Sauvegardez avant installation

---

Documentation mise à jour : Janvier 2025 © Simple Créa Web & Community

💡 Questions fréquentes

Compatible PrestaShop 1.7 ? Non, ce module est optimisé pour PrestaShop 8.x uniquement.

Faut-il payer Google ? Non, l’API Google est gratuite jusqu’à 1 million de connexions/mois.

Installation incluse ? Non, mais la documentation permet une installation autonome en 15 minutes.

Support disponible ? Support premium disponible en option à 45€/heure.

Important

• Support technique NON inclus dans le prix de base
• Installation à votre charge (guide détaillé fourni)
• Mises à jour garanties 6 mois
• Code source non chiffré : personnalisation possible

Caractéristiques techniques

• Version PrestaShop : 8.0.0 à 8.99.99
• Version PHP : 7.4 à 8.2
• Développeur : Songül TUNA
• Version module : 1.0.1
• Dernière mise à jour : Janvier 2025

Contenu du package

• Module complet (fichiers PHP, TPL, JS, CSS)
• Documentation d’installation (PDF)
• Guide de configuration Google Cloud Console
• Captures d’écran pas à pas
• Support par email pendant 6 mois

🛠️ Installation facile

1. Téléchargez le fichier ZIP
2. Uploadez dans PrestaShop (Modules > Gestionnaire de modules)
3. Configurez vos identifiants Google (guide inclus)
4. Activez et c’est prêt !

Temps d’installation estimé : 15 minutes

⚙️ Prérequis

• PrestaShop 8.2 (compatible 8.0 à 8.99)
• Compte Google Cloud Console (gratuit)
• SSL activé sur votre boutique
• Accès au back-office PrestaShop