=== Affiliate Butler PRO === Contributors: waseem_senjer Tags: affiliate, links, automation, keywords, cloaking Requires at least: 6.6 Requires PHP: 7.4 Tested up to: 7.1 Stable tag: 3.9.1 License: GPLv2 or later License URI: https://www.gnu.org/licenses/gpl-2.0.html Link your keywords to affiliate, external or internal links automatically, with short links and click stats. == Description == Link a keyword once and Affiliate Butler PRO links it in every post, page and excerpt, now and in the posts you write later. * **Auto links:** external URLs, posts and pages of your site, popups, image galleries, videos, maps and share boxes. * **Short links:** `yoursite.com/go/amazon` style links that hide and protect the affiliate URL, with a 302, 307 or 301 redirect, for all links or per link, UTM parameters passed on, URL rotation for split tests, and a QR code. * **SEO:** nofollow, `rel="sponsored"` for affiliate links and `noopener` for new windows, per link or as the default. * **Click stats:** clicks per day, country, browser, platform, language and referrer, without saving IP addresses. Bots are not counted. Clicks can also go to Google Analytics 4. * **Control:** a limit of links per post, excluded HTML tags, post types and single posts where nothing is linked, case-sensitive keywords. * **Quick add:** select text in the block editor and turn it into an auto link from the toolbar. * **Import / Export:** move your links to another site as JSON, edit them in a spreadsheet as CSV, and download every click as CSV. * **Privacy:** respect Do Not Track and Global Privacy Control, delete old clicks automatically, and a suggested text for your privacy policy. * **Developers:** a REST API under `affiliate-butler/v1` and filters for the links, the tracking and the redirects. == Installation == = Uploading in WordPress Dashboard = 1. Go to Plugins > Add New Plugin and click "Upload Plugin" 2. Select `affiliate-butler-pro.zip` from your computer 3. Click "Install Now" 4. Activate the plugin 5. Activate your licence key in Affiliate Butler > Licence to get the updates = Using FTP = 1. Extract `affiliate-butler-pro.zip` on your computer 2. Upload the `affiliate-butler-pro` folder to `/wp-content/plugins/` 3. Activate the plugin in the Plugins screen == Frequently Asked Questions == = I use the free Keywords to Links Converter. What happens when I install Pro? = Your links keep working: both plugins store them the same way. Activating Affiliate Butler Pro brings over the free plugin's settings, the click counts of its short links and the posts where you disabled auto links. The free plugin pauses itself while Pro is active; you can deactivate it. = Which languages does the plugin speak? = English, German, French, Spanish, Italian, Brazilian Portuguese and Dutch. It follows the language of your site (Settings > General) or the one in your user profile. To send a correction or add a language, translate `languages/affiliate-butler-pro.pot` with Poedit and send us the `.po` file through the support. = Are my links deleted when I delete the plugin? = No, the links, the click stats and the settings are kept for a reinstall. Turn on "Delete all data when the plugin is deleted" in Affiliate Butler > Settings to remove them. = Which data does the plugin save about visitors? = For each click: the date, the page, the country (from your hosting or CDN), the browser, the platform, the language and the domain of the referrer. No IP address, and nothing that links a click to a person. == Screenshots == 1. The post before adding the links 2. Links management. 3. The auto replacement of the keywords in the post. == Changelog == = 3.9.1 = * Fixed: Activating, checking or deactivating the licence failed with "The WPRuby store can’t be reached right now." The licence requests now go to the licence service of the WPRuby store. = 3.9.0 = * New: Upgrading from the free Keywords to Links Converter is seamless. Its links work as they are, and Affiliate Butler Pro brings over its settings (on a site without Pro settings yet), the click counts of its short links and the posts where auto links are disabled. The free plugin pauses itself while Pro is active, so no keyword is linked twice. = 3.8.0 = * New: German, French, Spanish, Italian, Brazilian Portuguese and Dutch translations. The plugin uses them when WordPress or your user profile is set to one of these languages. * Fixed: The Affiliate Butler screens built with React (links, link editor, stats, settings, import/export, licence) and the "Auto link" dialog of the block editor now show their translations. Only the texts made in PHP were translated before. * Improved: Clearer error messages in the link editor, e.g. "Another link already uses this URL." and "Please choose a post or page." = 3.7.0 = * New: URL rotation and split testing. A short link can rotate between up to 10 URLs, each with a weight, to compare offers or share traffic between stores. The link stats show the clicks of each URL, and the click export has a new "target" column. * New: Rotations are part of the import and export files. * Developers: The `abutler_rotation_target` filter changes the URL a rotating link picks, and the `lar_link_redirected` action now gets that URL as its second argument. = 3.6.0 = * New: Forward the parameters of a short link to its URL, per link. `yoursite.com/go/amazon?utm_source=newsletter` passes `utm_source` on; the parameters the URL already has, like your affiliate ID, are never replaced. * New: "Use the title of the page" in the link editor fills the link title with the title of the target page. * New: A QR code of every short link in the link editor, to download as a PNG. * New: Send an "affiliate_click" event to Google Analytics 4 when an auto link is clicked (Settings > Click stats, off by default). Every click also fires an `abutler:click` event in the page for other scripts. = 3.5.0 = * New: Choose the redirect type (301, 302 or 307) of each short link in the link editor. Links left on "Default" use the redirect type of the settings, as before. * New: The redirect type is part of the import and export files. = 3.4.0 = * New: An "Auto link" button in the block editor's text toolbar (in the "More" menu). Select some text, choose "Auto link", and add it as the keyword of a new auto link to a URL or to a post or page, without leaving the editor. = 3.3.0 = * New: An Import / Export screen in the Affiliate Butler menu. * New: Export the links as JSON (every field, and the settings if you want) or as CSV for spreadsheets. * New: Import a JSON or CSV file. You see which links will be added, updated or skipped, and why a row can't be imported, before anything is saved. A link of the file updates the link with the same short link slug, or else with the same keywords. * New: Internal links find their page by its address, so they keep working when you import them into another site. * New: Export the clicks as CSV, for all dates or a date range. = 3.2.1 = * New: WPRuby branding: a header with Documentation and Support links on the Affiliate Butler screens, and Documentation and Support links in the Plugins screen. * New: A new Licence page in the Affiliate Butler menu. It shows the status of the licence, its expiry date and how many sites use it, and you can deactivate it to move it to another site. * New: A "Renew licence" button for expired licences, and an "Activate licence" link in the Plugins screen while the licence isn't active. * Improved: Clear messages when a key is refused: expired, used on too many sites, for another product, or the store can't be reached. A refused key doesn't replace the active one. * Improved: The licence page doesn't load the WPRuby blog feed and logo from wpruby.com anymore. * Fixed: A PHP deprecation notice on the licence page. * Fixed: The old addresses of the settings and licence pages showed "Sorry, you are not allowed to access this page" instead of opening the new pages. = 3.2.0 = * New: An option to delete all the plugin data (links, categories, click stats and settings) when the plugin is deleted. It's off, the data is kept by default. * Improved: Deleting the plugin always removes its caches and scheduled jobs. * Improved: The update checks are cached for 3 hours instead of asking the store on most admin pages, and the plugin can be set to auto-update in the Plugins screen. * Security: The answers of the update server are never unserialized into PHP objects, and the changelog it sends is escaped. * Improved: An up-to-date translation template (`languages/affiliate-butler-pro.pot`) with the strings of the new admin. = 3.1.0 = * New: Mark links as sponsored (rel="sponsored"), as Google asks for affiliate links. New links are sponsored by default, the existing links are not changed. * New: External links that open in a new window get rel="noopener". * New: The type of the short links redirect: 302 (default), 307 or 301. * New: An option to respect Do Not Track and Global Privacy Control, and the `abutler_track_clicks` filter for consent plugins. * New: An option to delete the clicks older than a number of days. * New: A suggested text for the privacy policy, in Settings > Privacy. * New: The share boxes have X, Facebook, LinkedIn, Reddit, WhatsApp and Email, and the share sheet of the device when it has one. Google+ (closed in 2019) and Tumblr are removed. * Improved: The short links redirect in one step (no trailing slash redirect first), are never cached, and have an X-Robots-Tag: noindex header. * Improved: The country of the visitors also comes from Vercel and the mod_maxminddb module of Apache. = 3.0.0 = * New: A new admin under the "Affiliate Butler" menu: the links list with search and filters, a link editor, per-link stats with charts, and the settings. * New: The link editor shows where its keywords appear in your content. * New: An "Affiliate Butler" panel in the block editor to disable the auto links of a post. * New: The popups, image galleries, videos, maps and share boxes open in the browser's native dialog. jQuery, Magnific Popup and jBox are not used anymore. * Improved: The script and the style of the auto links are only loaded on the pages that have auto links. * Improved: The stats page shows the countries as a list instead of a world map, and the period can be 7, 30, 90 or 365 days. * Changed: Requires WordPress 6.6 or later. * Changed: The old Auto Links screens open the new admin. * Removed: The CMB2 library. The settings and the links keep their data. * Developers: The REST API can create, update and delete links, and read and change the settings. = 2.4.0 = * Changed: Requires PHP 7.4 and WordPress 5.3 or later. * Improved: Clicks are saved in their own database table instead of one growing post meta per link. The stats saved before are moved there automatically, in the background on large sites. * Improved: Only the host of the referrer is saved, not the full URL. * Added: A REST API under `affiliate-butler/v1`: links, link stats, and click tracking. * Added: Bots, crawlers and link previews are no longer counted (filter: `abutler_is_bot`). * Added: Android, iOS and Microsoft Edge in the platforms and browsers stats. * Fixed: The front-end script didn't run on WordPress 5.7 and later (jQuery 3), so popups and click tracking didn't work. * Fixed: Clicks on short links were counted twice, and clicks on popups were counted twice. * Fixed: Auto links don't open through window.open() anymore, so middle click, Ctrl+click and popup blockers work as usual. * Fixed: Deleting a link deletes its clicks. = 2.3.0 = * Improved: A new keyword engine that links all keywords in one pass. Pages render about 10 times faster, and much faster again when the same content is shown again. * Improved: The keyword list and the linked content are cached, and the caches are cleared when a link, a setting, a term or a post changes. * Changed: When keywords overlap, the one that starts first is linked, and the longest one when two start at the same place (e.g. "Amazon Prime" before "Amazon"). * Fixed: Case-insensitive keywords were skipped when the post only had them in another case. * Fixed: Terms of every taxonomy were linked when "Auto Link taxonomies" was saved with none selected. * Fixed: A space was added before every link. * Fixed: Keywords were linked inside scripts, styles and text areas. * Fixed: The popup content was added once per keyword, it is now added once per link, and only when the link is used. * Fixed: "Excluded HTML tags" didn't work with spaces after the commas or uppercase tags. * Fixed: The keyword stats box counted 0 occurrences for keywords with digits or several words. = 2.2.1 = * Security: Fixed SQL injection in the internal links search and the keyword stats box. * Security: Fixed HTML in escaped post text being turned into live markup when keywords are linked. * Security: Added capability checks and nonces to the admin AJAX actions and escaped admin output. * Security: Visitor IPs are no longer sent to a third-party geo service. Countries now come from CDN headers (Cloudflare, CloudFront) or the `abutler_visitor_country` filter. * Security: SSL verification is enabled for license and update requests. * Fixed: Click stats lost the previous countries, browsers, languages, referrers and platforms on every click. * Fixed: Fatal error when visiting a short link that doesn't exist. * Fixed: Translations were not loaded because of a wrong text domain. * Fixed: The "disable for this post" option was saved without a valid nonce check. = 2.2.0 = Added: A new option to disable the auto linking for specific post types. Fixed: PHP warnings and deprecated functions. = 2.1.21 = * Fixed: Update Notice has been fixed. = 2.1.20 = * Fixed: Performance issue, check keywords before replacing. = 2.1.19 = * Fixed: Dofollow links for internal links should not be unfollow. * Fixed: PHP compatibility. = 2.1.18 = * Fixed: Admin search for auto links. = 2.1.17 = * Fixed: Clicks stats were not calculated correctly for not-logged in users. = 2.1.16 = * FIXED: Select2 version conflicts. = 2.1.15 = * FIXED: Broken keywords when the keyword is mentioned in the SEO title. = 2.1.14 = * IMPROVED: The search for internal links. = 2.1.13 = * FIXED: shrink option was not saving when creating a new keyword. * FIXED: limit per post was not working properly. = 2.1.12 = * ADDED: Allow internal links to be searched with letter case insinsitive. = 2.1.11 = * ADDED: Extending internal links search to other available post types = 2.1.10 = * ADDED: a setting to disable excerpt replacement. * FIXED: not saved HTML elements on replacements = 2.1.9 = * FIXED: word occurrences count. = 2.1.8 = * FIXED: Limits per post. = 2.1.7 = * FIXED: fix chinese words spacing" = 2.1.6 = * ADDED: Chinese words support = 2.1.5 = * ADDED: Japanese words support = 2.1.4 = * FIXED: ordering taxonomies warning error = 2.1.3 = * FIXED: rename post type = 2.1.2 = * FIXED: fatal error in the license handler class = 1.1.0 = * ADDED: UI enhancemnts at the "All Auto Links" and "Add new Auto Link" pages. * ADDED: The online Documentation link to the Affiliate Butler menu item. * ADDED: An alternative native base62 encoder if the server doesn't have the BCMath module. * FIXED: per post limit has been fixed for taxonomies auto linking. * FIXED: flushing rewrite rules when activating the plugin. * FIXED: Skipping the keywords which are already linked by the WordPress WYSIWYG editor. * FIXED: Case sensitive option issue. * FIXED: shortcode conflicts with added keywords. =1.0.0= * Initial release. == Upgrade Notice == * Initial release.