Docs    Facebook    Documentation

Manually updating the Custom Facebook Feed plugin

Three ways to update the Custom Facebook Feed plugin by hand when the usual update from your Plugins page will not work.

Would you like to update the Facebook Feed plugin by hand because the automatic update isn’t working?

In this guide, we’ll walk you through two ways to do it. You can upload the new plugin file in WordPress, or replace the plugin files over FTP.

Before you get started, make sure Facebook Feed is installed and activated on your WordPress site.

Here is what we will cover.

Important: Don’t delete the plugin to update it. Deleting Facebook Feed from your Plugins page runs its uninstall routine. Unless Preserve settings if plugin is removed is turned on, that routine removes your feeds, connected sources, and settings. In the paid version, it also removes your license key. Instead, use either method below.

Downloading the Latest Version

To get started, we’ll download the latest plugin file.

  • For the paid version, go to the Downloads tab of your Smash Balloon account. Then, click the download link for the Facebook Feed plugin to save the plugin’s .zip file to your computer.
  • For the free version, go to the plugin’s page on WordPress.org. There, click the Download button to get the .zip file.

There’s no need to unzip the file for the WordPress method. You’ll upload the .zip file as it is. For the FTP method, you’ll unzip it later.

Before you upload it, we’ll turn on a setting that keeps your feeds and settings saved.

Keeping Your Settings

The setting we’ll turn on is a precaution in case the plugin is ever removed from your site. When it’s on, the plugin keeps your feeds and settings saved instead of removing them.

The free version has the same setting in the same place.

  1. In your WordPress dashboard, go to Facebook Feed » Settings.
  2. On the General tab, scroll down to Preserve settings if plugin is removed. Then, click the toggle to turn it on.
  3. When you’re done, click Save Changes.

The setting is off until you turn it on. Next to the toggle, the plugin explains that your feeds and settings stay saved even if the plugin is uninstalled.

Your settings are now saved, and you’re ready to update the plugin.

Updating From WordPress

All you need for this method is the .zip file you downloaded. You don’t need to deactivate or delete the plugin first.

  1. In your WordPress dashboard, go to Plugins » Add Plugin. In older versions of WordPress, this menu item is called Add New Plugin.
  2. At the top of the page, click Upload Plugin.
  3. In the upload box, click Choose File. Then, select the .zip file you downloaded.
  4. Once the file name appears next to the button, click Install Now. Because the plugin is already on your site, WordPress doesn’t install it a second time. Instead, it shows a screen titled “This plugin is already installed.” The Current column is the version on your site, and the Uploaded column is the file you just chose.
  5. Check that the Uploaded version is higher than the Current one. Then, click Replace current with uploaded. WordPress replaces the old plugin files with the new ones. To stop the update instead, click the Cancel and go back button next to it.
  6. Finally, go to Plugins » Installed Plugins. Next, find the plugin’s row and check its version number. If it matches the version you uploaded, the update is done.

If you see the error PCLZIP_ERR_BAD_FORMAT (-10) when you upload the file, see our guide on fixing the PCLZIP_ERR_BAD_FORMAT error. If you can’t upload through WordPress at all, you can replace the plugin files over FTP instead.

Updating With FTP

For this method, you’ll need FTP access to your website. If you’re new to FTP, see How to Manually Update WordPress Plugins via FTP for a general walkthrough.

  1. First, unzip the .zip file you downloaded.
  2. Next, connect to your site with your FTP program and go to the wp-content/plugins folder.
  3. Then, open the plugin’s folder. It’s called custom-facebook-feed-pro for the paid version and custom-facebook-feed for the free version.
  4. Finally, upload everything inside the unzipped plugin folder on your computer to the plugin’s folder on your site. When your FTP program asks, choose to overwrite the existing files.

When the upload is done, check the plugin’s version number the same way as in the final step of Updating From WordPress.

That’s it! You’ve updated the Facebook Feed plugin by hand without deleting it. If your update didn’t show on the Plugins page in the first place, see our guide on fixing an update that doesn’t show.

Frequently Asked Questions

Below, we’ve answered some of the most common questions about updating the plugin by hand.

Why shouldn’t I delete the plugin and install it again?

Deleting the plugin runs its uninstall routine. When Preserve settings if plugin is removed is off, the routine removes your feeds, your connected sources, and your settings. In the paid version, it also removes your license key. Uploading the new file with Replace current with uploaded, or replacing the files over FTP, updates the plugin without deleting it.

Do I need to turn on Preserve settings if plugin is removed?

No, but we recommend it. The setting is off until you turn it on. It’s a precaution that keeps your feeds and settings saved if the plugin is ever removed.

I don’t see Replace current with uploaded. What can I do?

WordPress shows that button only when your site meets the new version’s requirements. If it doesn’t, the screen says “The plugin cannot be updated due to the following” instead. Below that, it lists the reason, such as the PHP or WordPress version the new version needs. Once your site meets those requirements, upload the file again.

What if WordPress says I’m uploading an older version?

WordPress warns you when the file you uploaded is an older version of the plugin on your site. To stop, click Cancel and go back. Then, download the latest version again and upload that file instead.

The update doesn’t show on my Plugins page. Why not?

The paid version checks for updates with the license key saved in its settings. For the checks and fixes, see our guide on fixing an update that doesn’t show. You can also update by hand with the steps above.

support

Couldn’t find your answer in the docs?

Contact Support