Your own Keel installation<\/strong>, at the address you enter in Settings then\nKeel. Read only, anonymous, server to server: your plan list, your domain\nprices, and whether one name is free. What is sent is the domain typed into\nthe search box, and a request header naming this plugin, its version and\nthis site's own address, so that your Keel can tell which of your sites is\nasking. Nothing is sent to us or to any address but the one you entered.<\/p><\/li>\nA captcha provider, only if your Keel requires a solved challenge on\ndomain searches<\/strong>, and only on a page carrying a search: Google reCAPTCHA,\nhCaptcha or Cloudflare Turnstile, whichever you chose in Keel. Script URLs\nand policies are under \"What exactly does a captcha load?\" below.<\/p><\/li>\nTrustpilot's widget<\/strong>, only with [keel_reviews mode=\"widget\"]<\/code>. The\nbrowser loads\n https:\/\/widget.trustpilot.com\/bootstrap\/v5\/tp.widget.bootstrap.min.js.\nTerms\nhttps:\/\/corporate.trustpilot.com\/legal\/for-reviewers\/terms-of-use-for-consumers\nand privacy\nhttps:\/\/corporate.trustpilot.com\/legal\/for-reviewers\/privacy-policy-end-user<\/p><\/li>\nYour public Trustpilot profile<\/strong>, only with\n [keel_reviews mode=\"cached\"]. Your server reads the rating from the page\nyou name and holds it six hours. Nothing loads in the browser, no cookie is\nset, and the request names only this plugin and its version, not your site.\nSame terms as above.<\/p>\n\n[keel_reviews] is off by default, and with it off neither 3 nor 4 happens.<\/p><\/li>\n<\/ol>\n\n\n
Keel lives on a hostname of its own, beside this WordPress site:<\/p>\n\n
\nhttps:\/\/example.com<\/code> - your WordPress site<\/li>\nhttps:\/\/clients.example.com<\/code> - Keel<\/li>\n<\/ul>\n\n\n- Install and activate the plugin.<\/li>\n
- Go to Settings \u2192 Keel<\/strong>.<\/li>\n
- Put in the address Keel is on, the one your customers use to sign in. No\npath. Leave the Storefront box empty.<\/li>\n
- The Connection section on that screen tells you straight away whether it\nworked, which storefront Keel answered for, whether a domain search will\nrun, and the group slugs to paste into a shortcode.<\/li>\n<\/ol>\n\n\n
\nWhat do I put in `product` if my plans have no slugs?<\/h3><\/dt>\nThe id, which Settings \u2192 Keel lists beside every plan. A plan converted from\nanother billing system often has no slug yet, and the storefront says so by\nsending null<\/code> - so the shortcode takes either, exactly as Keel's own order\nform does, and a page and the order form it links to therefore always resolve\nthe same plan.<\/p><\/dd>\nCan Keel go in a subdirectory of my WordPress site?<\/h3><\/dt>\nNo. Keel identifies a company by hostname, and the table it reads has no path\nin it at all, so a path cannot say which company a request is about. Give Keel\na hostname of its own.<\/p><\/dd>\n
What do I put in the Storefront box?<\/h3><\/dt>\nNothing. The address identifies your storefront, and it is the one identifier\nyou cannot get wrong. The box is a compatibility route for an installation that\ndoes not yet know the address you entered.<\/p>\n\n
If you do fill it in with a name belonging to a different company from the\naddress, Keel refuses the request and the settings screen explains it, rather\nthan showing one brand's prices and sending the buyer to another brand's order\nform.<\/p><\/dd>\n
My domain search says it is unavailable<\/h3><\/dt>\nYour Keel is asking for a solved challenge. That challenge is on for domain\nsearches whatever the per-form switch says, because the search is the one thing\non a storefront that can cost you money at a registrar.<\/p>\n\n
This plugin draws the box for reCAPTCHA v2, hCaptcha and Turnstile. It cannot\ndraw invisible reCAPTCHA v3<\/strong>, which has no box. Settings \u2192 Keel says which\none you are on. Either pick one of the three on Keel's captcha screen, or clear\nthe captcha keys there and let Keel rely on its own cache and daily lookup\nceiling.<\/p><\/dd>\nA price I just changed is still showing the old figure<\/h3><\/dt>\nPrices are cached for five minutes so a busy pricing page does not ask Keel on\nevery hit. It will catch up on its own, or press Clear the cache<\/strong> on the\nsettings screen.<\/p><\/dd>\nKeel is down. What do visitors see?<\/h3><\/dt>\nThe last prices this site managed to read, for up to a week, rather than a\nblank space or an error. The settings screen and a notice in your admin say\nthat is what is happening, for as long as it is happening.<\/p>\n\n
Domain availability is never served from an old copy. A week-old \"available\"\nwould sell a name somebody else already registered, so a lookup that fails\nsays it failed.<\/p><\/dd>\n
Can visitors order without leaving my site?<\/h3><\/dt>\nNo, and that is deliberate. Payment, tax and terms belong in one place. Each\nplan links to your Keel order form.<\/p><\/dd>\n
What exactly does a captcha load?<\/h3><\/dt>\nOnly the provider your Keel is set to, and only on a page with a domain\nsearch. Google reCAPTCHA is https:\/\/www.google.com\/recaptcha\/api.js<\/code>, terms\nhttps:\/\/policies.google.com\/terms, privacy https:\/\/policies.google.com\/privacy.\nhCaptcha is https:\/\/js.hcaptcha.com\/1\/api.js<\/code>, terms\nhttps:\/\/www.hcaptcha.com\/terms, privacy https:\/\/www.hcaptcha.com\/privacy.\nCloudflare Turnstile is\n https:\/\/challenges.cloudflare.com\/turnstile\/v0\/api.js, terms\nhttps:\/\/www.cloudflare.com\/website-terms\/, privacy\nhttps:\/\/www.cloudflare.com\/privacypolicy\/. With no challenge required by your\nKeel, none of them is loaded at all.<\/p><\/dd>\nHow do I show a pricing table?<\/h3><\/dt>\n[keel_pricing group=\"shared-hosting\"] draws cards side by side.\n [keel_pricing group=\"shared-hosting\" layout=\"comparison\"] puts the plans\nacross the top and what each includes down the side. Add\n featured=\"advanced-hosting\" to mark one. Both read the same plans, so two\npages cannot disagree.<\/p>\n\n
Rows come from what each plan says it includes, entered in Keel as a label\nand a value. Use the same label across a group and the rows line up. Only\n\"yes\", \"no\", \"true\", \"false\", \"included\" and \"none\" become a tick or a cross;\nanything else prints as you typed it.<\/p><\/dd>\n
Can I compare plans from different groups?<\/h3><\/dt>\nYes: [keel_compare plans=\"basic,advanced,business\"]<\/code> compares exactly those,\nin the order you name them. [keel_compare groups=\"shared,reseller\"]<\/code> compares\nthe cheapest plan in each group.<\/p>\n\nOne table shows one billing period, because a column priced in a different\nperiod is a figure the eye compares and the small print does not correct. Name\nit with cycle=\"1:year\"<\/code>, or leave it out and the period your named plans\nshare is used. If they share none, the shortcode is left unexpanded on the\npage so the problem is visible, and an administrator is told why.<\/p><\/dd>\nCan a visitor see prices in their own currency?<\/h3><\/dt>\n[keel_currency_switcher] offers the currencies your installation really\nprices in, and the order form opens in the one they chose.<\/p><\/dd>\n
Can somebody with no account reach support?<\/h3><\/dt>\n[keel_enquiry] opens a real ticket in a real department, with no account\nneeded.<\/p><\/dd>\n
Does an affiliate link still pay out?<\/h3><\/dt>\nYes. A visitor arriving with ?ref=<\/code> or ?aftid=<\/code> has it carried through to\nyour Keel order form, including on the landing page itself. It is done in the\nbrowser rather than in PHP, so a cached page cannot credit one visitor's\naffiliate for everybody else's sales.<\/p><\/dd>\n\n<\/dl>\n\n\n1.8.1<\/h4>\n\n\n- Security: the enquiry form now carries a nonce and checks it.<\/strong>\n [keel_enquiry] could be submitted from another site, so a cross-site\nrequest was able to open a ticket in your support desk. A page carrying the\nform is now kept out of the page cache, so the nonce on it is always one\nthis site will accept.<\/li>\n
- Query string, cookie and
$_SERVER<\/code> values are sanitized where they are\nread rather than where they are used.<\/li>\n- Markup built inside the plugin is escaped where it is echoed.<\/li>\n
- The Trustpilot terms and privacy links in this readme pointed at addresses\nthat redirect three times; they now name Trustpilot's own current pages.<\/li>\n
- The settings-page confirmation after \"check now\" and \"clear the cache\" is\nshown only for a signed redirect from this plugin.<\/li>\n<\/ul>\n\n
1.8.0<\/h4>\n\n\n- A visitor can now reach your support desk without an account.<\/strong>\n [keel_enquiry] opens a real ticket in a department you have marked as\npublic. Keel has had a public enquiry form since the website builder was\nwritten and it addressed the message by SECTION - a row in Keel's own page\ntree - which a WordPress site has none of and never will, so this was\nunreachable from a marketing site. An internal queue is never offered and\nis refused even when named directly, and the ticket is attached to no\ncustomer account however the address matches.<\/li>\n
[keel_currency_switcher]<\/code><\/strong> offers the currencies your installation\nreally prices in, and carries the choice into the order form. No rate is\napplied to anything: each figure is the one Keel holds for that currency, so\na switched price is the price the invoice will carry.<\/li>\n[keel_compare]<\/code><\/strong> draws a comparison table from the catalogue. The\ncomparison page is the one page on a hosting site that is always out of date,\nbecause it is the one kept by hand.<\/li>\n- An affiliate link that lands on your marketing site now pays out.<\/strong> The\ncode is remembered and added to links pointing at Keel, sixty days, first\ntouch winning, matching Keel's own rule. Affiliatant's parameter is read as\nwell as Keel's.<\/li>\n
- Documented
[keel_tld_pricing]<\/code> and [keel_domain_search]<\/code> by name. Both\nhave worked since 1.0.0 and the description talked about what they do\nwithout ever telling anybody what to type.<\/li>\n<\/ul>\n\n1.7.0<\/h4>\n\n\n- A plan row can be switched between monthly, annual and biennial, and\nnothing on the page is calculated to do it.<\/strong> Every figure the toggle\nwrites was formatted here from a price Keel sent, so a toggled price is the\nsame number the invoice will carry. A script that multiplied a monthly\nfigure by twelve would produce a price nobody could reconcile.<\/li>\n
- The toggle offers only the terms EVERY plan in the row sells.<\/strong> Offering\none that a single plan does not would leave that card showing its monthly\nprice under an \"Annually\" heading, and a visitor reading four cards cannot\ntell which one failed to change. Fewer than two terms in common and there is\nno toggle, which is a group sold on one term rather than a fault.<\/li>\n
cycle=<\/code> still pins a row to one term and now suppresses the toggle with\nit, because the attribute is an instruction and a control that overrode it\nwould make the page disagree with its own heading.<\/li>\n- The card opens on the term the toggle opens on. Without a
cycle=<\/code> the\ncheapest recurring price was shown, which on a group sold quarterly as well\nas annually put a quarterly figure under a pressed \"Annually\" button.<\/li>\n- The control ships
hidden<\/code> and a theme's script removes the attribute, so a\nreader with no JavaScript is shown one complete price and never a dead\ncontrol.<\/li>\n<\/ul>\n\nEarlier versions are in changelog.txt<\/code>, which ships with the plugin.<\/p>","raw_excerpt":"Puts your live hosting plans, domain prices and a working domain search on any WordPress site, read from your own Keel installation.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/402025","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=402025"}],"author":[{"embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/havenswift-hosting"}],"wp:attachment":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=402025"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=402025"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=402025"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=402025"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=402025"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=402025"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}