WordPress logoUpgrade Preflight Check is a plugin that will attempt to check your other plugins and themes for problems that may cause errors when upgrading to WordPress 2.3. Run this before upgrading and it may save some headaches. It works in version 2.3 too and may be useful to help identify the cause of errors.

About WordPress 2.5 and Beyond

The current version of Upgrade Preflight Check only checks for problems in upgrading to WordPress 2.3. This is still useful if you’re upgrading from a version prior to 2.3 but obsolete otherwise. I will not be updating this plugin further.

Important Note

Having or not having problems listed in the Upgrade Preflight Check report is not a guarantee of compatibility or failure. It is designed as a starting point to help you follow-up on potential problems. Please check individual plugin and theme Web pages to fully verify compatibility. (And always make a backup before upgrading.)

How It Works

This plugin works by scanning for the appearance of text within plugins and themes that may indicate compatibility problems.

It currently looks for the following:

  • Use of the old category tables that are now gone.
  • Use of wp-admin/upgrade-functions.php, which has been moved and renamed.
  • Use of the get_the_title function, which works a little differently.
  • Use of deprecated permalink functions, which still work for now but should be replaced.

Each of these conditions comes from discussions on the wp-testers mailing list and various blog posts during the time leading up to the WordPress 2.3 release. More details are shown at the bottom of the report.

Installation and Use

  • Upload upgrade-preflight.php to the /wp-content/plugins/ directory.
  • Activate the plugin through the Plugins menu in WordPress.
  • Use the Upgrade Preflight menu under Options in the WordPress admin panel to generate a report.
  • There is no need to leave the plugin activated when not using it. Disable it when done.

Download

Download from smithsrus.com: Upgrade Preflight Check

Samuel Aguilera was nice enough to create a Spanish translation that you can download from his site.

Version History

Version 1.1, 10/22/07

  • Additional checks for plugins knowing about the new tag system so they don’t get flagged as incompatible. i.e., Sitemap Generator 3.0.
  • Internationalization of text. If you do a translation please send the files over. I’ll post them here for download and give you credit.
  • Miscellaneous clean up.
  • Added GPL license text.

Version 1.0, 9/26/07

  • Initial release.

Donations

I’ve been asked for a way to make donations. If the plugin saved you time or trouble and you want to say “thank you” in that way, you may do so through a PayPal donation or the Amazon Honor System.

95 thoughts on “WordPress Upgrade Preflight Check

  1. Well played, Doug. I’ll give a shot and let you know what I can get it to do, hehe.

  2. Simple but great!. Good work Doug.

  3. Brilliant. I wish I’d know this existed yesterday morning before upgrading. would have saved me hours of headaches.
    Please do this for all future releases.
    Many thanks
    Drew

  4. Nice – pointed out some potential issues that might have had me scratching my head otherwise. Now I know which plugins to thump :)

  5. [...] Jedes Plugin, aktiv und inaktiv, wird auf die veränderten Funktionen und Datenbankzugriffe geprüft. Gleiches gilt für die abgelegten Themes. Damit wird der Sprung auf die neue Version sichtlich ersichtlich – eine tolle Idee. Die Idee und Lösung stammt von Doug Smith und ist auf der folgenden Seite zu finden: „Wordpress Upgrade Preflight Check”. [...]

  6. [...] Das Plugin könnt Ihr auf der Seite von Doug Smith (er hat es auch geschrieben) downloaden. [...]

  7. [...] Smiths R Us » WordPress Upgrade Preflight Check [...]

  8. [...] WordPress Version 2.3 upzudaten, aber auf Nummer sicher gehen will, der sollte vor dem Update das Plugn Preflight Check installieren. Das Plugin versucht zu prüfen, ob die derzeit installierten Plugins, Fehler beim [...]

  9. [...] WordPress Upgrade Preflight Check – Plugin til at tjekke om dine plugins er kompatible med ny WordPress-version. Genialt! [...]

  10. [...] WordPress Upgrade Preflight Check attempts to check your other plugins and themes for problems that may cause errors when upgrading to WordPress 2.3. [...]

  11. Great idea. :) I disabled all the plugins that could be causing problems, but it looks like it may be the theme. Well, now to see about fixing that… Thanks!

  12. [...] information about the plugin can be found on Doug’s blog. Great stuff [...]

  13. Hi! Thank you very much for this great plugin. It’s easy and powerful, so it’s perfect :)

    I have made a spanish translation for the plugin for even better help for people that speak spanish ;)

  14. [...] with how the new changes will impact your blog. However, with the release of Doug Smith’s WordPress Upgrade Preflight Check plugin, upgrading just got a little less [...]

  15. [...] Rabbit deposit refunded? Where is my calavera? Googly Eyes for invitations Finish Halloween party guest list Finish Halloween party invitations Script fonts for the pc See & Sew Book: make bag w/Isabel Print Pix for me color my hair Print Pix for Mom Print Pix Florence V9.23 Opera on mac? yes. On PC? find out. then mark update entry read in bl Windshield 606-9600 ( Review Burda 8110 shorts (need pix) Review Burda 8110 top Review McCall M4887 Spay rabbit week of 10/30 Upgrade WordPress when mySQL gets upgraded Upgrading to WordPress 2.3 Dexter WordPress Upgrade Preflight Check [...]

  16. Thanks for this one. It solved a problem with several plug-ins after I had already upgraded to 2.3. A small donation will follow for you efforts. Thanks again.

  17. [...] repaired a couple of minor glitches by hand, you can gain the benefit of my impatience by running a Preflight Check to avoid any headaches [...]

  18. [...] WordPress Upgrade Preflight Check Upgrade Preflight Check is a plugin that will attempt to check your other plugins and themes for problems that may cause errors when upgrading to WordPress 2.3. Run this before upgrading and it may save some headaches. (tags: wordpress plugin) [...]

  19. [...] user, you really should go download the latest version and upgrade, however make sure you get this Upgrade Preflight Check plugin first. It will scan your setup and see if there are likely to be any issues with the upgrade. [...]

  20. [...] Download: Upgrade Prefligh Check Via: Smith R Us  [...]

  21. This is by far one of the most useful WP plugins I’ve come across in using WordPress. Thank you very much!

    I do hope that you’ll consider carrying-on the torch to release Pre-flight Checks for future upgrades as well. Or, perhaps see if Matt and the team would consider an official plug-in, making this an in-house ‘thing’ prior to major upgrades from now on.

  22. [...] WordPress Upgrade Preflight Check attempts to check your other plugins and themes for problems that may cause errors when upgrading to WordPress 2.3. [...]

  23. [...] WordPress Upgrade Preflight Check by SmithRUs [...]

  24. Thank you so much! I run a huge website which relies on a bunch of plugins in order to work properly and your wonderful plugin just saved me a lot of work.

  25. [...] To get this plugin, go to WordPress Upgrade Preflight Check [...]

  26. Brilliant plugin which goes into my top five favourites WP plugin list. Thanks, it’s saved me a lot of time and hassle

  27. [...] the WordPress Upgrade Preflight Check and run it to identify which existing plugins you have will work or won’t work with [...]

  28. [...] A big thank you to Samuel Aguilera who created a Spanish translation of my WordPress Upgrade Preflight Check plugin. [...]

  29. [...] WordPress Upgrade Preflight Check – “Upgrade Preflight Check is a plugin that will attempt to check your other plugins and themes for problems that may cause errors when upgrading to WordPress 2.3. Run this before upgrading and it may save some headaches. It works in version 2.3 too and may be useful to help identify the cause of errors.” [...]

  30. [...] you plan to upgrade to WordPress 2.3, a good idea is to first run the WordPress Upgrade Preflight Checklist [...]

  31. Hi, just noticed that the plugin doesn’t redo the check. I had a bogus upgrade-functions.php in my code, removed it, but it still complains about it.

  32. [...] Compatibility to confirm the theme and plugins you’re using are compatible. There is also WordPress Upgrade Preflight Check (http://smithsrus.com/downloads/wordpress-upgrade-preflight-check/) that will attempt to check [...]

  33. [...] sure to install and run the WordPress Upgrade Preflight Check to look for compatibility issues before you upgrade to version 2.3. Upgrade Preflight Check is a [...]

  34. [...] the “Upgrade Preflight Check” WordPress plugin and activate it, then create a report in order for you to identify the [...]

  35. [...] Smiths R Us » WordPress Upgrade Preflight Check (tags: wordpress plugins upgrade todo) [...]

  36. [...] Upgrade-preflight When I was upgrading to WordPress 2.3 I ran into a load of buggy problems. After a bit of hunting around I came across the ‘Upgrade Preflight’ Plugin. Essentially it tells you any possible problem plugins or areas for concern and allows you to very quickly identify the offending plugins that are no longer compatible with the new wordpress release. Download Upgrade Preflight [...]

  37. Nice…. plugin dude.. I really liked it… a lot of plugins..don’t work… for me.. on http://www.corpoalert.com
    I will find for newer versions or better alternatives…

    I really liked the speed of creating that list….

  38. [...] Compatibility to confirm the theme and plugins you’re using are compatible. There is also WordPress Upgrade Preflight Check (http://smithsrus.com/downloads/wordpress-upgrade-preflight-check/) that will attempt to check [...]

  39. [...] people alert the codex, so to still be sure we recommend you load and run this amazing plugin: http://smithsrus.com/downloads/wordpress-upgrade-preflight-check/.  We can tell you, if we had found this first…it’d have saved us several hours of [...]

  40. Fab plugin – thank you. Now I just need to add the dodgy plugins back in, one by one, to see which was the culprit …

  41. [...] WordPress Upgrade Preflight Check – Tags:wordpress plugins [...]

  42. [...] just finished a minor update to my WordPress Upgrade Preflight Plugin. Here are the [...]

  43. [...] To Improve WordPress 2.3 Upgrade: WordPress Upgrade Preflight Check WordPress Plugin attempts to check Plugins and Themes for errors when upgrading to WordPress 2.3. Run this before [...]

  44. [...] Smiths R Us » WordPress Upgrade Preflight Check [...]

  45. [...] big thanks to Smiths R Us for the very fine plugin WordPress Upgrade Preflight Check, which I wish I would have known about [...]

  46. [...] your Plugin compatibility and Theme compatibility before upgrading to WordPress 2.3. There is also WordPress Upgrade Preflight Check  that will attempt to check your other plugins and themes for problems before you install [...]

  47. That was actually very usefull. But I’m still dreaming for the day that wordpress will be able to update itself. =)

  48. helpful, thx. when preping for wp.2.3.2 i noticed that the path to upgrade.php is not wp-admin/include/upgrade.php but wp-admin/includes/upgrade.php — notice that little “s” … ;-)

  49. Thanks Peter. I’ll get that fixed in the next round. I was just about to investigate why it was giving false positives on a few plugins. That was the answer. :-)

  50. ok, now here is a really good idea! how many times are there incompatibilities when upgrading. Thanks for a great idea for a plugin. i echo the user above about wordpress updating itself – would love to see that!

  51. Great resource!!! I will keep this in mind for the next plugin review on my website!

  52. Thanks for the plugin – am about to upgrade our company wordpress installation so your work has probably saved us a lot of trouble :)

  53. I have been a frequent visitor of this blog for some time now, so I thought it would be a good idea to leave you with my thanks.

    Regards,
    Jim Mirkalami

  54. Home Based Business

    Wow, thanks for this post. I have had so many problems upgrading and with certain themes. Thanks again

  55. Thanks for this, it saved me hours of hassles. Another cool plugin worth mentioning on the topic of Upgrading WordPress, is the Instant Upgrade which makes the actual upgrading a snap (it doesn’t check for problems though) so we still need to run your PreFlight Check first.

  56. The upgrade preflight check is very usefull, it saves a lot of time and trouble at the last update for one of my clients

  57. [...] use with your site may not be compatible with the new version, so it is always wise to check out WordPress Upgrade Preflight Check just to make sure that the plugins you’re using are going to go well with the new [...]

  58. [...] a PreFlight Test: The WordPress Upgrade Preflight Check Plugin tests your blog to make sure it is ready for the new version. This is especially good for those [...]

  59. Any news on a 2.5 checking version?
    Also, hope you don’t mind the suggestion, but a ‘subscribe to comments’ type plugin might be useful on this site…

  60. @Chris: Yes, I’m working on a version to help with the WordPress 2.5 upgrade. I’ve been keeping an eye on the development and noting things that may break. I’m also hoping someone will do a post about things to watch for in upgrading to WordPress 2.5. There were a few of those posts for 2.3 that were helpful in making my list of things to check. Suggestions from all are welcome.

    Good idea on the comments subscription. I’ve been meaning to do that but just haven’t gotten around to it. Do you have a favorite plugin that is working well for that purpose?

  61. [...] OMG, hab grad den preflight-check lokal drüberlaufen lassen… es wird so nicht funktionieren das Upgrade :D [...]

  62. @Doug: If it helps, I use this plugin for comments subscription (http://txfx.net/code/wordpress/subscribe-to-comments/)

  63. [...] list includes steps like checking compatibilities, doing a PreFlight test, disable and/or remove old plugins and the most important step of all – [...]

  64. [...] o plugin WordPress Upgrade Preflight Check, que segundo Lorelle, verifica se sua instalação atual está apta a ser [...]

  65. [...] a PreFlight Test: The WordPress Upgrade Preflight Check Plugin tests your blog to make sure it is ready for the new version. This is especially good for those [...]

  66. [...] a PreFlight Test: The WordPress Upgrade Preflight Check Plugin tests your blog to make sure it is ready for the new version. This is especially good for those [...]

  67. [...] Rodar o plugin WordPress Upgrade Preflight Check, [...]

  68. [...] ทดสอบอีกครั้งว่าบล๊อกของเราพร้อมหรือไม่ ด้วยปลั๊กอิน WordPress Upgrade Preflight Check [...]

  69. [...] Before you jump on this major upgrade, please do the pre-flight checklist.  It can be found here – http://smithsrus.com/downloads/wordpress-upgrade-preflight-check/ [...]

  70. [...] des incompatibilités de thèmes ou de plugins je vous conseille d’installer le plugin “WordPress Upgrade Preflight Check” qui va valider la compatibilité de ce que vous avez d’installé sur votre [...]

  71. [...] blog peut être mis à jour selon son contenu, ses thèmes et ses plugins. Pour cela, téléchargez le plugin WordPress Upgrade Preflight Check. Via 2803. Mais avant tout, pensez à faire un backup avant la mise à jour [...]

  72. [...] дозапусковое тестирование: В этом вам поможет плагин WordPress Upgrade Preflight Check , который определит готовность вашего блога к работе с [...]

  73. Glad to see that you’re still working on this plugin. I’ll be looking forward to it as and when 2.5 comes out. Cheers.

  74. [...] a PreFlight Test: The WordPress Upgrade Preflight Check Plugin tests your blog to make sure it is ready for the new version. This is especially good for those [...]

  75. I am looking forward to a 2.5 Preflight Check… hoping soon, thanks for all your hard work!

  76. [...] Preflight Test Plugin: Get this handy plugin to sort out a detailed report on the upgrade process. This is highly recommended before you do any [...]

  77. [...] download and activate WordPress Upgrade Preflight Check. It checks all your plugins you use, if it may have compatibility problems with the newest [...]

  78. […] getan, für das Embedded Video With Link Plugin gibt’s immer noch kein Update / Fix. Das WordPress Upgrade Preflight Check Plugin gibt’s auch noch nicht für 2.5. Ihr müsst also – wenn ihr jetzt schon upgraden […]

  79. […] podem deixar de funcionar. Antes de atualizar seu blog, aguarde sair uma versão final do plugin Upgrade Preflight Check. Este plugin faz uma varredura por todos os seus plugins e themes para verificar se existe algum […]

  80. [...] want to run some preliminary checks in order to see if your blog is ready to upgrade, you can use this plugin. As a general rule, before upgrading back up your blog and its database. As far as I am concerned, [...]

  81. [...] may be also useful. There is a plugin called WordPress Upgrade Preflight Check that will generate a list of all your installed plugin, and it will tell you if there’s [...]

  82. When will it able to check WordPress 2.5 with this plugin?
    Thanks.
    Chris

  83. @Chris, Currently the plugin does not check anything specific for WordPress 2.5. It’s still useful if you are coming from a version less than 2.3, though. I’m still debating wether to upgrade for 2.5 specific issues because there really aren’t that many of them.

  84. [...] followed everything on the guide, download all the necessary plugins (wp-dbmanager, WordPress preflight check, Instant WordPress upgrade [...]

  85. would love to see this for 2.5, having a bunch of sites with tons of plugin’s, I don’t look forward to manually checking them all. If you do upgrade this, it would be appreciated. THanks!!

  86. [...] on a version for WP 2.5 so if you’re planning on upgrading to 2.5 soon be sure to check the Preflight Check page for [...]

  87. [...] Upgrade senza avere particolari problemi. Come prima cosa consiglio di scaricare questo plugin: Upgrade Preflight Check.Il plugin farà un check di tutti i vostri plugin e dei vostri themes segnalando eventuali [...]

  88. This is a great plugin, and I really think you should develop an upgrade for the 2.5 version. Is there a way to make this plugin static among upgrading wordpress versions? Since WordPress ALWAYS have updates.

  89. [...] atau tidak dengan version baru WordPress ni. Jadi, disini aku sarankan guna WordPress Upgrade Prefight Check. Plugin ni akan semak samada sesuai atau tidak plugin yang sedia ada untuk WordPress 2.6 [...]