﻿{"id":258,"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=258"},"modified":"2026-03-05T16:02:49","modified_gmt":"2026-03-05T15:02:49","slug":"b-easy-linktree-beautiful-link-pages-with-built-in-analytics","status":"publish","type":"bdw_plugin_doc","link":"https:\/\/baqueiro.es\/store\/plugin-docs\/b-easy-linktree-beautiful-link-pages-with-built-in-analytics\/","title":{"rendered":"[B] Easy LinkTree \u2014 Beautiful Link Pages with Built-In Analytics"},"content":{"rendered":"\n<h2>Requirements<\/h2>\n<ul>\n  <li>WordPress 6.0 or higher<\/li>\n  <li>PHP 7.4 or higher<\/li>\n  <li>Permissions: <code>edit_posts<\/code> to create LinkTrees, <code>manage_options<\/code> to access settings<\/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<\/ol><br>\n\n<h2>Configuration<\/h2>\n<p>Go to <strong>[B] Easy LinkTree \u2192 Settings<\/strong> to configure the plugin.<\/p><br>\n\n<h2>Base Slug<\/h2>\n<p>Sets the public URL slug for LinkTrees.<\/p>\n<p><strong>Example:<\/strong> <code>linktree<\/code> \u2192 Final URL: <code>\/linktree\/your-linktree-slug<\/code><\/p><br>\n\n<h2>Load Font Awesome from CDN<\/h2>\n<p>If checked, loads Font Awesome via CDN for icons. Disable if your theme already loads Font Awesome.<\/p><br>\n\n<h2>Cookie Consent (GDPR)<\/h2>\n<p>Enables the consent banner. Analytics are only recorded if the user consents.<\/p>\n<ul>\n  <li><strong>Consent Name:<\/strong> Cookie identifier.<\/li>\n  <li><strong>Texts by Language:<\/strong> Customize the banner message for GL, ES, EN, and PT.<\/li>\n<\/ul><br>\n\n<h2>IP Privacy<\/h2>\n<ul>\n  <li><strong>IP Hash:<\/strong> Recommended option for privacy compliance.<\/li>\n  <li><strong>Store Raw IP:<\/strong> Not recommended (LGPD\/GDPR concerns).<\/li>\n<\/ul><br>\n\n<h2>Geolocation (Optional)<\/h2>\n<p>Enables geolocation by IP using ipapi.co with local caching. Token is optional but may be required for high traffic.\n<\/p><br>\n\n<h2>SVG by API (QR)<\/h2>\n<p>Enables SVG QR code generation via api.qrserver.com external service.<\/p><br>\n\n<h2>Creating a LinkTree<\/h2>\n<ol>\n  <li>Go to <strong>[B] Easy LinkTree \u2192 LinkTrees<\/strong>.<\/li>\n  <li>Click <strong>Add New<\/strong>.<\/li>\n  <li>Set a <strong>title<\/strong> (displayed name for your LinkTree).<\/li>\n  <li>Fill in the <strong>Profile &amp; Theme<\/strong> metabox:\n    <ul>\n      <li><strong>Subtitle:<\/strong> Short bio text.<\/li>\n      <li><strong>Avatar:<\/strong> Profile image.<\/li>\n      <li><strong>Cover:<\/strong> Optional header image.<\/li>\n      <li><strong>Background:<\/strong> CSS color or gradient.<\/li>\n      <li><strong>Accent Color:<\/strong> Highlight color for buttons.<\/li>\n      <li><strong>Layout Preset:<\/strong> Choose a predefined style.<\/li>\n      <li><strong>Custom CSS:<\/strong> Optional additional styling.<\/li>\n    <\/ul>\n  <\/li>\n  <li>In the <strong>Links<\/strong> metabox:\n    <ul>\n      <li>Add each link with label and URL.<\/li>\n      <li>Choose an icon (Font Awesome or SVG).<\/li>\n      <li>Set the style (solid, outline, soft).<\/li>\n      <li>Mark as <strong>Active<\/strong> to display.<\/li>\n    <\/ul>\n  <\/li>\n  <li>In the <strong>QR Code<\/strong> metabox:\n    <ul>\n      <li>Generate and download PNG (via JS) or save to media library.<\/li>\n      <li>Generate PNG\/SVG via PHP and save to media library.<\/li>\n    <\/ul>\n  <\/li>\n  <li>Click <strong>Publish<\/strong>.<\/li>\n<\/ol><br>\n\n<h2>Dashboard<\/h2>\n<p>Go to <strong>[B] Easy LinkTree \u2192 Dashboard<\/strong> to view all your LinkTrees with metrics for views and clicks\n  from the last 30 days.<\/p>\n<p><strong>Quick actions:<\/strong><\/p>\n<ul>\n  <li>View LinkTree<\/li>\n  <li>Edit<\/li>\n  <li>Analytics<\/li>\n  <li>Copy URL<\/li>\n<\/ul><br>\n\n<h2>Analytics<\/h2>\n<p>Go to <strong>[B] Easy LinkTree \u2192 Analytics<\/strong> for detailed statistics.<\/p>\n<ol>\n  <li>Select a LinkTree from the dropdown.<\/li>\n  <li>Filter by date range (From \/ To).<\/li>\n  <li>View total views and clicks for the period.<\/li>\n  <li>Export CSV of views and clicks data.<\/li>\n  <li>See top performing links.<\/li>\n  <li>View countries breakdown (if geolocation is enabled).<\/li>\n<\/ol><br>\n\n<h2>Shortcode<\/h2>\n<p>Use this shortcode to embed a LinkTree in any page or post:<\/p>\n<p><code>[easylinktree id='123']<\/code><\/p>\n<p>Replace <code>123<\/code> with the actual LinkTree ID.<\/p><br>\n\n<h2>QR Code Generation<\/h2>\n<p>The plugin offers multiple ways to generate QR codes for your LinkTree:<\/p>\n<ul>\n  <li><strong>JavaScript PNG:<\/strong> Generate and download directly in the browser.<\/li>\n  <li><strong>PHP PNG:<\/strong> Server-side generation, can save to media library.<\/li>\n  <li><strong>SVG via API:<\/strong> External service (requires enabling in settings).<\/li>\n<\/ul>\n<p>QR codes link directly to your LinkTree public URL.<\/p><br>\n\n<h2>Roles &amp; Permissions<\/h2>\n<ul>\n  <li><strong>Administrators (<code>manage_options<\/code>):<\/strong> Full access to settings, LinkTrees, dashboard, and\n    analytics.<\/li>\n  <li><strong>Editors\/Authors (<code>edit_posts<\/code>):<\/strong> Can create\/edit LinkTrees, view dashboard and\n    analytics, export CSV.<\/li>\n  <li><strong>Visitors:<\/strong> Can view public LinkTrees without login.<\/li>\n<\/ul><br>\n\n<h2>Troubleshooting<\/h2>\n\n<h2>Icons not appearing<\/h2>\n<p><strong>Cause:<\/strong> Font Awesome is not loaded.<\/p>\n<p><strong>Solution:<\/strong> Enable &#8216;Load Font Awesome from CDN&#8217; in the plugin settings.<\/p><br>\n\n<h2>Analytics not recording<\/h2>\n<p><strong>Cause:<\/strong> User did not accept the consent banner.<\/p>\n<p><strong>Solution:<\/strong> Analytics only records after consent. Verify the consent banner is enabled and that users\n  are accepting it.<\/p><br>\n\n<h2>Geolocation data not showing<\/h2>\n<p><strong>Cause:<\/strong> Geolocation is disabled or API is not responding.<\/p>\n<p><strong>Solution:<\/strong> Enable &#8216;Geolocation&#8217; in settings. If using high traffic, add an ipapi.co token.<\/p><br>\n\n<h2>SVG QR code not generating<\/h2>\n<p><strong>Cause:<\/strong> SVG API option is disabled.<\/p>\n<p><strong>Solution:<\/strong> Enable &#8216;SVG by API (QR)&#8217; in settings, or use the PHP PNG generation instead.<\/p><br>\n\n<h2>CSV export fails<\/h2>\n<p><strong>Cause:<\/strong> User lacks permissions or nonce expired.<\/p>\n<p><strong>Solution:<\/strong> Ensure the user has <code>edit_posts<\/code> capability. Refresh the page and try again.\n<\/p><br>\n\n<h2>LinkTree showing 404<\/h2>\n<p><strong>Cause:<\/strong> Permalinks not flushed after changing base slug.<\/p>\n<p><strong>Solution:<\/strong> Go to <strong>Settings \u2192 Permalinks<\/strong> and click &#8216;Save Changes&#8217; to flush rewrite\n  rules.<\/p><br>\n\n<h2>Privacy &amp; Data<\/h2>\n<p>This plugin:<\/p>\n<ul>\n  <li>Collects analytics data (views, clicks) <strong>only with user consent<\/strong>.<\/li>\n  <li>Supports <strong>IP anonymization<\/strong> (hash) by default.<\/li>\n  <li>Sets a consent cookie only if the user accepts.<\/li>\n  <li>Does <strong>not<\/strong> share data with third parties (except optional geolocation API).<\/li>\n  <li>Is compatible with GDPR, LGPD, and similar privacy regulations.<\/li>\n<\/ul>\n<p><strong>External services (optional):<\/strong><\/p>\n<ul>\n  <li><strong>Font Awesome CDN:<\/strong> For loading icons.<\/li>\n  <li><strong>ipapi.co:<\/strong> For IP geolocation (if enabled).<\/li>\n  <li><strong>api.qrserver.com:<\/strong> For SVG QR generation (if enabled).<\/li>\n<\/ul><br>\n\n<h2>Uninstallation<\/h2>\n<p>To remove the plugin:<\/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>Note:<\/strong> Analytics data stored in the database (views, clicks, IP cache) will remain unless manually\n  deleted.<\/p><br>\n","protected":false},"excerpt":{"rendered":"<p>Requirements WordPress 6.0 or higher PHP 7.4 or higher Permissions: edit_posts to create LinkTrees, manage_options to access settings Installation Go to Plugins \u2192 Add New in your WordPress admin. Click Upload Plugin and select the .zip file. Click Install Now, then Activate. Configuration Go to [B] Easy LinkTree \u2192 Settings to configure the plugin. Base [&hellip;]<\/p>\n","protected":false},"featured_media":0,"template":"","class_list":["post-258","bdw_plugin_doc","type-bdw_plugin_doc","status-publish","hentry"],"_links":{"self":[{"href":"https:\/\/baqueiro.es\/store\/wp-json\/wp\/v2\/bdw_plugin_doc\/258","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":2,"href":"https:\/\/baqueiro.es\/store\/wp-json\/wp\/v2\/bdw_plugin_doc\/258\/revisions"}],"predecessor-version":[{"id":302,"href":"https:\/\/baqueiro.es\/store\/wp-json\/wp\/v2\/bdw_plugin_doc\/258\/revisions\/302"}],"wp:attachment":[{"href":"https:\/\/baqueiro.es\/store\/wp-json\/wp\/v2\/media?parent=258"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}