Please don’t break functionality in minor version upgrades

[ad_1]

Hey @kwisatz,

Thanks for reaching out to us.

Can you please share any details of what issue you faced after upgrading to the latest version?

Several functions got removed from 4.8.12 to 4.9.0. While they may have been deprecated for a while, a minor version upgrade is usually not where one would expect such changes to happen:

Given a version number MAJOR.MINOR.PATCH, increment the:

  1. MAJOR version when you make incompatible API changes
  2. MINOR version when you add functionality in a backwards compatible manner
  3. PATCH version when you make backwards compatible bug fixes

https://semver.org/

In other words, the major version should have been changed from 4 to 5 when those functions were removed. And while semver is not the only way to handle versioning, it is very widespread and users’ expectations are towards most software adhering to that contract.

That being said, I also have hard time finding any documentation on the programming API on https://www.mc4wp.com/kb/. I am currently going through the source code to see how to replace the functionality that has been removed.

  • This reply was modified 2 hours, 52 minutes ago by kwisatz.
  • This reply was modified 2 hours, 49 minutes ago by kwisatz.
  • This reply was modified 2 hours, 47 minutes ago by kwisatz.

Plugin Contributor
Lap

(@lapzor)

Thank you for the feedback.

In 2016 we did bump the version when we depreciated those hooks. Only now we’ve finally actually really removed them. We were hoping people would have noticed the depreciation warning in their logs by now. I suppose we could have bumped the version again either way.

Not all hooks are documented, and hooks that are not documented aren’t always as save to use / are more likely to change at some point as they might only be meant for our internal use.

You can check https://www.mc4wp.com/changelog/ and search for the hooks you need to replace, likely it will mention in the changelog what they were replaced with at the time we marked them as depreciated.

Besides the KB, a good place to look for filters and action hooks is https://github.com/ibericode/mailchimp-for-wordpress/tree/master/sample-code-snippets

Thanks again for your feedback!

Kind regards

 

This site will teach you how to build a WordPress website for beginners. We will cover everything from installing WordPress to adding pages, posts, and images to your site. You will learn how to customize your site with themes and plugins, as well as how to market your site online.

Buy WordPress Transfer