{"id":257,"date":"2026-03-05T09:43:44","date_gmt":"2026-03-05T08:43:44","guid":{"rendered":"https:\/\/baqueiro.es\/store\/?post_type=bdw_plugin_doc&#038;p=257"},"modified":"2026-03-05T15:11:13","modified_gmt":"2026-03-05T14:11:13","slug":"b-easy-vcard-generator-qr-code-digital-business-card","status":"publish","type":"bdw_plugin_doc","link":"https:\/\/baqueiro.es\/store\/plugin-docs\/b-easy-vcard-generator-qr-code-digital-business-card\/","title":{"rendered":"[B] Easy vCard Generator \u2014 QR Code + Digital Business Card"},"content":{"rendered":"\n<p><strong>[B] Easy vCard Generator<\/strong> creates and manages vCard QR Codes (digital business cards) with advanced\n  scan tracking and real-time analytics. Three delivery modes (Direct, Landing Page, Static), customizable colors,\n  multi-language landing pages, PNG\/SVG export, access rules (expiration, scan limit, password), and full GDPR\n  compliance.<\/p><br>\n\n<h2>Requirements<\/h2>\n<ul>\n  <li>WordPress 6.0 or higher<\/li>\n  <li>PHP 8.1 or higher<\/li>\n  <li>Composer (required to install dependencies)<\/li>\n  <li>endroid\/qr-code library (installed via Composer)<\/li>\n<\/ul><br>\n\n<h2>Installation<\/h2>\n<ol>\n  <li>Go to <strong>Plugins \u2192 Add New<\/strong> in your WordPress admin.<\/li>\n  <li>Click <strong>Upload Plugin<\/strong> and select the <code>.zip<\/code> file.<\/li>\n  <li>Click <strong>Install Now<\/strong>, then <strong>Activate<\/strong>.<\/li>\n  <li>Access the plugin directory via terminal\/SSH and run: <code>composer install<\/code><\/li>\n  <li>A new menu item <strong>QR Codes<\/strong> will appear in the admin sidebar.<\/li>\n<\/ol>\n<p><strong>Important:<\/strong> Without running <code>composer install<\/code>, the plugin will display a warning and will\n  not function.<\/p><br>\n\n<h2>Creating a QR Code<\/h2>\n<ol>\n  <li>Go to <strong>QR Codes \u2192 Add New<\/strong>.<\/li>\n  <li>Enter a <strong>Title<\/strong> (internal name for the QR Code).<\/li>\n  <li>Scroll to the <strong>Contact Information (vCard)<\/strong> section.<\/li>\n  <li>Fill in the contact details.<\/li>\n  <li>Configure the <strong>QR Appearance<\/strong> (colors).<\/li>\n  <li>Select the <strong>Delivery Mode<\/strong>.<\/li>\n  <li>Click <strong>Publish<\/strong>.<\/li>\n<\/ol><br>\n\n<h2>Contact Information Fields<\/h2>\n<ul>\n  <li><strong>First Name:<\/strong> Contact&#8217;s first name (recommended).<\/li>\n  <li><strong>Last Name:<\/strong> Contact&#8217;s last name (recommended).<\/li>\n  <li><strong>Company:<\/strong> Company or organization name (optional).<\/li>\n  <li><strong>Job Title:<\/strong> Professional title\/position (optional).<\/li>\n  <li><strong>Phone:<\/strong> Phone number, international format recommended, e.g., <code>+34 600 123 456<\/code>\n    (recommended).<\/li>\n  <li><strong>Email:<\/strong> Email address (recommended).<\/li>\n  <li><strong>Website:<\/strong> Website URL, always include <code>https:\/\/<\/code> (optional).<\/li>\n  <li><strong>LinkedIn:<\/strong> LinkedIn profile URL (optional).<\/li>\n  <li><strong>Address:<\/strong> Full address, multiple lines supported (optional).<\/li>\n<\/ul><br>\n\n<h2>QR Code Appearance<\/h2>\n<ul>\n  <li><strong>Main Color:<\/strong> Color of the QR modules (default: black #000000).<\/li>\n  <li><strong>Background Color:<\/strong> QR background color (default: white #ffffff).<\/li>\n<\/ul>\n<p><strong>Tips:<\/strong> Maintain high contrast between colors. Avoid very light colors for the main color. Test QR\n  readability after generating.<\/p><br>\n\n<h2>Delivery Modes<\/h2>\n\n<h2>Direct Delivery (Recommended)<\/h2>\n<ul>\n  <li><strong>Behavior:<\/strong> Tracks the scan and delivers the vCard file (.vcf).<\/li>\n  <li><strong>iOS:<\/strong> Automatically opens &#8220;Add Contact&#8221;.<\/li>\n  <li><strong>Android:<\/strong> Downloads the .vcf file.<\/li>\n  <li><strong>Tracking:<\/strong> Yes.<\/li>\n  <li><strong>Ideal for:<\/strong> Physical business cards, events.<\/li>\n<\/ul><br>\n\n<h2>Landing Page<\/h2>\n<ul>\n  <li><strong>Behavior:<\/strong> Tracks the scan and displays a customized web page.<\/li>\n  <li><strong>Content:<\/strong> Profile photo, social links, &#8220;Save Contact&#8221; button.<\/li>\n  <li><strong>Tracking:<\/strong> Yes.<\/li>\n  <li><strong>Ideal for:<\/strong> Digital networking, email signatures.<\/li>\n<\/ul><br>\n\n<h2>Static QR<\/h2>\n<ul>\n  <li><strong>Behavior:<\/strong> Instant vCard delivery (no redirect).<\/li>\n  <li><strong>Tracking:<\/strong> No.<\/li>\n  <li><strong>Ideal for:<\/strong> Permanent prints where tracking is not needed.<\/li>\n<\/ul><br>\n\n<h2>Landing Page Customization<\/h2>\n<p><em>Available only in &#8220;Landing Page&#8221; mode.<\/em><\/p>\n\n<h2>Accent Color<\/h2>\n<p>Choose the primary color for the landing page (buttons, links).<\/p><br>\n\n<h2>Profile Photo<\/h2>\n<ol>\n  <li>Click <strong>Select Image<\/strong>.<\/li>\n  <li>Choose an image from the library or upload a new one.<\/li>\n  <li>Recommended: 400x400px, JPG\/PNG format.<\/li>\n<\/ol><br>\n\n<h2>Multi-language Texts<\/h2>\n<p>Customize landing page texts for each language (Galego, Espa\u00f1ol, English):<\/p>\n<ul>\n  <li><strong>Headline:<\/strong> Main title (default: contact name).<\/li>\n  <li><strong>Subhead:<\/strong> Job title and company.<\/li>\n  <li><strong>Save Contact Button:<\/strong> Primary button text.<\/li>\n  <li><strong>WhatsApp Label:<\/strong> WhatsApp link label.<\/li>\n  <li><strong>Call Label:<\/strong> Phone link label.<\/li>\n  <li><strong>Website Label:<\/strong> Site link label.<\/li>\n  <li><strong>LinkedIn Label:<\/strong> LinkedIn link label.<\/li>\n  <li><strong>Footer:<\/strong> Footer text.<\/li>\n<\/ul>\n<p><strong>Note:<\/strong> Leave blank to use default values for each language.<\/p><br>\n\n<h2>Access Rules<\/h2>\n<p>Configure optional restrictions for each QR Code:<\/p>\n\n<h2>Expires On<\/h2>\n<ul>\n  <li><strong>Format:<\/strong> Date (YYYY-MM-DD).<\/li>\n  <li><strong>Behavior:<\/strong> After this date, the QR returns a 404 error.<\/li>\n  <li><strong>Example:<\/strong> <code>2025-12-31<\/code> (expires on the last day of 2025).<\/li>\n<\/ul><br>\n\n<h2>Scan Limit<\/h2>\n<ul>\n  <li><strong>Format:<\/strong> Integer number.<\/li>\n  <li><strong>Behavior:<\/strong> After reaching the limit, the QR returns an error.<\/li>\n  <li><strong>Value 0:<\/strong> Unlimited (default).<\/li>\n  <li><strong>Example:<\/strong> <code>100<\/code> (allows only 100 scans).<\/li>\n<\/ul><br>\n\n<h2>Access Password<\/h2>\n<ul>\n  <li><strong>Format:<\/strong> Free text.<\/li>\n  <li><strong>Behavior:<\/strong> Requires <code>?key=password<\/code> in the URL to access.<\/li>\n  <li><strong>Example:<\/strong> If password = <code>abc123<\/code>, URL must be\n    <code>https:\/\/site.com\/qr\/slug?key=abc123<\/code>.\n  <\/li>\n<\/ul><br>\n\n<h2>Downloading QR Codes<\/h2>\n<p>After publishing, use the preview panel on the right sidebar:<\/p>\n<ul>\n  <li><strong>Download PNG:<\/strong> Raster image, ideal for digital use and printing.<\/li>\n  <li><strong>Download SVG:<\/strong> Vector image, ideal for large-format printing.<\/li>\n<\/ul><br>\n\n<h2>Analytics Dashboard<\/h2>\n<p>Navigate to <strong>QR Codes \u2192 Analytics<\/strong> to view real-time data.<\/p>\n\n<h2>Summary Cards<\/h2>\n<ul>\n  <li><strong>Total Scans:<\/strong> Sum of all recorded scans.<\/li>\n  <li><strong>Scans Today:<\/strong> Scans performed on the current day.<\/li>\n  <li><strong>Most Popular:<\/strong> QR Code with the highest number of scans.<\/li>\n<\/ul><br>\n\n<h2>30-Day Chart<\/h2>\n<p>Visualize scan evolution over the last 30 days in a line chart.<\/p><br>\n\n<h2>Recent Scans Table<\/h2>\n<p>Displays the 20 most recent scans with:<\/p>\n<ul>\n  <li>Date and time of the scan.<\/li>\n  <li>Scanned QR Code (link to edit).<\/li>\n  <li>Anonymized IP (e.g., 192.168.1.0).<\/li>\n  <li>Device\/Browser (user agent).<\/li>\n<\/ul><br>\n\n<h2>Usage Examples<\/h2>\n\n<h2>Physical Business Card QR Code<\/h2>\n<ol>\n  <li>Go to <strong>QR Codes \u2192 Add New<\/strong>.<\/li>\n  <li>Fill in contact information (name, phone, email, etc.).<\/li>\n  <li>Set colors to match your brand.<\/li>\n  <li>Select <strong>Direct Delivery<\/strong> mode.<\/li>\n  <li>Publish and click <strong>Download PNG<\/strong>.<\/li>\n  <li>Send the file to your print shop.<\/li>\n<\/ol><br>\n\n<h2>Email Signature Landing Page<\/h2>\n<ol>\n  <li>Create a new QR Code with complete contact data.<\/li>\n  <li>Select <strong>Landing Page<\/strong> mode.<\/li>\n  <li>Upload a professional profile photo (400x400px).<\/li>\n  <li>Customize the accent color and texts.<\/li>\n  <li>Publish and copy the URL: <code>https:\/\/yoursite.com\/qr\/your-name<\/code>.<\/li>\n  <li>Add to your email signature as a link or embed the QR Code image.<\/li>\n<\/ol><br>\n\n<h2>Event QR Code with Scan Limit<\/h2>\n<ol>\n  <li>Create a new QR Code for your event stand.<\/li>\n  <li>Select <strong>Landing Page<\/strong> mode.<\/li>\n  <li>Set <strong>Expires On:<\/strong> last day of the event.<\/li>\n  <li>Set <strong>Scan Limit:<\/strong> stand capacity (e.g., 500).<\/li>\n  <li>Publish and monitor in <strong>Analytics<\/strong>.<\/li>\n<\/ol><br>\n\n<h2>Roles &amp; Permissions<\/h2>\n<ul>\n  <li><strong>Administrator:<\/strong> Full access \u2014 create, edit, delete QR Codes and access Analytics.<\/li>\n  <li><strong>Editor:<\/strong> Create, edit, and delete QR Codes. No Analytics access by default.<\/li>\n  <li><strong>Author\/Contributor:<\/strong> No access to the QR Codes CPT by default.<\/li>\n<\/ul>\n<p>To grant access to other roles, use a capabilities management plugin (e.g., User Role Editor).<\/p><br>\n\n<h2>Troubleshooting<\/h2>\n\n<h2>QR Code not generating<\/h2>\n<p><strong>Symptoms:<\/strong> Empty preview area or error.<\/p>\n<p><strong>Solutions:<\/strong><\/p>\n<ol>\n  <li>Verify that <code>composer install<\/code> was executed.<\/li>\n  <li>Confirm that the <code>vendor\/<\/code> folder exists in the plugin directory.<\/li>\n  <li>Check server write permissions.<\/li>\n  <li>Enable WP_DEBUG and check error logs.<\/li>\n<\/ol><br>\n\n<h2>Landing Page not displaying (404 error)<\/h2>\n<p><strong>Symptoms:<\/strong> 404 error when accessing <code>\/qr\/{slug}<\/code>.<\/p>\n<p><strong>Solutions:<\/strong><\/p>\n<ol>\n  <li>Go to <strong>Settings \u2192 Permalinks<\/strong>.<\/li>\n  <li>Click <strong>Save Changes<\/strong> (this flushes rewrites).<\/li>\n  <li>Test again.<\/li>\n<\/ol><br>\n\n<h2>Analytics showing empty<\/h2>\n<p><strong>Symptoms:<\/strong> &#8220;No scans recorded yet&#8221; message.<\/p>\n<p><strong>Causes:<\/strong><\/p>\n<ul>\n  <li>QR Code is in <strong>Static<\/strong> mode (does not track).<\/li>\n  <li>No scans have been performed yet.<\/li>\n  <li>Database table was not created.<\/li>\n<\/ul>\n<p><strong>Solutions:<\/strong><\/p>\n<ol>\n  <li>Check the QR Code&#8217;s delivery mode.<\/li>\n  <li>Perform a test scan.<\/li>\n  <li>Deactivate and reactivate the plugin (recreates the table).<\/li>\n<\/ol><br>\n\n<h2>Download not working<\/h2>\n<p><strong>Symptoms:<\/strong> Error when clicking &#8220;Download PNG\/SVG&#8221;.<\/p>\n<p><strong>Solutions:<\/strong><\/p>\n<ol>\n  <li>Verify that the post is published.<\/li>\n  <li>Confirm that the endroid library is installed.<\/li>\n  <li>Check PHP error logs.<\/li>\n<\/ol><br>\n\n<h2>Landing Page texts in wrong language<\/h2>\n<p><strong>Symptoms:<\/strong> Texts do not appear in the expected language.<\/p>\n<p><strong>Solutions:<\/strong><\/p>\n<ol>\n  <li>Check the browser&#8217;s language setting.<\/li>\n  <li>Manually customize texts in the QR Code editor.<\/li>\n  <li>Confirm the language is one of the supported options (gl\/es\/en).<\/li>\n<\/ol><br>\n\n<h2>Privacy &amp; Data (GDPR Compliance)<\/h2>\n<p>This plugin:<\/p>\n<ul>\n  <li><strong>Anonymizes IPs<\/strong> automatically using <code>wp_privacy_anonymize_ip()<\/code>.<\/li>\n  <li><strong>Truncates user agents<\/strong> for privacy.<\/li>\n  <li>Stores data in a single database table (<code>wp_bqrcode_scans<\/code>).<\/li>\n  <li>Does <strong>not<\/strong> set any cookies.<\/li>\n  <li>Does <strong>not<\/strong> make any external HTTP requests.<\/li>\n  <li>Does <strong>not<\/strong> send data to third parties.<\/li>\n  <li>Is fully compatible with GDPR, LGPD, and similar privacy regulations.<\/li>\n<\/ul><br>\n\n<h2>Uninstallation<\/h2>\n<p>Deactivating the plugin stops QR Code functionality. To fully remove:<\/p>\n<ol>\n  <li>Deactivate the plugin.<\/li>\n  <li>Delete it from <strong>Plugins \u2192 Installed Plugins<\/strong>.<\/li>\n<\/ol>\n<p><strong>Data removed on deletion:<\/strong><\/p>\n<ul>\n  <li>Database table <code>wp_bqrcode_scans<\/code>.<\/li>\n  <li>All posts of type <code>b_qrcode<\/code>.<\/li>\n  <li>All post meta with prefix <code>_bqrcode_*<\/code>.<\/li>\n<\/ul><br>\n","protected":false},"excerpt":{"rendered":"<p>[B] Easy vCard Generator creates and manages vCard QR Codes (digital business cards) with advanced scan tracking and real-time analytics. Three delivery modes (Direct, Landing Page, Static), customizable colors, multi-language landing pages, PNG\/SVG export, access rules (expiration, scan limit, password), and full GDPR compliance. Requirements WordPress 6.0 or higher PHP 8.1 or higher Composer (required [&hellip;]<\/p>\n","protected":false},"featured_media":0,"template":"","class_list":["post-257","bdw_plugin_doc","type-bdw_plugin_doc","status-publish","hentry"],"_links":{"self":[{"href":"https:\/\/baqueiro.es\/store\/wp-json\/wp\/v2\/bdw_plugin_doc\/257","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/baqueiro.es\/store\/wp-json\/wp\/v2\/bdw_plugin_doc"}],"about":[{"href":"https:\/\/baqueiro.es\/store\/wp-json\/wp\/v2\/types\/bdw_plugin_doc"}],"version-history":[{"count":5,"href":"https:\/\/baqueiro.es\/store\/wp-json\/wp\/v2\/bdw_plugin_doc\/257\/revisions"}],"predecessor-version":[{"id":299,"href":"https:\/\/baqueiro.es\/store\/wp-json\/wp\/v2\/bdw_plugin_doc\/257\/revisions\/299"}],"wp:attachment":[{"href":"https:\/\/baqueiro.es\/store\/wp-json\/wp\/v2\/media?parent=257"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}