📄 Documentation officielle

Generator Vcard

Plugin WordPress pour créer et gérer des cartes de contact numériques professionnelles avec QR code, URL NFC, lien de modification sécurisé et tableau de bord de statistiques.

🔌 WordPress 5.8+ 🐘 PHP 7.4+ ⚡ Elementor Free 🧱 Gutenberg 📱 Shortcode

Introduction

Generator Vcard permet à vos visiteurs ou collaborateurs de créer leur propre carte de visite numérique directement depuis votre site WordPress. Chaque vCard génère automatiquement un fichier .vcf, un QR code scannable, une URL courte partageable et un lien de modification personnel.

📇

vCards illimitées

Créez autant de cartes de visite numériques que nécessaire. Chaque vCard est un CPT WordPress indépendant.

📱

QR Code scannable

QR code généré en temps réel (norme ISO/IEC 18004), téléchargeable en PNG et SVG avec logo optionnel.

🔗

URL NFC dédiée

Chaque vCard dispose d'une URL courte /p/prenom-nom/ à programmer sur une carte NFC.

✏️

Lien de modification

Lien sécurisé avec token unique permettant au titulaire de modifier sa vCard sans compte WordPress.

📊

Statistiques de scans

Journal des scans par vCard sur 365 jours. Compteur de scans visible depuis le tableau de bord.

🔄

Mises à jour automatiques

Notification WordPress native dès qu'une nouvelle version est disponible sur le serveur XGPWEB.

Installation

Le plugin s'installe comme n'importe quelle extension WordPress via l'interface d'administration. Vous avez reçu un fichier ZIP lors de votre achat.

Téléverser le fichier ZIP

Dans votre admin WordPress, allez dans Extensions → Ajouter une extension → Téléverser une extension. Sélectionnez le fichier generator-vcard-X.X.X.zip et cliquez sur Installer maintenant.

Activer le plugin

Après l'installation, cliquez sur Activer l'extension. Un nouveau menu Generator Vcard apparaît dans votre barre d'administration.

Rafraîchir les permaliens

Allez dans Réglages → Permaliens et cliquez sur Enregistrer les modifications sans rien changer. Cette étape est indispensable pour que les URLs /p/nom/ et /vcarddl/ fonctionnent.

⚠️ Si vous sautez cette étape, les liens de téléchargement et les URLs NFC renverront une erreur 404.

Créer une page formulaire

Créez une nouvelle page WordPress et insérez le shortcode

Photo (JPG/PNG)

. C'est sur cette page que vos visiteurs créeront et modifieront leurs vCards. Notez bien l'URL de cette page, vous en aurez besoin dans les Réglages.

✅ Le plugin est maintenant installé. Passez à l'activation de votre licence pour activer les mises à jour automatiques.

Activation de la licence

Votre licence permet de recevoir les mises à jour automatiques directement dans WordPress. Elle est liée à un seul domaine. Vous avez reçu votre clé par email lors de votre achat.

Ouvrir la page Licences

Dans l'admin WordPress, allez dans Generator Vcard → Licences clients.

Saisir la clé de licence

Collez votre clé au format XXXX-XXXX-XXXX-XXXX dans le champ prévu et cliquez sur Activer. La clé est automatiquement liée à votre domaine lors de la première activation.

Vérifier l'activation

Un bandeau vert ✅ Licence active — domaine : votresite.fr confirme que tout fonctionne. Vous recevrez désormais les notifications de mise à jour directement dans WordPress.

ℹ️ Vous changez de domaine ? Contactez contact@pressweb.fr pour libérer votre licence et l'activer sur le nouveau domaine.

Configuration

Accédez aux réglages via Generator Vcard → Réglages. La configuration principale à effectuer est l'URL de la page d'édition.

Réglages essentiels

Paramètre	Description	Recommandé
URL page d'édition	URL de la page contenant Photo (JPG/PNG) . Utilisée pour générer les liens de modification.	Obligatoire
Champs activés	Sélectionnez les champs à afficher dans le formulaire (prénom, nom, téléphone, email, etc.).	Recommandé
Couleur primaire	Couleur du bouton de soumission et des éléments d'accent du formulaire.	Optionnel
Taille QR code	Taille en pixels du QR code généré (default : 200px).	Optionnel
Envoyer lien par email	Active l'envoi automatique du lien de modification par email après création.	Optionnel
Champs personnalisés	Ajoutez vos propres champs (ex: badge, service, numéro d'agent…).	Optionnel

Shortcode

Le shortcode

Photo (JPG/PNG)

est la méthode principale pour intégrer le formulaire vCard dans n'importe quelle page ou article WordPress.

Shortcode


    
        
        
                                
                        
                                            
                                    
                        
                                            
                                    
                        
                                            
                                    
                        
                                            
                                    
                        
                                            
                                    
                        
                                            
                                    
                        
                                            
                                    
                        
                                            
                                    
                        
                                            
                                    
                        
                            Photo (JPG/PNG)

Collez ce shortcode dans l'éditeur de n'importe quelle page. Le formulaire s'affiche avec les champs configurés dans les Réglages.

ℹ️ Avec Elementor, évitez de placer le shortcode dans un widget Code court — utilisez plutôt le widget dédié Generator Vcard visible dans le panneau des éléments.

Widget Elementor

Un widget natif Elementor est inclus, compatible avec Elementor Free et Pro. Il apparaît dans le panneau des éléments sous le nom Generator Vcard avec son icône de carte de visite.

Ouvrir une page avec Elementor

Créez ou éditez une page avec Elementor.

Rechercher le widget

Dans le panneau de gauche, tapez vcard dans la barre de recherche. Le widget Generator Vcard apparaît avec son icône.

Glisser-déposer

Faites glisser le widget dans votre colonne. Le formulaire s'affiche directement dans l'éditeur.

⚠️ Si le widget n'apparaît pas après l'installation, allez dans Elementor → Outils → Régénérer les fichiers CSS puis rechargez la page.

Bloc Gutenberg

Un bloc natif Gutenberg est disponible pour les sites n'utilisant pas Elementor.

Ajouter un bloc

Dans l'éditeur Gutenberg, cliquez sur le + pour ajouter un bloc.

Rechercher "vcard"

Tapez vcard dans la barre de recherche de blocs. Sélectionnez le bloc Generator Vcard Form.

Publier

Le formulaire est inséré dans votre page. Publiez ou mettez à jour la page pour le rendre visible.

Tableau de bord

Le tableau de bord centralise toutes les vCards créées. Accédez-y via Generator Vcard → Tableau de bord.

Actions disponibles par vCard

Bouton	Action
⬇️ VCF	Télécharge le fichier .vcf de la vCard.
✏️ Éditer	Ouvre le formulaire pré-rempli pour modifier la vCard (nécessite que l'URL de la page soit configurée dans les Réglages).
🔗 Lien édition	Copie le lien de modification dans le presse-papier pour le transmettre au titulaire.
✉️ Envoyer lien	Envoie le lien de modification par email à l'adresse renseignée dans la vCard (visible uniquement si un email est présent).
🔑 Token	Régénère le token de sécurité. L'ancien lien de modification est invalidé.
🗑	Supprime définitivement la vCard après confirmation.

Créer une vCard

Le formulaire est accessible sur la page où vous avez placé le shortcode ou le widget. Voici les champs disponibles :

Champ	Format	Obligatoire
Prénom	Texte libre	Oui
Nom	Texte libre	Oui
Fonction	Texte libre	Non
Entreprise / Organisation	Texte libre	Non
Email	Adresse email valide	Non
Téléphone portable	Numéro de téléphone	Non
Téléphone fixe	Numéro de téléphone	Non
Adresse	Texte libre	Non
LinkedIn	URL complète	Non
Photo	JPG ou PNG, max 5 Mo	Non

Après soumission, le panneau de résultat affiche le fichier .vcf à télécharger, l'URL NFC, le lien court, le lien de modification personnel, et le QR code. Un bouton Créer une nouvelle vCard permet de repartir sur un formulaire vierge sans recharger la page.

Modifier une vCard

Chaque titulaire dispose d'un lien de modification personnel contenant un token sécurisé. Ce lien ne nécessite pas de compte WordPress.

Format du lien
https://votresite.fr/vcard/?genv_id=123&genv_edit=TOKEN28CHARS

Sécurité — Le token fait 28 caractères aléatoires. Sans ce token, la vCard ne peut pas être modifiée.
Pré-remplissage — Quand quelqu'un ouvre son lien, le formulaire se pré-remplit avec ses données actuelles.
Invalidation — Si le token est régénéré depuis le tableau de bord (🔑 Token), l'ancien lien ne fonctionne plus.
Transmission — Vous pouvez copier le lien (🔗) ou l'envoyer par email directement depuis le tableau de bord (✉️).

QR Code & URL NFC

Chaque vCard génère automatiquement deux URLs et un QR code scannable.

URLs générées

URL	Description	Usage
/vcarddl/123/	Téléchargement direct du fichier .vcf	QR code, carte NFC
/p/prenom-nom/	URL courte mémorisable	Partage, signature email

Programmer une carte NFC

Téléchargez l'application NFC Tools (iOS / Android).
Dans le panneau de résultat de votre vCard, copiez l'URL NFC (format /vcarddl/123/).
Dans NFC Tools, créez un enregistrement de type URL et collez l'URL copiée.
Approchez votre carte NFC vierge du téléphone pour écrire.
Testez en approchant n'importe quel smartphone : le contact se télécharge automatiquement.

Export CSV

Exportez toutes vos vCards en fichier CSV depuis Generator Vcard → Export CSV. Le fichier inclut tous les champs standard et personnalisés, ainsi que les statistiques de scans.

Encodage — Le fichier utilise l'encodage UTF-8 avec BOM, compatible Excel et LibreOffice.
Performance — L'export se fait par lots de 100 vCards pour éviter les timeout sur les gros volumes.
Contenu — Nom, prénom, poste, organisation, email, téléphones, adresse, LinkedIn, URL NFC, lien court, nombre de scans, date de création.

Mises à jour automatiques

Le plugin vérifie automatiquement les mises à jour toutes les 12 heures en contactant le serveur XGPWEB. Lorsqu'une nouvelle version est disponible, vous recevez la notification standard WordPress.

Votre site WordPress

Vérif. toutes les 12h

→

Serveur XGPWEB

pressweb.fr/wp-json/genv/v1/

Licence valide ?

→

Notification WordPress

"Mettre à jour maintenant"

→

Mise à jour installée

ZIP téléchargé depuis pressweb.fr

ℹ️ Seules les licences actives et non révoquées peuvent télécharger les mises à jour. Sans licence valide, vous verrez qu'une mise à jour est disponible mais ne pourrez pas l'installer automatiquement.

Paramètres shortcode

Le shortcode accepte des attributs pour personnaliser son comportement par page.

Attribut	Valeur par défaut	Description
color	Réglages	Couleur primaire du bouton (hex). Ex: color="#c9a84c"
radius	Réglages	Arrondi des coins en pixels. Ex: radius="8"
qr_size	Réglages	Taille du QR code en pixels. Ex: qr_size="250"
ecc	M	Niveau de correction d'erreur QR : L, M, Q, H. Ex: ecc="H"

Exemple


    
        
        
                                
                        
                                            
                                    
                        
                                            
                                    
                        
                                            
                                    
                        
                                            
                                    
                        
                                            
                                    
                        
                                            
                                    
                        
                                            
                                    
                        
                                            
                                    
                        
                                            
                                    
                        
                            Photo (JPG/PNG)

FAQ

Le bouton "Éditer" dans le tableau de bord ne fonctionne pas

Vérifiez que vous avez renseigné l'URL de la page d'édition dans Generator Vcard → Réglages. Cette URL doit pointer vers la page contenant le shortcode

Photo (JPG/PNG)

. Si le champ est vide, le plugin essaie de trouver automatiquement la page, mais il peut échouer si plusieurs pages contiennent le shortcode.

Les URLs /p/ et /vcarddl/ renvoient une erreur 404

Allez dans Réglages → Permaliens et cliquez sur Enregistrer les modifications sans rien changer. Cette opération régénère le fichier .htaccess avec les règles de réécriture nécessaires.

L'email avec le lien de modification ne part pas

WordPress utilise la fonction PHP mail() par défaut, souvent désactivée ou filtrée par les hébergeurs. Installez un plugin SMTP comme WP Mail SMTP et configurez-le avec votre serveur d'envoi (Gmail, Mailgun, SendGrid…). Une fois configuré, les emails partiront correctement.

Le widget Elementor n'apparaît pas dans le panneau

Allez dans Elementor → Outils → Régénérer les fichiers CSS et les données, puis rechargez l'éditeur. Si le problème persiste, désactivez et réactivez le plugin Generator Vcard depuis la liste des extensions.

Puis-je utiliser le plugin sur plusieurs sites ?

Chaque licence est valable pour un seul domaine. Si vous souhaitez utiliser le plugin sur plusieurs sites, vous aurez besoin d'une licence par site. Contactez contact@pressweb.fr pour des tarifs multi-sites.

Comment obtenir une mise à jour sans notification automatique ?

Dans Generator Vcard → Licences clients, cliquez sur le bouton 🔄 Revérifier. Cela vide le cache de vérification et force WordPress à interroger le serveur XGPWEB immédiatement. Si une mise à jour est disponible, la notification apparaîtra dans les secondes qui suivent.

Support

Vous avez une question, un bug à signaler ou besoin d'aide pour la configuration ? Notre équipe vous répond rapidement.

✉️

Pour toute question technique ou commerciale : contact@pressweb.fr

Réponse sous 24–48h ouvrées.

🌐

Site XGPWEB

Retrouvez les dernières versions, le changelog complet et les annonces sur pressweb.fr/generator-vcard

💡 Avant de contacter le support, vérifiez que votre licence est active, que les permaliens sont à jour et que la version du plugin est bien à jour.

Informations utiles à joindre

Version du plugin (visible dans Generator Vcard → Licences clients)
Version de WordPress et de PHP
Thème et page builder utilisés
Message d'erreur exact ou capture d'écran