Ko-Fi Button

1. 

   Ko-fi settings page, set the default settings of the button

2. 

   Customize the button for a specific widget placement

What is Ko-fi

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.

Do Ko-fi take a fee

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.

What about monthly memberships

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.

What does the WordPress Plugin do

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.

Alternatively use the [kofi] shortcode in your page or in the shortcode block.

For more information see the help page at ko-fi.com.

Help! The Default Code on my widget has changed

With the release of 1.0.1 your Ko-fi code now comes from the settings page when using the shortcode or a widget.

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.

I’m getting errors with the widget after upgrading to the block widget editor

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.

What options are available for the `[kofi]` shortcode?

The following options are available:

• type: The type of Ko-fi widget to embed. Either button (default) or panel.
• code: Your Ko-fi username
• text: The button text (if using button type)
• color: The button background color (if using button type)

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.

How can I control which pages the Floating Button displays on?

By default, the floating button displays on every page when enabled. You can override it on individual posts and pages with the Display floating button on this page setting to hide on specific pages, or alternatively display only on specific pages when disabled globally.
For more advanced use cases, you can use the kofi_display_floating_button filter.

Acknowledgements

• Thanks to @mlchaves for his assistance with making the plugin php7.3 compliant.

Hide FAQ

1.3.10

• Tested with WordPress 6.9
• Fix HTML title attribute not working for widgets
• Automatically resize floating button based on button text

1.3.9

• Tested with WordPress 6.8
• Code quality improvements
• Fix panel widget alignment issue in some block themes
• Add option to customize the HTML title attribute for donate buttons

1.3.8

• Tested with WordPress 6.7
• Meta updates

1.3.7

• Fix deprecated function error on PHP 8+

1.3.6

• Fix fatal error on outdated versions of PHP

1.3.5

• Fix plugin translations not being loaded
• Fix overzealous escaping being applied to HTML elements
• Fix undefined index error sometimes occuring if a page has not been saved

1.3.4

• Fix fatal error on outdated versions of PHP
• Code quality improvements – now compliant with the WordPress PHP coding standards
• Increase minimum PHP version to 5.6

1.3.3

• XSS security fix
• Fix missing closing tag on link-only buttons

1.3.2

• Fix undefined array key warning
• Replace deactivation hook with uninstall hook

1.3.1

• Fix errors on sites running PHP 8

1.3.0

• Intoduce new floating button options.

1.2.1

• Fix potential fatal error

1.2.0

• PHP 8 compatibility updates
• Replace third party color picker script with native color picker from WordPress core
• Improve reliability of default coffee code settings
• Code quality improvements

1.1.0

• Fix button alignment bug with themes that support full width aligned blocks
• Fix conflict with Elementor
• Add donation panel widget
• Expand shortcode capabilities to include changing the username and embed the donation panel
• Allow changing the username in the widget
• Additional security checks
• Code quality improvements

1.0.3

• Handle the case with an apostrophe in the button text.
• Remove double quotation marks when rendering widget javascript to browser.
• Tested for button text handling extended characters.

1.0.2

• Align ‘Default Code’ field name in the Widget with the field name ‘Page Name Or ID’ on the settings.
• Set the default value in ‘Page Name or ID’ on the settings to being empty and set the placeholder to ‘supportkofi’.
• When adding a new widget take the default values from the current Ko-fi settings.
• Re-arrange settings into a more logical order on the settings page.

1.0.1

• Minor updates to the wording used within the plugin and to the use of ‘Ko-fi’.
• Addition of ability to change button alignment within containing element.
• Bring plugin version in-line with readme.
• Fix hyperlink functionlity.
• Make the ‘Default Code’ widget field readonly and always the same value as on the settings page.

1.0.0

• Initial release