{"id":87352,"date":"2018-10-23T12:09:56","date_gmt":"2018-10-23T12:09:56","guid":{"rendered":"https:\/\/wordpress.org\/plugins\/ko-fi-button\/"},"modified":"2025-12-12T01:46:51","modified_gmt":"2025-12-12T01:46:51","slug":"ko-fi-button","status":"publish","type":"plugin","link":"https:\/\/ur.wordpress.org\/plugins\/ko-fi-button\/","author":16218776,"comment_status":"closed","ping_status":"closed","template":"","meta":{"_crdt_document":"","version":"1.3.10","stable_tag":"1.3.10","tested":"6.9.4","requires":"4.6","requires_php":"5.6","requires_plugins":null,"header_name":"Ko-fi Button","header_author":"Ko-fi Team","header_description":"A ko-fi plugin for your website! Includes widgets, shortcode and much more!","assets_banners_color":"272727","last_updated":"2025-12-12 01:46:51","external_support_url":"","external_repository_url":"","donate_link":"https:\/\/ko-fi.com\/supportkofi","header_plugin_uri":"","header_author_uri":"https:\/\/www.ko-fi.com","rating":5,"author_block_rating":0,"active_installs":5000,"downloads":87710,"num_ratings":1,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":{"1.0.2":{"tag":"1.0.2","author":"chris.odell","date":"2021-01-19 23:12:58"},"1.0.3":{"tag":"1.0.3","author":"chris.odell","date":"2021-07-21 05:42:46"},"1.1.0":{"tag":"1.1.0","author":"cameronjonesweb","date":"2022-06-05 04:08:24"},"1.2.0":{"tag":"1.2.0","author":"cameronjonesweb","date":"2022-10-03 00:41:25"},"1.2.1":{"tag":"1.2.1","author":"cameronjonesweb","date":"2022-10-03 22:24:30"},"1.3.0":{"tag":"1.3.0","author":"cameronjonesweb","date":"2023-04-09 08:57:10"},"1.3.1":{"tag":"1.3.1","author":"cameronjonesweb","date":"2023-04-09 14:35:34"},"1.3.10":{"tag":"1.3.10","author":"cameronjonesweb","date":"2025-12-12 01:46:51"},"1.3.2":{"tag":"1.3.2","author":"cameronjonesweb","date":"2023-04-10 14:18:09"},"1.3.3":{"tag":"1.3.3","author":"cameronjonesweb","date":"2023-04-25 10:48:15"},"1.3.4":{"tag":"1.3.4","author":"cameronjonesweb","date":"2023-06-01 15:12:07"},"1.3.5":{"tag":"1.3.5","author":"cameronjonesweb","date":"2024-04-22 14:48:04"},"1.3.6":{"tag":"1.3.6","author":"cameronjonesweb","date":"2024-04-22 14:48:04"},"1.3.7":{"tag":"1.3.7","author":"cameronjonesweb","date":"2024-10-09 09:42:58"},"1.3.8":{"tag":"1.3.8","author":"cameronjonesweb","date":"2025-03-18 02:43:14"},"1.3.9":{"tag":"1.3.9","author":"cameronjonesweb","date":"2025-08-18 08:19:53"}},"upgrade_notice":[],"ratings":{"1":0,"2":0,"3":0,"4":0,"5":"1"},"assets_icons":{"icon-256x256.png":{"filename":"icon-256x256.png","revision":3252422,"resolution":"256x256","location":"assets","locale":""},"icon-512x512.png":{"filename":"icon-512x512.png","revision":3252422,"resolution":"512x512","location":"assets","locale":""}},"assets_banners":{"banner-1544x500.png":{"filename":"banner-1544x500.png","revision":3252422,"resolution":"1544x500","location":"assets","locale":""},"banner-772x250.png":{"filename":"banner-772x250.png","revision":3252422,"resolution":"772x250","location":"assets","locale":""}},"assets_blueprints":{},"all_blocks":[],"tagged_versions":["1.0.2","1.0.3","1.1.0","1.2.0","1.2.1","1.3.0","1.3.1","1.3.10","1.3.2","1.3.3","1.3.4","1.3.5","1.3.6","1.3.7","1.3.8","1.3.9"],"block_files":[],"assets_screenshots":{"screenshot-1.png":{"filename":"screenshot-1.png","revision":1961298,"resolution":"1","location":"assets","locale":""},"screenshot-2.png":{"filename":"screenshot-2.png","revision":1961298,"resolution":"2","location":"assets","locale":""}},"screenshots":{"1":"Ko-fi settings page, set the default settings of the button","2":"Customize the button for a specific widget placement"},"jetpack_post_was_ever_published":false},"plugin_section":[],"plugin_tags":[13301,246270,1932,377,24508],"plugin_category":[45,58],"plugin_contributors":[79034,128014,163381],"plugin_business_model":[],"class_list":["post-87352","plugin","type-plugin","status-publish","hentry","plugin_tags-donate-plugin","plugin_tags-ko-fi","plugin_tags-membership","plugin_tags-monetization","plugin_tags-paypal-donate","plugin_category-ecommerce","plugin_category-user-management","plugin_contributors-cameronjonesweb","plugin_contributors-chrisodell","plugin_contributors-kofibutton","plugin_committers-cameronjonesweb","plugin_committers-chrisodell","plugin_committers-koficommunity","plugin_support_reps-chrisodell"],"banners":{"banner":"https:\/\/ps.w.org\/ko-fi-button\/assets\/banner-772x250.png?rev=3252422","banner_2x":"https:\/\/ps.w.org\/ko-fi-button\/assets\/banner-1544x500.png?rev=3252422","banner_rtl":false,"banner_2x_rtl":false},"icons":{"svg":false,"icon":"https:\/\/ps.w.org\/ko-fi-button\/assets\/icon-256x256.png?rev=3252422","icon_2x":"https:\/\/ps.w.org\/ko-fi-button\/assets\/icon-256x256.png?rev=3252422","generated":false},"screenshots":[{"src":"https:\/\/ps.w.org\/ko-fi-button\/assets\/screenshot-1.png?rev=1961298","caption":"Ko-fi settings page, set the default settings of the button"},{"src":"https:\/\/ps.w.org\/ko-fi-button\/assets\/screenshot-2.png?rev=1961298","caption":"Customize the button for a specific widget placement"}],"raw_content":"<!--section=description-->\n<p>Ko-fi is a fast and friendly way to earn money from your blog, website or project.<\/p>\n\n<p>Create your free page at ko-fi.com in just a few minutes and link your PayPal or Stripe account to start receiving donations.<\/p>\n\n<p>Use the Plugin to add a Ko-fi button or donation panel to any widget area, sidebar or use the shortcode [kofi] to add a button to any page or post.<\/p>\n\n<p>Not sure where to start? <a href=\"https:\/\/help.ko-fi.com\/hc\/en-us\/articles\/115004002614-Adding-a-Ko-fi-Button-to-your-WordPress-site-or-blog\">Take a look at our guide!<\/a><\/p>\n\n<!--section=installation-->\n<p>To install the plugin, please follow the following steps:<\/p>\n\n<ol>\n<li>Go to 'Plugins' and click Add New, search for Ko-fi and install the plugin or upload the plugin files to the \/wp-content\/plugins\/Ko-fi-plugin directory.<\/li>\n<li>Activate the plugin through the \u2018Plugins' screen in WordPress.<\/li>\n<li>Use the Settings &gt; Ko-fi Settings screen to link to your Ko-fi page and configure the default settings.<\/li>\n<li>Go to Appearance &gt; Widgets and add a \u2018Ko-fi button' widget to any Sidebar or Widget area.<\/li>\n<li>Override any default settings in the widget.<\/li>\n<li>You can also add your Ko-fi button to any Page or Post using Shortcode [kofi].<\/li>\n<\/ol>\n\n<!--section=faq-->\n<dl>\n<dt id='what%20is%20ko-fi'><h3>What is Ko-fi<\/h3><\/dt>\n<dd><p>Ko-fi is a donation service allowing creators to receive small payments (roughly the price of a coffee) from supporters of their work. Used as an alternative to advertising, Ko-fi helps all types of artists, cosplayers, bloggers, coders and podcasters to fund their passions.<\/p><\/dd>\n<dt id='do%20ko-fi%20take%20a%20fee'><h3>Do Ko-fi take a fee<\/h3><\/dt>\n<dd><p>The payment processor will take a small fee for processing the transaction, but Ko-fi is free to use for accepting simple donations. For advanced features you'll pay a creator-friendly 5% platform fee.<\/p><\/dd>\n<dt id='what%20about%20monthly%20memberships'><h3>What about monthly memberships<\/h3><\/dt>\n<dd><p>Yes, use Ko-fi to receive monthly subscriptions or create your own membership tiers. Use membership tiers to offer different benefits and price points to suit your audience.<\/p><\/dd>\n<dt id='what%20does%20the%20wordpress%20plugin%20do'><h3>What does the WordPress Plugin do<\/h3><\/dt>\n<dd><p>The WordPress plugin allows WordPress users to easily add a customisable 'Support me on Ko-fi' button to their blog or website. Simply add the plugin, enter your page details and place the widget in a sidebar or widget area.<\/p>\n\n<p>Alternatively use the [kofi] shortcode in your page or in the shortcode block.<\/p>\n\n<p>For more information see the help page at <a href=\"https:\/\/help.ko-fi.com\/hc\/en-us\/articles\/115004002614-Add-a-Ko-fi-button-to-your-WordPress-site\">ko-fi.com.<\/a><\/p><\/dd>\n<dt id='help%21%20the%20default%20code%20on%20my%20widget%20has%20changed'><h3>Help! The Default Code on my widget has changed<\/h3><\/dt>\n<dd><p>With the release of 1.0.1 your Ko-fi code now comes from the settings page when using the shortcode or a widget.<\/p>\n\n<p>If you have not set your Ko-fi code in the settings page then simply update the Default Page Name\/Id on the settings page, save the change and the widget will automatically pick it up.<\/p><\/dd>\n<dt id='i%27m%20getting%20errors%20with%20the%20widget%20after%20upgrading%20to%20the%20block%20widget%20editor'><h3>I'm getting errors with the widget after upgrading to the block widget editor<\/h3><\/dt>\n<dd><p>In most instances there shouldn't be any issues upgrading to the block widget editor, but if you do encounter errors try removing the widget, saving, and adding the widget again.<\/p><\/dd>\n<dt id='what%20options%20are%20available%20for%20the%20%60%5Bkofi%5D%60%20shortcode%3F'><h3>What options are available for the `[kofi]` shortcode?<\/h3><\/dt>\n<dd><p>The following options are available:<\/p>\n\n<ul>\n<li><code>type<\/code>: The type of Ko-fi widget to embed. Either <code>button<\/code> (default) or <code>panel<\/code>.<\/li>\n<li><code>code<\/code>: Your Ko-fi username<\/li>\n<li><code>text<\/code>: The button text (if using <code>button<\/code> type)<\/li>\n<li><code>color<\/code>: The button background color (if using <code>button<\/code> type)<\/li>\n<\/ul>\n\n<p>You don't need to provide any of the options unless required, the options will default to the settings from the plugin settings page if not specified.<\/p><\/dd>\n<dt id='how%20can%20i%20control%20which%20pages%20the%20floating%20button%20displays%20on%3F'><h3>How can I control which pages the Floating Button displays on?<\/h3><\/dt>\n<dd><p>By default, the floating button displays on every page when enabled. You can override it on individual posts and pages with the <code>Display floating button on this page<\/code> setting to hide on specific pages, or alternatively display only on specific pages when disabled globally.\nFor more advanced use cases, you can use the <code>kofi_display_floating_button<\/code> filter.<\/p><\/dd>\n<dt id='acknowledgements'><h3>Acknowledgements<\/h3><\/dt>\n<dd><ul>\n<li>Thanks to @mlchaves for his assistance with making the plugin php7.3 compliant.<\/li>\n<\/ul><\/dd>\n\n<\/dl>\n\n<!--section=changelog-->\n<h4>1.3.10<\/h4>\n\n<ul>\n<li>Tested with WordPress 6.9<\/li>\n<li>Fix HTML title attribute not working for widgets<\/li>\n<li>Automatically resize floating button based on button text<\/li>\n<\/ul>\n\n<h4>1.3.9<\/h4>\n\n<ul>\n<li>Tested with WordPress 6.8<\/li>\n<li>Code quality improvements<\/li>\n<li>Fix panel widget alignment issue in some block themes<\/li>\n<li>Add option to customize the HTML title attribute for donate buttons<\/li>\n<\/ul>\n\n<h4>1.3.8<\/h4>\n\n<ul>\n<li>Tested with WordPress 6.7<\/li>\n<li>Meta updates<\/li>\n<\/ul>\n\n<h4>1.3.7<\/h4>\n\n<ul>\n<li>Fix deprecated function error on PHP 8+<\/li>\n<\/ul>\n\n<h4>1.3.6<\/h4>\n\n<ul>\n<li>Fix fatal error on outdated versions of PHP<\/li>\n<\/ul>\n\n<h4>1.3.5<\/h4>\n\n<ul>\n<li>Fix plugin translations not being loaded<\/li>\n<li>Fix overzealous escaping being applied to HTML elements<\/li>\n<li>Fix undefined index error sometimes occuring if a page has not been saved<\/li>\n<\/ul>\n\n<h4>1.3.4<\/h4>\n\n<ul>\n<li>Fix fatal error on outdated versions of PHP<\/li>\n<li>Code quality improvements - now compliant with the WordPress PHP coding standards<\/li>\n<li>Increase minimum PHP version to 5.6<\/li>\n<\/ul>\n\n<h4>1.3.3<\/h4>\n\n<ul>\n<li>XSS security fix<\/li>\n<li>Fix missing closing tag on link-only buttons<\/li>\n<\/ul>\n\n<h4>1.3.2<\/h4>\n\n<ul>\n<li>Fix undefined array key warning<\/li>\n<li>Replace deactivation hook with uninstall hook<\/li>\n<\/ul>\n\n<h4>1.3.1<\/h4>\n\n<ul>\n<li>Fix errors on sites running PHP 8<\/li>\n<\/ul>\n\n<h4>1.3.0<\/h4>\n\n<ul>\n<li>Intoduce new floating button options.<\/li>\n<\/ul>\n\n<h4>1.2.1<\/h4>\n\n<ul>\n<li>Fix potential fatal error<\/li>\n<\/ul>\n\n<h4>1.2.0<\/h4>\n\n<ul>\n<li>PHP 8 compatibility updates<\/li>\n<li>Replace third party color picker script with native color picker from WordPress core<\/li>\n<li>Improve reliability of default coffee code settings<\/li>\n<li>Code quality improvements<\/li>\n<\/ul>\n\n<h4>1.1.0<\/h4>\n\n<ul>\n<li>Fix button alignment bug with themes that support full width aligned blocks<\/li>\n<li>Fix conflict with Elementor<\/li>\n<li>Add donation panel widget<\/li>\n<li>Expand shortcode capabilities to include changing the username and embed the donation panel<\/li>\n<li>Allow changing the username in the widget<\/li>\n<li>Additional security checks<\/li>\n<li>Code quality improvements<\/li>\n<\/ul>\n\n<h4>1.0.3<\/h4>\n\n<ul>\n<li>Handle the case with an apostrophe in the button text.<\/li>\n<li>Remove double quotation marks when rendering widget javascript to browser.<\/li>\n<li>Tested for button text handling extended characters.<\/li>\n<\/ul>\n\n<h4>1.0.2<\/h4>\n\n<ul>\n<li>Align 'Default Code' field name in the Widget with the field name 'Page Name Or ID' on the settings.<\/li>\n<li>Set the default value in 'Page Name or ID' on the settings to being empty and set the placeholder to 'supportkofi'.<\/li>\n<li>When adding a new widget take the default values from the current Ko-fi settings.<\/li>\n<li>Re-arrange settings into a more logical order on the settings page.<\/li>\n<\/ul>\n\n<h4>1.0.1<\/h4>\n\n<ul>\n<li>Minor updates to the wording used within the plugin and to the use of 'Ko-fi'.<\/li>\n<li>Addition of ability to change button alignment within containing element.<\/li>\n<li>Bring plugin version in-line with readme.<\/li>\n<li>Fix hyperlink functionlity.<\/li>\n<li>Make the 'Default Code' widget field readonly and always the same value as on the settings page.<\/li>\n<\/ul>\n\n<h4>1.0.0<\/h4>\n\n<ul>\n<li>Initial release<\/li>\n<\/ul>","raw_excerpt":"Receive donations on your Ko-fi page with a button on your WordPress site.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/ur.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/87352","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/ur.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/ur.wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/ur.wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=87352"}],"author":[{"embeddable":true,"href":"https:\/\/ur.wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/koficommunity"}],"wp:attachment":[{"href":"https:\/\/ur.wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=87352"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/ur.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=87352"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/ur.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=87352"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/ur.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=87352"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/ur.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=87352"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/ur.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=87352"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}