# Jokko ChatBot - Plugin WordPress

Plugin WordPress officiel pour intégrer facilement le widget ChatBot Jokko sur votre site WordPress.

## Description

Jokko ChatBot est un plugin qui permet d'ajouter rapidement et simplement le widget de chatbot intelligent Jokko à n'importe quel site WordPress. Le chatbot utilise l'intelligence artificielle pour répondre automatiquement aux questions des visiteurs 24/7 et qualifier les leads.

## Fonctionnalites

- **Installation pre-configuree** : Telechargez le plugin avec vos identifiants deja configures
- **Configuration simple** : Interface d'administration intuitive dans WordPress
- **Gestion des identifiants** : Modifiez facilement ChatBot ID et Tenant ID
- **Activation/Désactivation** : Contrôle facile de l'affichage du widget
- **Performance optimisée** : Chargement asynchrone du script widget
- **Responsive** : Fonctionne parfaitement sur tous les appareils
- **Multilingue** : Support francais et anglais (pret pour traductions)
- **Sécurisé** : Validation et sanitization de toutes les entrées

**Note** : L'apparence du widget se configure directement dans votre tableau de bord Jokko.

## 🚀 Installation

### Méthode 1 : Installation pré-configurée depuis Jokko (recommandée)

1. Connectez-vous à votre tableau de bord [jokko.chat](https://jokko.chat)
2. Accédez à la page de configuration de votre chatbot
3. Cliquez sur le bouton **"Télécharger le plugin WordPress"**
4. Le plugin sera téléchargé avec vos identifiants déjà configurés
5. Dans WordPress, allez dans **Extensions > Ajouter > Téléverser une extension**
6. Choisissez le fichier ZIP téléchargé et cliquez sur **Installer maintenant**
7. Activez le plugin

Le plugin sera automatiquement configuré avec vos identifiants !

### Méthode 2 : Installation manuelle via WordPress

1. Téléchargez le dossier `jokko-chatbot` complet
2. Compressez-le en fichier ZIP
3. Dans WordPress, allez dans **Extensions > Ajouter**
4. Cliquez sur **Téléverser une extension**
5. Choisissez le fichier ZIP et cliquez sur **Installer maintenant**
6. Activez le plugin
7. Configurez manuellement vos identifiants dans **Réglages > Jokko ChatBot**

### Méthode 3 : Installation manuelle via FTP

1. Téléchargez le dossier `jokko-chatbot`
2. Uploadez le dossier dans `/wp-content/plugins/`
3. Dans WordPress, allez dans **Extensions**
4. Activez le plugin "Jokko ChatBot"
5. Configurez manuellement vos identifiants dans **Réglages > Jokko ChatBot**

## ⚙️ Configuration

### Configuration automatique (si téléchargé depuis Jokko)

Si vous avez téléchargé le plugin depuis votre tableau de bord Jokko, vos identifiants sont déjà configurés ! Il vous suffit de :

1. Activer le plugin dans WordPress
2. Vérifier les paramètres dans **Réglages > Jokko ChatBot**
3. Le widget s'affichera automatiquement sur votre site

### Configuration manuelle

Si vous avez installé le plugin manuellement :

1. Dans WordPress, allez dans **Réglages > Jokko ChatBot**
2. Remplissez les champs requis :
   - **ChatBot ID** : L'identifiant unique de votre chatbot (format GUID)
   - **Tenant ID** : L'identifiant de votre tenant Jokko (format GUID)
3. (Optionnel) Personnalisez :
   - **API URL** : URL de l'API (par défaut : `https://api.jokko.chat`)
4. Cochez **Activer le widget** pour l'afficher sur votre site
5. Cliquez sur **Enregistrer les paramètres**

**Important** : Pour personnaliser l'apparence du widget (position, couleurs, messages), connectez-vous à votre tableau de bord Jokko.

## 🔧 Obtenir vos identifiants

## Services externes

Ce plugin charge le widget Jokko depuis https://api.jokko.chat quand il est active sur le site.

Lorsqu'une page charge le widget ou qu'un visiteur engage une conversation, le navigateur du visiteur peut transmettre a Jokko son adresse IP, des metadonnees navigateur, l'URL de page, le referer, les messages echanges et toute donnee saisie dans le chat.

Conditions d'utilisation : https://jokko.chat/legal/terms
Politique de confidentialite : https://jokko.chat/legal/privacy

Pour obtenir vos identifiants ChatBot ID et Tenant ID :

1. Connectez-vous à [jokko.chat](https://jokko.chat)
2. Accédez à votre tableau de bord
3. Sélectionnez votre chatbot
4. Allez dans la section "Widget" ou "Intégration"
5. Téléchargez le plugin WordPress pré-configuré OU copiez les identifiants affichés

## 🔐 Fichier de Configuration (pour développeurs)

Le plugin supporte un fichier de configuration optionnel `config.php` qui permet de pré-configurer les identifiants :

```php
<?php
return array(
    'chatbot_id' => 'd63ff3ce-1461-4d36-8a95-63ea7a7a1514',
    'tenant_id' => '0f87c4b2-6e44-4d5c-8e2e-1e3bcb5f9dd1',
    'api_url' => 'https://api.jokko.chat',
);
```

Ce fichier est automatiquement généré lorsque vous téléchargez le plugin depuis Jokko. Pour une installation manuelle, vous pouvez créer ce fichier en copiant `config.php.example` vers `config.php`.

## 🎨 Personnalisation du Widget

La personnalisation de l'apparence du widget (position, couleurs, messages de bienvenue, taille, etc.) se fait directement dans votre **tableau de bord Jokko** :

1. Connectez-vous à [jokko.chat](https://jokko.chat)
2. Accédez à la configuration de votre chatbot
3. Utilisez l'éditeur visuel pour personnaliser :
   - Position du widget (4 coins disponibles)
   - Couleurs (primaire, accent, arrière-plan)
   - Messages de bienvenue
   - Avatar et nom du bot
   - Déclencheurs automatiques

Les modifications sont appliquées instantanément sur votre site WordPress !

## 📁 Structure du plugin

```
jokko-chatbot/
├── jokko-chatbot.php          # Fichier principal du plugin
├── readme.txt                  # Description WordPress.org
├── README.md                   # Ce fichier
├── assets/
│   ├── css/
│   │   └── admin.css          # Styles admin
│   ├── js/                    # Scripts (vide pour l'instant)
│   └── images/                # Images (logo, etc.)
├── languages/                 # Fichiers de traduction
│   ├── jokko-chatbot-fr_FR.po
│   └── jokko-chatbot-fr_FR.mo
├── admin/                     # Futurs fichiers admin
└── includes/                  # Futurs fichiers inclus
```

## 🔒 Sécurité

Le plugin suit les meilleures pratiques de sécurité WordPress :

- ✅ Vérification des permissions utilisateur
- ✅ Sanitization de toutes les entrées
- ✅ Échappement de toutes les sorties
- ✅ Validation des données
- ✅ Nonces pour les formulaires
- ✅ Prévention d'accès direct aux fichiers

## 🌍 Traductions

Le plugin est prêt pour la traduction et inclut les traductions françaises par défaut. Pour ajouter d'autres langues :

1. Utilisez les fichiers dans le dossier `languages/`
2. Créez de nouveaux fichiers `.po` et `.mo` pour votre langue
3. Utilisez un outil comme Poedit pour éditer les traductions

## 🔄 Mises à jour

### Version 1.0.0

- ✨ Version initiale
- ⚙️ Configuration ChatBot ID et Tenant ID
- 🎨 Personnalisation position et couleur
- 🔌 Activation/désactivation du widget
- 🌐 Support multilingue (FR/EN)

## 🛠️ Développement

### Prérequis

- WordPress 5.0+
- PHP 7.4+
- Compte Jokko actif

### Hooks disponibles

Le plugin ne fournit pas encore de hooks personnalisés, mais suit les standards WordPress pour permettre l'extensibilité.

### Contribuer

Les contributions sont les bienvenues ! Pour contribuer :

1. Fork le repository
2. Créez une branche feature (`git checkout -b feature/amélioration`)
3. Committez vos changements (`git commit -m 'Ajout d'une fonctionnalité'`)
4. Push vers la branche (`git push origin feature/amélioration`)
5. Ouvrez une Pull Request

## 📝 Roadmap

Fonctionnalités prévues pour les prochaines versions :

- [ ] Widget Gutenberg pour placement personnalisé
- [ ] Shortcode `[jokko-chatbot]` pour intégration dans le contenu
- [ ] Options avancées de personnalisation (messages, déclencheurs)
- [ ] Statistiques dans le dashboard WordPress
- [ ] Intégration avec WooCommerce
- [ ] Mode debug pour développeurs

## 🐛 Bugs et Support

Si vous rencontrez un problème :

1. Vérifiez que vos identifiants sont corrects
2. Vérifiez que le widget est activé dans les paramètres
3. Consultez la [documentation Jokko](https://docs.jokko.chat)
4. Contactez le support : support@jokko.chat

## 📄 Licence

Ce plugin est sous licence GPL v2 ou ultérieure.

```
This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
```

## 🔗 Liens utiles

- [Site web Jokko](https://jokko.chat)
- [Documentation](https://docs.jokko.chat)
- [Support](mailto:support@jokko.chat)
- [GitHub Repository](https://github.com/Jupiter-analytica/jokko)

## 👥 Auteurs

**Jokko Team**

- Site web : [https://jokko.chat](https://jokko.chat)
- Email : support@jokko.chat

---

**Développé avec ❤️ par l'équipe Jokko**